datasets rst

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.
 
 ----
 

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 <https://firms.modaps.eosdis.nasa.gov/>`_
 - `NASA Earthdata <https://earthdata.nasa.gov/>`_
 
+.. 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>`_
+`https://doi.org/10.1016/j.rse.2013.08.008 <https://doi.org/10.1016/j.rse.2013.08.008>`_

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 <https://www.goes-r.gov/>`_
-- `NOAA Big Data Program <https://www.noaa.gov/information-technology/open-data-dissemination>`_
+- `NOAA Open Data Dissemination <https://www.noaa.gov/information-technology/open-data-dissemination>`_
 
 ----
 

docs/_sources/datasets/landfire.rst.txt

@@ -4,29 +4,73 @@ 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
 --------
 
 **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)
 
 ----