polaris.remap.MappingFileStep

class polaris.remap.MappingFileStep(component, name, subdir=None, indir=None, ntasks=None, min_tasks=None, map_filename=None, method='bilinear')[source]

A step for creating a mapping file between grids

Variables:

remapper (pyremap.Remapper) – An object for creating a mapping file and remapping data between grids

__init__(component, name, subdir=None, indir=None, ntasks=None, min_tasks=None, map_filename=None, method='bilinear')[source]

Create a new step

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

  • name (str) – the name of the step

  • subdir (str, optional) –

    the subdirectory for the step. If neither this nor indir

    are provided, the directory is the name

  • indir (str, optional) – the directory the step is in, to which name will be appended

  • ntasks (int, optional) – the target number of MPI tasks the step would ideally use

  • min_tasks (int, optional) – the number of MPI tasks the step requires

  • map_filename (str, optional) – The name of the output mapping file, map_{source_type}_{dest_type}_{method}.nc by default

  • method ({'bilinear', 'neareststod', 'conserve'}, optional) – The method of interpolation used

Methods

__init__(component, name[, subdir, indir, ...])

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

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

Create the mappping file

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

Set up the task in the work directory, including downloading any dependencies.

validate_baselines()

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