Gridded NetCDF initial conditions (gridded_netcdf / std)¶
Description¶
Reads initial conditions from a 3D (level x latitude x longitude) gridded NetCDF file
See domain plugin Gridded NetCDF for information required coordinates format in the NetCDF file.
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¶
dir: (optional):
Path to the corresponding component. This value is used if not provided in parameters
accepted type: str
file: (optional):
File format in the given directory. This value is used if not provided in parameters
accepted type: str
varname: (optional):
Variable name to use to read data filesinstead of the parameter name if different to the parameter name
accepted type: str
file_freq: (optional):
Temporal frequency to fetch files
accepted type: str
dir_vcoord: (optional):
Directory containing
file_vcoord. Use this argument if the vertical coordinates are not infileaccepted type: str
file_vcoord: (optional)
NetCDF file containing the vertical coordinates. Use this argument if the vertical coordinates are not in
fileaccepted type: str
vertical_coord: (optional)
Read the domain’s vertical levels if this parameter is used. Should be ‘mids’ if the vertical coordinate represents the levels mid-points or ‘bounds’ if the vertical coordinate represents the levels boundaries. If this parameter is not used a domain single vertical level is created
accepted values:
mids: levels mid-points
bounds: levels boundaries
vertical_dim_name: (optional): lev
Vertical dimension name in
fileorfile_vcoordaccepted type: str
sigma_a_var_name: (optional): ap
‘sigma a’ variable name in
fileorfile_vcoordaccepted type: str
sigma_b_var_name: (optional): bp
‘sigma b’ variable name in
fileorfile_vcoordaccepted type: str
pressure_unit: (optional)
pressure units if different from
unitsattributes insigma `a` variable, should be ``'Pa'or'hPa'accepted values: [‘Pa’, ‘hPa’]
latitude_varname: (optional): latitude
Latitude coordinate variable name in
file. If this argument is not provided, the latitude coordinate is found by itsstandard_nameorlong_nameattribute (which should be'latitude').accepted type: str
longitude_varname: (optional): longitude
Longitude coordinate variable name in
file. If this argument is not provided, the longitude coordinate is found by itsstandard_nameorlong_nameattribute (which should be'longitude').accepted type: str
latitude_dimname: (optional): latitude
Latitude dimension name in
file.accepted type: str
longitude_dimname: (optional): longitude
Longitude dimension name in
file.accepted type: str
use_corners: (optional): False
True if the longitudes and latitudes are used to defined the corners instead of gridcell centers
accepted type: str
extend_lat: (optional): False
Extend corner latitudes by one cell if nlat_corner != nlat + 1
accepted type: str
extend_lon: (optional): False
Extend corner longitudes by one cell if nlon_corner != nlon + 1
accepted type: str
lat_min: (optional): -90.0
Minimum latitude
accepted type: float
lat_max: (optional): 90.0
Maximum latitude
accepted type: float
delta_lat: (optional)
Skip the reading/computation of latitude bounds and use regular gridcells with a size of
delta_lat.delta_latshould dividelat_max - lat_minand be coherent with the NetCDF file dimensions.accepted type: float
lon_min: (optional): -180.0
Minimum longitude
accepted type: float
lon_max: (optional): 180.0
Maximum longitude
accepted type: float
delta_lon: (optional)
Skip the reading/computation of longitude bounds and use regular gridcells with a size of
delta_lon.delta_lonshould dividelon_max - lon_minand be coherent with the NetCDF file dimensions.accepted type: float
Yaml template¶
Please find below a template for a Yaml configuration:
1datastream:
2 plugin:
3 name: gridded_netcdf
4 version: std
5 type: datastream
6
7 # Optional arguments
8 dir: XXXXX # str
9 file: XXXXX # str
10 varname: XXXXX # str
11 file_freq: XXXXX # str
12 dir_vcoord: XXXXX # str
13 file_vcoord: XXXXX # str
14 vertical_coord: XXXXX # mids|bounds
15 vertical_dim_name: XXXXX # str
16 sigma_a_var_name: XXXXX # str
17 sigma_b_var_name: XXXXX # str
18 pressure_unit: XXXXX # Pa|hPa
19 latitude_varname: XXXXX # str
20 longitude_varname: XXXXX # str
21 latitude_dimname: XXXXX # str
22 longitude_dimname: XXXXX # str
23 use_corners: XXXXX # str
24 extend_lat: XXXXX # str
25 extend_lon: XXXXX # str
26 lat_min: XXXXX # float
27 lat_max: XXXXX # float
28 delta_lat: XXXXX # float
29 lon_min: XXXXX # float
30 lon_max: XXXXX # float
31 delta_lon: XXXXX # float
