Running inversions
==================

DUBFI can be started from the command line::

  MPI_WORKERS=2 python3 -m dubfi -c /path/to/config -t /path/to/target/directory

To see more options, use the command line argument :code:`--help`.
This command will use the default linear algebra implementation ("MPI").
This will create two :term:`MPI` worker processes (configured using :code:`MPI_WORKERS=2`) and run the inversion.

When working on an :term:`HPC` system, the :term:`MPI` jobs should usually be invoked explicitly using :code:`mpirun`.
DUBFI works with one main process and multiple worker processes.
Each worker process runs :py:mod:`dubfi.linalg.mpi_worker_main` and awaits instructions from the main process.

When using a job scheduler, you use the following example to write a job script:

.. literalinclude:: ../../examples/jobscript_generic.sh
   :language: sh