$DIABAT group (relevant if DIABAT=.TRUE. in $MCSCF) This group controls creation of diabatic states from adiabatic states using complete active space-type MCSCF wavefunctions. Diabatization is performed at a single geometry, during RUNTYP=ENERGY, if DIABAT=.TRUE. in $MCSCF. Diabatization is presently programmed only for CISTEP=GUGA, and may be performed at either the the CASSCF level or at the MCQDPT level. Diabatization creates first the Diabatic Molecular Orbitals (DMOs), and then the diabatic states by rotation of the adiabatic CI states obtained with the DMOs. DMOs are a set of active orbitals evolving smoothly from a reference geometry (where the adiabatic states are cleanly separated, i.e. already diabatic in nature), through a region where several states might come close, or even undergo avoided crossings, and beyond to another region where adiabatic states are once again cleanly separable. Only one side is considered the reference geometry for DMO generation. The dominant CSFs in the diabatic reference states are taken from the adiabatic states at this reference geometry, possibly informed by user knowledge about the dominant CSFs at the other side of the crossing region. If MPLEVL=2 is specified, the diabatization program will also produce diabatic states at the MCQDPT level, utilizing the CAS-level DMOs during the MCQDPT diabatization. This is a simpler procedure than was used prior to 2013. Note that $MCQDPT input need not be given, as DIABAT=.TRUE. will force the selection of the CSF-based MCQDPT program, and will pass orbital counts and state weights from this input group to the MCQDPT. The method is described in: H.Nakamura, D.G.Truhlar J.Chem.Phys. 115, 10353-10372(2001) H.Nakamura, D.G.Truhlar J.Chem.Phys. 117, 5576-5593(2002) H.Nakamura, D.G.Truhlar J.Chem.Phys. 118, 6816-6829(2003) Z.H.Li, R.Valero, D.G.Truhlar Theoret.Chem.Acc. 118, 9-24(2007) K.R.Yang, X.Xu, D.G.Truhlar Chem.Phys.Lett. 573, 84-89(2013) REFMOS = a flag controlling reading of "order reference orbitals" at a reference geometry, from $DFMVEC. These are often obtained by the 3-fold way, or perhaps the 4-fold way at a nearby geometry. Default is .FALSE. If not set, this run will use the 3-fold way to prepare DMOs, and will also punch the DMOs for possible use as the $DFMVEC for other geometries. If set, this run will use the order reference orbitals to help align the active orbitals of the run to their order at the reference geometry. This is normally a good idea! REFGRP = a flag controlling reading of groups of CSFs expected to dominate different diabatic states. Default is .FALSE. If not set, for a run at some chosen reference geometry, the dominant groups are prepared and punched as a $REFCSF group. See also SLCTTH, which sets the threshold for "dominant". If set, diabatization will be performed, using the dominant CSF group information read from $REFCSF. Note: real diabatization runs must set REFGRP=.TRUE. but in some cases diabatization might have no ambiguity in orbital ordering, so REFMOS might be .TRUE. or .FALSE. SLCTTH = selection threshold for dominant configurations, when REFGRP=.FALSE. Also used as a printing threshold in adiabatic and diabatic states. Default is 0.20; it pertains to CI coefficients. * * * Keywords related to state selection * * * The defaults are quite reasonable, so most runs might omit all of these! Let NWEIGHT be the number of states up to and including the highest weighted state in the MCSCF orbital optimization (according to WSTATE in $GUGDM2). NWEIGHT includes any states with zero weight below the highest weighted one. The defaults use NWEIGHT states during the DMO generation, all with equal weight in the DMO generation, and then diabatize NWEIGHT states. NGRST = number of low lying states to be excluded from the final diabatization. Default = 0. NDIAST = number of states above the first NGRST which are included in the final diabatization. Default = NWEIGHT - NGRST. NEXST = number of excited states above the states being dealt with. One might set NSTATE in $GUGDIA fairly high, to monitor the position of states to ensure they don't come close in energy to the interesting states, which stop at NWEIGHT. Such extra states are ignored during generation of DMOs and during diabatization. Default = NSTATE - NGRST - NDIAST. WBLOCK = array of three (3) weights for the GR/DIA/EX blocks of states, used during DMO generation. The default is to give all NGRST and NDIAST states equal weight in the DMO process, with no weight for the NEXST states, namely NGRST/(NGRST+NDIAST), NDIAST/(NGRST+NDIAST), 0.0 Suppose the system of interest has one state lying at very low energy, two excited states of interest that are close to each other, and the user monitors three states higher than these. The MCSCF might very well average only the two states that come close together, $GUGDIA NSTATE=6 $END $GUGDM2 WSTATE(1)=0,1,1,0,0,0 $END The situation is thus NWEIGHT=3, so if no keywords are chosen here, both DMO generation and diabatization involve the first three states. The most reasonable non-default choice is NGRST=1, to omit the low-lying ground state from the diabatization, but keep it during the DMO generation. In case one also wishes to have the DMO step ignore the low lying state, enter the keyword WBLOCK(1)=0.0,1.0,0.0 which weights only the 2nd and 3rd states. * * * three-fold way parameters * * * ALPHAN = weight of the state-averaged natural orbital term, default = 2.0 ALPHAR = weight of the state-specific occupation number term, default= 1.0 ALPHAT = weight of the transition density matrix term, default = 0.5 * * * four-fold way parameters * * * The four-fold way is used if NMLAP and/or NDLAP are given. NDLAP = number of "resolution orbitals". Resolution DMOs are introduced to determine some of DMOs in the '2' (or DOC) block, as defined by MOSLAB below. Complex multi-arrangment reactions may use this resolution to avoid scrambling certain DMOs with others of smaller occupancy. A typical use is for systems with nearly filled lone pair orbitals. If given, $DPSVEC orbitals must be given, and if ORIENT is chosen, also $LCLDC input. Default = 0. NMLAP = number of "reference orbitals" used by the maximum overlap reference MO (MORMO) criterion of the "4-fold way" method for DMO determination. Reference DMOs are obtained at some reference geometry, and advice about their selection can be gained from looking at successful applications in the literature. MORMO is used to the determine some of the DMOs in the '1' (or VAL) orbitals, see MOSLAB below. If given, $DIAVEC orbitals must be given, and if ORIENT is chosen, also $LCLVL input. Default = 0. ORIENT = logical flag to rotate the "reference orbitals" and/or "resolution orbitals" from the reference geometry to the present coordinates. Default = .FALSE. MOSLAB = array containing a character assessment of the active orbitals: DOC ('2') orbitals should have occupancies close to two in all electronic states, and be filled in all reference CSFs; VAL ('1') orbitals have variable occupancies in different electronic state, not necessarily close to 1.0, with variable occupancy in reference CSFs; VIR ('0') orbitals should be only weakly occupied in all electronic states, and be empty in all reference CSFs. Only orbitals marked '2' are candidates for the "resolution orbital" step (see NDLAP), and only orbitals marked '1' are candidates for the 4-fold MORMO step (see NMLAP). The default treats the entire active space as the VAL block: MOSLAB(1)=1,1,1,...,1,1 Typically the number of '2' or '1' orbitals would exceed NDLAP and NMLAP inputs. See also THDOC and THVIR to let the program choose the 2's, 1's, 0's based on the active orbitals occupation number. THDOC = threshold on the state-averaged occupation numbers to identify DOC orbitals. Default=1.8 electrons. THVIR = threshold on the state-averaged occupation numbers to identify VIR orbitals. Default=0.2 electrons. * * * three-fold and four-fold iterations * * * MAXIT = number of D3 or MORMO Jacobi cycle iterations. The 3-fold way iterations seem very robust, but the MORMO 4-fold way iterations are less well convergent and more numerous (default=200) CONVTH = threshold for convergence of D3 and MORMO. Default = 1.0E-6 * * * DMOSYM = flag to allow lowering of symmetry during the DMO process. Default = .TRUE., preserving symmetry. Note: it is probably safer to enter GROUP=C1 in $DRT, and NOSYM=1 in $CONTRL, and thus have symmetry off during the entire run, than to choose this keyword. * * * Diabatization runs can read additional input groups which are not well described here. The $REFCSF and $DFMVEC input groups are often given. They are usually prepared by a three-fold DIABAT=.TRUE. run at some reference geometry, using both REFGRP=.FALSE. and REFMOS=.FALSE. $REFCSF: list of dominant configurations at the reference geometry, which is created by a REFGRP=.FALSE. run. Note that the SLCTTH threshold assists in deciding how many CSFs are placed in the reference groups. The $REFCSF data is then read by all REFGRP=.TRUE. runs at the various other geometries, in the same format as it is generated. $DFMVEC: a set of temporary DMOs for ordering the DMOs at the current geometry. Usually these are DMOs prepared by a 3-fold way calculation at one reference geometry, but could be from a 4-fold way calculation at a geometry very close to the current one. This contains only active MOS, namely NDOC+NALP+NAOS+NBOS+NVAL from $DRT. $DPSVEC contains NDLAP resolution DMOs. $DIAVEC contains NMLAP reference DMOs. Note: $DFMVEC, $DPSVEC, $DFMVEC are typical $VEC type inputs. Each is read ignoring the MO index, so you might prepare the order reference MOs from converged natural orbitals by simply deleting all doubly occupied orbitals, and keeping all active orbitals. Similarly, reference or resolution orbitals may be plucked from any desired orbital set: natural, canonical, localized... At present, there is no way for GAMESS to generate the orientation information, although this can be read in. Therefore their contents are not well described: $LCLDC and $LCLVL are orientation data for DPSVEC and DIAVEC, respectively, required if ORIENT=.TRUE. ========================================================== ===========================================================
generated on 7/7/2017