diff --git a/docs/.doctrees/datasets/era5.doctree b/docs/.doctrees/datasets/era5.doctree index fc1a431f..0b102524 100644 Binary files a/docs/.doctrees/datasets/era5.doctree and b/docs/.doctrees/datasets/era5.doctree differ diff --git a/docs/.doctrees/datasets/firms.doctree b/docs/.doctrees/datasets/firms.doctree index 2ee696c9..849190c5 100644 Binary files a/docs/.doctrees/datasets/firms.doctree and b/docs/.doctrees/datasets/firms.doctree differ diff --git a/docs/.doctrees/datasets/goesr.doctree b/docs/.doctrees/datasets/goesr.doctree index 7ad0dc14..2194479e 100644 Binary files a/docs/.doctrees/datasets/goesr.doctree and b/docs/.doctrees/datasets/goesr.doctree differ diff --git a/docs/.doctrees/datasets/landfire.doctree b/docs/.doctrees/datasets/landfire.doctree index 2d94f818..3fd08384 100644 Binary files a/docs/.doctrees/datasets/landfire.doctree and b/docs/.doctrees/datasets/landfire.doctree differ diff --git a/docs/.doctrees/datasets/mtbs.doctree b/docs/.doctrees/datasets/mtbs.doctree index caf14308..45a7137c 100644 Binary files a/docs/.doctrees/datasets/mtbs.doctree and b/docs/.doctrees/datasets/mtbs.doctree differ diff --git a/docs/.doctrees/datasets/noaa_flood.doctree b/docs/.doctrees/datasets/noaa_flood.doctree index 8dea4520..39e17896 100644 Binary files a/docs/.doctrees/datasets/noaa_flood.doctree and b/docs/.doctrees/datasets/noaa_flood.doctree differ diff --git a/docs/.doctrees/datasets/wfigs.doctree b/docs/.doctrees/datasets/wfigs.doctree index 4b2e6003..63d03300 100644 Binary files a/docs/.doctrees/datasets/wfigs.doctree and b/docs/.doctrees/datasets/wfigs.doctree differ diff --git a/docs/.doctrees/environment.pickle b/docs/.doctrees/environment.pickle index 0eed3451..4680e45c 100644 Binary files a/docs/.doctrees/environment.pickle and b/docs/.doctrees/environment.pickle differ diff --git a/docs/.doctrees/pyhazards_datasets.doctree b/docs/.doctrees/pyhazards_datasets.doctree index 3da85d50..022494c4 100644 Binary files a/docs/.doctrees/pyhazards_datasets.doctree and b/docs/.doctrees/pyhazards_datasets.doctree differ diff --git a/docs/_sources/datasets/era5.rst.txt b/docs/_sources/datasets/era5.rst.txt index 97719b9f..b914e406 100644 --- a/docs/_sources/datasets/era5.rst.txt +++ b/docs/_sources/datasets/era5.rst.txt @@ -4,6 +4,32 @@ ERA5 Global atmospheric reanalysis produced by the European Centre for Medium-Range Weather Forecasts (ECMWF), providing high-resolution meteorological fields for weather, climate, and hazard-related applications. +.. admonition:: At-a-glance (Quick Facts) + :class: note + + .. list-table:: + :widths: 26 74 + :stub-columns: 1 + + * - Producer + - ECMWF (Copernicus Climate Change Service, C3S) + * - Spatial coverage + - Global + * - Spatial resolution + - ~0.25° × 0.25° + * - Temporal resolution + - Hourly (single levels; pressure/model levels optional) + * - **Data update frequency** + - **Updated daily as an initial release (ERA5T) with ~5-day latency; final validated release follows ~2–3 months later.** + * - Period of record + - 1940–present + * - Format + - GRIB (native) and NetCDF (commonly provided via CDS) + * - Grid / CRS + - Regular latitude–longitude grid + * - Typical role in PyHazards + - Meteorological baseline / forcing and covariates + ---- Overview @@ -18,15 +44,38 @@ modeling, including wildfire danger assessment, flood risk analysis, and extreme ---- +Stats +----- + +.. list-table:: + :header-rows: 1 + :widths: 22 22 24 32 + + * - Spatial + - Temporal + - Update cadence + - Coverage + * - 0.25° × 0.25° + - Hourly + - Daily (ERA5T ~5-day latency); final ~2–3 months + - Global, 1940–present + +---- + Data Characteristics -------------------- -- **Spatial coverage:** Global -- **Spatial resolution:** ~0.25° latitude × 0.25° longitude -- **Temporal resolution:** Hourly -- **Vertical structure:** Single-level fields and optional pressure/model levels -- **Data format:** GRIB and NetCDF -- **Coordinate system:** Regular latitude–longitude grid +- **Spatial coverage:** Global +- **Spatial resolution:** ~0.25° latitude × 0.25° longitude +- **Temporal resolution:** Hourly +- **Vertical structure:** Single-level fields and optional pressure/model levels +- **Data format:** GRIB and NetCDF +- **Coordinate system:** Regular latitude–longitude grid +- **Data update frequency:** Daily initial release (ERA5T) with ~5-day latency; final validated release ~2–3 months later + +.. note:: + If you request dates close to “today”, the CDS may serve a mixture of validated ERA5 and preliminary ERA5T + for the most recent period; this is expected behavior for near-real-time access. ---- diff --git a/docs/_sources/datasets/firms.rst.txt b/docs/_sources/datasets/firms.rst.txt index e2b10202..87ed1448 100644 --- a/docs/_sources/datasets/firms.rst.txt +++ b/docs/_sources/datasets/firms.rst.txt @@ -4,29 +4,77 @@ FIRMS Near-real-time global active fire detection dataset provided by NASA, based on satellite thermal anomaly observations for operational wildfire monitoring and hazard analysis. +.. admonition:: At-a-glance (Quick Facts) + :class: note + + .. list-table:: + :widths: 26 74 + :stub-columns: 1 + + * - Provider + - NASA LANCE / FIRMS + * - Data type + - Event-based **point detections** (vector hotspots; not gridded tensors) + * - Sensors + - MODIS (Terra/Aqua) and VIIRS (Suomi NPP / NOAA-20 / NOAA-21) :contentReference[oaicite:1]{index=1} + * - Spatial coverage + - Global + * - Spatial resolution + - ~375 m (VIIRS), ~1 km (MODIS) :contentReference[oaicite:2]{index=2} + * - Latency (typical) + - **< 3 hours globally**; **< 1–30 mins for US/Canada** products :contentReference[oaicite:3]{index=3} + * - **Data update frequency** + - **Fire maps refresh ~every 5 minutes; downloadable SHP/KML/CSV refresh ~hourly.** + NRT detections are later replaced by standard/science-quality data (~3 months). :contentReference[oaicite:4]{index=4} + * - Formats + - CSV, Shapefile, GeoJSON, KML (plus web services) + * - CRS + - Geographic lat–lon (WGS84) :contentReference[oaicite:5]{index=5} + ---- Overview -------- **FIRMS (Fire Information for Resource Management System)** is a NASA-operated system that distributes -active fire and thermal anomaly detections derived from satellite sensors, including MODIS and VIIRS. +active fire and thermal anomaly detections derived from satellite sensors such as MODIS and VIIRS. Each record corresponds to a time-stamped hotspot detection associated with a potential fire event. FIRMS is widely used for operational wildfire monitoring, rapid situational awareness, and as event-level -labels or targets in wildfire prediction pipelines when combined with meteorological and land-surface data. +labels/targets in wildfire prediction pipelines when combined with meteorological and land-surface data. + +---- + +Stats +----- + +.. list-table:: + :header-rows: 1 + :widths: 22 22 26 30 + + * - Spatial + - Latency + - Refresh cadence + - Representation + * - 375 m (VIIRS) / 1 km (MODIS) + - <3h global; <1–30m US/CA + - Map ~5 min; files ~60 min + - Point detections (vector) ---- Data Characteristics -------------------- -- **Spatial coverage:** Global -- **Spatial resolution:** Sensor-dependent (e.g., ~375 m for VIIRS) -- **Temporal resolution:** Near real time (multiple updates per day) -- **Data structure:** Event-based point detections (not gridded tensors) -- **Data format:** CSV, Shapefile, GeoJSON, KML -- **Coordinate system:** Geographic latitude–longitude +- **Spatial coverage:** Global +- **Spatial resolution:** Sensor-dependent (e.g., ~375 m for VIIRS; ~1 km for MODIS) :contentReference[oaicite:6]{index=6} +- **Temporal resolution:** Event-based detections (polar-orbiting overpasses; multiple updates/day) +- **Latency:** FIRMS makes NRT detections available within ~3 hours globally; US/Canada streams can be faster (<1–30 mins) :contentReference[oaicite:7]{index=7} +- **Data structure:** Event-based point detections (not gridded tensors) +- **Formats:** CSV, Shapefile, GeoJSON, KML +- **CRS:** Geographic latitude–longitude (WGS84) :contentReference[oaicite:8]{index=8} +- **Data update frequency:** Fire maps update ~every 5 minutes; SHP/KML/CSV downloads update ~every 60 minutes :contentReference[oaicite:9]{index=9} +- **NRT → standard replacement:** NRT detections are replaced by standard/science-quality products when available (~3 months) :contentReference[oaicite:10]{index=10} ---- @@ -35,10 +83,10 @@ Variables Each FIRMS detection record typically includes: -- Detection time and satellite overpass information -- Geographic location (latitude and longitude) -- Fire radiative power (FRP) or thermal anomaly indicators -- Confidence or quality flags (sensor- and product-specific) +- Detection time and satellite overpass metadata +- Geographic location (latitude, longitude) +- Fire radiative power (FRP) / thermal anomaly indicators (product-dependent) +- Confidence / quality flags (sensor- and product-specific) ---- @@ -60,6 +108,9 @@ FIRMS data are publicly accessible through NASA Earthdata services: - `FIRMS portal `_ - `NASA Earthdata `_ +.. note:: + Some archive / bulk download endpoints require an Earthdata Login, depending on the access route. :contentReference[oaicite:11]{index=11} + ---- Reference @@ -68,4 +119,4 @@ Reference Schroeder, W., Oliva, P., Giglio, L., & Csiszar, I. (2014). *The New VIIRS 375 m active fire detection data product: Algorithm description and initial assessment*. Remote Sensing of Environment, 143, 85–96. -`https://doi.org/10.1016/j.rse.2013.08.008 `_ +`https://doi.org/10.1016/j.rse.2013.08.008 `_ \ No newline at end of file diff --git a/docs/_sources/datasets/goesr.rst.txt b/docs/_sources/datasets/goesr.rst.txt index 95860fe1..3e621c0d 100644 --- a/docs/_sources/datasets/goesr.rst.txt +++ b/docs/_sources/datasets/goesr.rst.txt @@ -4,29 +4,86 @@ GOES-R High-frequency geostationary satellite observations from NOAA’s GOES-R series, providing continuous multispectral imagery for monitoring atmospheric and surface processes. +.. admonition:: At-a-glance (Quick Facts) + :class: note + + .. list-table:: + :widths: 26 74 + :stub-columns: 1 + + * - Provider + - NOAA GOES-R Program + * - Payload (core) + - ABI (Advanced Baseline Imager) multispectral imagery + * - Spatial coverage + - Western Hemisphere / Americas (geostationary view) + * - Spatial resolution + - ~0.5–2 km (band-dependent) + * - Temporal resolution (typical) + - **Mode 6 default:** Full Disk 10 min; CONUS 5 min; Mesoscale 1 min + * - **Data update frequency** + - **Continuous ingest; new files are added as soon as available.** + (Scan cadence depends on sector/mode; see above.) + * - Latency (depends on access route) + - Cloud/Open-Data: near real time; CLASS subscription can be ~30 min–2 hr after observation + * - Format + - NetCDF (ABI Level 1b / Level 2+ products) + * - Projection / CRS + - ABI fixed grid (geostationary projection); lat–lon remaps are available for some workflows + * - Typical role in PyHazards + - Rapid-refresh imagery for smoke/fire evolution, ignition monitoring, and situational awareness + ---- Overview -------- -**GOES-R** refers to the latest generation of NOAA geostationary operational environmental satellites, -including GOES-16, GOES-17, and GOES-18. The series carries the Advanced Baseline Imager (ABI), which -provides rapid-refresh, multispectral observations over the Americas. +**GOES-R** refers to NOAA’s current-generation geostationary operational environmental satellites. +The series carries the Advanced Baseline Imager (ABI), which provides rapid-refresh, multispectral +observations over the Americas. GOES-R data are widely used for real-time monitoring of weather systems, smoke and fire evolution, and early wildfire detection, particularly where high temporal resolution is critical. ---- +Stats +----- + +.. list-table:: + :header-rows: 1 + :widths: 22 22 28 28 + + * - Spatial + - Temporal + - Refresh / update cadence + - Representation + * - 0.5–2 km (band-dependent) + - 1–10 min (sector/mode) + - Continuous ingest; files appear as soon as available + - Raster imagery time series (ABI fixed grid) + +---- + Data Characteristics -------------------- -- **Spatial coverage:** Western Hemisphere (geostationary view) -- **Spatial resolution:** ~0.5–2 km (band-dependent) -- **Temporal resolution:** 1–15 minutes (mode-dependent) -- **Data structure:** Gridded satellite imagery (raster time series) -- **Data format:** NetCDF -- **Coordinate system:** Geostationary projection (with latitude–longitude products available) +- **Spatial coverage:** Western Hemisphere (geostationary view) +- **Spatial resolution:** ~0.5–2 km (band-dependent) +- **Temporal resolution:** 1–15 minutes (mode/sector-dependent; typical default Mode 6 cadence below) +- **Typical scan cadence (Mode 6 default):** + - Full Disk: every 10 minutes + - CONUS: every 5 minutes + - Mesoscale: every 1 minute +- **Data structure:** Gridded satellite imagery (raster time series) +- **Data format:** NetCDF +- **Coordinate system:** ABI fixed grid (geostationary projection; lat–lon remaps can be generated) + +.. note:: + “Data update frequency” in GOES-R is best interpreted as **(1) observation refresh cadence** + (sector/mode) + **(2) distribution latency** (varies by access channel). For near-real-time pipelines, + cloud/open-data mirrors typically publish granules as soon as they are available; some archival/subscription + services may have longer delays. ---- @@ -58,7 +115,7 @@ Access GOES-R data are distributed by NOAA through multiple access points: - `GOES-R Program `_ -- `NOAA Big Data Program `_ +- `NOAA Open Data Dissemination `_ ---- diff --git a/docs/_sources/datasets/landfire.rst.txt b/docs/_sources/datasets/landfire.rst.txt index d66d01e1..7ce7a4f7 100644 --- a/docs/_sources/datasets/landfire.rst.txt +++ b/docs/_sources/datasets/landfire.rst.txt @@ -4,6 +4,30 @@ LANDFIRE National-scale vegetation, fuel, and landscape characterization dataset produced by the U.S. Forest Service, supporting wildfire behavior modeling and landscape-scale fire risk assessment. +.. admonition:: At-a-glance (Quick Facts) + :class: note + + .. list-table:: + :widths: 26 74 + :stub-columns: 1 + + * - Producer + - U.S. Forest Service (LANDFIRE Program) + * - Spatial coverage + - United States (CONUS + Alaska/Hawaii; some products include PRVI) + * - Spatial resolution + - ~30 m (product-dependent) + * - Data structure + - Gridded raster layers (static / slowly varying background covariates) + * - Formats + - GeoTIFF (commonly distributed); additional GIS packages may be provided + * - Projection / CRS + - Projected coordinate systems (product-dependent; distributed with dataset metadata) + * - **Data update frequency** + - **Annual/yearly updates (versioned “LF YYYY Update” suites), targeting products current to the previous year.** + * - Typical role in PyHazards + - Fuels + vegetation + canopy covariates for behavior/spread/risk modeling + ---- Overview @@ -11,22 +35,42 @@ Overview **LANDFIRE (Landscape Fire and Resource Management Planning Tools)** is a geospatial data program that provides consistent, nationwide maps of vegetation, fuels, and fire regimes across the United States. -The products are derived from remote sensing, field observations, and ecological modeling. +Products are derived from remote sensing, field observations, disturbance mapping, and ecological modeling. LANDFIRE datasets are widely used as static or slowly varying background layers in wildfire modeling, including fire behavior simulation, fire spread modeling, and wildfire risk assessment pipelines. ---- +Stats +----- + +.. list-table:: + :header-rows: 1 + :widths: 22 22 26 30 + + * - Spatial + - Update cadence + - Primary layers + - Representation + * - ~30 m + - Annual (versioned updates) + - Fuels / vegetation / canopy / fire regime + - Raster grids (GeoTIFF) + +---- + Data Characteristics -------------------- -- **Spatial coverage:** United States -- **Spatial resolution:** ~30 m -- **Temporal coverage:** Versioned updates (quasi-annual releases) -- **Data structure:** Gridded raster layers (static or slowly varying) -- **Data format:** GeoTIFF -- **Coordinate system:** Projected coordinate systems (product-dependent) +- **Spatial coverage:** United States +- **Spatial resolution:** ~30 m (product-dependent) +- **Temporal coverage:** Versioned releases (annual/yearly update suites) +- **Data structure:** Gridded raster layers (static or slowly varying) +- **Data format:** GeoTIFF +- **Coordinate system:** Projected coordinate systems (product-dependent) +- **Data update frequency:** Annual/yearly updates; “LF YYYY Update” products aim to be current to the + previous year (reduced-latency update strategy) ---- @@ -38,7 +82,7 @@ LANDFIRE products include multiple thematic layers, such as: - Fuel models (e.g., Fire Behavior Fuel Models) - Vegetation type, cover, and height - Canopy characteristics (canopy cover, base height, bulk density) -- Fire regime and disturbance descriptors +- Fire regime and disturbance descriptors (annual disturbance / transitions) ---- diff --git a/docs/_sources/datasets/mtbs.rst.txt b/docs/_sources/datasets/mtbs.rst.txt index 62b2739c..1b93f010 100644 --- a/docs/_sources/datasets/mtbs.rst.txt +++ b/docs/_sources/datasets/mtbs.rst.txt @@ -1,9 +1,35 @@ MTBS ==== -National-scale wildfire burn severity and perimeter dataset produced by the U.S. Geological Survey (USGS), +National-scale wildfire burn severity and perimeter dataset produced by the U.S. Geological Survey (USGS) and partners, supporting post-fire impact assessment and long-term wildfire regime analysis. +.. admonition:: At-a-glance (Quick Facts) + :class: note + + .. list-table:: + :widths: 26 74 + :stub-columns: 1 + + * - Producer + - USGS + USDA Forest Service (interagency MTBS program) + * - Spatial coverage + - United States (CONUS + Alaska + Hawaii + Puerto Rico) + * - Spatial resolution + - 30 m (Landsat-based) + * - Data structure + - Event-based rasters + vector perimeters (per-fire bundles; mosaics available) + * - Formats + - GeoTIFF, Shapefile, File Geodatabase + * - Projection / CRS + - Projected coordinate systems (product-dependent; distributed with metadata) + * - **Data update frequency** + - **Continuous mapping + quarterly releases (typically Feb / May / Aug / Nov).** + * - Period of record + - 1984–near present (inventory grows with releases) + * - Typical role in PyHazards + - Post-fire labels / validation targets (extent, severity classes, burn metrics) + ---- Overview @@ -18,15 +44,39 @@ training or validation data for models that predict burn extent, burn severity, ---- +Stats +----- + +.. list-table:: + :header-rows: 1 + :widths: 22 22 26 30 + + * - Spatial + - Temporal + - Update cadence + - Representation + * - 30 m (Landsat) + - Fire-event / fire-year + - Continuous mapping; quarterly releases + - Per-fire rasters + perimeters (vector) + +---- + Data Characteristics -------------------- -- **Spatial coverage:** United States -- **Spatial resolution:** 30 m (Landsat-based) -- **Temporal coverage:** Annual fire-year products -- **Data structure:** Event-based raster layers and vector perimeters -- **Data format:** GeoTIFF, Shapefile, File Geodatabase -- **Coordinate system:** Projected coordinate systems (product-dependent) +- **Spatial coverage:** United States +- **Spatial resolution:** 30 m (Landsat-based) +- **Temporal coverage:** Fire-event products aggregated by fire year; historical archive from 1984 onward +- **Data structure:** Event-based raster layers and vector perimeters +- **Data format:** GeoTIFF, Shapefile, File Geodatabase +- **Coordinate system:** Projected coordinate systems (product-dependent) +- **Data update frequency:** Continuous mapping with **quarterly releases** (commonly Feb / May / Aug / Nov) + +.. note:: + MTBS is not strictly “near-real-time”. Product availability depends on suitable pre-/post-fire Landsat + imagery and production workflow; recent fire seasons are typically populated progressively across + quarterly releases. ---- diff --git a/docs/_sources/datasets/noaa_flood.rst.txt b/docs/_sources/datasets/noaa_flood.rst.txt index fc0922d7..6a106800 100644 --- a/docs/_sources/datasets/noaa_flood.rst.txt +++ b/docs/_sources/datasets/noaa_flood.rst.txt @@ -1,32 +1,81 @@ NOAA Flood Events ================= -Event-based flood and severe weather records compiled by the U.S. National Oceanic and Atmospheric -Administration (NOAA), providing historical reports of flood occurrence and impacts. +Event-based flood and severe weather records compiled by NOAA, providing historical reports of flood +occurrence and impacts across the United States. + +.. admonition:: At-a-glance (Quick Facts) + :class: note + + .. list-table:: + :widths: 26 74 + :stub-columns: 1 + + * - Provider + - NOAA National Centers for Environmental Information (NCEI) + * - Primary source + - NOAA National Weather Service (NWS) Storm Data / Storm Events entries + * - Spatial coverage + - United States (county/zone-based reporting; points when available) + * - Temporal resolution + - Event-based (begin/end timestamps) + * - **Data update frequency** + - **Updated monthly; typically published ~75–90 days after the end of a data month (occasionally up to ~120 days).** + * - Period of record + - 1950–present (through the most recently processed month) + * - Data structure + - Tabular event records (not gridded tensors) + * - Formats + - Web query + bulk CSV/DB extracts + * - Typical role in PyHazards + - Event labels / targets (flood occurrence + impacts) ---- Overview -------- -**NOAA Flood Events** are derived from the NOAA Storm Events Database, which documents the occurrence, +**NOAA Flood Events** are derived from the NOAA **Storm Events Database**, which documents the occurrence, location, timing, and impacts of severe weather events across the United States. Flood-related events -are reported by local weather offices and emergency management agencies. +are reported by local weather offices and emergency management partners, then compiled and archived by NCEI. This dataset is widely used for flood frequency analysis, impact assessment, and as event-level labels or targets in supervised hazard modeling, particularly when paired with meteorological reanalysis data. ---- +Stats +----- + +.. list-table:: + :header-rows: 1 + :widths: 22 22 26 30 + + * - Spatial + - Temporal + - Update cadence + - Representation + * - United States + - Event-based + - Monthly (typical ~75–90 day latency) + - Tabular records + optional point coords + +---- + Data Characteristics -------------------- -- **Spatial coverage:** United States -- **Temporal coverage:** Historical records with monthly updates -- **Temporal resolution:** Event-based (begin and end timestamps) -- **Data structure:** Tabular event records (not gridded tensors) -- **Data format:** CSV, database extracts -- **Coordinate system:** Administrative regions and point locations (where available) +- **Spatial coverage:** United States +- **Temporal coverage:** Historical records, appended as new months are processed +- **Temporal resolution:** Event-based (begin and end timestamps) +- **Data structure:** Tabular event records (not gridded tensors) +- **Location representation:** Administrative regions (state/county/zone); point coordinates where available +- **Data update frequency:** Updated monthly; database is typically refreshed within ~75–90 days after the end of a data month + (rarely longer, up to ~120 days) +- **Data format:** Online query; bulk downloads and database extracts + +.. note:: + For “very recent” months, event records may not yet be available due to reporting/validation and monthly publication lag. ---- @@ -58,6 +107,7 @@ Access NOAA Storm Events data are publicly available via NOAA NCEI: - `Storm Events Database `_ +- `Storm Events bulk download (CSV) `_ - `NOAA NCEI `_ ---- diff --git a/docs/_sources/datasets/wfigs.rst.txt b/docs/_sources/datasets/wfigs.rst.txt index cf332261..a7cc3800 100644 --- a/docs/_sources/datasets/wfigs.rst.txt +++ b/docs/_sources/datasets/wfigs.rst.txt @@ -2,7 +2,34 @@ WFIGS ===== Authoritative incident-level wildfire records maintained by U.S. interagency fire management systems, -providing official information on real wildfire events across the United States. +providing official information on real wildfire incidents across the United States. + +.. admonition:: At-a-glance (Quick Facts) + :class: note + + .. list-table:: + :widths: 26 74 + :stub-columns: 1 + + * - Provider + - National Interagency Fire Center (NIFC) Open Data / Interagency WFIGS + * - Data type + - **Incident-level event records** with **point + perimeter** geometries (authoritative “ground truth”) + * - Spatial coverage + - United States + * - Temporal coverage + - Historical + ongoing incidents (continuously appended/updated) + * - **Data update frequency** + - **Refreshed from IRWIN every ~5 minutes; perimeter-source changes may take up to ~15 minutes to appear.** + “Current” layers apply **fall-off** rules to remove stale incidents; “To-Date” layers keep the full year. + * - Data structure + - Vector features (incident points / polygons) + attributes and status fields + * - Formats + - ArcGIS REST services, GeoJSON, Shapefile (download options vary by layer) + * - CRS + - Typically WGS84 geographic (service-dependent) + * - Typical role in PyHazards + - Authoritative labels/targets + validation baseline for satellite detections (FIRMS/GOES) ---- @@ -11,22 +38,46 @@ Overview **WFIGS (Wildland Fire Incident Geospatial Services)** is an interagency system that aggregates and distributes geospatial information on active and historical wildland fire incidents. Each record -represents an officially reported wildfire event, rather than a satellite-detected hotspot. +represents an officially reported wildfire event (IRWIN-linked incident), rather than a satellite-detected hotspot. WFIGS is commonly treated as an authoritative source of wildfire ground truth and is widely used to validate satellite-based fire detections and to label wildfire occurrence in modeling pipelines. ---- +Stats +----- + +.. list-table:: + :header-rows: 1 + :widths: 22 22 26 30 + + * - Spatial + - Temporal + - Update cadence + - Representation + * - U.S. + - Event-based + - ~5 min refresh (IRWIN-linked) + - Incident points + perimeters (vector) + +---- + Data Characteristics -------------------- -- **Spatial coverage:** United States -- **Temporal coverage:** Historical and ongoing wildfire incidents -- **Temporal resolution:** Event-based (ignition, containment, and status updates) -- **Data structure:** Incident-level event records (point or polygon geometries) -- **Data format:** GIS services, GeoJSON, Shapefile -- **Coordinate system:** Geographic and projected systems (service-dependent) +- **Spatial coverage:** United States +- **Temporal coverage:** Historical + ongoing wildfire incidents +- **Temporal resolution:** Event-based (ignition/discovery, containment, status updates) +- **Data structure:** Incident-level event records (point or polygon geometries) +- **Data update frequency:** Refreshed from IRWIN approximately every **5 minutes**; perimeter-source changes may take up to **~15 minutes** to display +- **Current vs To-Date layers:** + - **Current** layers use **fall-off rules** to remove stale records (based on fire size and last-update time) + - **To-Date** layers retain the full current-year incident/perimeter set (no fall-off) + +.. note:: + WFIGS is “working/operational data”: incident attributes and geometries may change as the incident evolves + (e.g., perimeter refinements, containment updates, record reconciliation). ---- @@ -36,7 +87,7 @@ Variables Typical WFIGS records include: - Incident name and unique incident identifier -- Ignition date, discovery date, and containment status +- Ignition/discovery date, containment status, and last-modified timestamps - Incident location (point or perimeter geometry) - Fire size, cause, and management status - Associated agency and reporting metadata @@ -58,7 +109,7 @@ Access WFIGS data are publicly accessible through U.S. interagency geospatial portals: -- `WFIGS data portal `_ +- `NIFC Open Data (WFIGS layers) `_ - `National Interagency Fire Center (NIFC) `_ ---- @@ -67,5 +118,5 @@ Reference --------- National Interagency Fire Center (NIFC). -*Wildland Fire Incident Geospatial Services (WFIGS) Documentation*. +*Wildland Fire Incident Geospatial Services (WFIGS)* (Open Data portal documentation and layers). `https://data-nifc.opendata.arcgis.com/ `_ diff --git a/docs/_sources/pyhazards_datasets.rst.txt b/docs/_sources/pyhazards_datasets.rst.txt index 795afd35..70388ad2 100644 --- a/docs/_sources/pyhazards_datasets.rst.txt +++ b/docs/_sources/pyhazards_datasets.rst.txt @@ -49,7 +49,7 @@ the PyHazards dataset interface. .. code-block:: bash - python -m pyhazards.datasets.inspection --date 2024-01-01 --outdir outputs/ + python -m pyhazards.datasets.inspection 20260101 Core classes diff --git a/docs/datasets/era5.html b/docs/datasets/era5.html index 746dfb33..4bc903b8 100644 --- a/docs/datasets/era5.html +++ b/docs/datasets/era5.html @@ -263,6 +263,46 @@

