CHIMERE / gasJtab¶
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:
Mandatory arguments¶
schemeid: (mandatory)
Name of the chemical scheme
accepted type: str
Optional arguments¶
nreactamax: (optional): 4
Max number of reactants/reaction
accepted type: int
ntemps: (optional): 4
Number of tabul. temperatures for stoichio.
accepted type: int
ntabmax: (optional): 22
Max number of rate constants
accepted type: int
nlevphotmax: (optional): 50
Max number of tabulated photolysis levels
accepted type: int
ntabuzenmax: (optional): 20
Max number of tabulated zenith angles
accepted type: int
nphotmax: (optional): 50
Max number of photolysis reactions
accepted type: int
dir_precomp: (optional)
Directory where pre-defined chemical schemes are stored. The assumed structure is:
${dir_precomp}/${schemeid}/accepted type: str
acspecies: (optional)
List of active species and corresponding parameters
- accepted structure:
any_key: (optional)
Name of a species.
- accepted structure:
restart_id: (optional)
ID of the species in the LMDZ restart files. If the ID is an integer, the variable name to be found in restart.nc files has the format q{:02d}.
To explicitly specify the variable name to look for in restart.nc files, use the format explicit_XXXX; in that case, all characters after explicit_ make the species/variable name.
mass: (optional)
Molar mass of the species
htransport: (optional): 2
Vertical transport scheme to use in CHIMERE
accepted values:
1: PPM scheme
2: Van Leer
0: Upwind
vtransport: (optional): 1
Vertical transport scheme to use in CHIMERE
accepted values:
1: Upwind
2: Van Leer
bound_dry: (optional): True
Apply a conversion to humid concentration if dry
accepted type: bool
outspecies: (optional): <pycif.utils.classes.chemistries.Chemistry object at 0x7f92be8db9d0>
List of output species and corresponding parameters
- accepted structure:
any_key: (optional)
Name of a species.
- accepted structure:
output_frac: (optional): 0
In CHIMERE, computed concentrations are in fraction of total air (i.e., wet). It is possible to convert it to dry, or apply any other conversion factor.
accepted values:
-1: Keep CHIMERE wet concentrations
0: Dry concentrations
1: Any positive number is applied as is to wet concentrations
emis_species: (optional): <pycif.utils.classes.chemistries.Chemistry object at 0x7f92be8db160>
List of emitted species with constant emissions on corresponding time steps. Use for all emitted species for LMDZ. Corresponds to ANTHROPOGENIC species in CHIMERE
- accepted structure:
any_key: (optional)
Name of a species.
accepted structure:
bio_species: (optional): <pycif.utils.classes.chemistries.Chemistry object at 0x7f92be8db9a0>
List of emitted species with interpolated emissions between time steps. Do not use for LMDZ. Corresponds to BIOGENIC species in CHIMERE
- accepted structure:
any_key: (optional)
Name of a species.
accepted structure:
families: (optional): <pycif.utils.classes.chemistries.Chemistry object at 0x7f92be8db340>
List of families of species. Only for CHIMERE
- accepted structure:
any_key: (optional)
Name of a species.
accepted structure:
photo_parameters: (optional): <pycif.utils.classes.chemistries.Chemistry object at 0x7f92be8dbd60>
Information about photolysis parameters
- accepted structure:
ntabuzen: (optional): 0
Number of zenithal angles for which values are given
nphot: (optional): 0
Number of species for which values are given
nwavel: (optional): 3
Not used anywere…
altiphot: (optional): []
Levels (in meters above ground level) at which photolysis rates are given
Yaml template¶
Please find below a template for a Yaml configuration:
1chemistry:
2 plugin:
3 name: CHIMERE
4 version: gasJtab
5 type: chemistry
6
7 # Mandatory arguments
8 schemeid: XXXXX # str
9
10 # Optional arguments
11 nreactamax: XXXXX # int
12 ntemps: XXXXX # int
13 ntabmax: XXXXX # int
14 nlevphotmax: XXXXX # int
15 ntabuzenmax: XXXXX # int
16 nphotmax: XXXXX # int
17 dir_precomp: XXXXX # str
18 acspecies:
19 any_key:
20 restart_id: XXXXX # any
21 mass: XXXXX # any
22 htransport: XXXXX # 1|2|0
23 vtransport: XXXXX # 1|2
24 bound_dry: XXXXX # bool
25 outspecies:
26 any_key:
27 output_frac: XXXXX # -1|0|1
28 emis_species:
29 any_key:
30 bio_species:
31 any_key:
32 families:
33 any_key:
34 photo_parameters:
35 ntabuzen: XXXXX # any
36 nphot: XXXXX # any
37 nwavel: XXXXX # any
38 altiphot: XXXXX # any
