IC-EO: Interpretable Code-Based Assistant for Earth Observation

This skill enables Claude to build code-generating Earth Observation agents that convert plain-English requests into executable, auditable Python pipelines. Based on the IC-EO framework (Lahouel et al., 2026), the core idea is a "code-only contract": instead of returning black-box predictions or free-text answers, the agent always outputs runnable Python that calls a structured, unified API of EO tools -- classification, segmentation, object detection (with oriented bounding boxes), spectral indices, and geospatial operators. Every result is transparent, reproducible, and verifiable at three levels: individual tool accuracy, code validity, and end-to-end task correctness.

When to Use

• When a user asks to analyze satellite or aerial imagery using classification, segmentation, or object detection and wants reproducible Python code rather than a one-off answer.
• When building a conversational agent or chatbot that wraps EO foundation models (DOFA, Prithvi-EO-2.0, SAMGeo, YOLOv11-OBB) behind a natural-language interface.
• When a user needs to compute spectral indices (NDVI, NDWI, EVI, SAVI, NDSI, etc.) from Sentinel-2 or similar multispectral data and wants a code pipeline.
• When performing land-cover composition analysis -- e.g., "What percentage of this image is forest vs. cropland?"
• When assessing post-disaster damage (wildfire burn scars, flood extent) by combining remote sensing models with ancillary data.
• When a user wants an extensible EO API design where new models or tools can be added without rewriting the agent.
• When auditability and interpretability are requirements -- the user or reviewer must be able to inspect every processing step.

Key Technique

The IC-EO architecture enforces a strict separation between the LLM controller (which plans and writes code) and the execution environment (which runs it in a sandboxed container). The LLM receives structured tool specifications -- each tool documented with its function signature, argument types, return types, supported sensors, normalization requirements, and dataset taxonomies. This structured schema dramatically reduces hallucination: IC-EO achieves an 87% execution success rate, with failures primarily caused by resource constraints rather than code errors. The key insight is that constraining the LLM to emit only code that calls well-documented functions is more reliable and auditable than letting it reason freely about imagery.

The unified API wraps several foundation models under a consistent interface: DOFA (a neural-plasticity-inspired encoder) for scene classification and semantic segmentation, Prithvi-EO-2.0 for multi-temporal burn-scar mapping, YOLOv11-OBB for oriented bounding box detection, and SAMGeo for zero-shot prompt-based segmentation. Data ingestion tools connect to Google Earth Engine for Sentinel-1/2 access with built-in cloud masking, reprojection, and tiling. A spectral indices library covers the standard vegetation, water, and snow indices.