Template plugin for observation parsers (template
/ std
)¶
Description¶
This is a template to implement a new observation parser plugin. It include all required functions to run properly.
It loops over existing files and generate pseudo data as if they were parsed. The files can be any format, they are just used as a basis for looping.
Warning
Please gradually document your plugin properly when starting from the template.
It includes input_arguments
(see here for details),
as well as all information about the original data the plugin is supposed to
accommodate.
Please include licensing information, permanent link to download the data (or a contact person if no link is publicly available), as well as data format (temporal and horizontal resolution, names and shape of the data files), and any specific treatment that prevents the plugin from working with another type of files.
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¶
parameter: (optional): CO2
Name of the species for which to generate observations
accepted type: str
obs_min: (optional): 380
Lower range for generating random observations
accepted type: float
obs_max: (optional): 450
Lower range for generating random observations
accepted type: float
nstations: (optional): 5
Number of stations to randomly distribute
accepted type: int
xmin: (optional): -180
West border of the domain on which to distribute stations
accepted type: float
xmax: (optional): 180
East border of the domain on which to distribute stations
accepted type: float
ymin: (optional): -90
South border of the domain on which to distribute stations
accepted type: float
ymax: (optional): 90
North border of the domain on which to distribute stations
accepted type: float
Yaml template¶
Please find below a template for a Yaml configuration:
1obsparser:
2 plugin:
3 name: template
4 version: std
5 type: obsparser
6
7 # Optional arguments
8 parameter: XXXXX # str
9 obs_min: XXXXX # float
10 obs_max: XXXXX # float
11 nstations: XXXXX # int
12 xmin: XXXXX # float
13 xmax: XXXXX # float
14 ymin: XXXXX # float
15 ymax: XXXXX # float