$STATPT group        (for RUNTYP=OPTIMIZE or SADPOINT)                          
                                                                                
    This group controls the search for stationary points.                       
Note that NZVAR in $CONTRL determines if the geometry                           
search is conducted in Cartesian or internal coordinates.                       
                                                                                
METHOD = optimization algorithm selection.  Pick from                           
                                                                                
         NR   Straight Newton-Raphson iterate. This will                        
              attempt to locate the nearest stationary                          
              point, which may be of any order. There                           
              is no steplength control. RUNTYP can be                           
              either OPTIMIZE or SADPOINT                                       
                                                                                
         RFO  Rational Function Optimization. This is                           
              one of the augmented Hessian techniques                           
              where the shift parameter(s) is(are) chosen                       
              by a rational function approximation to                           
              the PES. For SADPOINT searches it involves                        
              two shift parameters. If the calculated                           
              stepsize is larger than DXMAX the step is                         
              simply scaled down to size.                                       
                                                                                
         QA   Quadratic Approximation. This is another                          
              version of an augmented Hessian technique                         
              where the shift parameter is chosen such                          
              that the steplength is equal to DXMAX.                            
              It is completely equivalent to the TRIM                           
              method. (default)                                                 
                                                                                
         SCHLEGEL The quasi-NR optimizer by Schlegel.                           
                                                                                
         CONOPT, CONstrained OPTimization. An algorithm                         
              which can be used for locating TSs.                               
              The starting geometry MUST be a minimum!                          
              The algorithm tries to push the geometry                          
              uphill along a chosen Hessian mode (IFOLOW)                       
              by a series of optimizations on hyperspheres                      
              of increasingly larger radii.                                     
              Note that there currently are no restart                          
              capabilitites for this method, not even                           
              manually.                                                         
                                                                                
OPTTOL = gradient convergence tolerance, in Hartree/Bohr.                       
         Convergence of a geometry search requires the                          
         largest component of the gradient to be less                           
         than OPTTOL, and the root mean square gradient                         
         less than 1/3 of OPTTOL.  (default=0.0001)                             
                                                                                
NSTEP  = maximum number of steps to take.  Restart data                         
         is punched if NSTEP is exceeded.  The default is                       
         50 steps for a minimum search, but only 20 for                         
         a transition state search, which benefit from                          
         relatively frequent Hessian re-evaluations.                            
                                                                                
                                                                                
      --- the next four control the step size ---                               
                                                                                
DXMAX  = initial trust radius of the step, in Bohr.                             
         For METHOD=RFO, QA, or SCHLEGEL, steps will                            
         be scaled down to this value, if necessary.                            
         (default=0.3 for OPTIMIZE and 0.2 for SADPOINT)                        
         For METHOD=NR, DXMAX is inoperative.                                   
         For METHOD=CONOPT, DXMAX is the step along the                         
         previous two points to increment the hypersphere                       
         radius between constrained optimizations.                              
         (default=0.1)                                                          
                                                                                
    the next three apply only to METHOD=RFO or QA:                              
                                                                                
TRUPD  = a flag to allow the trust radius to change as                          
         the geometry search proceeds.  (default=.TRUE.)                        
                                                                                
TRMAX  = maximum permissible value of the trust radius.                         
         (default=0.5 for OPTIMIZE and 0.3 for SADPOINT)                        
                                                                                
TRMIN  = minimum permissible value of the trust radius.                         
         (default=0.05)                                                         
                                                                                
     --- the next three control mode following ---                              
                                                                                
IFOLOW = Mode selection switch, for RUNTYP=SADPOINT.                            
         For METHOD=RFO or QA, the mode along which the                         
         energy is maximized, other modes are minimized.                        
         Usually referred to as "eigenvector following".                        
         For METHOD=SCHLEGEL, the mode whose eigenvalue                         
         is (or will be made) negative.  All other                              
         curvatures will be made positive.                                      
         For METHOD=CONOPT, the mode along which the                            
         geometry is initially perturbed from the minima.                       
         (default is 1)                                                         
         In Cartesian coordinates, this variable doesn't                        
         count the six translation and rotation degrees.                        
         Note that the "modes" aren't from mass-weighting.                      
                                                                                
