LabRAI · runyangxu · Jan 29, 2026 · Jan 29, 2026
diff --git a/docs/.doctrees/datasets/merra2.doctree b/docs/.doctrees/datasets/merra2.doctree
diff --git a/docs/.doctrees/environment.pickle b/docs/.doctrees/environment.pickle
diff --git a/docs/_sources/datasets/merra2.rst.txt b/docs/_sources/datasets/merra2.rst.txt
@@ -1,9 +1,35 @@
 MERRA-2
 =======
 
-Global atmospheric reanalysis dataset produced by NASA Global Modeling and Assimilation Office (GMAO),
+Global atmospheric reanalysis produced by NASA Global Modeling and Assimilation Office (GMAO),
 providing physically consistent meteorological fields for weather, climate, and hazard modeling.
 
+.. admonition:: At-a-glance (Quick Facts)
+   :class: note
+
+   .. list-table::
+      :widths: 26 74
+      :stub-columns: 1
+
+      * - Producer
+        - NASA GMAO (GEOS)
+      * - Spatial coverage
+        - Global
+      * - Spatial resolution
+        - ~0.5° (lat) × 0.625° (lon)
+      * - Temporal resolution
+        - Hourly (also 3-hourly / daily / monthly products)
+      * - **Data update frequency**
+        - **Published monthly; typically available ~2–3 weeks after month end.**
+      * - Period of record
+        - 1980–present
+      * - Format
+        - NetCDF4
+      * - Grid / CRS
+        - Regular latitude–longitude grid
+      * - Typical role in PyHazards
+        - Core meteorological driver (forcing + covariates)
+
 ----
 
 Overview
@@ -13,20 +39,40 @@ Overview
 atmospheric reanalysis that assimilates satellite and conventional observations into a numerical
 weather prediction system to produce gridded, time-continuous estimates of the atmospheric state.
 
-It is widely used as a core meteorological driver in climate analysis and hazard prediction pipelines,
+It is widely used as a meteorological backbone for climate analysis and hazard prediction pipelines,
 including wildfire, hurricane, drought, and extreme heat studies.
 
 ----
 
+Stats
+-----
+
+.. list-table::
+   :header-rows: 1
+   :widths: 22 22 22 34
+
+   * - Spatial
+     - Temporal
+     - Update cadence
+     - Coverage
+   * - 0.5° × 0.625°
+     - Hourly
+     - Monthly (+ ~2–3 weeks latency)
+     - Global, 1980–present
+
+----
+
 Data Characteristics
 --------------------
 
-- **Spatial coverage:** Global  
-- **Spatial resolution:** ~0.5° latitude × 0.625° longitude  
-- **Temporal resolution:** Hourly  
-- **Vertical structure:** Surface fields and multi-level pressure profiles  
-- **Data format:** NetCDF  
-- **Coordinate system:** Regular latitude–longitude grid  
+- **Spatial coverage:** Global
+- **Spatial resolution:** ~0.5° latitude × 0.625° longitude
+- **Temporal resolution:** Hourly (with derived 3-hourly/daily/monthly products)
+- **Vertical structure:** Surface fields and multi-level pressure profiles
+- **Data format:** NetCDF4
+- **Coordinate system:** Regular latitude–longitude grid
+- **Data update frequency:** Monthly publication; new data typically appear ~2–3 weeks after month end
+  (common operational latency for standard MERRA-2 streams)
 
 ----
 
@@ -55,11 +101,15 @@ Typical Use Cases
 Access
 ------
 
-MERRA-2 data can be accessed via NASA GMAO and Earthdata services:
+MERRA-2 data can be accessed via NASA Earthdata / GES DISC services:
 
-- `MERRA-2 overview <https://gmao.gsfc.nasa.gov/gmao-products/merra-2/>`_
+- `MERRA-2 overview (GMAO) <https://gmao.gsfc.nasa.gov/gmao-products/merra-2/>`_
 - `NASA Earthdata <https://earthdata.nasa.gov/>`_
 
+.. note::
+   For standard MERRA-2 streams, operational latency is commonly documented as
+   ~2–3 weeks after the end of each month (monthly publication cadence).
+
 ----
 
 Reference
@@ -68,4 +118,4 @@ Reference
 Gelaro, R., McCarty, W., Suárez, M. J., *et al.* (2017).
 *The Modern-Era Retrospective Analysis for Research and Applications, Version 2 (MERRA-2)*.
 Journal of Climate, 30(14), 5419–5454.
