Working with artifacts

About

This example show a simple use of artifacts. A prolog task named download_clim downloads a climatology to artifact file that is used by the run_model. After the first cycle, the run_model task use an artifact created at the previous cycle.

Path: examples/academic/artifacts.

Configuring

workflow.cfg

[cycles]
begin_date=2020-01-01
end_date=2020-01-02
freq=1D
as_intervals=False

[stages]
    [[prolog]]
    downloads=download_clim
    [[cycles]]
    run=run_croco

tasks.cfg

[download_clim]

    [[content]]
    commandline=echo foo > {{ task.artifacts['clim_file'] }}

    [[artifacts]]
    clim_file={{ run_dir }}/clim.nc

[run_croco]

    [[content]]
    commandline="""
# - get the climatoogy
cp {{ workflow.get_artifact('clim_file', 'download_clim') }} .

{% if not cycle.is_first %}
# - get the restart from previous cycle
echo {{ task.name }} {{ cycle.prev }}
cp {{ workflow.get_artifact('model_restart', task.name, cycle.prev) }} prev_croco_rst.nc
{% endif %}

# - run the model
echo {{ task.name }} {{ cycle }} > {{ task.artifacts['model_restart'] }}
"""

    [[artifacts]]
    model_restart={{ run_dir }}/croco_rst.nc

hosts.cfg

[local]
# default values!

Running

Overview

Let’s have an overview of stages before running the workflow.

$ woom show overview
################################## TASK TREE ###################################
prolog:
    - downloads: download_clim
cycles:
    - run: run_croco
#################################### CYCLES ####################################
2020-01-01T00:00:00+00:00
2020-01-02T00:00:00+00:00
################################### ENSEMBLE ###################################
no member

Dry run

Now let’s run the workflow in test (dry) and debug modes.

$ woom run --log-no-color --log-level debug --dry-run
woom.log    : DEBUG    *** STARTED LOG SESSION ***
woom.cli    : DEBUG    Run the workflow
woom.cli    : DEBUG    Loading extensions
woom.cli    : INFO     No extension to load
woom.cli    : DEBUG    Load workflow config: /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/workflow.cfg
woom.cli    : INFO     Loaded workflow config
woom.cli    : DEBUG    Initialize the host manager
woom.cli    : INFO     Initialized the host manager
woom.cli    : DEBUG    Load hosts config file: hosts.cfg
woom.cli    : INFO     Loaded hosts config file: hosts.cfg
woom.cli    : DEBUG    Infer host
woom.cli    : INFO     Infered host: local
woom.cli    : DEBUG    Initialize the task manager
woom.cli    : INFO     Initialized the task manager
woom.cli    : DEBUG    Load the task config file: tasks.cfg
woom.cli    : INFO     Loaded the task config file: tasks.cfg
woom.cli    : DEBUG    Initialize the workflow
woom.workflow: DEBUG    Task tree:
prolog:
    - downloads: download_clim
cycles:
    - run: run_croco
woom.cli    : INFO     Initialized the workflow
woom.cli    : INFO     Successfully setup the workflow!
woom.cli    : DEBUG    Run the workflow
woom.workflow: DEBUG    Running the workflow in fake mode
woom.workflow: DEBUG    Entering stage: prolog
woom.workflow: DEBUG    Entering sequence: downloads
woom.workflow: DEBUG    Running task: prolog/downloads/download_clim
woom.workflow: DEBUG    Cleaning task: prolog/downloads/download_clim
woom.workflow: DEBUG    Submitting task: prolog/downloads/download_clim
woom.workflow: DEBUG      Dependencies: 
woom.workflow: DEBUG    Creating directory: /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/prolog/download_clim
woom.workflow: INFO     Created directory: /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/prolog/download_clim
woom.job    : INFO     Started job manager: BackgroundJobManager()
woom.workflow: DEBUG    Fake submission:
--------------- submission command ---------------
bash /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/prolog/download_clim/job.sh
-------------- batch script content --------------
#!/bin/bash

# Prolog
set -eo pipefail
on_exit() {
    status=$?
    echo $status > "$WOOM_SUBMISSION_DIR/job.status"
    exit $status
}
trap on_exit EXIT