STPT   = flag to indicate whether the initial geometry                          
         is considered a stationary point. If .true.                            
         the initial geometry will be perturbed by                              
         a step along the IFOLOW normal mode with                               
         stepsize STSTEP. (default=.false.)                                     
         The positive direction is taken as the one where                       
         the largest component of the Hessian mode is                           
         positive. If there are more than one largest                           
         component (symmetry), the first is taken as                            
         positive.                                                              
         Note that STPT=.TRUE. has little meaning with                          
         HESS=GUESS as there will be many degenerate                            
         eigenvalues.                                                           
                                                                                
STSTEP = Stepsize for jumping off a stationary point.                           
         Using values of 0.05 or more may work better.                          
         (default=0.01)                                                         
                                                                                
IFREEZ = array of coordinates to freeze.  These may be                          
         internal or Cartesian coordinates.  For example,                       
         IFREEZ(1)=1,3 freezes the two bond lengths in                          
         the $ZMAT example, which was for a triatomic                           
           $CONTRL NZVAR=3 $END                                                 
           $ZMAT IZMAT(1)=1,1,2,  2,1,2,3,  1,2,3  $END                         
         while optimizing the angle.                                            
                                                                                
         If NZVAR=0, so that this value applies to the                          
         Cartesian coordinates instead, the input of                            
         IFREEZ(1)=4,8 means to freeze the x coordinate                         
         of the 2nd and y coordinate of the 3rd atom.                           
                                                                                
         See also IFZMAT and FVALUE in $ZMAT, and IFCART                        
         below, as IFREEZ does not apply to DLC internals.                      
                                                                                
         In a numerical Hessian run, IFREEZ specifies                           
         Cartesian displacements to be skipped for a                            
         Partial Hessian Analysis.  IFREEZ can pertain to                       
         EFP particles, but only during RUNTYP=HESSIAN,                         
         where the 6 translational and rotational degrees                       
         of freedom of each EFP come AFTER the QM atom                          
         coordinates.  For more information:                                    
         J.D.Head, Int.J.Quantum Chem. 65, 827, 1997                            
         H.Li, J.H.Jensen                                                       
             Theoret. Chem. Acc. 107, 211-219(2002)                             
                                                                                
IFCART = array of Cartesian coordinates to freeze during                        
         a geometry optimization using delocalized internal                     
         coordinates.  This probably works less well than                       
         IFREEZ when it freezes Cartesians.  Only one of                        
         IFREEZ or IFCART may be chosen in a single run.                        
                                                                                
IACTAT = array of "active atoms", which is a complimentary                      
         input to IFREEZ.  Any atom *not* included in the                       
         list has its Cartesian coordinates frozen.  Thus                       
         IACTAT(1)=3,-5,107,144,202,-211 allows 15 atoms,                       
         namely 3-5, 107, 144, and 202-211 to be optimized,                     
         while all other atoms are frozen.  NZVAR in                            
         $CONTRL must be 0 when this option is chosen.                          
                                                                                
IFREEZ and IACTAT are mutually exclusive.  The latter acts                      
by generating a IFREEZ for all atom coordinates not defined                     
as "active", so users can input whichever list is shorter.                      
                                                                                
 --- The next two control the hessian matrix quality ---                        
                                                                                
HESS   = selects the initial hessian matrix.                                    
       = GUESS chooses an initial guess for the hessian.                        
               (default for RUNTYP=OPTIMIZE)                                    
       = READ  causes the hessian to be read from a $HESS                       
               group. (default for RUNTYP=SADPOINT)                             
       = RDAB  reads only the ab initio part of the                             
               hessian, and approximates the effective                          
               fragment blocks.                                                 
       = RDALL reads the full hessian, then converts                            
               any fragment blocks to 6x6 T+R shape.                            
               (this option is seldom used).                                    
       = CALC  compute the hessian, see $FORCE input.                           
                                                                                
IHREP  = the number of steps before the hessian is                              
         recomputed.  If given as 0, the hessian will                           
         be computed only at the initial geometry if                            
         you choose HESS=CALC, and never again.  If                             
         nonzero, the hessian is recalculated every                             
         IHREP steps, with the update formula used on                           
         other steps.  (default=0)                                              
                                                                                
HSSEND = a flag to control automatic hessian evaluation                         
         at the end of a successful geometry search.                            
         (default=.FALSE.)                                                      
                                                                                
                                                                                
   --- the next two control the amount of output ---                            
    Let 0 mean the initial geometry, L mean the last                            
    geometry, and all mean every geometry.                                      
    Let INTR mean the internuclear distance matrix.                             
    Let HESS mean the approximation to the hessian.                             
    Note that a directly calculated hessian matrix                              
    will always be punched, NPUN refers only to the                             
    updated hessians used by the quasi-Newton step.                             
                                                                                
