polaris.ocean.model.OceanIOStep

class polaris.ocean.model.OceanIOStep(component, name, **kwargs)[source]

A step that writes input and/or output files for Omega or MPAS-Ocean

Variables:
  • mpaso_to_omega_dim_map (dict) – A map from MPAS-Ocean dimension names to their Omega equivalents

  • omega_to_mpaso_dim_map (dict) – A map from Omega dimension names to their MPAS-Ocean equivalents, the inverse of mpaso_to_omega_dim_map

  • mpaso_to_omega_var_map (dict) – A map from MPAS-Ocean variable names to their Omega equivalents

  • omega_to_mpaso_var_map (dict) – A map from Omega variable names to their MPAS-Ocean equivalents, the inverse of mpaso_to_omega_var_map

__init__(component, name, **kwargs)[source]

Create a new step

Parameters:
  • component (polaris.Component) – The component the step belongs to

  • name (str) – the name of the task

  • kwargs – keyword arguments passed to polaris.Step()

Methods

__init__(component, name, **kwargs)

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 and ntasks based on the number of cores available to this step

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, **kwargs)

Open the given dataset, mapping variable and dimension names from Omega to MPAS-Ocean names if appropriate

process_inputs_and_outputs()

Process the inputs to and outputs from a step added with polaris.Step.add_input_file() and polaris.Step.add_output_file().

run()

Run the step.

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()

If the ocean model is Omega, set up maps between Omega and MPAS-Ocean variable names

validate_baselines()

Compare variables between output files in this step and in the same step from a baseline run if one was provided.

write_model_dataset(ds, filename)

Write out the given dataset, mapping dimension and variable names from MPAS-Ocean to Omega names if appropriate