# Environment variables
export WOOM_TASK_NAME="download_clim"
export WOOM_RUN_DIR="/home/docs/woom/scratch/woom/prolog/download_clim"
export WOOM_APP_NAME=""
export WOOM_APP_CONF=""
export WOOM_APP_EXP=""
export WOOM_CYCLES_BEGIN_DATE="2020-01-01T00:00:00+00:00"
export WOOM_CYCLES_END_DATE="2020-01-02T00:00:00+00:00"
export WOOM_CYCLES_FREQ="1D"
export WOOM_CYCLES_AS_INTERVALS="0"
export WOOM_CYCLES_ROUND=""
export WOOM_CYCLES_NCYCLES="0"
export WOOM_CYCLES_INDEP="0"
export WOOM_APP_PATH=""
export WOOM_TASK_PATH="prolog/download_clim"
export WOOM_NMEMBERS="0"
export WOOM_WORKFLOW_DIR="/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts"
export WOOM_SUBMISSION_DIR="/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/prolog/download_clim"
export WOOM_LOG_DIR="/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/log"
export WOOM_SCRIPT_PATH="/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/prolog/download_clim/job.sh"
export PATH=/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/bin:$PATH
export PYTHONPATH=/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/lib/python:$PYTHONPATH
export LIBRARY_PATH=/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/lib:$LIBRARY_PATH
export INCLUDE_PATH=/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/include:$INCLUDE_PATH

# Go to run dir
mkdir -p /home/docs/woom/scratch/woom/prolog/download_clim && cd /home/docs/woom/scratch/woom/prolog/download_clim

# Run the commandline(s)
echo foo > /home/docs/woom/scratch/woom/prolog/download_clim/clim.nc

# Check artifacts
test -f "/home/docs/woom/scratch/woom/prolog/download_clim/clim.nc" || { echo artifact clim_file="/home/docs/woom/scratch/woom/prolog/download_clim/clim.nc"; exit 1; }
------------------- artifacts --------------------
clim_file: /home/docs/woom/scratch/woom/prolog/download_clim/clim.nc
--------------------------------------------------
woom.workflow: INFO     Submitted task: prolog/downloads/download_clim with job id 622703
woom.workflow: INFO     Successfully submitted stage: prolog
woom.workflow: DEBUG    Entering stage: cycles
woom.workflow: INFO     Cycling on dates from 2020-01-01 00:00:00+00:00 to 2020-01-02 00:00:00+00:00 in 2 time(s)
woom.workflow: DEBUG    Running cycle: 2020-01-01T00:00:00+00:00
woom.workflow: DEBUG    Entering sequence: run
woom.workflow: DEBUG    Running task: cycles/run/run_croco
woom.workflow: DEBUG    Cleaning task: cycles/run/run_croco
woom.workflow: DEBUG    Submitting task: cycles/run/run_croco
woom.workflow: DEBUG      Dependencies: 622703
woom.workflow: DEBUG    Creating directory: /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-01T00:00:00+00:00/run_croco
woom.workflow: INFO     Created directory: /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-01T00:00:00+00:00/run_croco
woom.workflow: DEBUG    Fake submission:
--------------- submission command ---------------
bash /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-01T00:00:00+00:00/run_croco/job.sh
-------------- batch script content --------------
#!/bin/bash

# Prolog
set -eo pipefail
on_exit() {
    status=$?
    echo $status > "$WOOM_SUBMISSION_DIR/job.status"
    exit $status
}
trap on_exit EXIT

# Environment variables
export WOOM_TASK_NAME="run_croco"
export WOOM_RUN_DIR="/home/docs/woom/scratch/woom/2020-01-01T00:00:00+00:00/run_croco"
export WOOM_APP_NAME=""
export WOOM_APP_CONF=""
export WOOM_APP_EXP=""
export WOOM_CYCLES_BEGIN_DATE="2020-01-01T00:00:00+00:00"
export WOOM_CYCLES_END_DATE="2020-01-02T00:00:00+00:00"
export WOOM_CYCLES_FREQ="1D"
export WOOM_CYCLES_AS_INTERVALS="0"
export WOOM_CYCLES_ROUND=""
export WOOM_CYCLES_NCYCLES="0"
export WOOM_CYCLES_INDEP="0"
export WOOM_APP_PATH=""
export WOOM_TASK_PATH="2020-01-01T00:00:00+00:00/run_croco"
export WOOM_CYCLE="2020-01-01T00:00:00+00:00"
export WOOM_CYCLE_BEGIN_DATE="2020-01-01T00:00:00+00:00"
export WOOM_CYCLE_LABEL="2020-01-01T00:00:00+00:00"
export WOOM_CYCLE_TOKEN="2020-01-01T00:00:00+00:00"
export WOOM_CYCLE_DATE="2020-01-01T00:00:00+00:00"
export WOOM_CYCLE_IS_FIRST="1"
export WOOM_CYCLE_IS_LAST="0"
export WOOM_CYCLE_NEXT="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_PREV=""
export WOOM_CYCLE_BEGIN_DATE_NEXT="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_LABEL_NEXT="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_TOKEN_NEXT="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_DATE_NEXT="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_IS_FIRST_NEXT="0"
export WOOM_CYCLE_IS_LAST_NEXT="1"
export WOOM_CYCLE_NEXT_NEXT=""
export WOOM_CYCLE_PREV_NEXT="2020-01-01T00:00:00+00:00"
export WOOM_NMEMBERS="0"
export WOOM_WORKFLOW_DIR="/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts"
export WOOM_SUBMISSION_DIR="/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-01T00:00:00+00:00/run_croco"
export WOOM_LOG_DIR="/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/log"
export WOOM_SCRIPT_PATH="/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-01T00:00:00+00:00/run_croco/job.sh"
export PATH=/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/bin:$PATH
export PYTHONPATH=/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/lib/python:$PYTHONPATH
export LIBRARY_PATH=/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/lib:$LIBRARY_PATH
export INCLUDE_PATH=/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/include:$INCLUDE_PATH

