Changes between Initial Version and Version 1 of OMI_observation_modules

Timestamp:

Nov 23, 2020, 9:44:13 AM (3 years ago)

Author:

lnerger

Comment:

--

OMI_observation_modules

@@ +1 @@
+= PDAF-OMI Observation Modules = 
+
+[[PageOutline(2-3,Contents of this page)]]
+
+The implementation of the observations with OMI is done in observation modules (obs-modules). For each observation type a separate module should be created. 
+
+Each obs-module contains four routines:
+
+ - init_dim_obs initializes all variables holding the information about one observation type. The information about the observation type is stored in a data structure (Fortran derived type).
+ - obs_op applies the observation operator to a state vector. One can call an observation operator routine provided by PDAF, or one can to implement a new operator.
+ - init_dim_obs_l calls a PDAF-OMI routine to initialize the observation information corresponding to a local analysis domain. One can set localization parameters, liek the localization radius, for each observation type.
+ - localize_covar calls a PDAF-OMI routine to apply covariance localization. One can set localization parameters, liek the localization radius, for each observation type. 
+
+== obs_f data type == 
+
+To ensure the functionality within each obs-module, we rely on a derived data type called `obs_f` that describes the observation. One instance of this data type is allocated in each obs-module as the variable `thisobs`. a few of the elements of `obs_f` are initialized by the user when the observation information is initialized on `init_dim_obs_f`. Further information is set in a call to the routine `PDAFomi_gather_obs`. This information is then used by all other routines in the obs-module. The template file obs_TYPE_pdafomi_TEMPLATE.F90 shows the different steps needed to initialize thisobs. 
+
+{{{
+! ---- Mandatory variables to be set in init_dim_obs_f ----
+  INTEGER :: doassim                    ! Whether to assimilate this observation type
+  INTEGER :: disttype                   ! Type of distance computation to use for localization
+                                        !   (0) Cartesian, (1) Cartesian periodic
+                                        !   (2) simplified geographic, (3) geographic haversine function
+  INTEGER :: ncoord                     ! Number of coordinates use for distance computation
+  INTEGER, ALLOCATABLE :: id_obs_p(:,:) ! Indices of observed field in state vector (process-local)
+}}}
+
+