ERA5

Global atmospheric reanalysis produced by the European Centre for Medium-Range Weather Forecasts (ECMWF), providing high-resolution meteorological fields for weather, climate, and hazard-related applications.

+
+

At-a-glance (Quick Facts)

+
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Producer

ECMWF (Copernicus Climate Change Service, C3S)

Spatial coverage

Global

Spatial resolution

~0.25° × 0.25°

Temporal resolution

Hourly (single levels; pressure/model levels optional)

Data update frequency

Updated daily as an initial release (ERA5T) with ~5-day latency; final validated release follows ~2–3 months later.

Period of record

1940–present

Format

GRIB (native) and NetCDF (commonly provided via CDS)

Grid / CRS

Regular latitude–longitude grid

Typical role in PyHazards

Meteorological baseline / forcing and covariates

+
+

Overview

@@ -273,6 +313,34 @@

Overview modeling, including wildfire danger assessment, flood risk analysis, and extreme weather attribution.

+
+

Stats

+
+ ++++++ + + + + + + + + + + + + + + +

Spatial

Temporal

Update cadence

Coverage

0.25° × 0.25°

Hourly

Daily (ERA5T ~5-day latency); final ~2–3 months

Global, 1940–present

+
+
+

Data Characteristics

+
+

Note

+

If you request dates close to “today”, the CDS may serve a mixture of validated ERA5 and preliminary ERA5T +for the most recent period; this is expected behavior for near-real-time access.

