File: cli.rst

package info (click to toggle)
qcengine 0.30.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,524 kB
  • sloc: python: 36,452; makefile: 54; sh: 35
file content (94 lines) | stat: -rw-r--r-- 1,865 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
Command Line Interface
======================

QCEngine provides a command line interface with three commands:

* ``qcengine info`` displays information about the environment detected by QCEngine.
* ``qcengine run`` runs a program.
* ``qcengine run-procedure`` runs a procedure.

Info Command
------------

Command Invocation
~~~~~~~~~~~~~~~~~~

.. code-block:: bash

    qcengine info <options>

Command Description
~~~~~~~~~~~~~~~~~~~

This command prints information about the QCEngine environment.

Arguments
~~~~~~~~~

``category``
    The information categories to show. Choices include:

    * ``version``: Print version of QCEngine and QCElemental.
    * ``programs``: Print detected and supported programs.
    * ``procedures``: Print detected and supported procedures.
    * ``config``: Print host, compute, and job configuration
    * ``all``: Print all available information.

    By default, all available information is printed.

Run Command
-----------

Command Invocation
~~~~~~~~~~~~~~~~~~

.. code-block:: bash

    qcengine run <program> <data>

Command Description
~~~~~~~~~~~~~~~~~~~

This command runs a program on a given task and outputs the result as a JSON blob.

Arguments
~~~~~~~~~

``program``
    The program to run.

``data``
    Data describing the task. One of:

    * A JSON blob.
    * A file name.
    * '-', indicating data will be read from STDIN.


Run-Procedure Command
---------------------

Command Invocation
~~~~~~~~~~~~~~~~~~

.. code-block:: bash

    qcengine run-procedure <program> <data>

Command Description
~~~~~~~~~~~~~~~~~~~

This command runs a procedure on a given task and outputs the result as a JSON blob.

Arguments
~~~~~~~~~

``procedure``
    The procedure to run.

``data``
    Data describing the task. One of:

    * A JSON blob.
    * A file name.
    * '-', indicating data will be read from STDIN.