$EOMINP group
         (optional, for CCTYP=EOM-CCSD, CR-EOM, or CR-EOML)
                   (optional, for CCTYP=EA-EOMx or IP-EOMx)
            (optional for CCSD properties, or CCTYP=CR-CCL)
 
    This group controls the calculation of excited states
by the equation of motion coupled cluster with single and
double excitations, with optional triples corrections.  It
also pertains to electron attachment and detachment
processes, which may result in the system being left in an
excited state.  EOM-CCSD can be selected for RHF or ROHF
reference states, while all other CCTYP listed above can be
used only with SCFTYP=RHF.
 
    These EOM-type runs consist of an SCF calculation on
the reference state, followed by a ground state CCSD (see
the $CCINP input to control the ground state calculation,
and the orbital range correlated), followed by an EOM-CCSD,
IP-EOMCC, or EA-EOMCC calculations on the target states
(see NSTATE below).  In some cases, triples corrections
based on the method of moments approach may follow.
 
    The input group permits selection of how many states
are computed (machine time is linear in the number of
states). Since the target state default is simplistic (only
one excited state in the totally symmetric representation),
it is usually necessary to give this group, to select
NSTATE and IROOT sensibly.
 
    Because this input group is used for several CCTYP
calculations, not all keywords are used in every case, or
the keywords may have slightly different meanings:
a) if the reference type is RHF, and CCTYP is EOM-CCSD, CR-
EOM, or CR-EOML, keywords MULT and NACT are ignored.
b) if the reference type is ROHF, and CCTYP is EOM-CCSD,
keywords CCPRPE, NACT, MTRIP, MEOM, MCI, MINIT, CVGCI,
MAXCI, MICCI are ignored.  MULT is sometimes ignored.
c) if the reference type if RHF, and CCTYP is an ionization
process (EA/IP), keywords CCPRPE, MTRIP, MEOM, MCI, MINIT,
CVGCI, MAXCI, MICCI are ignored.
 
    Additional information on CC and EOM methods can be
found in the "Further Information" section of this manual.
 
 
--- spin and space symmetry, and state selection:
 
MULT   = Spin multiplicities for the target states.
         The meaning depends on the particular calculation.
         The default for cases using $EOMINP's MULT is -1.
         If any doubly excited states or EA/IP quartets
         are sought, be sure to select MINIT=1 so that
         the initial guess states include these.
 
  In case the run is IP-EOM or EA-EOM type, the run will
  pass through open shell code, although the reference
  in $CONTRL must be given as RHF and MULT=1.  The IP or EA
  states will be spin adapted.
   MULT = -1 means target both doublet and quartet states
        =  2 means consider only doublet states
        =  4 means consider only quartet states, which can
             be produced at the EOM-CCSD level by a double
             that unpairs two electrons, and attaches (or
             detaches) a third electron.
 
  In case the run is EOM-CCSD, SCFTYP=ROHF, but $CONTRL
  selects a closed shell reference by MULT=1:
   MULT = -1 means target singlet, triplet, and pentuplets.
        =  1 consider only singlet excited states
        =  3 consider only triplet excited states
        =  5 consider only pentuplet excited states.
 
  In case the run is EOM-CCSD, SCFTYP=ROHF, and $CONTRL
  selects a genuinely open shell reference, the EOM states
  will not be perfectly spin adapted.  The spin projection
  of Ms from $CONTRL's (MULT-1)/2 is the only good quantum
  number.  The excited states will have S values near to
  Ms, Ms+1, or Ms+2 since single and double excitations are
  treated.  Note that target states with spins LOWER than
  Ms are not generated, even if they exist in nature. The
  output will not print approximate S or  values,
  but will label spatial symmetry.
   MULT =  input will be ignored
 
  In case the run is an RHF reference EOM-CCSD (or triples
  correction), the target states are singlets, only.
   MULT =  input will be ignored
 
