Skip to content

Commit a20cfa5

Browse files
committed
Merge remote-tracking branch 'lt/develop' into docs/build-and-ci-improvements
Signed-off-by: Jason T. Brown <jason@astraea.earth>
2 parents 56478b2 + f6163a1 commit a20cfa5

File tree

38 files changed

+659
-277
lines changed

38 files changed

+659
-277
lines changed

CONTRIBUTING.md

Lines changed: 5 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,10 @@
11
# Contributing to RasterFrames
22

3-
Thanks for your interest in this project.
3+
Community contributions are always welcome. To get started, please review this document,
4+
the [code of conduct](https://github.com/locationtech/rasterframes/blob/develop/CODE_OF_CONDUCT.md), and reach out to
5+
us on [gitter](https://gitter.im/locationtech/rasterframes) so the community can help you get started!
46

5-
## Project Description
6-
7-
LocationTech RasterFrames brings the power of Spark DataFrames to geospatial
8-
raster data, empowered by the map algebra and tile layer operations of
9-
GeoTrellis. The underlying purpose of RasterFrames is to allow data scientists
10-
and software developers to process and analyze geospatial-temporal raster data
11-
with the same flexibility and ease as any other Spark Catalyst data type. At its
12-
core is a user-defined type (UDT) called TileUDT, which encodes a GeoTrellis
13-
Tile in a form the Spark Catalyst engine can process. Furthermore, we extend the
14-
definition of a DataFrame to encompass some additional invariants, allowing for
15-
geospatial operations within and between RasterFrames to occur, while still
16-
maintaining necessary geo-referencing constructs.
7+
The official home of RasterFrames under the Eclipse Foundation may be found here:
178

189
* https://projects.eclipse.org/projects/locationtech.rasterframes
1910

@@ -58,19 +49,10 @@ commands are as follows:
5849
* Build documentation: `sbt makeSite`
5950
* Spark shell with RasterFrames initialized: `sbt console`
6051

61-
62-
## Contribution Process
63-
64-
RasterFrames uses GitHub pull requests (PRs) for accepting contributions.
65-
Please fork the repository, create a branch, and submit a PR based off the `master` branch.
66-
During the PR review process comments may be attached. Please look out for comments
67-
and respond as necessary.
68-
69-
7052
## Contact
7153

7254
Help, questions and community dialog are supported via Gitter:
7355

74-
* https://gitter.im/s22s/raster-frames
56+
* https://gitter.im/locationtech/rasterframes
7557

7658
Commercial support is available by writing to info@astraea.earth

README.md

Lines changed: 20 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,40 @@
11
<img src="docs/src/main/paradox/_template/images/RasterFramesLogo.png" width="300px"/><sup style="vertical-align: top;">&reg;</sup>
22

3-
[![Join the chat at https://gitter.im/s22s/raster-frames](https://badges.gitter.im/s22s/raster-frames.svg)](https://gitter.im/s22s/raster-frames?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
3+
[![Join the chat at https://gitter.im/locationtech/rasterframes](https://badges.gitter.im/locationtech/rasterframes.svg)](https://gitter.im/locationtech/rasterframes?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
44

5-
_RasterFrames™_ brings the power of Spark DataFrames to geospatial raster data, empowered by the map algebra and tile layer operations of [GeoTrellis](https://geotrellis.io/).
5+
RasterFrames® brings together Earth-observation (EO) data access, cloud computing, and DataFrame-based data science. The recent explosion of EO data from public and private satellite operators presents both a huge opportunity as well as a challenge to the data analysis community. It is _Big Data_ in the truest sense, and its footprint is rapidly getting bigger.
6+
7+
RasterFrames provides a DataFrame-centric view over arbitrary raster data, enabling spatiotemporal queries, map algebra raster operations, and compatibility with the ecosystem of Spark ML algorithms. By using DataFrames as the core cognitive and compute data model, it is able to deliver these features in a form that is both accessible to general analysts and scalable along with the rapidly growing data footprint.
68

79
<img src="docs/src/main/paradox/RasterFramePipeline.png" width="600px"/>
810

911
Please see the [Getting Started](http://rasterframes.io/getting-started.html) section of the Users' Manual to start using RasterFrames.
1012

11-
## Documentation
13+
## User Resources
14+
15+
* [RasterFrames Users' Manual](http://rasterframes.io/)
16+
* [RasterFrames Jupyter Notebook Docker Image](https://hub.docker.com/r/s22s/rasterframes-notebook/)
17+
* [Gitter Channel](https://gitter.im/locationtech/rasterframes)
18+
* [Submit an Issue](https://github.com/locationtech/rasterframes/issues)
19+
20+
21+
## Contributing
1222

13-
* [Users' Manual](http://rasterframes.io/)
14-
* [API Documentation](http://rasterframes.io/latest/api/index.html)
15-
* [List of available UDFs](http://rasterframes.io/latest/api/index.html#org.locationtech.rasterframes.RasterFunctions)
16-
* [RasterFrames Jupyter Notebook Docker Image](https://hub.docker.com/r/s22s/rasterframes-notebooks/)
23+
Community contributions are always welcome. To get started, please review our [contribution guidelines](https://github.com/locationtech/rasterframes/blob/develop/CONTRIBUTING.md), [code of conduct](https://github.com/locationtech/rasterframes/blob/develop/CODE_OF_CONDUCT.md), and reach out to us on [gitter](https://gitter.im/locationtech/rasterframes) so the community can help you get started!
1724

18-
## Build instruction
25+
RasterFrames is part of the LocationTech Stack.
1926

20-
First, you will need [sbt](https://www.scala-sbt.org/).
27+
<img src ="pyrasterframes/src/main/python/docs/static/rasterframes-locationtech-stack.png" width="600px" />
2128

22-
Download the source from GitHub.
29+
It is written in Scala, but with Python bindings. If you wish to contribute to the development of RasterFrames, or you
30+
wish to build it from scratch, you will need [sbt](https://www.scala-sbt.org/). Then clone the repository from GitHub.
2331

2432
```bash
2533
git clone https://github.com/locationtech/rasterframes.git
2634
cd rasterframes
2735
```
2836

29-
To publish to hyou Ivy local repository:
37+
To publish to your local repository:
3038

3139
```bash
3240
sbt publishLocal
@@ -50,7 +58,7 @@ The documentation may be built with
5058
sbt makeSite
5159
```
5260

53-
The `pyrasterframes` build instructions are located at [pyrasterframes/src/main/python/README.md](pyrasterframes/src/main/python/README.md)
61+
Additional, Python sepcific build instruction may be found at [pyrasterframes/src/main/python/README.md](pyrasterframes/src/main/python/README.md)
5462

5563
## Copyright and License
5664

build.sbt

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -141,9 +141,12 @@ lazy val docs = project
141141
),
142142
paradoxNavigationExpandDepth := Some(3),
143143
paradoxTheme := Some(builtinParadoxTheme("generic")),
144-
makeSite := makeSite.dependsOn(Compile / unidoc).dependsOn(Compile / paradox).value,
144+
makeSite := makeSite
145+
.dependsOn(Compile / unidoc)
146+
.dependsOn((Compile / paradox)
147+
.dependsOn(pyrasterframes / doc)
148+
).value,
145149
Compile / paradox / sourceDirectories += (pyrasterframes / Python / doc / target).value,
146-
Compile / paradox := (Compile / paradox).dependsOn(pyrasterframes / doc).value
147150
)
148151
.settings(
149152
addMappingsToSiteDir(ScalaUnidoc / packageDoc / mappings, ScalaUnidoc / siteSubdirName)

core/src/it/scala/org/locationtech/rasterframes/ref/RasterSourceIT.scala

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,6 @@ package org.locationtech.rasterframes.ref
2424
import java.lang.Math.ceil
2525
import java.net.URI
2626

27-
import com.azavea.gdal.GDALWarp
2827
import org.locationtech.rasterframes
2928
import org.locationtech.rasterframes.util.time
3029
import org.locationtech.rasterframes.{NOMINAL_TILE_SIZE, TestData, TestEnvironment}

0 commit comments

Comments
 (0)