wiki:Porting_to_OMI

Version 11 (modified by lnerger, 2 months ago) (diff)

--

Porting an Existing Implementation to OMI

PDAF-OMI Guide

  1. Overview
  2. callback_obs_pdafomi.F90
  3. Observation Modules
  4. Observation Operators
  5. Checking error status
  6. Debugging functionality
  7. Implementing the analysis step with OMI
    1. General overview for ensemble filters
      1. Implementation for Global Filters
      2. Implementation for Local Filters
      3. Implementation for LEnKF
    2. General overview for 3D-Var methods
      1. Implementation for 3D-Var
      2. Implementation for 3D Ensemble Var
      3. Implementation for Hybrid 3D-Var
  8. Using nondiagonal R-matrices
  9. Porting an existing implemention to OMI
  10. Additional OMI Functionality

If you have an implementation of the data assimilation with PDAF without OMI, you can port it to OMI with the following steps:

  1. Install the current PDAF version which includes the OMI functionality (V1.16 or later; we recommend to use the latest version)
  2. In mod_assimilation declare an array coords_l for the coordinates of the local analysis domain. Then fill coords_l in init_dim_l_pdaf. These coordinates are later used in init_dim_obs_l_pdafomi.
  3. Copy the template file callback_obs_pdafomi.F90 to your code directory.
  4. In assimilate_pdaf replace the call(s) to PDAF_put_state_X or PDAF_assimilate_X by the calls to PDAFomi_put_state_local/global or PDAFomi_assimilate_local/global (You can copy this from the template files in templates/)
  5. In assimilate_pdaf further replace the declaration of the 'EXTERNAL' subroutines following the template (several of the routines are no longer present with PDAF-OMI, while those that remain now have the suffix _pdafomi (like init_dim_obs_pdafomi)
  6. For each observation type implement an obs-module as described in the documention on the observation modules
  7. Add a call to deallocate_obs_pdafomi() are the end of your routine prepoststep.
  8. Adapt the compilation to also compile callback_obs_pdafomi.F90 and the obs-modules.
  9. Modify the compilation such that the include-directory of your PDAF installation is defined as an include directory (i.e. specify -IPDAF_ROOT/include where PDAF_ROOT is the root directory of your PDAF installation.)

Notes:

  • In the classical implementation variant one had to code separate routines for observation handling in global and local filters (e.g. init_dim_obs and init_dim_obs_f_pdaf. With OMI is it longer necessary to distinguish, as OMI takes case of the different operations in case of global or local filters.
  • With OMI we recommend to define the observation errors (rms_obs_TYPE) within each observation module instead of using the general module mod_assimilation.
  • While it is not done in the template and tutorial codes, one can move the localization parameters (locweight, cradius, sradius) into each observation module. This allos to easily define separate localization values for each observation type.