compass.ocean.mesh.cull.CullMeshStep

class compass.ocean.mesh.cull.CullMeshStep(test_case, base_mesh_step, with_ice_shelf_cavities, name='cull_mesh', subdir=None, do_inject_bathymetry=False, preserve_floodplain=False, remap_topography=None)

A step for culling a global MPAS-Ocean mesh

Variables:

• base_mesh_step (compass.mesh.spherical.SphericalBaseStep) – The base mesh step containing input files to this step

• with_ice_shelf_cavities (bool) – Whether the mesh includes ice-shelf cavities

• do_inject_bathymetry (bool) – Whether to interpolate bathymetry from a data file so it can be used as a culling criteria

• preserve_floodplain (bool) – Whether to leave land cells in the mesh based on bathymetry specified by do_inject_bathymetry

• remap_topography (compass.ocean.mesh.remap_topography.RemapTopography) – A step for remapping topography. If provided, the remapped topography is used to determine the land mask

__init__(test_case, base_mesh_step, with_ice_shelf_cavities, name='cull_mesh', subdir=None, do_inject_bathymetry=False, preserve_floodplain=False, remap_topography=None)

Create a new step

Parameters:

• test_case (compass.ocean.tests.global_ocean.mesh.Mesh) – The test case this step belongs to

• base_mesh_step (compass.mesh.spherical.SphericalBaseStep) – The base mesh step containing input files to this step

• with_ice_shelf_cavities (bool) – Whether the mesh includes ice-shelf cavities

• name (str, optional) – the name of the step

• subdir (str, optional) – the subdirectory for the step. The default is name

• do_inject_bathymetry (bool, optional) – Whether to interpolate bathymetry from a data file so it can be used as a culling criteria

• preserve_floodplain (bool, optional) – Whether to leave land cells in the mesh based on bathymetry specified by do_inject_bathymetry

• remap_topography (compass.ocean.mesh.remap_topography.RemapTopography, optional) – A step for remapping topography. If provided, the remapped topography is used to determine the land mask

Methods

__init__(test_case, base_mesh_step, ...[, ...])	Create a new step
add_input_file([filename, target, database, ...])	Add an input file to the step (but not necessarily to the MPAS model).
add_model_as_input()	make a link to the model executable and add it to the inputs
add_namelist_file(package, namelist[, ...])	Add a file with updates to namelist options to the step to be parsed when generating a complete namelist file if and when the step gets set up.
add_namelist_options(options[, out_name, mode])	Add the namelist replacements to be parsed when generating a namelist file if and when the step gets set up.
add_output_file(filename)	Add the output file that must be produced by this step and may be made available as an input to steps, perhaps in other test cases.
add_streams_file(package, streams[, ...])	Add a streams file to the step to be parsed when generating a complete streams file if and when the step gets set up.
constrain_resources(available_resources)	Constrain cpus_per_task and ntasks based on the number of cores available to this step
process_inputs_and_outputs()	Process the inputs to and outputs from a step added with compass.Step.add_input_file() and compass.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.
setup()	Set up the test case in the work directory, including downloading any dependencies.
update_namelist_at_runtime(options[, out_name])	Update an existing namelist file with additional options.
update_namelist_pio([out_name])	Modify the namelist so the number of PIO tasks and the stride between them consistent with the number of nodes and cores (one PIO task per node).
update_streams_at_runtime(package, streams, ...)	Update the streams files during the run phase of this step using the given template and replacements.