-`https://doi.org/10.1175/JCLI-D-16-0758.1 <https://journals.ametsoc.org/view/journals/clim/30/14/jcli-d-16-0758.1.xml>`_
+`https://doi.org/10.1175/JCLI-D-16-0758.1 <https://journals.ametsoc.org/view/journals/clim/30/14/jcli-d-16-0758.1.xml>`_
diff --git a/docs/datasets/merra2.html b/docs/datasets/merra2.html
@@ -3,7 +3,7 @@
   <head><meta charset="utf-8"/>
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
-<link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="ERA5" href="era5.html" /><link rel="prev" title="Datasets" href="../pyhazards_datasets.html" />
+<link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" />
         <link rel="canonical" href="https://labrai.github.io/PyHazards/datasets/merra2.html" />
 
     <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
@@ -206,18 +206,8 @@
 <li class="toctree-l1"><a class="reference internal" href="../quick_start.html">Quick Start</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">API Reference</span></p>
-<ul class="current">
-<li class="toctree-l1 current has-children"><a class="reference internal" href="../pyhazards_datasets.html">Datasets</a><input checked="" class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" role="switch" type="checkbox"/><label for="toctree-checkbox-1"><div class="visually-hidden">Toggle navigation of Datasets</div><i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i></label><ul class="current">
-<li class="toctree-l2 current current-page"><a class="current reference internal" href="#">MERRA-2</a></li>
-<li class="toctree-l2"><a class="reference internal" href="era5.html">ERA5</a></li>
-<li class="toctree-l2"><a class="reference internal" href="noaa_flood.html">NOAA Flood Events</a></li>
-<li class="toctree-l2"><a class="reference internal" href="firms.html">FIRMS</a></li>
-<li class="toctree-l2"><a class="reference internal" href="mtbs.html">MTBS</a></li>
-<li class="toctree-l2"><a class="reference internal" href="landfire.html">LANDFIRE</a></li>
-<li class="toctree-l2"><a class="reference internal" href="wfigs.html">WFIGS</a></li>
-<li class="toctree-l2"><a class="reference internal" href="goesr.html">GOES-R</a></li>
-</ul>
-</li>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../pyhazards_datasets.html">Datasets</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../pyhazards_models.html">Models</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../pyhazards_engine.html">Engine</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../pyhazards_metrics.html">Metrics</a></li>
@@ -271,27 +261,97 @@
         <article role="main" id="furo-main-content">
           <section id="merra-2">
 <h1>MERRA-2<a class="headerlink" href="#merra-2" title="Link to this heading">¶</a></h1>
-<p>Global atmospheric reanalysis dataset produced by NASA Global Modeling and Assimilation Office (GMAO),
+<p>Global atmospheric reanalysis produced by NASA Global Modeling and Assimilation Office (GMAO),
 providing physically consistent meteorological fields for weather, climate, and hazard modeling.</p>
+<div class="note admonition">
+<p class="admonition-title">At-a-glance (Quick Facts)</p>
+<div class="table-wrapper colwidths-given docutils container">
+<table class="docutils align-default">
+<colgroup>
+<col style="width: 26.0%" />
+<col style="width: 74.0%" />
+</colgroup>
+<tbody>
+<tr class="row-odd"><th class="stub"><p>Producer</p></th>
+<td><p>NASA GMAO (GEOS)</p></td>
+</tr>
+<tr class="row-even"><th class="stub"><p>Spatial coverage</p></th>
+<td><p>Global</p></td>
+</tr>
+<tr class="row-odd"><th class="stub"><p>Spatial resolution</p></th>
+<td><p>~0.5° (lat) × 0.625° (lon)</p></td>
+</tr>
+<tr class="row-even"><th class="stub"><p>Temporal resolution</p></th>
+<td><p>Hourly (also 3-hourly / daily / monthly products)</p></td>
+</tr>
+<tr class="row-odd"><th class="stub"><p><strong>Data update frequency</strong></p></th>
+<td><p><strong>Published monthly; typically available ~2–3 weeks after month end.</strong></p></td>
+</tr>
+<tr class="row-even"><th class="stub"><p>Period of record</p></th>
+<td><p>1980–present</p></td>
+</tr>
+<tr class="row-odd"><th class="stub"><p>Format</p></th>
+<td><p>NetCDF4</p></td>
+</tr>
+<tr class="row-even"><th class="stub"><p>Grid / CRS</p></th>
+<td><p>Regular latitude–longitude grid</p></td>
+</tr>
+<tr class="row-odd"><th class="stub"><p>Typical role in PyHazards</p></th>
+<td><p>Core meteorological driver (forcing + covariates)</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
 <hr class="docutils" />
 <section id="overview">
 <h2>Overview<a class="headerlink" href="#overview" title="Link to this heading">¶</a></h2>
 <p><strong>MERRA-2 (Modern-Era Retrospective analysis for Research and Applications, Version 2)</strong> is a global
 atmospheric reanalysis that assimilates satellite and conventional observations into a numerical
 weather prediction system to produce gridded, time-continuous estimates of the atmospheric state.</p>
-<p>It is widely used as a core meteorological driver in climate analysis and hazard prediction pipelines,
+<p>It is widely used as a meteorological backbone for climate analysis and hazard prediction pipelines,
 including wildfire, hurricane, drought, and extreme heat studies.</p>
 </section>
 <hr class="docutils" />
