polaris.tasks.e3sm.init.topo.remap.RemapTopoStep
- class polaris.tasks.e3sm.init.topo.remap.RemapTopoStep(component, base_mesh_step, combine_topo_step, mask_topo_step, name, subdir, smoothing=False, unsmoothed_topo=None)[source]
A step for remapping topography data such as base elevation and ice sheet properites from a cubed-sphere grid to a global MPAS base mesh.
Note: This step cannot descend from {py:class}`polaris.remap.MappingFileStep` because the soruce mesh is a cubed-sphere grid, which is not currently supported by pyremap.
- Variables:
base_mesh_step (polaris.mesh.spherical.SphericalBaseStep) – The base mesh step containing input files to this step
combine_topo_step (polaris.tasks.e3sm.init.topo.CombineStep) – The step for combining global and Antarctic topography on a cubed sphere grid
mask_topo_step (polaris.tasks.e3sm.init.topo.MaskTopoStep) – The step that applies a mask to a global topography dataset on a cubed sphere grid
smoothing (bool, optional) – Whether smoothing will be applied as part of the remapping
unsmoothed_topo (polaris.tasks.e3sm.init.topo.RemapTopoStep, optional) – A step with unsmoothed topography
expand_distance (float or xarray.DataArray) – The distance to expand the topography mask
expand_factor (float or xarray.DataArray) – The factor to expand the topography mask
do_remapping (bool) – Whether to remap the topography. If False, the step will symlink to the unsmoothed topography file.
- __init__(component, base_mesh_step, combine_topo_step, mask_topo_step, name, subdir, smoothing=False, unsmoothed_topo=None)[source]
Create a new step
- Parameters:
component (polaris.Component) – The component the step belongs to
base_mesh_step (polaris.mesh.spherical.SphericalBaseStep) – The base mesh step containing input files to this step
combine_topo_step (polaris.tasks.e3sm.init.topo.CombineStep) – The step for combining global and Antarctic topography on a cubed sphere grid
mask_topo_step (polaris.tasks.e3sm.init.topo.MaskTopoStep) – The step that applies a mask to a global topography dataset on a cubed sphere grid
name (str) – the name of the step
subdir (str) – the subdirectory for the step
smoothing (bool, optional) – Whether smoothing will be applied as part of the remapping
unsmoothed_topo (polaris.tasks.e3sm.init.topo.RemapTopoStep, optional) – A step with unsmoothed topography
Methods
__init__
(component, base_mesh_step, ...[, ...])Create a new step
add_dependency
(step[, name])Add step as a dependency of this step (i.e. this step can't run until the dependency has finished).
add_input_file
([filename, target, database, ...])Add an input file to the step (but not necessarily to the MPAS model).
add_output_file
(filename[, validate_vars])Add the output file that must be produced by this step and may be made available as an input to steps, perhaps in other tasks.
constrain_resources
(available_resources)Constrain
cpus_per_task
andntasks
based on the number of cores available to this stepdefine_smoothing
(ds_unsmoothed)Define smoothing
expand_distance
andexpand_factor
fields.process_inputs_and_outputs
()Process the inputs to and outputs from a step added with
polaris.Step.add_input_file()
andpolaris.Step.add_output_file()
.run
()Run this step of the test case
runtime_setup
()Update attributes of the step at runtime before calling the
run()
method.set_resources
([cpus_per_task, ...])Update the resources for the subtask.
set_shared_config
(config[, link])Replace the step's config parser with the shared config parser
setup
()Set up the step in the work directory, including downloading any dependencies.
validate_baselines
()Compare variables between output files in this step and in the same step from a baseline run if one was provided.