GBDXTools: Python tools for using GBDX

GBDXTools is a package to simplify interaction with Maxars’s GBDX platform and integrate GBDX data into Python’s mature analysis ecosystem.

GBDX Platform

GBDX is Maxar’s online platform to access imagery, search data, and run analysis. Its functionality can be broken into four areas:

  • Raster Data Access

    Access to 100+ PB of Maxar satellite imagery plus Landsat, Sentinel, and other sources.

  • Image Catalog

    Search and filter image metadata to find imagery.

  • Vector Services

    Search and store vector data. Includes image footprints, OpenStreetMap, NaturalEarth, and other datasets.

  • GBDX Workflows

    Build analysis workflows using a library of tasks and run them at scale.

Python GBDXTools

GBDXTools extends the access to these services with additional functionality for analysis and visualization. It can be thought of as having three layers:

  • A core API library to abstract GBDX services
  • Image classes that wrap all of the API calls, manage the geospatial metadata, and return NumPy arrays. These classes are based on Dask arrays which defer the server calls until the image data is needed.
  • Simple visualization and analysis methods such as one-line plotting with Matplotlib (not included).

CLI RdaTools

Some GBDX functionality is also available through the command line with https://github.com/DigitalGlobe/rdatools. The CLI tool is useful for building simple workflows with other command lines tools like gdal_translate or JQ. RdaTools is a statically linked Go executable and binaries should run on most systems.

Example

To load a subset of an image covering the Denver area using its catalog identifier, and view it in a Jupyter notebook:

from gbdxtools import CatalogImage
image = CatalogImage('103001007B9DD400', bbox=[-105.06, 39.67, -105.04, 39.68])
image.plot()
_images/getting_started.jpg

GBDXTools is MIT licenced.

The recommended installation method is with Anaconda:

conda install -c conda-forge -c digitalglobe gbdxtools

GBDXTools can also be installed with pip:

pip install gbdxtools