row 1.0.0

Row is a command line tool that helps you manage workflows on HPC resources.
Documentation
# submit_options

`action.submit_options`: **table** - sets the cluster-specific submission options. Keys
in `submit_options` must be one of the named clusters defined in
 [`clusters.toml`](../../clusters/index.md).

Example:
```toml
[action.submit_options.cluster1]
account = "my_account"
setup = """
module reset
module load cuda
"""
custom = ["--mail-user=user@example.com"]
partition = "shared"

[action.submit_options.cluster2]
account = "other_account"
setup = "module load openmpi"
output_file_path = "path/to/output"
output_file_name = "{action_name}-%j.out"
```

> [!NOTE]
> You may omit `[submit_options]` entirely.

## `<name>.account`

`action.submit_options.<name>.account`: **string** - Submit jobs to this account on
cluster `<name>`. When you omit `account`, **row** does not add the `--account=` line
to the submission script.

## `<name>.setup`

`action.submit_options.<name>.setup`: **string** - Lines to include in the submission
script on cluster `<name>`. The setup is executed *before* the action's command. You may
omit `setup` to leave this portion of the script blank.

## `<name>.custom`

`action.submit_options.<name>.custom`: **array** of **strings** - List of additional
command line options to pass to the batch submission script on cluster `<name>`. For
example. `custom = ["--mail-user=user@example.com"]` will add the line
```
#SBATCH --mail-user=user@example.com
```
to the top of a SLURM submission script. `custom` defaults to an empty array when
omitted.

## `<name>.partition`

`action.submit_options.<name>.partition`: **string** - Force the use of a particular
partition when submitting jobs to the queue on cluster `<name>`. When omitted, **row**
will automatically determine the correct partition based on the configuration in
[`clusters.toml`](../../clusters/index.md).

> [!TIP]
> You should almost always omit `partition`. Set it *only* when your action
> **requires** a *specialty* partition that is not automatically selected.


## `<name>.output_file_path`
`action.submit_options.<name>.output_file_path`: **string** - Set the directory
in which to place the output file when submitting jobs to the queue on cluster `<name>`.
When omitted, the file will be placed in the scheduler's default location (usually the
location the action is run from).

## `<name>.output_file_name`
`action.submit_options.<name>.output_file_name`: **string** - Set the name of the output
file created when submitting jobs to the queue on cluster `<name>`. The name of the
action can be included in the file name by including '{action_name}' within the
specified string. Additionally, information about the job known to slurm can be
included using certain replacement symbols (c.f. the symbols documented in the
[slurm documentation](https://slurm.schedmd.com/sbatch.html#SECTION_FILENAME-PATTERN)).
When omitted, the file is set to a default value of '{action_name}-%j.out'.