# Go to run dir
mkdir -p /home/docs/woom/scratch/woom/2020-01-01T00:00:00+00:00/run_croco && cd /home/docs/woom/scratch/woom/2020-01-01T00:00:00+00:00/run_croco

# Run the commandline(s)

# - get the climatoogy
cp /home/docs/woom/scratch/woom/download_clim/clim.nc .


# - run the model
echo run_croco 2020-01-01T00:00:00+00:00 > /home/docs/woom/scratch/woom/2020-01-01T00:00:00+00:00/run_croco/croco_rst.nc


# Check artifacts
test -f "/home/docs/woom/scratch/woom/2020-01-01T00:00:00+00:00/run_croco/croco_rst.nc" || { echo artifact model_restart="/home/docs/woom/scratch/woom/2020-01-01T00:00:00+00:00/run_croco/croco_rst.nc"; exit 1; }
------------------- artifacts --------------------
model_restart: /home/docs/woom/scratch/woom/2020-01-01T00:00:00+00:00/run_croco/croco_rst.nc
--------------------------------------------------
woom.workflow: INFO     Submitted task: cycles/run/run_croco with job id 858928 depending on [622703]
woom.workflow: INFO     Successfully submitted cycle: 2020-01-01T00:00:00+00:00
woom.workflow: DEBUG    Running cycle: 2020-01-02T00:00:00+00:00
woom.workflow: DEBUG    Entering sequence: run
woom.workflow: DEBUG    Running task: cycles/run/run_croco
woom.workflow: DEBUG    Cleaning task: cycles/run/run_croco
woom.workflow: DEBUG    Submitting task: cycles/run/run_croco
woom.workflow: DEBUG      Dependencies: 858928
woom.workflow: DEBUG    Creating directory: /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-02T00:00:00+00:00/run_croco
woom.workflow: INFO     Created directory: /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-02T00:00:00+00:00/run_croco
woom.workflow: DEBUG    Fake submission:
--------------- submission command ---------------
bash /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-02T00:00:00+00:00/run_croco/job.sh
-------------- batch script content --------------
#!/bin/bash

# Prolog
set -eo pipefail
on_exit() {
    status=$?
    echo $status > "$WOOM_SUBMISSION_DIR/job.status"
    exit $status
}
trap on_exit EXIT

