polaris.tasks.ocean.merry_go_round.default.viz.Viz
- class polaris.tasks.ocean.merry_go_round.default.viz.Viz(component, dependencies, taskdir)[source]
A step for visualizing the output of the default merry-go-round test case
- __init__(component, dependencies, taskdir)[source]
Create the step
- Parameters:
component (polaris.Component) – The component the step belongs to
dependencies (dict of polaris.steps) –
the dependencies of this step must be given as separate keys in the dict:
- meshpolaris.step
must have the attribute path, the path to base_mesh.nc for the default resolution
- initpolaris.step
must have the attribute path, the path to initial_state.nc for the default resolution
- forwarddict of polaris.steps
must have the attribute path, the path to forward.nc for the default resolution
taskdir (str) – The subdirectory that the task belongs to
Methods
__init__(component, dependencies, taskdir)Create the 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_horiz_mesh_input_file(**kwargs)Add the horizontal-mesh input file using a placeholder that is resolved to the configured filename at
process_inputs_and_outputs()time.add_init_input_file(**kwargs)Add the initial-condition input file using a placeholder that is resolved to the configured filename at
process_inputs_and_outputs()time.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.
add_output_files_for_ocean_model_input([...])Register output files that will be consumed by the ocean model as inputs (horizontal mesh, initial condition, and model-specific files).
add_vert_coord_input_file([filename])Add the vertical-coordinate input file.
check_properties()This method should be overridden to check properties of step outputs
constrain_resources(available_resources)Constrain
cpus_per_taskandntasksbased on the number of cores available to this stepget_horiz_mesh_filename()Get the configured local filename for the horizontal mesh file.
get_init_filename()Get the configured local filename for the initial-condition file.
get_vert_coord_filename()Get the configured local filename for the vertical coordinate file.
map_from_native_model_vars(ds)If the model is Omega, rename dimensions and variables in a dataset from their Omega names to the MPAS-Ocean equivalent (appropriate for datasets that are output from the model)
map_to_native_model_vars(ds)If the model is Omega, rename dimensions and variables in a dataset from their MPAS-Ocean names to the Omega equivalent (appropriate for input datasets like an initial condition)
open_model_dataset(filename, config, **kwargs)Open the given dataset, mapping variable and dimension names from Omega to MPAS-Ocean names if appropriate
open_vert_coord_dataset(ds_init[, ...])Return the dataset containing vertical-coordinate variables (
bottomDepth,minLevelCell,maxLevelCell,vertCoordMovementWeightsand eitherrestingThicknessorRefPseudoThickness).process_inputs_and_outputs()Resolve
<<<placeholder>>>filenames to configured names and drop<<<vert_coord>>>entries for MPAS-Ocean before delegating to the baseStepprocessing.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()Add input files, which are dependent on the config options values
validate_baselines()Compare variables between output files in this step and in the same step from a baseline run if one was provided.
write_horiz_mesh_dataset(ds, filename, config)Write a horizontal mesh dataset, validating that all expected mesh variables are present before writing.
write_initial_state_dataset(ds, filename, config)Write an initial-state dataset, omitting horizontal mesh fields and (for Omega) vertical coordinate fields.
write_model_dataset(ds, filename, config)Write out the given dataset, mapping dimension and variable names from MPAS-Ocean to Omega names if appropriate
write_vert_coord_dataset(ds, filename, config)Write a vertical-coordinate dataset for Omega's
InitialVertCoordstream.Attributes
componentconfiginput_data