geo-infer-examples

name	geo-infer-examples
description	Working examples and module orchestration patterns. Use when looking for usage examples, cross-module orchestration patterns, end-to-end workflows, or reference implementations of GEO-INFER capabilities.
prerequisites	{"required":[],"recommended":[]}
difficulty	beginner
estimated_time	30min
examples_dir	../GEO-INFER-EXAMPLES/examples/

GEO-INFER-EXAMPLES

Instructions

Core Capabilities

• Module orchestrators: Cross-module workflow examples
• Domain examples: Per-domain analysis workflows
• Active Inference: End-to-end inference pipeline examples
• Integration patterns: How modules connect and compose

Key Directories

GEO-INFER-EXAMPLES/examples/
├── module_orchestrators/     # Per-module orchestration demos
├── getting_started/          # Beginner walkthroughs
├── agriculture_integration/  # AG + SPACE + RISK workflows
├── climate_integration/      # CLIMATE + SPACE workflows
├── health_integration/       # HEALTH + SPACE workflows
└── iot_radiation_monitoring/ # IOT + DATA + SPACE workflow

Orchestrator Example

from geo_infer_examples.core.module_orchestrator import ModuleOrchestrator

orchestrator = ModuleOrchestrator(monitoring_enabled=False)
workflow_ids = orchestrator.list_workflows()
module_health = orchestrator.get_module_health()

Examples

from geo_infer_examples.core.module_orchestrator import ModuleOrchestrator

# Inspect configured cross-module workflows before execution
orchestrator = ModuleOrchestrator(monitoring_enabled=False)
for workflow_id in orchestrator.list_workflows():
    workflow = orchestrator.get_workflow_definition(workflow_id)
    print(workflow_id, workflow.execution_strategy)

# Domain workflow: Agricultural risk assessment
from geo_infer_ag.models.soil_health import SoilHealthModel
from geo_infer_risk.core.risk_engine import RiskEngine
from geo_infer_space.backends.h3 import H3Backend

# 1. Tessellate farm boundary
cells = H3Backend().tessellate(farm_polygon, resolution=9)

# 2. Assess soil health per cell
soil = SoilHealthModel()
health_scores = {cell: soil.assess(cell) for cell in cells}

# 3. Compute risk
risk = RiskEngine()
risk_map = risk.assess(hazard=drought_index, exposure=health_scores)

Guidelines

• module_orchestrator.py convergence check uses numeric relative-change
• Track new tutorial requests in the root task ledger before adding examples
• Verified runnable examples live under examples/*/scripts/
• Test: uv run python -m pytest GEO-INFER-EXAMPLES/tests/ -v

Integrations

• INTRA → Documentation hub links to examples
• All modules → Examples demonstrate cross-module workflows
• TEST → Example code testable as integration tests