NPRT   =  1  Print INTR at all, orbitals at all                                 
          0  Print INTR at all, orbitals at 0+L (default)                       
         -1  Print INTR at all, orbitals never                                  
         -2  Print INTR at 0+L, orbitals never                                  
                                                                                
NPUN   =  3  Punch all orbitals and HESS at all                                 
          2  Punch all orbitals at all                                          
          1  same as 0, plus punch HESS at all                                  
          0  Punch all orbitals at 0+L, otherwise only                          
             occupied orbitals (default)                                        
         -1  Punch occ orbitals at 0+L only                                     
         -2  Never punch orbitals                                               
                                                                                
---- the next parameters control harmonic constraints ---                       
Harmonic constraints can be added to the current geometry                       
by setting ALL the keywords below.  For instance, to                            
harmonically constrain the distance between atom 3 and 12                       
to a distance of 2.0 Angstrom and a force constant of 500                       
kcal/mol, the following example can be used:                                    
   IHMCON(1)=1,3,12  SHMCON(1)=2.0  FHMCON(1)=500.0                             
The default is all zeros which means do not do this.                            
                                                                                
IHMCON = array of coordinates to constrain. The input                           
         is similar to IZMAT in $ZMAT, a code integer,                          
         and the atoms involved in the coordinate.                              
         The code integer may only be 1, for stretches.                         
                                                                                
SHMCON = equilibrium constraint values for the distances                        
         specified by IHMCON, given in Angstrom.                                
                                                                                
FHMCON = array of force constants for the distances                             
         specified by IHMCON, given in kcal/mol.                                
                                                                                
                                                                                
 ---- the following parameters are quite specialized ----                       
                                                                                
PURIFY = a flag to help eliminate the rotational and                            
         translational degrees of freedom from the                              
         initial hessian (and possibly initial gradient).                       
         This is much like the variable of the same name                        
         in $FORCE, and will be relevant only if internal                       
         coordinates are in use.  (default=.FALSE.)                             
                                                                                
PROJCT = a flag to eliminate translation and rotational                         
         degrees of freedom from Cartesian optimizations.                       
         The default is .TRUE. since this normally will                         
         reduce the number of steps, except that this                           
         variable is set false when POSITION=FIXED is                           
         used during EFP runs.                                                  
                                                                                
ITBMAT = number of micro-iterations used to compute the                         
         step in Cartesians which corresponds to the                            
         desired step in internals.  The default is 5.                          
                                                                                
UPHESS = SKIP     do not update Hessian (not recommended)                       
         BFGS     default for OPTIMIZE using RFO or QA                          
         POWELL   default for OPTIMIZE using NR or CONOPT                       
         POWELL   default for SADPOINT                                          
         MSP      mixed Murtagh-Sargent/Powell update                           
         SCHLEGEL only choice for METHOD=SCHLEGEL                               
                                                                                
                                                                                
 ---- NNEG, RMIN, RMAX, RLIM apply only to SCHLEGEL ----                        
                                                                                
NNEG   = The number of negative eigenvalues the force                           
         constant matrix should have. If necessary the                          
         smallest eigenvalues will be reversed. The                             
         default is 0 for RUNTYP=OPTIMIZE, and 1 for                            
         RUNTYP=SADPOINT.                                                       
                                                                                
RMIN   = Minimum distance threshold. Points whose root                          
         mean square distance from the current point is                         
         less than RMIN are discarded. (default=0.0015)                         
                                                                                
RMAX   = Maximum distance threshold. Points whose root                          
         mean square distance from the current point is                         
         greater than RMAX are discarded. (default=0.1)                         
                                                                                
RLIM   = Linear dependence threshold. Vectors from the                          
         current point to the previous points must not                          
         be colinear.  (default=0.07)                                           
==========================================================                      
                                                                                
       * * * * * * * * * * * * * * * * * * * * *                                
       See the 'further information' section for                                
       some help with OPTIMIZE and SADPOINT runs                                
       * * * * * * * * * * * * * * * * * * * * *                                
                                                                                
                                                                                
==========================================================                      

generated on 7/7/2017