polaris.tasks.ocean.realistic_global.restart.Restart

class polaris.tasks.ocean.realistic_global.restart.Restart(component, mesh_name: str, init_condition: InitialCondition)[source]

A task that checks that a run continued from a restart reproduces the uninterrupted run, history included, shaped like CIME’s ERS test.

A full_run covers the whole period and writes a restart partway through, along with its history up to that restart in a file of its own. A restart_run continues from that restart to the end of the period, appending its frames to a copy of that history. A validate step then checks that the two histories hold the same frames at the same times and the same state.

Appending is also a regression test for Omega #482, where a continuing run measured its history time axis from its own start rather than the simulation’s, so its first frame collided with the first frame already in the file and silently replaced the earlier frames.

__init__(component, mesh_name: str, init_condition: InitialCondition)[source]

Create the task

Parameters:

  • component (polaris.tasks.ocean.Ocean) – The ocean component that this task belongs to

  • mesh_name (str) – The name of the mesh (e.g. e3sm-qu240)

  • init_condition (InitialCondition) – The source of the model input files, shared by every forward step

Methods

__init__(component, mesh_name, init_condition)

Create the task

add_step([step, subdir, symlink, run_by_default])

Add a step to the task and component (if not already present)

configure()

Modify the configuration options for this task.

remove_step(step)

Remove the given step from this task and the component

set_shared_config(config[, link])

Replace the task's config parser with the shared config parser