i.up42.import - GRASS manual

NAME

i.up42.import - Imports Pléiades data using the Python SDK from UP42.

KEYWORDS

imagery, import, projection, Pléiades, UP42, VHR

SYNOPSIS

i.up42.import

i.up42.import --help

i.up42.import [-pm] [input=name] [input_geojson=string] [producttype=string] [start=string] [end=string] [clouds=integer] [area_relation=string] [directory=string] [output=name] [max_area=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-p: Print only credits for job
-m: Create vector map with meta data named meta_{output}
--overwrite: Allow output files to overwrite existing files
--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

input=name: Name of input vector map; Input vector map of BBOX
input_geojson=string: Input map as GeoJSON string in EPSGS:4326
producttype=string: UP42 product type to filter; Options: pleiades; Default: pleiades
start=string: Start date ('YYYY-MM-DD'); Default: 2020-01-01
end=string: End date ('YYYY-MM-DD'); Default: today
clouds=integer: Maximum cloud cover percentage for scene; Default: 100
area_relation=string: Spatial relation; Options: Intersects, Contains; Default: Contains
directory=string: Directory to save the original data; If not set, downloaded data will be deleted
output=name: Name for output raster map
max_area=integer: Maximum allowed area size in sqm

DESCRIPTION
EXAMPLES
- Estimate Credits for download of Pléiades data contained in a GeoJSON Polygon
SEE ALSO
AUTHOR

DESCRIPTION

i.up42.import is a Python 3 script which uses the Python SDK for UP42. UP42 is a platform for Earth data and analytics. You have to sign in to UP42 before using this GRASS GIS addon (https://up42.com/). So far, only the download of the Pléiades data is supported by this addon. The download region can be defined by an input vector map input or a GeoJSON polygon input_geojson. Here it is important that the area size must be at least 0.1 sqkm. if input_geojson is used, the GeoJSON must be passed as string with a polygon, UP42 only allows one single feature and not multiple features inside a geojson file and also no multipolygons. With the flag p the credits of a process are estimated.

EXAMPLES

Estimate Credits for download of Pléiades data contained in a GeoJSON Polygon

# setting authentication
export UP42_PROJECT_ID=[PROJECT_ID]
export UP42_PROJECT_API_KEY=[PROJECT_API_KEY]

# polygon in GeoJSON format
GEOJSON='{"type": "FeatureCollection","features": [{"type": "Feature","properties": {},"geometry": {"type": "Polygon","coordinates": [[[7.095494270324707,50.742294306843085],[7.092854976654053,50.740447578361746],[7.098348140716552,50.73836992176511],[7.100987434387207,50.73957850446387],[7.098090648651123,50.7425794569557],[7.095494270324707,50.742294306843085]]]}}]}'

# import of Pléiades in this polygon
i.up42.import input_geojson="$GEOJSON" clouds=2 -p directory=vhr/ start=2020-04-01 end=2020-04-30 output=vhr

AUTHOR

Anika Weinmann, mundialis, Germany

SOURCE CODE

Available at: i.up42.import source code (history)

Accessed: Monday Jul 27 12:22:45 2026