Event Monitoring and Disaster Assessment¶

This notebook demonstrates GeoAgent's ability to search for satellite data related to natural disasters and environmental events — hurricanes, wildfires, floods, and more.

GeoAgent automatically selects the right data collection and time range for event-based queries.

In [ ]:

# %pip install geoagent

# %pip install geoagent

In [ ]:

from geoagent import GeoAgent

agent = GeoAgent()

from geoagent import GeoAgent agent = GeoAgent()

1. Hurricane Monitoring with SAR¶

SAR (Synthetic Aperture Radar) imagery works through clouds and at night, making it ideal for monitoring hurricane impacts.

In [ ]:

result = agent.chat(
    "Show me radar imagery of Houston Texas during Hurricane Harvey August 2017"
)
print(f"Success: {result.success}")
print(f"Plan: intent={result.plan.intent}, dataset={result.plan.dataset}")
print(f"Items: {result.data.total_items if result.data else 0}")
if result.data and result.data.items:
    print(f"Collection: {result.data.items[0].get('collection')}")
result.map

result = agent.chat( "Show me radar imagery of Houston Texas during Hurricane Harvey August 2017" ) print(f"Success: {result.success}") print(f"Plan: intent={result.plan.intent}, dataset={result.plan.dataset}") print(f"Items: {result.data.total_items if result.data else 0}") if result.data and result.data.items: print(f"Collection: {result.data.items[0].get('collection')}") result.map

In [ ]:

print(result.code)

print(result.code)

2. Wildfire Detection¶

MODIS thermal anomaly data detects active fires and burned areas globally.

In [ ]:

result = agent.chat("Show wildfire activity in Southern California in January 2025")
print(f"Success: {result.success}")
print(f"Plan: intent={result.plan.intent}, dataset={result.plan.dataset}")
print(f"Items: {result.data.total_items if result.data else 0}")
result.map

result = agent.chat("Show wildfire activity in Southern California in January 2025") print(f"Success: {result.success}") print(f"Plan: intent={result.plan.intent}, dataset={result.plan.dataset}") print(f"Items: {result.data.total_items if result.data else 0}") result.map

In [ ]:

result = agent.chat("Show me burned area mapping for Montana wildfire regions 2023")
print(f"Success: {result.success}")
print(f"Items: {result.data.total_items if result.data else 0}")
result.map

result = agent.chat("Show me burned area mapping for Montana wildfire regions 2023") print(f"Success: {result.success}") print(f"Items: {result.data.total_items if result.data else 0}") result.map

In [ ]:

print(result.code)

print(result.code)

3. Flood Monitoring¶

SAR imagery from Sentinel-1 can detect flooding through clouds, day or night.

In [ ]:

result = agent.chat("Show me flood extent in Pakistan during August 2022")
print(f"Success: {result.success}")
print(f"Plan: intent={result.plan.intent}, dataset={result.plan.dataset}")
print(f"Items: {result.data.total_items if result.data else 0}")
result.map

result = agent.chat("Show me flood extent in Pakistan during August 2022") print(f"Success: {result.success}") print(f"Plan: intent={result.plan.intent}, dataset={result.plan.dataset}") print(f"Items: {result.data.total_items if result.data else 0}") result.map

In [ ]:

print(result.code)

print(result.code)

4. Urban Expansion¶

High-resolution satellite imagery can reveal urban growth patterns over time.

In [ ]:

result = agent.chat(
    "Show me high resolution satellite imagery of Dubai urban expansion in 2020"
)
print(f"Success: {result.success}")
print(f"Plan: intent={result.plan.intent}, dataset={result.plan.dataset}")
print(f"Items: {result.data.total_items if result.data else 0}")
result.map

result = agent.chat( "Show me high resolution satellite imagery of Dubai urban expansion in 2020" ) print(f"Success: {result.success}") print(f"Plan: intent={result.plan.intent}, dataset={result.plan.dataset}") print(f"Items: {result.data.total_items if result.data else 0}") result.map

In [ ]:

print(result.code)

print(result.code)

5. Contextual Event Questions¶

Ask GeoAgent about events and it will provide contextual answers using LLM knowledge.

In [ ]:

result = agent.chat("How was NYC impacted by Hurricane Sandy?")
print(f"Intent: {result.plan.intent}")
print()
if result.answer_text:
    print(result.answer_text)

result = agent.chat("How was NYC impacted by Hurricane Sandy?") print(f"Intent: {result.plan.intent}") print() if result.answer_text: print(result.answer_text)

In [ ]:

result = agent.chat(
    "What satellites are most useful for monitoring volcanic eruptions?"
)
print(f"Intent: {result.plan.intent}")
print()
if result.answer_text:
    print(result.answer_text)

result = agent.chat( "What satellites are most useful for monitoring volcanic eruptions?" ) print(f"Intent: {result.plan.intent}") print() if result.answer_text: print(result.answer_text)

6. NASA VEDA Catalog¶

GeoAgent now includes the NASA VEDA (Visualization, Exploration, and Data Analysis) catalog alongside Microsoft Planetary Computer.

In [ ]:

from geoagent.catalogs.registry import CatalogRegistry

reg = CatalogRegistry()
for cat in reg.list_catalogs():
    auth = " (auth required)" if cat.requires_auth else ""
    print(f"{cat.name:25s} {cat.url}{auth}")

from geoagent.catalogs.registry import CatalogRegistry reg = CatalogRegistry() for cat in reg.list_catalogs(): auth = " (auth required)" if cat.requires_auth else "" print(f"{cat.name:25s} {cat.url}{auth}")

---

Summary¶

GeoAgent supports event-based queries by automatically selecting the right collection:

Event Type	Data Source	Example
Hurricanes / Floods	Sentinel-1 GRD (SAR)	"Show radar imagery of Houston during Harvey"
Wildfires	MODIS Thermal (14A1)	"Show wildfire activity in California"
Burned Areas	MODIS Thermal (14A1)	"Show burned areas in Montana 2023"
Snow Events	MODIS Snow (10A1)	"Show snow cover in Quebec"
Urban Change	Sentinel-2 L2A	"Show Dubai urban expansion in 2020"
Impact Analysis	ContextAgent (LLM)	"How was NYC impacted by Hurricane Sandy?"