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
andntasks
based on the number of cores available to this stepIf 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)
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()
andpolaris.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