NTO_ANALYSIS

Perform a natural transition orbital analysis, i.e. the transition density matrix \(T^{(n)}=\left( \begin{array}{cc}0& {X}^{(n)}\\ \left({Y}^{(n)} \right)^T & 0\end{array} \right)\) is decomposed into its singular values \(T^{(n)} = {U}^{(n)} {\Lambda^{(n)}} \left({V}^{(n)}\right)^T\) in order to compute the NTO pairs \(\phi_I^{(n)}(\mathbf{r}_e) = \sum_{p=1}^{N_b} \varphi_p(\mathbf{r}_e) V_{p,I}^{(n)}\) for the electron and \(\chi_I^{(n)}(\mathbf{r}_h) = \sum_{q=1}^{N_b} \varphi_q(\mathbf{r}_h) U_{q,I}^{(n)}\) for the hole. [Edit on GitHub]

Subsections

Keywords

Keyword descriptions

SECTION_PARAMETERS: enum = OFF

Lone keyword: SILENT

Usage: silent

Valid values:

  • ON

  • OFF

  • SILENT

  • LOW

  • MEDIUM

  • HIGH

  • DEBUG

Level starting at which this property is printed [Edit on GitHub]

ADD_LAST: enum = NO

Usage: ADD_LAST (NO|NUMERIC|SYMBOLIC)

Valid values:

  • NO Do not mark last iteration specifically

  • NUMERIC Mark last iteration with its iteration number

  • SYMBOLIC Mark last iteration with lowercase letter l

If the last iteration should be added, and if it should be marked symbolically (with lowercase letter l) or with the iteration number. Not every iteration level is able to identify the last iteration early enough to be able to output. When this keyword is activated all iteration levels are checked for the last iteration step. [Edit on GitHub]

APPEND: logical = F

Lone keyword: T

append the cube files when they already exist [Edit on GitHub]

COMMON_ITERATION_LEVELS: integer = 0

Usage: COMMON_ITERATION_LEVELS

How many iterations levels should be written in the same file (no extra information about the actual iteration level is written to the file) [Edit on GitHub]

CUBE_FILES: logical = T

Lone keyword: T

Usage: CUBE_FILES {logical}

Print NTOs on Cube Files [Edit on GitHub]

EPS_NTO_EIGVAL: real = 1.00000000E-002

Usage: EPS_NTO_EIGVAL 0.01

Threshold for NTO eigenvalues, i.e. only \({\left(\lambda_I^{(n)}\right)}^2\) > EPS_NTO_EIGVAL are considered. [Edit on GitHub]

EPS_OSC_STR: real = -1.00000000E+000

Usage: EPS_OSC_STR 0.01

Threshold of oscillator strengths \(f^{(n)}\) for an excitation level. In case, the excitation level n has a smaller oscillator strength, the NTOs for this excitation level are not printed. [Edit on GitHub]

FILENAME: string = BSE-NTO_ANALYSIS

Usage: FILENAME ./filename

controls part of the filename for output. use __STD_OUT__ (exactly as written here) for the screen or standard logger. use filename to obtain projectname-filename. use ./filename to get filename. A middle name (if present), iteration numbers and extension are always added to the filename. if you want to avoid it use =filename, in this case the filename is always exactly as typed. Please note that this can lead to clashes of filenames. [Edit on GitHub]

LOG_PRINT_KEY: logical = F

Lone keyword: T

Usage: LOG_PRINT_KEY

This keywords enables the logger for the print_key (a message is printed on screen everytime data, controlled by this print_key, are written) [Edit on GitHub]

NUM_PRINT_EXC_NTOS: integer = -1

Usage: NUM_PRINT_EXC_NTOS 5

Number of excitation level \(n\) up to which NTOs are printed. By default, this is set to NUM_PRINT_EXC. Negative or too large NUM_PRINT_EXC_NTOS defaults to NUM_PRINT_EXC. [Edit on GitHub]

STATE_LIST: integer

Usage: STATE_LIST {integer} {integer} .. {integer}

Specifies a list of excitation levels \(n\) for which NTOs are printed. Overrides NUM_PRINT_EXC_NTOS. [Edit on GitHub]

STRIDE: integer = 2 2 2

Usage: STRIDE 2 2 2

The stride (X,Y,Z) used to write the cube file (larger values result in smaller cube files). Provide 3 numbers (for X,Y,Z) or 1 number valid for all components. [Edit on GitHub]

__CONTROL_VAL: integer = 8

hidden parameter that controls storage, printing,… of the print_key [Edit on GitHub]