# Environment variables
export WOOM_TASK_NAME="run_croco"
export WOOM_RUN_DIR="/home/docs/woom/scratch/woom/2020-01-02T00:00:00+00:00/run_croco"
export WOOM_APP_NAME=""
export WOOM_APP_CONF=""
export WOOM_APP_EXP=""
export WOOM_CYCLES_BEGIN_DATE="2020-01-01T00:00:00+00:00"
export WOOM_CYCLES_END_DATE="2020-01-02T00:00:00+00:00"
export WOOM_CYCLES_FREQ="1D"
export WOOM_CYCLES_AS_INTERVALS="0"
export WOOM_CYCLES_ROUND=""
export WOOM_CYCLES_NCYCLES="0"
export WOOM_CYCLES_INDEP="0"
export WOOM_APP_PATH=""
export WOOM_TASK_PATH="2020-01-02T00:00:00+00:00/run_croco"
export WOOM_CYCLE="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_BEGIN_DATE="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_LABEL="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_TOKEN="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_DATE="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_IS_FIRST="0"
export WOOM_CYCLE_IS_LAST="1"
export WOOM_CYCLE_NEXT=""
export WOOM_CYCLE_PREV="2020-01-01T00:00:00+00:00"
export WOOM_CYCLE_BEGIN_DATE_NEXT="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_LABEL_NEXT="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_TOKEN_NEXT="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_DATE_NEXT="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_IS_FIRST_NEXT="0"
export WOOM_CYCLE_IS_LAST_NEXT="1"
export WOOM_CYCLE_NEXT_NEXT=""
export WOOM_CYCLE_PREV_NEXT="2020-01-01T00:00:00+00:00"
export WOOM_NMEMBERS="0"
export WOOM_WORKFLOW_DIR="/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts"
export WOOM_SUBMISSION_DIR="/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-02T00:00:00+00:00/run_croco"
export WOOM_LOG_DIR="/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/log"
export WOOM_SCRIPT_PATH="/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-02T00:00:00+00:00/run_croco/job.sh"
export WOOM_CYCLE_BEGIN_DATE_PREV="2020-01-01T00:00:00+00:00"
export WOOM_CYCLE_LABEL_PREV="2020-01-01T00:00:00+00:00"
export WOOM_CYCLE_TOKEN_PREV="2020-01-01T00:00:00+00:00"
export WOOM_CYCLE_DATE_PREV="2020-01-01T00:00:00+00:00"
export WOOM_CYCLE_IS_FIRST_PREV="1"
export WOOM_CYCLE_IS_LAST_PREV="0"
export WOOM_CYCLE_NEXT_PREV="2020-01-02T00:00:00+00:00"
export WOOM_CYCLE_PREV_PREV=""
export PATH=/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/bin:/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/bin:$PATH
export PYTHONPATH=/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/lib/python:/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/lib/python:$PYTHONPATH
export LIBRARY_PATH=/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/lib:/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/lib:$LIBRARY_PATH
export INCLUDE_PATH=/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/include:/home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/include:$INCLUDE_PATH

# Go to run dir
mkdir -p /home/docs/woom/scratch/woom/2020-01-02T00:00:00+00:00/run_croco && cd /home/docs/woom/scratch/woom/2020-01-02T00:00:00+00:00/run_croco

# Run the commandline(s)

# - get the climatoogy
cp /home/docs/woom/scratch/woom/download_clim/clim.nc .

# - get the restart from previous cycle
echo run_croco 2020-01-01T00:00:00+00:00
cp /home/docs/woom/scratch/woom/2020-01-01T00:00:00+00:00/run_croco/croco_rst.nc prev_croco_rst.nc

# - run the model
echo run_croco 2020-01-02T00:00:00+00:00 > /home/docs/woom/scratch/woom/2020-01-02T00:00:00+00:00/run_croco/croco_rst.nc


# Check artifacts
test -f "/home/docs/woom/scratch/woom/2020-01-02T00:00:00+00:00/run_croco/croco_rst.nc" || { echo artifact model_restart="/home/docs/woom/scratch/woom/2020-01-02T00:00:00+00:00/run_croco/croco_rst.nc"; exit 1; }
------------------- artifacts --------------------
model_restart: /home/docs/woom/scratch/woom/2020-01-02T00:00:00+00:00/run_croco/croco_rst.nc
--------------------------------------------------
woom.workflow: INFO     Submitted task: cycles/run/run_croco with job id 151167 depending on [858928]
woom.workflow: INFO     Successfully submitted cycle: 2020-01-02T00:00:00+00:00
woom.workflow: DEBUG    Entering stage: epilog
woom.workflow: DEBUG    No sequence of task. Skipping...
woom.cli    : INFO     Successfully ran the workflow!

Normal run

And finally in run it.

