pygw

GeoWave provides geospatial and temporal indexing on top of Accumulo, HBase, BigTable, Cassandra, Kudu, Redis, RocksDB, and DynamoDB.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

438

Maintenance

Last Commit

1mo ago

Contributors

94

Package

Dependencies

2

License

Categories

Readme

GeoWave

About

Continuous IntegrationLicenseChat
GitHub Action Test StatusLicenseJoin the chat at https://gitter.im/locationtech/geowave

GeoWave is an open source set of software that:

  • Capabilities
  • Geospatial software plugins
    • GeoServer plugin to allow geospatial data in various key/value stores to be shared and visualized via OGC standard services

Basically, GeoWave is working to bridge geospatial software with modern key/value stores and distributed compute systems.

The Docs

The Software

  • We have multi-platform standalone installers for the GeoWave's command-line tools to help get started
    • This is often the quickest and easiest way to get started using GeoWave on your own machine
  • We have a RPM repository
    • This contains various packages including puppet modules, best used for distributed environments.
    • See the Installation Guide for more info.
  • Maven artifacts are available on Maven Central
  • And you can always build from source

Community

Getting Started

Programmatic Access

You can use Maven to reference pre-built GeoWave artifacts with the following pom.xml snippet (replacing ${keyvalue-datastore} with your data store of choice and ${geowave.version} with the GeoWave version you'd like to use):

    <dependencies>
        <dependency>
            <groupId>org.locationtech.geowave</groupId>
            <artifactId>geowave-datastore-${keyvalue-datastore}</artifactId>
            <version>${geowave.version}</version>
        </dependency>
        <dependency>
            <groupId>org.locationtech.geowave</groupId>
            <artifactId>geowave-adapter-vector</artifactId>
            <version>${geowave.version}</version>
        </dependency>
        <dependency>
            <groupId>org.locationtech.geowave</groupId>
            <artifactId>geowave-adapter-raster</artifactId>
            <version>${geowave.version}</version>
        </dependency>
    </dependencies>

Use the libraries available in the api package to leverage GeoWave's capabilities (where <data store options> might be AccumuloRequiredOptions or HBaseRequiredOptions and simple examples of creating the data type and index can be found in SimpleIngest within the examples directory):

DataStore store = DataStoreFactory.createDataStore(<data store options>);
store.addType(<my data type>, <my index>);
try(Writer writer = store.createWriter()){
  //write data
  writer.writer(<data>);
}
 
//this just queries everything
try(CloseableIterator it = store.query(QueryBuilder.newBuilder().build())){
  while(it.hasNext()){
    //retrieve results matching query criteria and do something
    it.next();
  }
}

See the Developer Guide for more detailed programmatic API examples.

Command-line Access

Alternatively, you can always use the GeoWave command-line to access the same capabilities:

# Add a new RocksDB data store called myStore in the current directory
geowave store add -t rocksdb myStore

# Add a spatial index called spatialIdx to myStore
geowave index add -t spatial myStore spatialIdx

# Ingest a shapefile with states into myStore in the spatialIdx index
geowave ingest localToGW -f geotools-vector states.shp myStore spatialIdx

# Query all the data in the states type from myStore
geowave vector query "SELECT * FROM myStore.states"

See the CLI documentation for a full list of commands and their options.

Some GeoWave rendered eye candy

Geolife data at city scale

Geolife data at block scale

OSM GPX tracks at country scale

See Example Screenshots in the GeoWave Overview for more information.

Supported versions of core libraries

We work to maintain a N and N-1 tested and supported version pace for the following core libraries.

GeoServerGeoToolsAccumuloHBaseHadoopJava
2.14.x20.x[1.7.x,1.9.x][1.1.x,1.4.x]2.xJava8

Origin

GeoWave was originally developed at the National Geospatial-Intelligence Agency (NGA) in collaboration with RadiantBlue Technologies (now Maxar Technologies) and Booz Allen Hamilton. The software use, modification, and distribution rights are stipulated within the Apache 2.0 license.

Contributing

All pull request contributions to this project will be released under the Apache 2.0 or compatible license. Contributions are welcome and guidelines are provided here.

Did I mention our documentation!

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100