ALMO_SCF

References: Khaliullin2013, Scheiber2018

Settings for a class of efficient linear scaling methods based on absolutely localized orbitals (ALMOs). ALMO methods are currently restricted to closed-shell molecular systems. [Edit on GitHub]

Subsections

Keywords

Keyword descriptions

ALMO_ALGORITHM

🔗

Type: enum
Default: DIAG
Usage: ALMO_ALGORITHM DIAG

Description: Specifies the algorithm to update block-diagonal ALMOs during the SCF procedure. [Edit on GitHub]

Valid values:

  • DIAG DIIS-accelerated diagonalization controlled by ALMO_OPTIMIZER_DIIS. Recommended for large systems containing small fragments.

  • PCG Energy minimization with a PCG algorithm controlled by ALMO_OPTIMIZER_PCG.

  • TRUST_REGION Trust-region optimizer is recommended if PCG has difficulty converging. It is controlled by ALMO_OPTIMIZER_TRUSTR

  • SKIP Skip optimization of block-diagonal ALMOs.

ALMO_EXTRAPOLATION_ORDER

🔗

Type: integer
Default: 3
Usage: ALMO_EXTRAPOLATION_ORDER 3

Description: Number of previous states used for the ASPC extrapolation of the ALMO initial guess. 0 implies that the guess is given by ALMO_SCF_GUESS at each step. [Edit on GitHub]

ALMO_SCF_GUESS

🔗

Type: enum
Default: ATOMIC
Usage: ALMO_SCF_GUESS MOLECULAR

Description: The method to generate initial ALMOs. [Edit on GitHub]

Valid values:

  • MOLECULAR SCF calculations on single molecules controlled by the regular SCF keywords outside ALMO options. This kind of calculation is expensive and only recommended if ALMO SCF does not converge from the ATOMIC guess.

  • ATOMIC Superposition of atomic densities.

CONSTRUCT_NLMOS

🔗

Type: logical
Default: F
Usage: CONSTRUCT_NLMOS .TRUE.

Description: Turns on post-SCF construction of NLMOs [Edit on GitHub]

DELOCALIZE_METHOD

🔗

Type: enum
Default: XALMO_X
Usage: DELOCALIZE_METHOD XALMO_X

Description: Methods to reintroduce electron delocalization, which is excluded with the block-diagonal ALMO reference. Electron delocalization can be computed using either fully delocalized MOs or spatially restricted ALMOs (called eXtended ALMOs or XALMOs). All methods below use either a PCG or trust-region optimizers controlled by XALMO_OPTIMIZER_* subsections. The only exception is the non-iterative XALMO_1DIAG. [Edit on GitHub]

Valid values:

  • NONE Neglect electron delocalization

  • XALMO_1DIAG Correction based on one diagonalization of the spatially projected Hamiltonian (XALMO)

  • XALMO_X Single excitation correction (no Hamiltonian re-build) with spatial restrictions (XALMO)

  • XALMO_SCF Self-consistent treatment of delocalization with spatial restrictions (XALMO)

  • FULL_X Single excitation correction (no Hamiltonian re-build) without spatial restrictions

  • FULL_SCF Self-consistent treatment of delocalization without spatial restrictions

  • FULL_X_THEN_SCF Single excitation correction followed by full SCF procedure, both without spatial restrictions

EPS_FILTER

🔗

Type: real
Default: 1.00000000E-007
Usage: EPS_FILTER 1.e-6

Description: Threshold for the matrix sparsity filter [Edit on GitHub]

MO_OVERLAP_INV_ALG

🔗

Type: enum
Default: LS_HOTELLING
Usage: MO_OVERLAP_INV_ALG LS_HOTELLING

Description: Algorithm to invert MO overlap matrix. [Edit on GitHub]

Valid values:

  • LS_HOTELLING Linear scaling iterative Hotelling algorithm. Fast for large sparse matrices.

  • LS_TAYLOR Linear scaling algorithm based on Taylor expansion of (A+B)^(-1).

  • DENSE_CHOLESKY Stable but dense Cholesky algorithm. Cubically scaling.

RETURN_ORTHOGONALIZED_MOS

🔗

Type: logical
Default: T
Lone keyword: T
Usage: RETURN_ORTHOGONALIZED_MOS .TRUE.

Description: Orthogonalize final ALMOs before they are returned to Quickstep (i.e. for calculation of properties) [Edit on GitHub]

XALMO_ALGORITHM

🔗

Type: enum
Default: PCG
Usage: XALMO_ALGORITHM TRUST_REGION

Description: Specifies the algorithm to update ALMOs on eXtended domains (XALMOs). [Edit on GitHub]

Valid values:

  • DIAG DIIS-accelerated diagonalization.

  • PCG PCG algorithm controlled by XALMO_OPTIMIZER_PCG.

  • TRUST_REGION Trust-region optimizer controlled by XALMO_OPTIMIZER_TRUSTR

XALMO_EXTRAPOLATION_ORDER

🔗

Type: integer
Default: 0
Usage: XALMO_EXTRAPOLATION_ORDER 1

Description: Number of previous states used for the ASPC extrapolation of the initial guess for the delocalization correction. [Edit on GitHub]

XALMO_R_CUTOFF_FACTOR

🔗

Type: real
Default: 1.50000000E+000
Usage: XALMO_R_CUTOFF_FACTOR 1.6

Description: Controls the localization radius of XALMOs: R_cutoff = XALMO_R_CUTOFF_FACTOR*(radius(at1)+radius(at2)) [Edit on GitHub]

XALMO_TRIAL_WF

🔗

Type: enum
Default: PROJECT_R0_OUT
Usage: XALMO_TRIAL_WF SIMPLE

Description: Determines the form of the trial XALMOs. [Edit on GitHub]

Valid values:

  • SIMPLE Straightforward AO-basis expansion.

  • PROJECT_R0_OUT Block-diagonal ALMOs plus the XALMO term projected onto the unoccupied ALMO-subspace.