Filename parsing

The plot_file input defines the simulation output directory. Alamo supports time and dimension wildcards, input-variable substitution, and Slurm environment substitution in this value.

Time and dimension wildcards

The following wildcard strings are available:

%Y  Four-digit year
%m  Two-digit month (01-12)
%d  Two-digit day of the month (01-31)
%H  Two-digit hour (00-23)
%M  Two-digit minute (00-59)
%S  Two-digit second (00-59)
%f  Microseconds within the current second
%D  Spatial dimension

For example:

plot_file = output_%Y%m%d_%H%M%S

may resolve to:

output_20250307_211201

Input variable substitution

Use braces to substitute a variable from the input file:

myinput.value = 3
plot_file = output_{myinput.value}

This resolves the output directory to:

output_3

Slurm environment substitution

Any brace-delimited variable whose name begins with SLURM_ is read from the process environment. Common substitutions include:

{SLURM_JOB_ID}
{SLURM_JOB_NAME}
{SLURM_JOB_PARTITION}
{SLURM_CLUSTER_NAME}
{SLURM_ARRAY_TASK_ID}

For example:

plot_file = output_{SLURM_JOB_ID}

may resolve to:

output_314159

If the requested variable is unavailable or empty, its name is retained without braces:

output_SLURM_JOB_ID