Finite-amplitude Rossby Wave Diagnostics

diagnostics/finite_amplitude_wave_diag/doc/finite_amplitude_wave_diag_zonal_mean.rst

@@ -0,0 +1,127 @@
+.. This is a comment in RestructuredText format (two periods and a space).
+
+.. Note that all "statements" and "paragraphs" need to be separated by a blank 
+   line. This means the source code can be hard-wrapped to 80 columns for ease 
+   of reading. Multi-line comments or commands like this need to be indented by
+   exactly three spaces.
+
+.. Underline with '='s to set top-level heading: 
+   https://docutils.sourceforge.io/docs/user/rst/quickref.html#section-structure
+
+Finite Amplitude Rossby Wave Diagnostics Documentation
+======================================================
+
+.. rst-class:: center
+
+Clare S. Y. Huang\ |^1|, Christopher Polster |^2| and Noboru Nakamura\ |^1|
+
+.. rst-class:: center
+
+|^1|\ The University of Chicago, Chicago, Illinois
+
+|^2|\ Johannes Gutenberg-Universität Mainz, Germany
+
+.. rst-class:: center
+
+Last update: 03/12/2024
+
+Description
+-----------
+(to be filled in )
+
+.. Underline with '-'s to make a second-level heading.
+
+Version & Contact info
+----------------------
+
+Here you should describe who contributed to the diagnostic, and who should be
+contacted for further information:
+
+- Version/revision information: version 1 (03/12/2024)
+- PI (name, affiliation, email): Clare S. Y. Huang (The University of Chicago, [email protected])
+- Developer/point of contact: Clare S. Y. Huang (The University of Chicago, [email protected])
+- Other contributors: Christopher Polster, Noboru Nakamura
+
+.. Underline with '^'s to make a third-level heading.
+
+Open source copyright agreement
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The MDTF framework is distributed under the LGPLv3 license (see LICENSE.txt). 
+Unless you've distributed your script elsewhere, you don't need to change this.
+
+Functionality
+-------------
+
+(to be filled in)
+
+Required programming language and libraries
+-------------------------------------------
+
+(to be filled in)
+
+
+Required model output variables
+-------------------------------
+
+(to be filled in)
+
+References
+----------
+
+References
+----------
+
+.. _ref-Nakamura-annual-review:
+
+10241. Nakamura, N. (2024). Large-Scale Eddy-Mean Flow Interaction in the Earth's Extratropical Atmosphere. *Annual Review of Fluid Mechanics*, **56**, 349-377,
+`doi:10.1146/annurev-fluid-121021-035602 <https://doi.org/10.1146/annurev-fluid-121021-035602>`__.
+
+.. _ref-Neal-et-al-GRL:
+
+10242. Neal, E., Huang, C. S., & Nakamura, N. (2022). The 2021 Pacific Northwest heat wave and associated blocking: meteorology and the role of an upstream cyclone as a diabatic source of wave activity. *Geophysical Research Letters*, **49(8)**, e2021GL097699. `doi:10.1029/2021GL097699 <https://doi.org/10.1029/2021GL097699>`__.
+
+.. _ref-Nakamura-Science:
+
+10243. Nakamura, N., & Huang, C. S. (2018). Atmospheric blocking as a traffic jam in the jet stream. *Science*, **361(6397)**, 42-47, `doi:10.1126/science.aat0721 <https://doi.org/10.1126/science.aat0721>`__.
+
+.. _ref-Nakamura-Solomon-JAS-2010:
+
+10244. Nakamura, N., & Solomon, A. (2010). Finite-amplitude wave activity and mean flow adjustments in the atmospheric general circulation. Part I: Quasigeostrophic theory and analysis. *Journal of the atmospheric sciences*, **67(12)**, 3967-3983, `doi:10.1175/2010JAS3503.1 <https://doi.org/10.1175/2010JAS3503.1>`__.
+
+.. _ref-Nakamura-Solomon-JAS-2011:
+
+10245. Nakamura, N., & Solomon, A. (2011). Finite-amplitude wave activity and mean flow adjustments in the atmospheric general circulation. Part II: Analysis in the isentropic coordinate. Journal of the atmospheric sciences, 68(11), 2783-2799, `doi:10.1175/2011JAS3685.1 <https://doi.org/10.1175/2011JAS3685.1>`__.
+
+.. _ref-Huang-Nakamura-JAS-2016:
+
+10246. Huang, C. S., & Nakamura, N. (2016). Local finite-amplitude wave activity as a diagnostic of anomalous weather events. Journal of the Atmospheric Sciences, 73(1), 211-229, `doi:10.1175/JAS-D-15-0194.1 <https://doi.org/10.1175/JAS-D-15-0194.1>`__.
+
+.. _ref-Huang-Nakamura-GRL-2017:
+
+10247. Huang, C. S., & Nakamura, N. (2017). Local wave activity budgets of the wintertime Northern Hemisphere: Implication for the Pacific and Atlantic storm tracks. Geophysical Research Letters, 44(11), 5673-5682, `doi:10.1002/2017GL073760 <https://doi.org/10.1002/2017GL073760>`__.
+
+More about this diagnostic
+--------------------------
+
+(to be filled in)
+
+Links to external sites
+^^^^^^^^^^^^^^^^^^^^^^^
+
+(to be filled in)
+
+More references and citations
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+(to be filled in)
+
+Figures
+^^^^^^^
+
+(to be filled in)
+
+Equations
+^^^^^^^^^
+
+(to be filled in)

diagnostics/finite_amplitude_wave_diag/finite_amplitude_wave_diag.html

