Table of Contents

Orbital localization

Localized orbitals are calculated according to the Boys, Pipek-Mezey or NLMO criteria. Localization takes place within each symmetry species separately. For intrisnic bond orbital (IBO) localization, see the IBBA program, section intrinsic basis bonding analysis (IAO/IBO). If complete localization is desired, no symmetry should be used. All subcommands can be abbreviated by three characters.

The localization program is invoked by the LOCALI command

LOCALI [,method],[LOCMETHOD=locmethod],[REFORB=record],[THRPIP|THRBOYS=thresh]

The keyword method can be either BOYS, PIPEK, NATURAL, IBO By default, the canonical valence orbitals from the last energy calculation are localized using the Boys criterion. Only orbital subsets which leave the energy invariant are transformed. These defaults can be modified using the optional commands described in the following sections.

The option LOCMETHOD only applies to Pipek-Mezey localization. The value locmethod can take the following values:

The option REFORB has the same effect as the directive REFORB described further below.

The option THRPIP (THRBOYS is an alias) is the threshold used for Pipek-Mezey or Boys localization (same as THRESH in section localization thresholds (THRESH)).

Defining the input orbitals (ORBITAL)

ORBITAL,record.file,specifications

The orbitals to be localized are read from dump record record.file. A state specific orbital set can be selected using specifications, as explained in section selecting orbitals and density matrices (ORBITAL, DENSITY). Default are the orbitals calculated last.

Saving the localized orbitals (SAVE)

SAVE,record.file

This specifies the dump record where the localized orbitals are stored. If the dump record already exists, the localized orbitals are added to it. Default is the input record (cf. ORBITAL).

Choosing the localization method (METHOD)

METHOD,method

The localization method method can be either BOYS, PIPEK, NATURAL, or IBO. This can also be specified as argument on the LOCALI card (see above).

Delocalization of orbitals (DELOCAL)

DELOCAL

If this card is present, the orbitals are delocalized. This is not implemented for NATURAL and IBO.

Localizing AOs(LOCAO)

LOCAO

If this card is present, the number of AOs contributing to each MO is minimized. This can be useful to rotate degenerate orbitals (e.g., px, py, pz in an atom) so that pure orbitals (in this case px, py, pz) result.

This implies Pipek-Mezey localization.

Selecting the orbital space

By default, only the valence orbitals are localized, in order to ensure invariance of subsequent electron correlation treatments. This behaviour can be modified using the OCC and CORE directives, or the LOCCORE option:

By default, all non-valence orbitals are treated as core.

Defining the occupied space (OCC)

OCC, $o_1$, $o_2 \ldots$

defines the highest orbital $o_i$ in each symmetry $i$ to be localized.

Defining the core orbitals (CORE)

CORE, $c_1$, $c_2 \ldots$

The first $c_i$ orbitals in each symmetry are treated as core orbitals and not localized. Thus, orbitals $c_i+1$ to $o_i$ are localized in symmetry $i$.

Defining groups of orbitals (GROUP, OFFDIAG)

GROUP,orb1,orb2,orb3,…

This card defines groups of orbitals to be localized as follows:

Orbitals in different groups are localized independently. Orbitals not included in any group are unchanged.

Localization between groups (OFFDIAG)

OFFDIAG

If this card is present, localize between groups instead of within groups.

Ordering of localized orbitals

ORDER,type

If type=CHARGE, the orbitals are ordered according to their charge centroids (default).

If type=FOCK, the orbitals are ordered according to increasing diagonal elements of the fock operator (PIPEK) or increasing Coulson-additive orbital energies (BOYS). This requires a Fock operator from the preceding energy calculation. For localization of Hartree-Fock orbitals, this operator is stored in the dump record and automatically found. For localization of MCSCF orbitals, an effective fock operator is computed from the MCSCF density matrix (see DENSITY option). Alternatively, a dump record of a previous SCF calculation can be specified on the FOCK card, and then the fock operator is read from this record. For degenerate orbitals, further ordering according to the the coordinates of charge centres is attempted (first according to largest z-coordinates, then according to x, then y).

This card does not apply to NLMO localization.

No reordering (NOORDER)

NOORDER

If this card is present, the localized orbitals are not reordered. This is useful if localized orbitals are used as starting guess, and it is intended that their order remains unchanged.

Ordering using domains (SORT)

SORT,[THRCHCHG=charge][THREIG=eps],GROUP=igrp],[REVERT],centrelist

This directive only works for Pipek-Mezey localization. The orbitals are ordered according to domains and the given centrelist. The contributions of the centres to domains are determined by Löwdin charges. Only centres with charges greater than THRCHCHG (default 0.4) are included in these domains. The orbitals are reordered according to the following criteria:

Note that core orbitals are neither localized nor reordered.

Defining reference orbitals (REFORB)

REFORB,record.file,specifications

The localized orbitals are reordered such that the overlap with the reference orbitals read from record.file is maximized. This is useful for local correlation treatments for keeping the order of the localized constant for different geometries. A state specific orbital set can be selected using specifications, as explained in section selecting orbitals and density matrices (ORBITAL, DENSITY).

Selecting the fock matrix (FOCK)

FOCK,record.file

This specifies a record holding a Fock operator to be used for ordering the orbitals. Note that only SCF dump records hold fock operators. Default is the Fock operator from the energy calculation which produced the input orbitals.

Selecting a density matrix (DENSITY)

DENSITY,record.file,specifications

This specifies a record holding a density matrix for construction of a fock operator used for ordering the orbitals. This can be used if no fock operator is available, and has only an effect for MCSCF localizations. By default, the (state averaged) MCSCF density is used. A state specific density matrix can be selected using specifications as described in section selecting orbitals and density matrices (ORBITAL, DENSITY).

Localization thresholds (THRESH)

THRESH,thresh,eorder [locsec:thrpip]

thresh is a threshold for localization (default 1.d-9). If eorder is nonzero (default 1.d-4), the orbitals whose energy difference is smaller then eorder are considered to be degenerate and reordered according to the position of their charge centres (see section ordering of localized orbitals).

Options for PM localization (PIPEK)

Some special options exist for Pipek-Mezey localization and can be given on the PIPEK directive (optional):

PIPEK,METHOD=method,DELETE=ndel,MAXDL=maxdl,THRESH|ACC=thresh,ORDER=iorder,STEP=step

method=2: use Newton-Raphson method;
method=3: Initial iterations using 2×2 rotation method , final convergence using NR method.

If iorder=2, order final orbitals according charge centres (default).

Printing options (PRINT)

PRINT,[ORBITAL=]pri [,CHARGE] [,CENTRES] [,TEST] [,TRAN];

If ORB[ITAL] is given, the localized orbitals are printed.
If CHA[RGE] or CEN[TRES] is given, the charge centres of the localized orbitals are printed.
If TRAN is given, the transformation matrix is printed (Boys only).
If TEST is given, intermediate information is printed.