GROUP     the name of the Abelian group to be used, which
          may be only one of the groups shown in the
          table below. The default is taken from $DATA,
          and is reset to C1 if the group is non-Abelian.
          The purpose is to let the Abelian symmetry be
          turned off by setting GROUP=C1, if desired.
          Symmetry is used to help with the initial
          excited state selection, for controlling
          the EOMCC calculations, and for labeling the
          calculated states in the output (not to speed
          up the calculations).
 
NSTATE    an array of up to 8 integers telling how many
          excited states of each symmetry type should be
          computed. The default is
             NSTATE(1)=1,0,0,0,0,0,0,0
          meaning 1 totally symmetric state is to be found.
          The ground state is always computed, and MUST NOT
          be included in NSTATE's input, for excited state
          runs.  For EA or IP runs, the NSTATE input MUST
          include the target ion's ground state, and may
          include excited states of the ion.
          See also ISELCT below.
 
There is no particular reason the first excited state (or
ionic ground state) should be totally symmetric, so most
runs should give a sensible NSTATE input.  Up to 10 states
can be found in any irrep.  Machine time is linear in the
number of states to be found, so be realistic!
 
NSTATE uses this order for irreducible representations:
       irrep  1    2    3    4    5    6    7    8
         C1   A
         C2   A    B
         Cs   A'   A''
         Ci   Ag   Au
         C2v  A1   A2   B1   B2
         C2h  Ag   Au   Bg   Bu
         D2   A    B1   B2   B3
         D2h  Ag   Au   B1g  B1u  B2g  B2u  B3g  B3u
 
As an aside, NSTATE(1)=0,0,0,0,0,0,0,0 for RHF references
will calculate the ground state only, generating the type
I, II, or possibly III CR-CCSD(T) energies, which aren't
otherwise available in a direct ground state calculation.
 
IROOT     selects the state whose energy is to be saved
          for further calculations, such as numerical
          gradients, or whose properties are evaluated,
          see CCPRPE below.
          The first integer lists the irrep number, from
          the same table as NSTATE, and the second lists
          the number of the state.  Thus, IROOT(1)=3,2
          means the second B1 state, if GROUP=C2V.
          (default IROOT(1)=1,0)
 
IROOT's default is moderately sensible for a RHF-based
excited state run, corresponding to the ground state
(labeled as state 0), as this state must lie in the totally
symmetric representation.  ROHF-based excitations, or EA/IP
runs should select something appropriate!
 
If degenerate EOM-CCSD states are detected, only one such
state will be triples-corrected.  The state chosen for
possible triples will be the lower irrep number, so make
sure IROOT matches this.
 
ISELCT  = an array allowing experts to reduce the number of
          states that are actually solved for.  When given,
          NSTATE determines the number of states generated
          by the initial guess procedures, with ISELECT
          selecting those which carry into the calculation.
          NSTATE(1)=2,2,2,2 with ISELCT(1)=1,3,5,7 prepares
          two guesses in each irrep, but only iterates the
          EOM-CCSD equations for the lowest state in each
          irrep (the guesses are counted serially).
 
     The next two keywords address triples corrections.
     Note that non-iterative triples corrections are not
     presently available for any SCFTYP=ROHF reference.
 
MTRIP     selects the type of noniterative triples
          corrections to SCFTYP=RHF EOM-CCSD energies.
          MINIT applies only to CCTYP=CR-EOM or CR-EOML:
      1 = compute the CR-EOMCCSD(T) triples corrections
          termed type I and II in the output. This is the
          default, which skips the iterative CISD
          calculations needed to construct the
          CR-EOMCCSD(T) triples corrections of type III.
      2 = after performing an additional CISD calculation,
          evaluate all types of the CR-EOMCCSD(T) triples
          corrections, including types I, II, and III.
          This choice of MTRIP uses approximately 50 %
          more memory, but less CPU time than MTRIP=4.
      3 = evaluate the CR-EOMCCSD(T) corrections of type
          III only. As with MTRIP=2, this calculation
          includes the iterative CISD calculation, which
          is needed to construct the type III triples
          corrections, in addition to the EOMCCSD and
          CR-EOMCCSD(T) calculations.
      4 = carry out MTRIP=1 calculations, followed by
          MTRIP=3 calculations, thus evaluating all types
          of the CR-EOMCCSD(T) corrections (types I, II,
          and III in the output). As with MTRIP=2, this
          calculation includes the CISD iterations, which
          are needed to construct the type III triples
          corrections, in addition to the EOMCCSD and
          CR-EOMCCSD(T) calculations.
 
      NACT pertains only to EA-EOM3A or IP-EOM3A runs:
 