+<section id="stats">
+<h2>Stats<a class="headerlink" href="#stats" title="Link to this heading">¶</a></h2>
+<div class="table-wrapper colwidths-given docutils container">
+<table class="docutils align-default">
+<colgroup>
+<col style="width: 22.0%" />
+<col style="width: 22.0%" />
+<col style="width: 22.0%" />
+<col style="width: 34.0%" />
+</colgroup>
+<thead>
+<tr class="row-odd"><th class="head"><p>Spatial</p></th>
+<th class="head"><p>Temporal</p></th>
+<th class="head"><p>Update cadence</p></th>
+<th class="head"><p>Coverage</p></th>
+</tr>
+</thead>
+<tbody>
+<tr class="row-even"><td><p>0.5° × 0.625°</p></td>
+<td><p>Hourly</p></td>
+<td><p>Monthly (+ ~2–3 weeks latency)</p></td>
+<td><p>Global, 1980–present</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</section>
+<hr class="docutils" />
 <section id="data-characteristics">
 <h2>Data Characteristics<a class="headerlink" href="#data-characteristics" title="Link to this heading">¶</a></h2>
 <ul class="simple">
 <li><p><strong>Spatial coverage:</strong> Global</p></li>
 <li><p><strong>Spatial resolution:</strong> ~0.5° latitude × 0.625° longitude</p></li>
-<li><p><strong>Temporal resolution:</strong> Hourly</p></li>
+<li><p><strong>Temporal resolution:</strong> Hourly (with derived 3-hourly/daily/monthly products)</p></li>
 <li><p><strong>Vertical structure:</strong> Surface fields and multi-level pressure profiles</p></li>
-<li><p><strong>Data format:</strong> NetCDF</p></li>
+<li><p><strong>Data format:</strong> NetCDF4</p></li>
 <li><p><strong>Coordinate system:</strong> Regular latitude–longitude grid</p></li>
+<li><p><strong>Data update frequency:</strong> Monthly publication; new data typically appear ~2–3 weeks after month end
+(common operational latency for standard MERRA-2 streams)</p></li>
 </ul>
 </section>
 <hr class="docutils" />
@@ -318,11 +378,16 @@ <h2>Typical Use Cases<a class="headerlink" href="#typical-use-cases" title="Link
 <hr class="docutils" />
 <section id="access">
 <h2>Access<a class="headerlink" href="#access" title="Link to this heading">¶</a></h2>
-<p>MERRA-2 data can be accessed via NASA GMAO and Earthdata services:</p>
+<p>MERRA-2 data can be accessed via NASA Earthdata / GES DISC services:</p>
 <ul class="simple">
-<li><p><a class="reference external" href="https://gmao.gsfc.nasa.gov/gmao-products/merra-2/">MERRA-2 overview</a></p></li>
+<li><p><a class="reference external" href="https://gmao.gsfc.nasa.gov/gmao-products/merra-2/">MERRA-2 overview (GMAO)</a></p></li>
 <li><p><a class="reference external" href="https://earthdata.nasa.gov/">NASA Earthdata</a></p></li>
 </ul>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>For standard MERRA-2 streams, operational latency is commonly documented as
+~2–3 weeks after the end of each month (monthly publication cadence).</p>
+</div>
 </section>
 <hr class="docutils" />
 <section id="reference">
@@ -339,26 +404,8 @@ <h2>Reference<a class="headerlink" href="#reference" title="Link to this heading
       <footer>
 
         <div class="related-pages">
-          <a class="next-page" href="era5.html">
-              <div class="page-info">
-                <div class="context">
-                  <span>Next</span>
-                </div>
-                <div class="title">ERA5</div>
-              </div>
-              <svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
-            </a>
-          <a class="prev-page" href="../pyhazards_datasets.html">
-              <svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
-              <div class="page-info">
-                <div class="context">
-                  <span>Previous</span>
-                </div>
-
-                <div class="title">Datasets</div>
-
-              </div>
-            </a>
+
+
         </div>
         <div class="bottom-of-page">
           <div class="left-details">
@@ -391,6 +438,7 @@ <h2>Reference<a class="headerlink" href="#reference" title="Link to this heading
             <ul>
 <li><a class="reference internal" href="#">MERRA-2</a><ul>
 <li><a class="reference internal" href="#overview">Overview</a></li>
+<li><a class="reference internal" href="#stats">Stats</a></li>
 <li><a class="reference internal" href="#data-characteristics">Data Characteristics</a></li>
 <li><a class="reference internal" href="#variables">Variables</a></li>
 <li><a class="reference internal" href="#typical-use-cases">Typical Use Cases</a></li>

diff --git a/docs/searchindex.js b/docs/searchindex.js