Geospatial Imagery Pipeline Platform

Updated Oct 1, 2018

This document is intended as developer level documentation for the interfaces provided by the tcc-gipper library. 

Installation

The packages necessary to interact with the Geospatial Imagery Pipeline Platform are available for install via Conda.

  1. Install Conda if it is not already installed.
  2. Create a Python 2 conda environment.
  3. Install the latest versions of fieldview-platform and tcc-gipper conda packages.
Authentication

Define the following environment variables. These environment variables are used by fieldview-platform to provide authenticated access to metadata and imagery.

  • OAUTH2_CLIENT_ID
  • OAUTH2_CLIENT_SECRET
  • API_KEY
  • USERNAME=<Climate FieldView email address>
  • PASSWORD=<Climate FieldView password>
Quickstart

Create a directory to hold the example and change to the directory.

At the command prompt,  enter the following commands. Feel free to change the name of the conda environment.

conda create --name tcc-gipper-example python=2
conda activate tcc-gipper-example
conda install fieldview-platform tcc-gipper

Create a python file with the following content and execute it. If it executes without error then everything needed for authentication was located.

from tcc_gipper.gipper import Gipper
gipper = Gipper()

Update the same python file with the following changes and execute it. Now, you should see the full metadata output for the Sentinel2-Level 1C dataset represented by the specified UUID.

from tcc_gipper.gipper import Gipper
from tcc_gipper.utils import print_json

gipper = Gipper()
dataset = gipper.get_dataset("3412b3e6-092f-4793-9c52-012dad48507e")
print_json(dataset)
Data Catalog

Datasets from several satellites have been ingested into the system and are available. Users are granted access to imagery on both a sensor and area of interest basis. 

Detailed information regarding the APIs, public libraries, and metadata are also available. 

Access and Support

Users interested in access to these APIs should complete this form. Access requests generally take less than 48 hours to be approved and granted.