Configuration file#

Configurable settings that can be set within the configuration file are listed here.

Default config file#

configs:
  default:
    invocation:
      environment_setup:
      match: {}
    config:
      machine: HOSTNAME
      log_file_path: logs/MatFlow_v0.3.0a135.log
      environment_sources: []
      task_schema_sources: []
      command_file_sources: []
      parameter_sources: []
      default_scheduler: direct
      default_shell: bash
      schedulers:
        direct:
          defaults: {}
      shells:
        bash:
          defaults: {}

Validation schema#

The configuration file must conform to the following validation schema.

configs#

A mapping of string config "invocation keys" to configuration settings.

[map-value]#

invocation#

match#
environment_setup#

config#

user_orcid#
user_name#
user_affiliation#
task_schema_sources#
shells#
[map-value]#
defaults#
os_args#
executable#
WSL_user#
WSL_executable#
WSL_distribution#
wsl+bash#
wsl#
powershell#
bash#
schedulers#
[map-value]#
partitions#
parallel_environments#
defaults#
submit_cmd#
show_cmd#
shebang_args#
options#
js_cmd#
del_cmd#
cwd_switch#
array_switch#
array_item_var#
slurm#
partitions#
[map-value]#
parallel_modes#
num_nodes#
num_cores_per_node#
num_cores#
sge#
parallel_environments#
[map-value]#
parallel_modes#
num_nodes#
num_cores#
direct_posix#
direct#
parameter_sources#
machine#

A label that references the current machine. By default, this uses the return from the Python function socket.gethostname().

log_file_path#

File path to the app log file. The variables <<app_name>> and <<app_version>> are available to be used in this option, which resolve to the app name and version, respectively.

The file path may be nested in non-existent directories, in which case those directories will be generated. If specified as a relative path, the path will be resolved relative to the config directory (the directory that contains the config file).

log_file_level#
log_console_level#
linux_release_file#
environment_sources#
demo_data_manifest_file#

If provided, this will be used as the path to the manifest for the built-in example data files. It should point to a JSON file whose top-level keys are example data file names. Each value should be an empty map/dict or a map like: {"in_zip": "text_file.zip"}, where text_file.zip is the name of a zip archive that contains the example data file. This can be a local path or an fsspec URL.

demo_data_dir#

If provided, this will be used as the path to the directory containing demo data files. This can be a local path or an fsspec URL.

default_shell#
default_scheduler#
command_file_sources#