+
@@ -363,6 +437,7 @@

ReferenceERA5
  • Overview
    • +
  • Stats
  • Data Characteristics
  • Variables
  • Typical Use Cases
    • diff --git a/docs/datasets/firms.html b/docs/datasets/firms.html index 43c5583e..b34ecb1e 100644 --- a/docs/datasets/firms.html +++ b/docs/datasets/firms.html @@ -263,25 +263,97 @@

    FIRMS

    Near-real-time global active fire detection dataset provided by NASA, based on satellite thermal anomaly observations for operational wildfire monitoring and hazard analysis.

    +
    +

    At-a-glance (Quick Facts)

    +
    + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Provider

    NASA LANCE / FIRMS

    Data type

    Event-based point detections (vector hotspots; not gridded tensors)

    Sensors

    MODIS (Terra/Aqua) and VIIRS (Suomi NPP / NOAA-20 / NOAA-21) :contentReference[oaicite:1]{index=1}

    Spatial coverage

    Global

    Spatial resolution

    ~375 m (VIIRS), ~1 km (MODIS) :contentReference[oaicite:2]{index=2}

    Latency (typical)

    < 3 hours globally; < 1–30 mins for US/Canada products :contentReference[oaicite:3]{index=3}

    Data update frequency

    Fire maps refresh ~every 5 minutes; downloadable SHP/KML/CSV refresh ~hourly. +NRT detections are later replaced by standard/science-quality data (~3 months). :contentReference[oaicite:4]{index=4}

    Formats

    CSV, Shapefile, GeoJSON, KML (plus web services)

    CRS

    Geographic lat–lon (WGS84) :contentReference[oaicite:5]{index=5}

    +
    +

    Overview

    FIRMS (Fire Information for Resource Management System) is a NASA-operated system that distributes -active fire and thermal anomaly detections derived from satellite sensors, including MODIS and VIIRS. +active fire and thermal anomaly detections derived from satellite sensors such as MODIS and VIIRS. Each record corresponds to a time-stamped hotspot detection associated with a potential fire event.

    FIRMS is widely used for operational wildfire monitoring, rapid situational awareness, and as event-level -labels or targets in wildfire prediction pipelines when combined with meteorological and land-surface data.

    +labels/targets in wildfire prediction pipelines when combined with meteorological and land-surface data.

    +
    +
    +
    +

    Stats

    +
    + ++++++ + + + + + + + + + + + + + + +

    Spatial

    Latency

    Refresh cadence

    Representation

    375 m (VIIRS) / 1 km (MODIS)

    <3h global; <1–30m US/CA

    Map ~5 min; files ~60 min

    Point detections (vector)

    +

    Data Characteristics

    • Spatial coverage: Global

      • -

    • Spatial resolution: Sensor-dependent (e.g., ~375 m for VIIRS)

      • -

    • Temporal resolution: Near real time (multiple updates per day)

      • +

    • Spatial resolution: Sensor-dependent (e.g., ~375 m for VIIRS; ~1 km for MODIS) :contentReference[oaicite:6]{index=6}

      • +

    • Temporal resolution: Event-based detections (polar-orbiting overpasses; multiple updates/day)

      • +

    • Latency: FIRMS makes NRT detections available within ~3 hours globally; US/Canada streams can be faster (<1–30 mins) :contentReference[oaicite:7]{index=7}

    • Data structure: Event-based point detections (not gridded tensors)

      • -

    • Data format: CSV, Shapefile, GeoJSON, KML

      • -

    • Coordinate system: Geographic latitude–longitude

      • +

    • Formats: CSV, Shapefile, GeoJSON, KML

      • +

    • CRS: Geographic latitude–longitude (WGS84) :contentReference[oaicite:8]{index=8}

      • +

    • Data update frequency: Fire maps update ~every 5 minutes; SHP/KML/CSV downloads update ~every 60 minutes :contentReference[oaicite:9]{index=9}

      • +

    • NRT → standard replacement: NRT detections are replaced by standard/science-quality products when available (~3 months) :contentReference[oaicite:10]{index=10}

    @@ -289,10 +361,10 @@

    Data CharacteristicsVariables

    Each FIRMS detection record typically includes:

      -

    • Detection time and satellite overpass information

      • -

    • Geographic location (latitude and longitude)

      • -

    • Fire radiative power (FRP) or thermal anomaly indicators

      • -

    • Confidence or quality flags (sensor- and product-specific)

      • +

    • Detection time and satellite overpass metadata

      • +

    • Geographic location (latitude, longitude)

      • +

    • Fire radiative power (FRP) / thermal anomaly indicators (product-dependent)

      • +

    • Confidence / quality flags (sensor- and product-specific)

@@ -313,6 +385,10 @@

Access

FIRMS portal

  • NASA Earthdata

    • +
    +

    Note

    +

    Some archive / bulk download endpoints require an Earthdata Login, depending on the access route. :contentReference[oaicite:11]{index=11}

    +
    @@ -363,6 +439,7 @@

    ReferenceFIRMS