$ woom run --log-no-color
woom.cli    : INFO     No extension to load
woom.cli    : INFO     Loaded workflow config
woom.cli    : INFO     Initialized the host manager
woom.cli    : INFO     Loaded hosts config file: hosts.cfg
woom.cli    : INFO     Infered host: local
woom.cli    : INFO     Initialized the task manager
woom.cli    : INFO     Loaded the task config file: tasks.cfg
woom.cli    : INFO     Initialized the workflow
woom.cli    : INFO     Successfully setup the workflow!
woom.workflow: INFO     Created directory: /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/prolog/download_clim
woom.workflow: INFO     Created batch script: /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/prolog/download_clim/job.sh
woom.job    : INFO     Started job manager: BackgroundJobManager()
woom.workflow: INFO     Submitted task: prolog/downloads/download_clim with job id 791
woom.workflow: INFO     Successfully submitted stage: prolog
woom.workflow: INFO     Cycling on dates from 2020-01-01 00:00:00+00:00 to 2020-01-02 00:00:00+00:00 in 2 time(s)
woom.workflow: INFO     Created directory: /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-01T00:00:00+00:00/run_croco
woom.workflow: INFO     Created batch script: /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-01T00:00:00+00:00/run_croco/job.sh
woom.workflow: INFO     Submitted task: cycles/run/run_croco with job id 793 depending on [791]
woom.workflow: INFO     Successfully submitted cycle: 2020-01-01T00:00:00+00:00
woom.workflow: INFO     Created directory: /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-02T00:00:00+00:00/run_croco
woom.workflow: INFO     Created batch script: /home/docs/checkouts/readthedocs.org/user_builds/woom/checkouts/v2025.10.1/examples/academic/artifacts/jobs/2020-01-02T00:00:00+00:00/run_croco/job.sh
woom.job    : ERROR    Finished with exit status: 1
woom.job    : ERROR    Can't submit job because one of the parent job failed: 793
woom.cli    : ERROR    Workflow failed: Task submission aborted: cycles/run/run_croco. Stopping workflow...
Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/woom/envs/v2025.10.1/lib/python3.11/site-packages/woom/cli.py", line 353, in main_run
    workflow.run(dry=args.dry_run, update=args.update)
  File "/home/docs/checkouts/readthedocs.org/user_builds/woom/envs/v2025.10.1/lib/python3.11/site-packages/woom/workflow.py", line 618, in run
    raise WorkFlowError(
woom.workflow.WorkFlowError: Task submission aborted: cycles/run/run_croco. Stopping workflow...

Check status

Check what is running or finished.

$ woom show status
╭──────────────┬─────────┬───────────────┬───────────────────────────┬──────────────────────────────────────────╮
│ STATUS       │ JOBID   │ TASK          │ CYCLE                     │ SUBMISSION DIR                           │
├──────────────┼─────────┼───────────────┼───────────────────────────┼──────────────────────────────────────────┤
│ SUCCESS      │ 791     │ download_clim │ prolog                    │ jobs/prolog/download_clim                │
│ ERROR        │ 793     │ run_croco     │ 2020-01-01T00:00:00+00:00 │ jobs/2020-01-01T00:00:00+00:00/run_croco │
│ NOTSUBMITTED │         │ run_croco     │ 2020-01-02T00:00:00+00:00 │ jobs/2020-01-02T00:00:00+00:00/run_croco │
╰──────────────┴─────────┴───────────────┴───────────────────────────┴──────────────────────────────────────────╯

Show run directories

Show where tasks were executed.

$ woom show run_dirs
╭───────────────┬───────────────────────────┬──────────────────────────────────────────────────────────────────╮
│ TASK          │ CYCLE                     │ RUN DIR                                                          │
├───────────────┼───────────────────────────┼──────────────────────────────────────────────────────────────────┤
│ download_clim │ prolog                    │ /home/docs/woom/scratch/woom/prolog/download_clim                │
│ run_croco     │ 2020-01-01T00:00:00+00:00 │ /home/docs/woom/scratch/woom/2020-01-01T00:00:00+00:00/run_croco │
│ run_croco     │ 2020-01-02T00:00:00+00:00 │ /home/docs/woom/scratch/woom/2020-01-02T00:00:00+00:00/run_croco │
╰───────────────┴───────────────────────────┴──────────────────────────────────────────────────────────────────╯

Show artifacts

Show artifacts, either generated or expected.

$ woom show artifacts
╭───────────────┬───────────────┬───────────────────────────────────────────────────────────────────────────────┬───────────╮
│ TASK          │ ARTIFACT      │ PATH                                                                          │ EXISTS?   │
├───────────────┼───────────────┼───────────────────────────────────────────────────────────────────────────────┼───────────┤
│ download_clim │ clim_file     │ /home/docs/woom/scratch/woom/prolog/download_clim/clim.nc                     │ False     │
│ run_croco     │ model_restart │ /home/docs/woom/scratch/woom/2020-01-01T00:00:00+00:00/run_croco/croco_rst.nc │ False     │
│ run_croco     │ model_restart │ /home/docs/woom/scratch/woom/2020-01-02T00:00:00+00:00/run_croco/croco_rst.nc │ False     │
╰───────────────┴───────────────┴───────────────────────────────────────────────────────────────────────────────┴───────────╯