| commit | 2158d7676492738286b6691390fec8a448544468 | [log] [tgz] |
|---|---|---|
| author | Jia Yu <jiayu2@asu.edu> | Thu Oct 06 17:07:47 2016 -0700 |
| committer | GitHub <noreply@github.com> | Thu Oct 06 17:07:47 2016 -0700 |
| tree | 5f73f41320f2447f75fa5fef196736b5224a4724 | |
| parent | 88d3ab56b7770da1e82ff4ea67218256fcd781dd [diff] |
Update README.md
| Version | Summary |
|---|---|
| 0.1 | Support spatial range, join and Knn |
| 0.2 | Improve code structure and refactor API |
| 0.3 | Major updates: Significantly shorten query time on spatial join for skewed data; Support load balanced spatial partitioning methods (also serve as the global index); Optimize code for iterative spatial data mining |
| 0.3.1 | Bug fix: Support Apache Spark 2.X version, fix a bug which results in inaccurate results when doing join query, add more unit test cases |
| Master branch | even with 0.3.1 |
| Spark 1.X branch | even with 0.3.1 but only supports Apache Spark 1.X |
GeoSpark is a cluster computing system for processing large-scale spatial data. GeoSpark extends Apache Spark with a set of out-of-the-box Spatial Resilient Distributed Datasets (SRDDs) that efficiently load, process, and analyze large-scale spatial data across machines. This problem is quite challenging due to the fact that (1) spatial data may be quite complex, e.g., rivers' and cities' geometrical boundaries, (2) spatial (and geometric) operations (e.g., Overlap, Intersect, Convex Hull, Cartographic Distances) cannot be easily and efficiently expressed using regular RDD transformations and actions. GeoSpark provides APIs for Apache Spark programmer to easily develop their spatial analysis programs with Spatial Resilient Distributed Datasets (SRDDs) which have in house support for geometrical and distance operations. Experiments show that GeoSpark is scalable and exhibits faster run-time performance than Hadoop-based systems in spatial analysis applications like spatial join, spatial aggregation, spatial autocorrelation analysis and spatial co-location pattern recognition.
Note: GeoSpark Master branch supports Apache Spark 2.X releases and GeoSpark for Spark 1.X branch supports Apache Spark 1.X releases. Please refer to the proper branch you need.
./bin/spark-shell --jars GeoSpark_COMPILED.jar
Spatial queries Java example in “org.datasyslab.geospark.showcase” folder: Spatial range, join and KNN.
####Spatial range query
val objectRDD = new RectangleRDD(sc, inputLocation, offset, "csv");
val resultSize = RangeQuery.SpatialRangeQuery(objectRDD, queryEnvelope, 0).getRawRectangleRDD().count();
####Spatial KNN query
val objectRDD = new RectangleRDD(sc, inputLocation, offset, "csv");
val result = KNNQuery.SpatialKnnQuery(objectRDD, queryPoint, 1000); ####Spatial join query with index val rectangleRDD = new RectangleRDD(sc, inputLocation2, offset2, "csv");
val objectRDD = new RectangleRDD(sc, inputLocation, offset ,"wkt","rtree",numPartitions);
objectRDD.buildIndex("rtree");
val joinQuery = new JoinQuery(sc,objectRDD,rectangleRDD);
val resultSize = joinQuery.SpatialJoinQueryUsingIndex(objectRDD,rectangleRDD).count();
Please refer GeoSpark Scala and Java API Usage
GeoSpark extends RDDs to form Spatial RDDs (SRDDs) and efficiently partitions SRDD data elements across machines and introduces novel parallelized spatial (geometric operations that follows the Open Geosptial Consortium (OGC) standard) transformations and actions (for SRDD) that provide a more intuitive interface for users to write spatial data analytics programs. Moreover, GeoSpark extends the SRDD layer to execute spatial queries (e.g., Range query, KNN query, and Join query) on large-scale spatial datasets. After geometrical objects are retrieved in the Spatial RDD layer, users can invoke spatial query processing operations provided in the Spatial Query Processing Layer of GeoSpark which runs over the in-memory cluster, decides how spatial object-relational tuples could be stored, indexed, and accessed using SRDDs, and returns the spatial query results required by user.
(column, column,..., Longitude, Latitude, column, column,...)
(column, column,...,Longitude 1, Longitude 2, Latitude 1, Latitude 2,column, column,...)
Two pairs of longitude and latitude present the vertexes lie on the diagonal of one rectangle.
(column, column,...,Longitude 1, Latitude 1, Longitude 2, Latitude 2, ...)
Each tuple contains unlimited points.
##Supported data format GeoSpark supports Comma-Separated Values (“csv”), Tab-separated values (“tsv”), Well-Known Text (“wkt”), and GeoJSON (“geojson”) as the input formats. Users only need to specify input format as Splitter and the start column (if necessary) of spatial info in one tuple as Offset when call Constructors.
GeoSpark supports equal size (“equalgrid”), R-Tree (“rtree”) and Voronoi diagram (“voronoi”) spatial partitioning methods. Spatial partitioning is to repartition RDD according to objects' spatial locations. Spatial join on spatial paritioned RDD will be very fast.
GeoSpark supports two Spatial Indexes, Quad-Tree and R-Tree.
GeoSpark currently provides native support for Inside, Overlap, DatasetBoundary, Minimum Bounding Rectangle and Polygon Union in SRDDS following Open Geospatial Consortium (OGC) standard.
GeoSpark so far provides spatial range query, join query and KNN query in SRDDs.
Jia Yu, Jinxuan Wu, Mohamed Sarwat. “A Demonstration of GeoSpark: A Cluster Computing Framework for Processing Big Spatial Data”. (demo paper) In Proceeding of IEEE International Conference on Data Engineering ICDE 2016, Helsinki, FI, May 2016
Jia Yu, Jinxuan Wu, Mohamed Sarwat. “GeoSpark: A Cluster Computing Framework for Processing Large-Scale Spatial Data”. (short paper) In Proceeding of the ACM International Conference on Advances in Geographic Information Systems ACM SIGSPATIAL GIS 2015, Seattle, WA, USA November 2015
GeoSaprk makes use of JTS Plus (An extended JTS Topology Suite Version 1.14) for some geometrical computations.
Please refer to JTS Topology Suite website and JTS Plus for more details.
Jia Yu (Email: jiayu2@asu.edu)
Jinxuan Wu (Email: jinxuanw@asu.edu)
Mohamed Sarwat (Email: msarwat@asu.edu)
###Project website Please visit GeoSpark project wesbite for latest news and releases.
GeoSpark is one of the projects under DataSys Lab at Arizona State University. The mission of DataSys Lab is designing and developing experimental data management systems (e.g., database systems).