ancil_general_regrid.py#
For a full description see ants.cli.ancil_general_regrid.
usage: ancil_general_regrid [-h] [--land-threshold LAND_THRESHOLD]
[--target-lsm TARGET_LSM | --target-grid TARGET_GRID [TARGET_GRID ...]]
--output OUTPUT [--ants-config ANTS_CONFIG]
[--netcdf-only] [--ignore-metadata-read]
[--ignore-metadata-write] [--begin BEGIN]
[--end END] [--search-method {kdtree,spiral}]
[--invert-mask] [--save-ukca]
sources [sources ...]
Positional Arguments#
- sources
Source data path(s).
Additional arguments#
- --land-threshold
Land fraction threshold for converting land fraction (where provided) to a landsea mask.
- --target-lsm
Path to the land sea mask. If provided the file is used to define both the target grid and the land sea mask. The land sea mask is used in the nearest neighbour fill of missing data for land only or ocean only fields.
--target-lsmor--target-gridshould be provided but not both.- --target-grid
Path to the target grid file(s). The grid files can be CAP horizontal namelists, UM vertical namelists or any file type supported by iris.load (NetCDF, pp, Ancillary). If using more than one grid file then separate the file names with a space.
--target-lsmor--target-gridshould be provided but not both.- --output, -o
Output filepath, which must be different from the source input file(s).
- --ants-config
Configuration path. See ants.config
- --netcdf-only
Only write out a netCDF file.
Default:
False- --ignore-metadata-read
Stops the application from searching for metadata files with the same name as the source and loading them alongside the source.
Default:
False- --ignore-metadata-write
Stops the application from writing metadata files alongside outputs.
Default:
False- --begin, -b
Year to start the processing in the format ‘YYYY’ e.g. ‘1990’.
- --end, -e
Year to end the processing in the format ‘YYYY’ e.g. ‘2010’. For a single year of data, this should be the same as the argument given to the
--beginargument.- --search-method
Possible choices: kdtree, spiral
Select the search method used when filling missing points.
Default:
kdtree- --invert-mask
Invert the provided target_mask or not. Using this argument will set it to False. When set to True, treat target mask True (1) values as unmasked. When set to False, treat target mask True (1) values as masked. It is common to use this argument to denote source ocean fields as the landsea mask has True values to denote land.
Default:
True- --save-ukca
Save to a UKCA-specific netCDF file
Default:
False