.. _qp_edit:

=======
qp_edit
=======

.. program:: qp_edit


This command reads the content of the |EZFIO| directory and creates a temporary
file containing the data.  The data is presented as a *ReStructured Text* (rst)
document, where each section corresponds to the corresponding |qp| module.  The
content of the file can be modified to change the input parameters.  When the
text editor is closed, the updated data is saved into the |EZFIO| directory.

.. note::
   The text editor which will be opened is defined by the :envvar:`EDITOR`
   environment variable. If this variable is not set, the :command:`vi`
   text editor will be used by default.
   
.. warning::
   When the wave function is too large (more than 10 000 determinants), the
   determinants are not displayed.

Usage
-----

.. code:: bash

   qp_edit [-c|--check] [-h|--help] [-n <int>|--ndet=<int>]
         [-s <range>|--state=<range>] [--] EZFIO_DIR

.. option:: -c, --check

   Checks the input data

.. option:: -h, --help

   Print the help text and exits

.. option:: -n, --ndet=<int>

   Truncates the wavefunction to the target number of determinants

.. option:: -s, --state=<range>

   Select the states to extract from the |EZFIO| directory, using the same conventions
   as :ref:`qp_set_mo_class`. See example below.


Example
-------

.. code:: bash

   qp_edit --state="[1,3-5]" test.ezfio

Removes all states except states 1,3,4 and 5 from :file:`test.ezfio`.  The
resulting |EZFIO| directory has 4 states.