polaris.setup.setup_tasks

polaris.setup.setup_tasks(work_dir, task_list=None, numbers=None, config_file=None, machine=None, baseline_dir=None, component_path=None, suite_name='custom', cached=None, copy_executable=False, clean=False)

Set up one or more tasks

Parameters

• work_dir (str) – A directory that will serve as the base for creating task directories

• task_list (list of str, optional) – Relative paths for a tasks to set up

• numbers (list of str, optional) – Task numbers to setup, as listed from polaris list, optionally with a suffix c to indicate that all steps in that task should be cached

• config_file ({str, None}, optional) – Configuration file with custom options for setting up and running tasks

• machine (str, optional) – The name of one of the machines with defined config options, which can be listed with polaris list --machines

• baseline_dir (str, optional) – Location of baselines that can be compared to

• component_path (str, optional) – The relative or absolute path to the location where the model and default namelists have been built

• suite_name (str, optional) – The name of the suite if tasks are being set up through a suite or 'custom' if not

• cached (list of list of str, optional) – For each task in tasks, which steps (if any) should be cached, or a list with “_all” as the first entry if all steps in the task should be cached

• copy_executable (bool, optional) – Whether to copy the model executable to the work directory

• clean (bool, optional) – Whether to delete the contents of the base work directory before setting up tasks

Returns

tasks (dict of polaris.Task) – A dictionary of tasks, with the relative path in the work directory as keys