qp2/docs/source/programs/fci.rst

89 lines
2.4 KiB
ReStructuredText

.. _fci:
.. program:: fci
===
fci
===
Selected Full Configuration Interaction with stochastic selection
and PT2.
This program performs a |CIPSI|-like selected |CI| using a
stochastic scheme for both the selection of the important Slater
determinants and the computation of the |PT2| correction. This
|CIPSI|-like algorithm will be performed for the lowest states of
the variational space (see :option:`determinants n_states`). The
|FCI| program will stop when reaching at least one the two following
conditions:
* number of Slater determinants > :option:`determinants n_det_max`
* abs(|PT2|) less than :option:`perturbation pt2_max`
The following other options can be of interest:
:option:`determinants read_wf`
When set to |false|, the program starts with a ROHF-like Slater
determinant as a guess wave function. When set to |true|, the
program starts with the wave function(s) stored in the |EZFIO|
directory as guess wave function(s).
:option:`determinants s2_eig`
When set to |true|, the selection will systematically add all the
necessary Slater determinants in order to have a pure spin wave
function with an |S^2| value corresponding to
:option:`determinants expected_s2`.
For excited states calculations, it is recommended to start with
:ref:`cis` or :ref:`cisd` guess wave functions, eventually in
a restricted set of |MOs|, and to set :option:`determinants s2_eig`
to |true|.
Needs:
.. hlist::
:columns: 3
* :c:data:`psi_coef`
* :c:data:`is_zmq_slave`
* :c:data:`do_pt2`
* :c:data:`mo_two_e_integrals_in_map`
* :c:data:`psi_det`
Calls:
.. hlist::
:columns: 3
* :c:func:`run_cipsi`
* :c:func:`run_stochastic_cipsi`
Touches:
.. hlist::
:columns: 3
* :c:data:`ci_electronic_energy`
* :c:data:`ci_electronic_energy`
* :c:data:`ci_energy`
* :c:data:`ci_electronic_energy`
* :c:data:`n_det`
* :c:data:`n_iter`
* :c:data:`psi_occ_pattern`
* :c:data:`c0_weight`
* :c:data:`psi_coef`
* :c:data:`psi_det_sorted_bit`
* :c:data:`psi_det`
* :c:data:`psi_det_size`
* :c:data:`psi_det_sorted_bit`
* :c:data:`psi_energy`
* :c:data:`psi_occ_pattern`
* :c:data:`psi_energy`
* :c:data:`pt2_stoch_istate`
* :c:data:`state_average_weight`
* :c:data:`threshold_generators`