Use Cases by Team
The same API serves very different questions. Pick the path that matches yours.
Emergency and Land Management Teams
You need to know about new fires in your area as soon as a satellite sees them.
- Poll both
VIIRS_NOAA20_NRTandVIIRS_NOAA21_NRTwith aday_rangeof 1, so you catch two afternoon passes. - Keep
MODIS_NRTin the list until Terra stops, because it's your only morning pass. - Add geostationary detections from the FIRMS map when you need updates every 10 to 15 minutes and can accept coarser pixels.
- Use FIRMS Fire Alerts for email notice without writing any code, and check that your alerts include NOAA-20 and NOAA-21.
Researchers
You're building a record across seasons or years, where consistency matters more than speed.
- Use
_SPsources for anything older than a few weeks, since Standard Processing is the finished science record. - Keep each sensor's series separate, and plan the MODIS-to-VIIRS break using Migrating Off MODIS.
- Cite each dataset by its DOI, which you'll find on NASA's catalog pages for MODIS and VIIRS NOAA-20.
Risk and Insurance Analysts
You need to know which properties sit close to an active fire, ideally before a customer calls.
import pandas as pd
from firms import get_fires, high_confidence, flag_within, CURRENT_VIIRS
# Your own list of properties with latitude and longitude columns
properties = pd.read_csv("properties.csv")
BOX = (
properties["longitude"].min() - 0.5,
properties["latitude"].min() - 0.5,
properties["longitude"].max() + 0.5,
properties["latitude"].max() + 0.5,
)
fires = pd.concat([get_fires(s, BOX, day_range=1) for s in CURRENT_VIIRS], ignore_index=True)
flagged = flag_within(properties, high_confidence(fires), radius_km=5)
at_risk = flagged[flagged["within_radius"]].sort_values("nearest_fire_km")
print(at_risk)
flag_within() adds each property's distance to the nearest detection and a yes or no flag for your chosen radius. The box adds about half a degree around your properties so fires just outside their spread still count.
A detection near a property isn't evidence of damage. Treat the flag as a reason to check the property and reach the policyholder, and confirm with local fire agencies before acting on it.
For a portfolio with many thousands of properties, the distance calculation compares every property with every detection and can use a lot of memory. Split the list into chunks, or move the join into a spatial database.