@@ -0,0 +1,120 @@
+<!-- This file is part of the EOF_500hPa module of the MDTF code package (see LICENSE.txt) -->
+
+<TITLE> Finite-amplitude Rossby wave diagnostics</TITLE>
+<img src="../mdtf_diag_banner.png">
+<h3>Finite-amplitude Rossby wave diagnostics</h3>
+
+<td class="d-block comment-body markdown-body  js-comment-body">
+          <p dir="auto">The goal to incorporate Finite-amplitude wave activity (FAWA) formalism into MDTF repo is to provide diagnostic tools for model comparison. Each diagnostic shall associate with an interpretation related to the physical process.</p>
+<p dir="auto">Below are some proposed candidates and associated physical interpretations:</p>
+<table role="table">
+<thead>
+<tr>
+<th>Diagnostic</th>
+<th>Interpretation</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>Seasonal climatology of zonal mean FAWA</td>
+<td>It quantifies the strength of vertically propagating planetary waves, and also relative strength of synoptic eddies in troposphere</td>
+</tr>
+<tr>
+<td>Seasonal climatology of Uref</td>
+<td>To quantify strength of mean-flow interaction, i.e., adiabatic adjustment of flow from an eddy-free reference state is given by Uref-Ubar(zonal mean wind)</td>
+</tr>
+<tr>
+<td>Seasonal climatology of &lt;LWA&gt; (&lt;...&gt; = vertically averaged)</td>
+<td>To quantify geographical distribution (and amplitude) of eddies</td>
+</tr>
+<tr>
+<td>Seasonal climatology of temporal Covariance of &lt;LWA&gt; and &lt;U&gt; (as in NH18 Fig. 2A)</td>
+<td>A measure of strength of nonlinear wave-mean flow interaction (via nonlinear zonal wave activity flux)</td>
+</tr>
+</tbody>
+</table>
+</td>
+
+<a href="https://mdtf-diagnostics.readthedocs.io/en/latest/sphinx_pods/finite_amplitude_wave_diag_zonal_mean.html">Full Documentation and Contact Information</a>
+
+<h4>Zonal-mean finite-amplitude wave diagnostics for {{CASENAME}} (Climatologies)</h4>
+
+<table class="tg">
+<thead>
+  <tr>
+    <th>Name of Diagnostic</th>
+    <th>DJF</th>
+    <th>MAM</th>
+    <th>JJA</th>
+    <th>SON</th>
+  </tr>
+</thead>
+<tbody>
+  <tr>
+    <td>zonal mean zonal wind</td>
+    <td><a href=model/DJF_zonal_mean_u.png>plot</a></td>
+    <td><a href=model/MAM_zonal_mean_u.png>plot</a></td>
+    <td><a href=model/JJA_zonal_mean_u.png>plot</a></td>
+    <td><a href=model/SON_zonal_mean_u.png>plot</a></td>
+  </tr>
+  <tr>
+    <td>zonal mean wave activity (FAWA)</td>
+    <td><a href=model/DJF_zonal_mean_lwa.png>plot</a></td>
+    <td><a href=model/MAM_zonal_mean_lwa.png>plot</a></td>
+    <td><a href=model/JJA_zonal_mean_lwa.png>plot</a></td>
+    <td><a href=model/SON_zonal_mean_lwa.png>plot</a></td>
+  </tr>
+  <tr>
+    <td>zonal mean reference states (Uref)</td>
+    <td><a href=model/DJF_zonal_mean_uref.png>plot</a></td>
+    <td><a href=model/MAM_zonal_mean_uref.png>plot</a></td>
+    <td><a href=model/JJA_zonal_mean_uref.png>plot</a></td>
+    <td><a href=model/SON_zonal_mean_uref.png>plot</a></td>
+  </tr>
+  <tr>
+    <td>zonal mean wind adjustment (\Delta U)</td>
+    <td><a href=model/DJF_zonal_mean_delta_u.png>plot</a></td>
+    <td><a href=model/MAM_zonal_mean_delta_u.png>plot</a></td>
+    <td><a href=model/JJA_zonal_mean_delta_u.png>plot</a></td>
+    <td><a href=model/SON_zonal_mean_delta_u.png>plot</a></td>
+  </tr>
+</tbody>
+</table>
+
+
+<h4>Vertically-averaged finite-amplitude wave diagnostics for {{CASENAME}} (Climatologies)</h4>
+
+<table class="tg">
+<thead>
+  <tr>
+    <th>Name of Diagnostic</th>
+    <th>DJF</th>
+    <th>MAM</th>
+    <th>JJA</th>
+    <th>SON</th>
+  </tr>
+</thead>
+<tbody>
+  <tr>
+    <td>Barotropic zonal mean zonal wind</td>
+    <td><a href=model/DJF_u_baro.png>plot</a></td>
+    <td><a href=model/MAM_u_baro.png>plot</a></td>
+    <td><a href=model/JJA_u_baro.png>plot</a></td>
+    <td><a href=model/SON_u_baro.png>plot</a></td>
+  </tr>
+  <tr>
+    <td>Barotropic local wave activity</td>
+    <td><a href=model/DJF_lwa_baro.png>plot</a></td>
+    <td><a href=model/MAM_lwa_baro.png>plot</a></td>
+    <td><a href=model/JJA_lwa_baro.png>plot</a></td>
+    <td><a href=model/SON_lwa_baro.png>plot</a></td>
+  </tr>
+  <tr>
+    <td>Covariance between barotropic zonal wind and LWA</td>
+    <td><a href=model/DJF_u_lwa_covariance.png>plot</a></td>
+    <td><a href=model/MAM_u_lwa_covariance.png>plot</a></td>
+    <td><a href=model/JJA_u_lwa_covariance.png>plot</a></td>
+    <td><a href=model/SON_u_lwa_covariance.png>plot</a></td>
+  </tr>
+</tbody>
+</table>