motoko.yaml

motoko.yaml is the workflow input file. It declares the task-manager directories and the Python function that will orchestrate them.

Minimal configuration

task_managers:
  task1:
  task2:

orchestrator: orchestrator.main

Detailed configuration

task_managers:
  prepare:
  solve:
    host: zeo://cluster_name:8010
  analyze:

aliases:
  post: analyze

orchestrator: orchestrator.main

generator: slurmCoat
slurm_options:
  - nodes=1

Fields

  • task_managers: Required mapping. Each key is both the task-manager name and the relative directory name containing that task’s BlackDynamite study. Empty values are allowed. A task manager may define host to override the default local ZEO host.

  • orchestrator: Required string in module.function form. Motoko loads module.py from the workflow directory and calls function(workflow, **params).

  • aliases: Optional mapping from alternative workflow attribute names to task-manager names. For example, post: analyze allows workflow.post to access the analyze task manager.

  • generator: Optional BlackDynamite launcher generator, such as bash, Slurm, or PBS.

  • *_options: Optional launcher-specific option lists. Motoko derives the key from the generator name with generator.replace("Coat", "_options") and appends the listed values to the launcher command.