Forward run forward/std

Description

This mode simply runs the observation operator in forward mode (including the transport model and all auxiliary operations). Depending on how the model and the system is set up, it will compute observation equivalent and/or save all the 4d concentration fields.

YAML arguments

The following arguments are used to configure the plugin. pyCIF will return an exception at the initialization if mandatory arguments are not specified, or if any argument does not fit accepted values or type:

Optional arguments

run_mode : “fwd” or “tl”, optional, default “fwd”

Running mode for the forward simulation

• “fwd”: run a full forward mode

• “tl”: run the tangent-linear operator

use_xb : bool, optional, default True

Running mode for the forward simulation

perturb_obsvect : bool, optional, default False

If True, perturbs the output observation vector to generate truth in OSSEs. The formula used for the perturbations is \(\delta y \sim \mathcal{N}(0, \sigma_\epsilon)\)

with \(\sigma_\epsilon = \sigma_\mathbf{y} \;.\; \delta\);

\(\delta\) is the value specified in ${obserror}. Perturbed simulations are saved in the obs column of the output monitor.nc file; \(\sigma_\mathbf{y} \;.\; \delta is stored in the column ``yobs_err`\)

obserror : float, optional, default 0.0

The scale used to generate perturbation on the errors.

reload_results : bool, optional, default False

Reload results from previous simulations. If True does not recomputed already computed simulations

Requirements

The current plugin requires the present plugins to run properly:

Requirement name	Requirement type	Explicit definition	Any valid	Default name	Default version
controlvect	ControlVect	True	True	standard	std
obsoperator	ObsOperator	True	False	standard	std

YAML template

Please find below a template for a YAML configuration:

mode:
  plugin:
    name: forward
    version: std
    type: mode

    # Optional arguments
    run_mode: XXXXX  # fwd|tl
    use_xb: XXXXX  # bool
    perturb_obsvect: XXXXX  # bool
    obserror: XXXXX  # float
    reload_results: XXXXX  # bool