2. Setting the mapper with output concentrations

Here, we propose to extract output concentrations from pre-computed output files. This is possible in the template by using the option only_outputs in the model paragraph.

 1#####################
 2# pyCIF config file #
 3#####################
 4
 5# Define here all parameters for pyCIF following YAML syntax
 6# For details on YAML syntax, please see:
 7# http://docs.ansible.com/ansible/latest/YAMLSyntax.html
 8
 9###############################################################################
10# pyCIF parameters
11
12rootdir: &rootdir /tmp/CIF/
13outdir: &outdir  !join [*rootdir, /.tox/py38/tmp]
14verbose: 2
15workdir:  !join [*outdir, /4_onlyconcs]
16logfile: log.txt
17datei: 2000-01-01 00:00:00
18datef: 2000-02-01 00:00:00
19
20###############################################################################
21
22# http://community-inversion.eu/documentation/plugins/models/template.html
23
24model:
25  plugin:
26    name: template
27    version: std
28
29  require_domain: true
30  require_chemistry: true
31  only_outputs: true
32
33###############################################################################
34
35# http://community-inversion.eu/documentation/plugins/modes/forward.html
36
37mode:
38  plugin:
39    name: forward
40    version: std
41
42###############################################################################
43
44# http://community-inversion.eu/documentation/plugins/domains/dummy.html
45
46domain:
47  plugin:
48    name: dummy
49    version: std
50
51  nlat: 15
52  nlon: 10
53  xmax: 50
54  xmin: -10
55  ymax: 60
56  ymin: 40
57
58###############################################################################
59
60# http://community-inversion.eu/documentation/plugins/obsoperators/standard.html
61
62obsoperator:
63  plugin:
64    name: standard
65    version: std
66
67###############################################################################
68
69chemistry:
70  schemeid: template_CO2
71  acspecies:
72    CO2:
73      restart_id: 1
74      mass: 12
75  emis_species:
76    CO2: null
77
78###############################################################################
79
80# http://community-inversion.eu/documentation/plugins/datavects/standard.html
81
82datavect:
83  plugin:
84    name: standard
85    version: std
86
87  components:
88    concs:
89      parameters:
90        CO2:
91          plugin:
92            name: random
93            type: measurements
94            version: param
95          duration: 2H22min
96          frequency: 1H
97          nstations: 1
98          seed: true
99          zmax: 100

Compared to the previous yaml, the following elements have been added:

  1. mode paragraph: this is the execution mode. It is needed for pyCIF to go further than the initialization step. Here we are computing a forward simulation to compare simulations with observations

  2. chemistry paragraph: this paragraph indicates information about species to be transported and/or emitted in the model

  3. datavect paragraph: this paragraph indicated all required information about pyCIF inputs. Further details is given here

In the example above, observations are generated at random locations. If one needs/wants to use a file of its own making, please refer to the dedicated documentation page about observation inputs (here) to properly prepare the file.

Once successfully running, the forward working files are saved in the folder $runsubdir/obsoperator/fwd_0000/. In particular, the output simulations and corresponding observations are saved here: $runsubdir/obsoperator/fwd_0000/obsvect.