GBDX

ENVI® Geo JSON To ROI

This task converts GeoJSON features to a region of interest (ROI).

GBDX Registered Name: ENVI_GeoJSONToROI
Provider: Harris Geospatial Solutions

Quickstart

This is a workflow example for basic processing.

Python

# Initialize the Environment.

from gbdxtools import Interface
gbdx = Interface()

tasks = []
output_location = 'ENVI/GeoJSONToROI'

# Creates an ENVI ROI.
envi_geojson_to_roi_task = gbdx.Task("ENVI_GeoJSONToROI")
envi_geojson = '''{"type": "GeometryCollection","name": "roi_geojson","geometries": [{ "type": "MultiPolygon", "properties": { "name": 1 }, "coordinates": [ [ [ [ -94.28559834878169, 43.16727586294779 ], [ -94.285586915028276, 43.16785127307449 ], [ -94.284557877221843, 43.167409291865695 ], [ -94.283860418264126, 43.166958968099649 ], [ -94.283860418264126, 43.166508641013728 ], [ -94.282865681717894, 43.166291815677198 ], [ -94.28251123536235, 43.166800520059091 ], [ -94.281996716459119, 43.166842216951714 ], [ -94.282031017719333, 43.166491962169012 ], [ -94.28191668018529, 43.165999934201139 ], [ -94.282305427801049, 43.165791446578652 ], [ -94.283517405661996, 43.165399487922009 ], [ -94.282831380457679, 43.164640582097746 ], [ -94.283437369388139, 43.164482128043609 ], [ -94.283848984510712, 43.163689851607927 ], [ -94.284752251029715, 43.163648152563532 ], [ -94.285655517548719, 43.163906686179985 ], [ -94.28559834878169, 43.16727586294779 ] ] ] ] },{ "type": "MultiPolygon", "properties": { "name": 2 }, "coordinates": [ [ [ [ -94.285975662644034, 43.169004161836746 ], [ -94.285904201685256, 43.169060450604327 ], [ -94.285915635438641, 43.168935364383707 ], [ -94.285809873219662, 43.168616393361646 ], [ -94.285964228890634, 43.16865183466858 ], [ -94.285975662644034, 43.169004161836746 ] ] ] ] },{ "type": "MultiPolygon", "properties": { "name": 3 }, "coordinates": [ [ [ [ -94.27333850669315, 43.168658089014706 ], [ -94.272552436146569, 43.168666428141904 ], [ -94.272569586776655, 43.16858929117187 ], [ -94.2733470820082, 43.168597630308462 ], [ -94.27333850669315, 43.168658089014706 ] ] ] ] },{ "type": "MultiPolygon", "properties": { "name": 4 }, "coordinates": [ [ [ [ -94.273501437679187, 43.169316876555747 ], [ -94.27357004019963, 43.172085374368471 ], [ -94.267533018401792, 43.171851891446664 ], [ -94.267350078347306, 43.169350232697944 ], [ -94.273501437679187, 43.169316876555747 ] ] ] ] }]}'''
envi_geojson_to_roi_task.inputs.input_geojson = envi_geojson
tasks += [envi_geojson_to_roi_task]

workflow = gbdx.Workflow(tasks)
workflow.savedata(envi_geojson_to_roi_task.outputs.output_roi_uri, location=output_location)

workflow.execute()

Inputs

The following table lists all ENVI_GeoJSONToROI inputs.
Mandatory (optional) settings are listed as Required = True (Required = False).

Name Required Default Valid Values Description
file_types False N/A string GBDX Option. Comma seperated list of permitted file type extensions. Use this to filter input files -- Value Type: STRING[*]
output_roi_uri_filename False N/A string Specify a string with the fully-qualified path and filename for OUTPUT_ROI. -- Value Type: STRING
input_geojson True N/A See ENVIGEOJSON input type Specify an input GeoJSON object. -- Value Type: ENVIGEOJSON

Outputs

The following table lists all ENVI_GeoJSONToROI outputs.
Mandatory (optional) settings are listed as Required = True (Required = False).

Name Required Default Valid Values Description
task_meta_data False N/A directory GBDX Option. Output location for task meta data such as execution log and output JSON
output_roi_uri True N/A directory Output for OUTPUT_ROI. -- Value Type: ENVIURI

Output structure

The output_roi_uri file will be written to the specified S3 Customer Account Location.

Background

For additional background information on this task please refer to the Harris Geospatial ENVI documentation and
ENVI® Geo JSONTo ROI.

Contact

If you have any questions or issues with this task, please contact gbdx-support@digitalglobe.com.