CLI reference

Every top-level surtgis subcommand, with flags and a minimal example. Pages are generated from --help output and regenerated on every CLI-surface change.

Top-level commands

• surtgis info — Show information about a raster file
• surtgis terrain — Terrain analysis algorithms
• surtgis hydrology — Hydrology algorithms
• surtgis imagery — Imagery / spectral index algorithms
• surtgis morphology — Mathematical morphology algorithms
• surtgis landscape — Landscape ecology metrics (global patch/class/landscape level)
• surtgis extract — Extract raster values at point locations to CSV
• surtgis extract-patches — Extract raster patches centered on points or sampled from polygons for CNN training
• surtgis clip — Clip a raster by polygon or bounding box
• surtgis reproject — Reproject a raster from one CRS to another (native, no GDAL dependency)
• surtgis rasterize — Rasterize a vector file to a raster grid (.geojson, .shp, .gpkg)
• surtgis resample — Resample a raster to match the grid of a reference raster
• surtgis mosaic — Mosaic multiple rasters into one covering the union extent
• surtgis cog — Read and process Cloud Optimized GeoTIFFs (COGs) via HTTP
• surtgis stac — Search and fetch data from STAC catalogs (Planetary Computer, Earth Search)
• surtgis pipeline — Pipeline: integrated workflows for specific use cases
• surtgis vector — Vector geoprocessing: intersection, union, difference, dissolve, buffer
• surtgis interpolation — Geostatistical interpolation: variogram, kriging, universal kriging, regression kriging
• surtgis temporal — Temporal analysis: trend, anomaly, phenology, statistics
• surtgis classification — Classification: unsupervised/supervised raster classification (k-means, PCA, etc.)
• surtgis texture — Texture analysis: edge detection and GLCM texture measures
• surtgis statistics — Statistics: focal, zonal, and spatial autocorrelation

Global flags

Available on every subcommand:

  -v, --verbose                  Verbose output
      --compress                 Compress output GeoTIFFs (deflate)
      --streaming                Force streaming mode for large rasters (auto-detected if >500MB)
      --max-memory <MAX_MEMORY>  Maximum memory to use (e.g., 4G, 1024MB, 500MiB). If raster would exceed this when decompressed, force streaming
  -h, --help                     Print help
  -V, --version                  Print version