Command line interface

DPGEN2: concurrent learning workflow generating the machine learning potential energy models.

usage: dpgen2 [-h] [-v]
              {submit,resubmit,showkey,status,download,watch,terminate,stop,suspend,delete,retry,resume}
              ...

Named Arguments

-v, --version: show program’s version number and exit

Valid subcommands

command: Possible choices: submit, resubmit, showkey, status, download, watch, terminate, stop, suspend, delete, retry, resume

Sub-commands

submit

Submit DPGEN2 workflow

dpgen2 submit [-h] [-o] CONFIG

Positional Arguments

CONFIG: the config file in json format defining the workflow.

Named Arguments

-o, --old-compatible

compatible with old-style input script used in dpgen2 < 0.0.6.

Default: False

resubmit

Submit DPGEN2 workflow resuing steps from an existing workflow

dpgen2 resubmit [-h] [-l] [-u REUSE [REUSE ...]] [-k] [-o] CONFIG ID

Positional Arguments

CONFIG: the config file in json format defining the workflow.
ID: the ID of the existing workflow.

Named Arguments

-l, --list

list the Steps of the existing workflow.

Default: False

-u, --reuse

specify which Steps to reuse.

-k, --keep-schedule

if set then keep schedule of the old workflow. otherwise use the schedule defined in the input file

Default: False

-o, --old-compatible

compatible with old-style input script used in dpgen2 < 0.0.6.

Default: False

showkey

Print the keys of the successful DPGEN2 steps

dpgen2 showkey [-h] CONFIG ID

Positional Arguments

CONFIG: the config file in json format.
ID: the ID of the existing workflow.

status

Print the status (stage, iteration, convergence) of the DPGEN2 workflow

dpgen2 status [-h] CONFIG ID

Positional Arguments

CONFIG: the config file in json format.
ID: the ID of the existing workflow.

download

Download the artifacts of DPGEN2 steps

dpgen2 download [-h] [-k KEYS [KEYS ...]] [-p PREFIX] [-n] CONFIG ID

Positional Arguments

CONFIG: the config file in json format.
ID: the ID of the existing workflow.

Named Arguments

-k, --keys

the keys of the downloaded steps. If not provided download all artifacts

-p, --prefix

the prefix of the path storing the download artifacts

-n, --no-check-point

if specified, download regardless whether check points exist.

Default: True

watch

Watch a DPGEN2 workflow

dpgen2 watch [-h] [-k KEYS [KEYS ...]] [-f FREQUENCY] [-d] [-p PREFIX] [-n]
             CONFIG ID

Positional Arguments

CONFIG: the config file in json format.
ID: the ID of the existing workflow.

Named Arguments

-k, --keys

the subkey to watch. For example, ‘prep-run-train’ ‘prep-run-lmp’

Default: [‘prep-run-train’, ‘prep-run-lmp’, ‘prep-run-fp’, ‘collect-data’]

-f, --frequency

the frequency of workflow status query. In unit of second

Default: 600.0

-d, --download

whether to download artifacts of a step when it finishes

Default: False

-p, --prefix

the prefix of the path storing the download artifacts

-n, --no-check-point

if specified, download regardless whether check points exist.

Default: True

terminate

Terminate a DPGEN2 workflow.

dpgen2 terminate [-h] CONFIG ID

Positional Arguments

CONFIG: the config file in json format.
ID: the ID of the workflow.

stop

Stop a DPGEN2 workflow.

dpgen2 stop [-h] CONFIG ID

Positional Arguments

CONFIG: the config file in json format.
ID: the ID of the workflow.

suspend

Suspend a DPGEN2 workflow.

dpgen2 suspend [-h] CONFIG ID

Positional Arguments

CONFIG: the config file in json format.
ID: the ID of the workflow.

delete

Delete a DPGEN2 workflow.

dpgen2 delete [-h] CONFIG ID

Positional Arguments

CONFIG: the config file in json format.
ID: the ID of the workflow.

retry

Retry a DPGEN2 workflow.

dpgen2 retry [-h] CONFIG ID

Positional Arguments

CONFIG: the config file in json format.
ID: the ID of the workflow.

resume

Resume a DPGEN2 workflow.

dpgen2 resume [-h] CONFIG ID

Positional Arguments

CONFIG: the config file in json format.
ID: the ID of the workflow.