GDI

🛠️ Requirements

• Python >= 3.12

Install poetry and poetry shell

pip install poetry==2.0.1

poetry self add poetry-plugin-shell

Make an env

poetry shell

Install the dependencies

poetry install

---

🔐 Authentication

gdi generate-token --client-id <client-id> --client-secret <client-secret> --role <role>

---

📍 Vector Commands

Get Vector Data

Without Saving:

gdi get_vector_data --client-id <client-id> --client-secret <client-secret> --role <role> --resource-id <resource-id>

With Saving:

gdi get_vector_data --client-id <client-id> --client-secret <client-secret> --role <role> --resource-id <resource-id> --save-object True --config-path <config-path> --file-path <file-path>

Features Count

gdi features-count --config-path <config-path> --client-id <client-id> --artifact-url <artifact-url>

List Objects

gdi ls-objects --config-path <config-path> --client-id <client-id>

Create Buffer

gdi create-buffer --config-path <config-path> --client-id <client-id> --artifact-url <artifact-url> --buffer-d <buffer-distance> --store-artifact True --file-path <file-path>

Create Intersection

gdi create-intersection --config-path <config-path> --client-id <client-id> --left_feature <left-feature-path> --right_feature <right-feature-path> --store-artifact True --file-path <file-path>

Download Vector Features

gdi download_vector_features --config-path <config-path> --client-id <client-id> --artifact-url <artifact-url> --save-as <output-file-path>

List Vector Data

gdi list_vector_data --location <location>

Compute Geometry

gdi compute-geometry --config-path <config-path> --client-id <client-id> --artifact-url <artifact-url> --store-artifact True --file-path <file-path>

Reduce to Raster

gdi reduce_to_raster --config-path <config-path> --client-id <client-id> --artifact-url <artifact-url> --attribute <attribute> --grid-size <grid-size> --reducer <reducer> --store-artifacts <True/False> --file-path <file-path>

Create Optimal Route

gdi create-optimal-route --config-path <config-path> --client-id <client-id> --artifact-url <artifact-url> --points-filepath <points-filepath> --store-artifacts True --route-file-path <route-file-path>

Create Voronoi

gdi create-voronoi --config-path <config-path> --client-id <client-id> --input-artifact-url <artifact-url> --store-artifact True --file-path <file-path>

Delaunay Triangulation

gdi create-delaunay-triangles --config-path <config-path> --client-id <client-id> --artifact-url <artifact-url> --store-artifact <storage-location> --file-path <file-path>

Clip Vector

gdi clip-vector --config-path <config-path> --client-id <client-id> --target-artifact-url <target-artifact-url> --clip-artifact-url <clip-artifact-url> --store-artifact <storage-location> --file-path <file-path>

BBOX Vector Clip

gdi bbox-feature-clip --config-path <config-path> --client-id <client-id> --target-artifact-url <target-artifact-url> --clip-vector-path <clip-vector-path> --store-artifact <storage-location> --file-path <file-path>

---

🗺️ Raster Commands

Search Catalog

gdi search-cat --collection-ids <collection-id>

Get STAC Assets

gdi get-raster-data --client-id <client-id> --client-secret <client-secret> --role <role> --collection-ds <collection-ds> --config-path <config-path>

Flood Fill Model

gdi flood-fill-model --config-path <config-path> --client-id <client-id> --artifact-url <artifact-url> --threshold <threshold> --store-artifact True --file-path <file-path>

Generate NDVI

gdi generate-ndvi --config-path <config-path> --client-id <client-id> --red-artifact-url <red-artifact-url> --nir-artifact-url <nir-artifact-url> --store-artifact <storage-location> --file-path <file-path>

Compute Slope

gdi generate-slope --config-path <config-path> --client-id <client-id> --artifact-url <artifact-url> --store-artifact <storage-location> --file-path <file-path>

Generate Isometric Lines

gdi generate-isometric-lines --config-path <config-path> --client-id <client-id> --artifact-url <artifact-url> --interval <interval> --store-artifact <storage-location> --file-path <file-path>

Reduce to Feature

gdi reduce-to-feature --config-path <config-path> --client-id <client-id> --raster-artifact-url <raster-artifact-url> --vector-artifact-url <vector-artifact-url> --reducer <reducer> --attribute <attribute> --store-artifact <storage-location> --file-path <file-path>

Merge Rasters

gdi rasters-merge --config-path <config-path> --client-id <client-id> --prefix <prefix> --store-artifact <storage-location> --file-path <file-path>

Clip Raster

gdi raster-clip --config-path <config-path> --client-id <client-id> --raster-key <raster-key> --geojson-key <geojson-key> --store-artifact <storage-location> --file-path <file-path>

BBOX Raster Clip

gdi bbox-raster-clip --config-path <config-path> --client-id <client-id> --raster-key <raster-key> --vector-path <vector-path> --store-artifact <storage-location> --file-path <file-path>

Generate Local Correlation

gdi generate-local-correlation --config-path <config-path> --client-id <client-id> --x <band_path> --y <band_path> --chunk-size <chunk_size> --store-artifact <storage-location> --file-path <file-path>

Extract Band Path

gdi extract-band-path --asset-list <asset-list> --item-key <item-key> --asset-key <asset-key>

---

For Reference : 

client-id  = 7dcf1193-4237-48a7-a5f2-4b530b69b1cb

client secret = a863cafce5bd3d1bd302ab079242790d18cec974

To know more about any of the commands:

gdi <command-name> -- help

---

📄 Notes

• Make sure your config-path file is correctly set up with MinIO credentials and bucket info.
• store-artifact and store-artifacts must be explicitly set to True or a valid storage destination.
• <artifact-url> and <file-path> must be adjusted to reflect your environment and bucket layout.