NACT   = the number of active MOs used to select the 3p2h
         or 3h2p excitations in EA-EOMCCSDt (EA-EOM3A) or
         IP-EOMCCSDt (IP-EOM3A) calculations.
         For CCTYP=EA-EOM3A, used to describe the (N+1) e-
         system, NACT refers to the NACT lowest unoccupied
         orbitals of the N e- reference system.
         For CCTYP=IP-EOM3A, used to describe the (N-1) e-
         system, NACT refers to the NACT highest occupied
         orbitals of the N e- reference system.
         The default for NACT is 0, which allows no three
         particle or three hole operators, and thus yields
         only EA-EOMCC2 or IP-EOMCC2 results.
         In other words, you should input a value for NACT!
 
CCPRPE = a flag to select computation of the EOM-CCSD level
         excited state density matrices (see also CCPRP in
         $CCINP for ground states).
         The computation takes extra time, to obtain left
         eigenstates, so the default is .FALSE.
 
CCPRPE can be used only if SCFTYP=RHF and CCTYP=EOM-CCSD,
CR-EOM, or CR-EOML.  The property printout includes
transition moments and oscillator strengths between all
pairs of states, as well as the full range of Gaussian
properties (see $ELMOM, etc), for state IROOT only.  CC
density matrices are square, not symmetric, which means
that CCSD natural orbitals come in left/right pairs.  To
minimize the amount of output, only left natural orbitals
for excited state IROOT will be found in the log file.
 
 
--- iterative solver selection:
 
MEOM      selects the solver for the EOMCCSD calculations:
      0 = one EOMCCSD root at a time, united iterative
          space for all calculated roots (default)
      1 = one root at a time, separate iterative space for
          each calculated root
      2 = the Hirao-Nakatsuji multi-root solver
      3 = one root at a time, separate iterative space for
          all computed right/left roots. (compare to 1)
      4 = one root at a time, united iterative spaces
          for each right/left root (compare to 0).
For open shell references, or IP/EA runs, there is only one
EOM-CCSD solver, so MEOM is ignored.
 
MEOM=0,1,2 obtain all the right eigenvectors first, and
then if properties are being computed, proceed to compute
the left eigenvectors.  MEOM=3,4 obtain right and left
eigenvectors simultaneously, and therefore should only be
chosen if you are computing properties (see CCPRP/CCPRPE).
 
MCI       selects the solver for the CISD step, which
          is irrelevant unless MTRIP is bigger than 1.
      1 = one root at a time, separate iterative space for
          each calculated root (default)
      2 = the Hirao-Nakatsuji multi-root solver (slower)
 
 
--- initial guess for EOM-CCSD (and possible CISD) solvers:
 
For both MINIT and MACT below, S and D stand for using all
singles or doubles, while s and d mean restricting those
excitations, both from and to a smaller number of orbitals.
Of course, to define the range of orbitals "active" in the
initial guess, inputs NOACT and NUACT (and perhaps MOACT)
below must be given.  The reason that MINIT=1 is preferred
is that low-lying states with non-negligible double
excitation character, or significant multi-configurational
character are missing in a simple CIS guess, and thus may
not appear in the final converged calculations.
 
MINIT     selects the initial guess procedure for EOM-CCSD,
          and possibly CISD iterations, in case MTRIP>1.
          MINIT applies to all runs reading $EOMINP.
      1 = Use EOMCCSd to start the EOMCCSD iterations,
          and CISd to start possible CISD iterations.
      2 = Use CIS wave functions to start both EOMCCSD,
          or any possible CISD calculations.
  MINIT's default is 2, but MINIT=1 is HIGHLY RECOMMENDED!
 
