Implementation Tutorials

The tutorial model

The tutorial implementation uses a simple 2-dimensional model domain with a single model field.

• ​PDAF Tutorial: The tutorial model: non-parallel and parallel versions (PDF, 0.6 MB)
  

Implementing the online mode of PDAF

In the online mode of PDAF one couples PDAF to a model into a single assimilation program. With version 1.16 we introduced PDAF-OMI, the Observation Module Infrastructure. The tutorials are adapted for OMI, while tutorials describing the implementation without OMI are provided further below. The implementation is done from the templates provided in /templates/online of the source code package. Two implementations are demonstrated: The case that the model itself is not parallelized and the case that the model is parallelized (i.e. if field is decomposed over several processes).

Step-by-step descriptions of the required implementation steps are provided by the following slide sets (the described features are supported from PDAF 1.16):

• ​PDAF Tutorial: Implementation of the assimilation system with a model that is not parallelized (PDF, 0.9 MB)
  
• ​PDAF Tutorial: Implementation of the assimilation system with a parallelized model (PDF, 0.9 MB)
  

Implementing the offline analysis step

In the offline mode of PDAF one uses separate programs for the model and the data assimilation. The implementation is done from the templates provided in /templates/offline of the source code package. The tutorial describes the implementation with PDAF-OMI that was introduced with version 1.16.

A step-by-step description of the required implementation steps is provided by the following slide set (the described features are supported from PDAF 1.16):

• ​PDAF Tutorial: Implementation of the analysis step in offline mode (PDF, 0.8 MB)

Implementing 3D-Var

With PDAF V2.0 we added 3D variational methods to PDAF. Templates for the implementation are provided in /templates/3dvar of the course package. Tutorial codes are in /tutorial/3dvar. The tutorial explains the particularities for the implementation of the 3D-Var methods:

• ​PDAF Tutorial: Implementation of the analysis step for 3D-Var (PDF, 1.8 MB)

Implementing without using PDAF-OMI

With PDAF version 1.16 we introduced PDAF-OMI (Observation Module Infrastructure). We recommend to use this new way to implement observationhandling more efficiently. However, implementing without OMI is still possible and here we provide the tutorial slides for this case:

Step-by-step descriptions of the required implementation steps are provided by the following slide sets (the described features are supported from PDAF 1.16):
Online mode:

• ​PDAF Tutorial: Implementation of the assimilation system without OMI with a model that is not parallelized (PDF, 0.9 MB)
  
• ​PDAF Tutorial: Implementation of the assimilation system without OMI with a parallelized model (PDF, 0.9 MB)
  

Offline mode:

• ​PDAF Tutorial: Implementation of the analysis step in offline mode without OMI (PDF, 1.0 MB)

Full documentation

For the online implementation guide and full documentation on the use of PDAF visit:

• Implementation Guide for the online assimilation system
• Implementation Guide for the offline assimilation program
• Implementing the analysis step:
  • Overview on implementing the analysis for ensemble filters
  • Overview on implementing the analysis step for 3D-Var methods
• Overview of filter-specific options
• Overview of PDAF-OMI
• Which filter should one use?
• Adding a filter algorithm to PDAF