Skip to content

Satellite Imagery and Vision

github-actions[bot] edited this page Nov 1, 2026 · 3 revisions

This page is generated from the repository on every merge to main; changes made here are overwritten.

calculate_raster_change_detection

Compute pixel-wise differential change between two temporal rasters (after minus before) -- 'what changed between these two satellite images', 'compare before and after images for damage', 'show me the damage from before to after'. The core building block calculate_damage_exposure_severity composes into a full damage assessment (zonal stats per admin unit, building exposure counts, severity classing) -- use this tool directly only for the raw pixel-difference layer itself, calculate_damage_exposure_severity for a per-district severity score. Produces a new raster layer named 'change_detection_vs' added to the project with a diverging ramp symmetric about zero (blue = decrease, red = increase, no change transparent) so the change pattern is visible straight away.

Parameter Type Required Description
raster_before string yes
raster_after string yes
align_to_first boolean no If the two rasters are not on one pixel grid, warp the 'before' raster onto the 'after' raster's grid instead of refusing; the result says what was done. Default false: refuse.
resampling string no With align_to_first: 'bilinear' (default), 'nearest' (classes/counts) or 'cubic'.

inspect_canvas_visually

LOOK at the current map: captures the map canvas as a picture you can see (at most 1,280 pixels on the long edge), sent to you right after this result together with the legend and the visible layers as text. Use it for 'what is wrong with this map', 'does it look right', 'what does the map show'. Optional extent_layer: look at that layer's extent instead of the current view (the canvas is not moved). If the model cannot see pictures you get the legend and layer list as text instead.

Parameter Type Required Description
prompt_guidance string no
extent_layer string no Optional: name of a layer; the picture shows that layer's extent instead of the current view.

search_stac_satellite_imagery (network-only)

Search STAC API (Earth Search / Sentinel-2) for satellite scenes by bounding box and date range. Pass max_cloud_cover (percent) when the user names a cloud limit: the filter is applied by the service, so every scene returned meets it. The reply lists only scenes the service returned (newest first); never add scenes from memory.

Parameter Type Required Description
bbox array[number] yes
start_date string yes
end_date string yes
limit integer no
max_cloud_cover number no Only scenes with eo:cloud_cover below this percent (0-100).

Clone this wiki locally