MACT   = fine tuning of MINIT's EOM-CCSD initial guess
         For MINIT=1 MACT=0, use EOMCCSd guess
         For MINIT=1 MACT=1, use EOMCCsd guess
         For MINIT=2 MACT=0, use CIS guess
         For MINIT=2 MACT=1, use CIs guess
         The default for MACT is 0.
 
MINIT applies to all calculations reading $EOMINP, while
MACT applies only if SCFTYP=ROHF.
 
   the next three define the initial guess active space:
     There are no default values of NOACT and NUACT,
     so the user MUST provide NOACT and NUACT values
     if they are needed.  NOACT and NUACT are usually
     small (5 or so), but should be chosen to avoid
     splitting any degenerate orbital shells.
 
NOACT     the number of occupied MOs in the active space
          for little s or little d initial guesses.
NUACT     the number of unoccupied MOs in the active space
          for little s or little d initial guesses.
MOACT     array allows explicit selection of the active
          orbitals used to define the EOMCCSd and CISd
          initial guesses.  If not provided, the MOACT
          array is filled such that the NOACT highest
          occupied and NUACT lowest unoccupied orbitals
          are selected.  If MOACT is given, the number of
          values provided must be NOACT+NUACT.
          MOACT is most useful in the virtual space, where
          the lowest orbitals might be diffuse in nature.
          An example with 15 occupied orbitals, and where
          the user has searched the virtual space looking
          for valence-like orbitals, might be
               MINIT=1 NOACT=3 NUACT=5
               MOACT(1)=13,14,15, 19,20,24,25,30
 
 
--- iteration control:
 
CVGEOM    convergence criterion on the EOMCCSD excitation
          amplitudes R1 and R2 (default=1.0d-4).
MAXEOM    maximum number of iterations in the EOMCCSD
          calculations (default=50). For MEOM=0 or 1,
          this is the maximum number of iterations per
          each calculated state. For MEOM=2, this is
          the maximum number of iterations for all
          states of the EOMCCSD multi-root procedure.
MICEOM    maximum number of microiterations in the
          EOMCCSD calculations (default=80). Rarely used.
          For MEOM=1 (separate iterative space for each
          root), this is the maximum number of
          microiterations for each calculated state.
          For MEOM=0 or 2 (united iterative space
          for all calculated roots), this is the
          maximum number of microiterations for all
          calculated states. It is much better to
          perform calculations with MICEOM > MAXEOM
          (i.e., in a single iteration cycle). If
          for some reason the EOMCCSD convergence is
          very slow and the iterative space becomes
          very large, it may be worth changing the
          default MICEOM value to MICEOM < MAXEOM
          to reduce the disk usage. This is not
          going to happen too often and normally there
          is no need to change the default MICEOM value.
 
     The next three apply only to closed shell reference
triples, if the triples method MTRIP is greater than 1:
 
CVGCI     convergence criterion for the CISD expansion
          coefficients (default=1.0d-4).
MAXCI     maximum number of iterations in the CISD
          calculation (default=50). For MCI=1, this
          is the maximum number of iterations per each
          calculated CISD state. For MCI=2, this is
          the maximum number of iterations for all
          states of the CISD multi-root procedure.
MICCI     maximum number of microiterations in the
          CISD calculation (default=80). Rarely used.
          For MCI=1 (separate iterative space for each
          root), this is the maximum number of
          microiterations for each calculated state.
          For MCI=2 (united iterative space for all
          calculated roots), this is the maximum
          number of microiterations for all calculated
          states. In analogy to MICEOM, it is much
          better to perform the CISD calculations with
          MICCI > MAXCI (i.e., in a single iteration
          cycle).
 
 
---- restarts:
 
JREST  = 0 this is not a restart
       = 1 restart data is read from AMPROCC file
    One use for this is to request additional states, with
    the restart taking any converged roots from disk, and
    doing an initial guess for additional states.
    You must not change MULT when restarting.
 
 
381 lines are written.
Edited by Shiro KOSEKI on Tue May 17 15:19:38 2022.