Provided by: psi3_3.4.0-6ubuntu1_amd64 bug

NAME

       ccenergy - Coupled cluster singles and doubles energy program

DESCRIPTION

       The  program  ccenergy solves the coupled cluster singles and doubles amplitude equations.
       This code will work for spin-restricted closed-shell Hartree-Fock  (RHF),  spin-restricted
       open-shell  Hartree-Fock  (ROHF),  spin-unrestricted  Hartree-Fock  (UHF),  and  Brueckner
       references.  The algorithm makes use of spatial  symmetry  (D2h  and  its  subgroups)  and
       matrix  algebra  techniques  for  efficiency.   In  addition,  the  program can be used to
       simulate local correlation methods.

REFERENCES

       1.     An introduction to coupled cluster theory for computational chemists, T.D. Crawford
              and H.F. Schaefer, Rev. Comp. Chem.  14 33-136 (2000).

       2.     A  direct  product  decomposition  approach  for symmetry exploitation in many-body
              methods. I. Energy calculations, J.F. Stanton,  J.  Gauss,  J.D.  Watts,  and  R.J.
              Bartlett, J. Chem. Phys.  94 4334 (1991).

INPUT FORMAT

       Input for this program is read from the file input.dat.  The following keywords are valid:

       WFN = string
              Specifies  the  type  of  coupled  cluster  calculation  desired.  Valid entries at
              present are CCSD, CCSD_T, BCCD, and BCCD_T.  There is no default.

       REFERENCE = string
              Specifies the type of orbitals used for the single-determinant reference  function.
              Valied entries at present are RHF, UHF, and ROHF.  There is no default.

       MEMORY = (real MB)
              The maximum amount of core memory to be used, in megabytes.  See also the CACHETYPE
              and CACHELEV keywords below.

       CONVERGENCE = integer
              Convergence desired on the CC amplitudes.  Convergence is achieved when the RMS  of
              the error in the CC wave function is less than 10**(-n).  The default is 7.

       BRUECKNER_CONV = integer
              Convergence  desired for the orbitals in Brueckner-CC calculations.  Convergence is
              achieved when the largest absolute value of a single T1 ampltiudes is is less  than
              10**(-n).  The default is 5.

       MAXITER = integer
              Maximum  number  of iterations to solve the coupled cluster equations.  Defaults to
              50.

       FREEZE_CORE = string
              Specifes whether core orbitals should  be  automatically  frozen  in  the  CC  wave
              function.   If  this  option is set (preferably in the "default" section of input),
              then the cscf program will identify the core orbitals.  Subsequent  codes  starting
              with  transqt will freeze these orbitals.  Note that this keyword usually makes the
              additional specification of FROZEN_DOCC unnecessary, but it may still  be  required
              in  some  special  cases.  Allowed values are true, false, yes, no, 1, 0, large and
              small.

       FROZEN_DOCC = integer_array
              The  number  of  lowest  energy  doubly  occupied  orbitals  in  each   irreducible
              representation from which there will be no excitations.  The Cotton ordering of the
              irredicible representations is used.  The default is the  zero  vector.   NB:  This
              keyword  is  actually  read  by the integral transformation program transqt and the
              integral sorting program ccsort.  See also the FREEZE_CORE keyword.

       FROZEN_UOCC = integer_vector
              The number of highest energy unoccupied orbitals in each irreducible representation
              into which there will be no excitations.  The default is the zero vector.  NB: This
              keyword is actually read by the integral transformation  program  transqt  and  the
              integral sorting program ccsort.

       PRINT = integer
              Determines  the  verbosity  of  the  output.   A value of 0 (the default) specifies
              minimal printing and a value of 2 will give output updates as each term of  the  CC
              equations is complete.  No other values have yet been used.

       NUM_AMPS = integer
              Specifies  the number of largest T1 and T2 amplitudes to print at the end of the CC
              procedure.  Default is 10.

       PRINT_MP2_AMPS = boolean
              Indicates if the MP2 amplitudes  (which  are  starting  guesses  for  RHF  and  UHF
              reference functions) should be printed.  Default is false.

       RESTART = boolean
              Allows  the  program to use old T1 and T2 vectors from previous calculations as the
              initial guesses for a new calculation.  This is particularly  useful  for  geometry
              optimizations.   The  default is TRUE.  NB: The ability to restart a calculation is
              also controlled by the phases of the molecular orbitals.  If  the  parameter  PHASE
              from  the  chkpt file (cf. libchkpt) is set to FALSE, then the user's RESTART input
              will be ignored.  This behavior can be overridden, however with  the  FORCE_RESTART
              option.

       FORCE_RESTART= boolean
              Forces  possible  restart  of  the CC equations from previous T1 and T2 amplitudes.
              This option should be used only by experts.

       AO_BASIS= string
              Compute contributions from four virtual-index integrals, <ab|cd>, from the  atomic-
              orbital  basis  integrals.  This option slows the calculation somewhat, but greatly
              reduces disk-space requirements.  Allowed values are NONE (default), DISK (use  the
              AO-basis  integrals  stored  on  disk),  or  DIRECT  (use  cints to compute the AO-
              integrals  on  the  fly  in  each  CC  iteration).   The  DIRECT  option  is  still
              experimental and should be used only by experts.

       CACHETYPE= string
              Selects  the  priority  type for maintaining the automatic memory cache used by the
              DPD codes.  (See libdpd.html for further details.)  A value of  LOW  (the  default)
              selects  a  "low  priority" scheme in which the deletion of items from the cache is
              based on pre-programmed priorities.  A value of LRU selects a "least recently used"
              scheme in which the oldest item in the cache will be the first one deleted.

       CACHELEV= integer
              Selects  the  level  of  automatic  cacheing  desired  in  the  storage  of various
              amplitudes, integrals, and intermediates in the coupled cluster procedure.  A value
              of  0  retains  no  quantities  in  cache, while a level of 6 attempts to store all
              quantities in cache.  For particularly large calculations, a value of  0  may  help
              with  certain  types  of  memory  problems.  The default is 2, which means that all
              four-index  quantites  with  up  to  two  virtual-orbital  indices  (e.g.,  <ij|ab>
              integrals) may be held in the cache.

       DIIS= boolean
              Selects  the use of the direct-inversion in the iterative subspace (DIIS) technique
              of Pulay for convergence acceleration.  The default is TRUE.

       LOCAL= boolean
              Simluate the effects of local correlation techniques.  The default is FALSE.

       LOCAL_CUTOFF= real
              The  tolerance  value  (always  between  one  and  zero)  for  the  Broughton-Pulay
              completeness check used to contruct orbital domains for local-CC calculations.  The
              default is 0.02.  See J. Broughton and P. Pulay, J. Comp. Chem. 14, 736-740  (1993)
              and C. Hampel and H.-J. Werner, J. Chem. Phys. 104, 6286-6297 (1996).

       LOCAL_METHOD= string
              Selects  the  type  of local-CCSD scheme to be simulated.  Valid entries are WERNER
              for the method develop by H.-J. Werner and co-workers or  AOBASIS  for  the  method
              developed  by G.E. Scuseria and co-workers (currently inoperative).  The default is
              WERNER.

       LOCAL_WEAKP= string
              Selects the desired treatment of "weak pairs" in the local-CCSD method.  A value of
              NEGLECT ignores weak pairs entirely.  A value of NONE treats weak pairs in the same
              manner  as  strong  pairs.   A  value  of  MP2  (the  default)  uses   second-order
              perturbation  theory  to  correct  the  local-CCSD  energy computed with weak pairs
              ignored.

       PRINT_PAIR_ENERGIES = boolean
              Indicates if the MP2 and CCSD  pair  energies  should  be  printed.  This  is  only
              possible for RHF references. Default is false.

       SPINADAPT_ENERGIES = boolean
              Indicates if spin-adapted pair energies should be printed.  Default is false.

                                           18 June, 2002                              ccenergy(1)