Changes between Initial Version and Version 1 of OMI_ImplementationofAnalysisStep_PDAF23


Ignore:
Timestamp:
Jun 3, 2025, 12:58:05 PM (3 days ago)
Author:
lnerger
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • OMI_ImplementationofAnalysisStep_PDAF23

    v1 v1  
     1= Implementation of the Analysis Step with OMI =
     2
     3{{{
     4#!html
     5<div class="wiki-toc">
     6<h4>PDAF-OMI Guide</h4>
     7<ol><li><a href="PDAF_OMI_Overview">Overview</a></li>
     8<li><a href="OMI_Callback_obs_pdafomi">callback_obs_pdafomi.F90</a></li>
     9<li><a href="OMI_observation_modules">Observation Modules</a></li>
     10<li><a href="OMI_observation_operators">Observation operators</a></li>
     11<li><a href="OMI_error_checking">Checking error status</a></li>
     12<li><a href="OMI_debugging">Debugging functionality</a></li>
     13<li>Implementing the analysis step with OMI</li>
     14<ol>
     15<li> <a href="ImplementFilterAnalysisOverview"> General overview for ensemble filters</a></li>
     16<ol>
     17<li><a href="ImplementAnalysisGlobal">Implementation for Global Filters</a></li>
     18<li><a href="ImplementAnalysisLocal">Implementation for Local Filters</a></li>
     19<li><a href="ImplementAnalysislenkfOmi">Implementation for LEnKF</a></li>
     20</ol>
     21<li> <a href="Implement3DVarAnalysisOverview"> General overview for 3D-Var methods</a></li>
     22<ol>
     23<li><a href="ImplementAnalysis_3DVar">Implementation for 3D-Var</a></li>
     24<li><a href="ImplementAnalysis_3DEnVar">Implementation for 3D Ensemble Var</a></li>
     25<li><a href="ImplementAnalysis_Hyb3DVar">Implementation for Hybrid 3D-Var</a></li>
     26</ol>
     27</ol>
     28<li><a href="OMI_nondiagonal_observation_error_covariance_matrices">Using nondiagonal R-matrices</a></li>
     29<li><a href="Porting_to_OMI">Porting an existing implemention to OMI</a></li>
     30<li><a href="PDAFomi_additional_functionality">Additional OMI Functionality</a></li>
     31</ol>
     32</div>
     33}}}
     34
     35{{{
     36#!html
     37<div class="wiki-toc">
     38<h4>Implementation Guide</h4>
     39<ol><li><a href="ImplementationGuide">Main page</a></li>
     40<li><a href="AdaptParallelization">Adaptation of the parallelization</a></li>
     41<li><a href="InitPdaf">Initialization of PDAF</a></li>
     42<li><a href="ModifyModelforEnsembleIntegration">Modifications for ensemble integration</a></li>
     43<li><a href="PDAF_OMI_Overview">PDAF-OMI Overview</a></li>
     44</div>
     45}}}
     46
     47The implementation of the analysis step requires that the user-supplied routines whose names are given in the call to the filter-specific put-state routine are implemented with full functionality.
     48
     49With PDAF-OMI many of the routines are general and hence usable for all filter algorithms. There are some differences between the local and global filters and the LEnKF.  The general routines will be repeated, but they are marked as general.
     50
     51
     52
     53There are three different routines that call the filter analysis step.
     54 * [ImplementFilterAnalysisOverview General overview] of routines required to implement the analysis step for ensemble filters.
     55 1. [ImplementAnalysisGlobal Implementation of the analysis for Global Filters]
     56 1. [ImplementAnalysisLocal Implementation of the analysis for Local Filters]
     57 1. [ImplementAnalysislenkfOmi Implementation of the analysis for the LEnKF using covariance localization]
     58
     59For the application of the 3D-Var methods there are separate routines (added with PDAF 2.0):
     60 * [wiki:Implement3DVarAnalysisOverview General overview] of routines required to implement the analysis step for 3D-Var.
     61 1. [wiki:ImplementAnalysis_3DVar Implementation of the analysis for 3D-Var with parameterized background covariance matrix]
     62 1. [wiki:ImplementAnalysis_3DEnVar Implementation of the analysis for 3D Ensemble Var ]
     63 1. [wiki:ImplementAnalysis_Hyb3DVar Implementation of the analysis for hybrid 3D-Var]
     64
     65
     66== Implementation of the analysis step without OMI ==
     67
     68PDAF-OMI was introduced with version 1.16 of PDAF. While we recommend using OMI, the [wiki:ImplementationofAnalysisStep_noOMI implementation of the analysis step without OMI] is still possible.
     69
     70
     71== Testing the full implementation ==
     72
     73After the implementation of the user-supplied routines for the analysis step, the data assimilation system is fully implemented. In order to test the program one has to compile it without setting 'PDAF_NO_UPDATE'.
     74
     75To speed up the testing it can be useful to comment out the time stepping part. In that case only the model initialization and the assimilation cycle would be executed, without the usually costly time integration of the ensemble. One should then check if all user-supplied routines perform as they should.
     76
     77