|
423 | 423 | - [pexsi\_zero\_thr](#pexsi_zero_thr) |
424 | 424 | - [Linear Response TDDFT](#linear-response-tddft) |
425 | 425 | - [xc\_kernel](#xc_kernel) |
| 426 | + - [lr\_init\_xc\_kernel](#lr_init_xc_kernel) |
426 | 427 | - [lr\_solver](#lr_solver) |
427 | 428 | - [lr\_thr](#lr_thr) |
428 | 429 | - [nocc](#nocc) |
|
434 | 435 | - [abs\_broadening](#abs_broadening) |
435 | 436 | - [ri\_hartree\_benchmark](#ri_hartree_benchmark) |
436 | 437 | - [aims\_nbasis](#aims_nbasis) |
| 438 | + - [Reduced Density Matrix Functional Theory](#Reduced-Density-Matrix-Functional-Theory) |
| 439 | + - [rdmft](#rdmft) |
| 440 | + - [rdmft\_power\_alpha](#rdmft_power_alpha) |
437 | 441 |
|
438 | 442 | [back to top](#full-list-of-input-keywords) |
439 | 443 | ## System variables |
@@ -988,7 +992,7 @@ calculations. |
988 | 992 |
|
989 | 993 | - **Type**: String |
990 | 994 | - **Description**: In our package, the XC functional can either be set explicitly using the `dft_functional` keyword in `INPUT` file. If `dft_functional` is not specified, ABACUS will use the xc functional indicated in the pseudopotential file. |
991 | | - On the other hand, if dft_functional is specified, it will overwrite the functional from pseudopotentials and performs calculation with whichever functional the user prefers. We further offer two ways of supplying exchange-correlation functional. The first is using 'short-hand' names such as 'LDA', 'PBE', 'SCAN'. A complete list of 'short-hand' expressions can be found in [the source code](../../../source/module_hamilt_general/module_xc/xc_functional.cpp). The other way is only available when ***compiling with LIBXC***, and it allows for supplying exchange-correlation functionals as combinations of LIBXC keywords for functional components, joined by a plus sign, for example, 'dft_functional='LDA_X_1D_EXPONENTIAL+LDA_C_1D_CSC'. The list of LIBXC keywords can be found on its [website](https://www.tddft.org/programs/libxc/functionals/). In this way, **we support all the LDA,GGA and mGGA functionals provided by LIBXC**. |
| 995 | + On the other hand, if dft_functional is specified, it will overwrite the functional from pseudopotentials and performs calculation with whichever functional the user prefers. We further offer two ways of supplying exchange-correlation functional. The first is using 'short-hand' names such as 'LDA', 'PBE', 'SCAN'. A complete list of 'short-hand' expressions can be found in [the source code](../../../source/module_hamilt_general/module_xc/xc_functional.cpp). The other way is only available when ***compiling with LIBXC***, and it allows for supplying exchange-correlation functionals as combinations of LIBXC keywords for functional components, joined by a plus sign, for example, dft_functional='LDA_X_1D_EXPONENTIAL+LDA_C_1D_CSC'. The list of LIBXC keywords can be found on its [website](https://libxc.gitlab.io/functionals/). In this way, **we support all the LDA,GGA and mGGA functionals provided by LIBXC**. |
992 | 996 |
|
993 | 997 | Furthermore, the old INPUT parameter exx_hybrid_type for hybrid functionals has been absorbed into dft_functional. Options are `hf` (pure Hartree-Fock), `pbe0`(PBE0), `hse` (Note: in order to use HSE functional, LIBXC is required). Note also that HSE has been tested while PBE0 has NOT been fully tested yet, and the maximum CPU cores for running exx in parallel is $N(N+1)/2$, with N being the number of atoms. And forces for hybrid functionals are not supported yet. |
994 | 998 |
|
@@ -1389,7 +1393,7 @@ These variables are used to control the geometry relaxation. |
1389 | 1393 | ### relax_nmax |
1390 | 1394 |
|
1391 | 1395 | - **Type**: Integer |
1392 | | -- **Description**: The maximal number of ionic iteration steps, the minimum value is 1. |
| 1396 | +- **Description**: The maximal number of ionic iteration steps. If set to 0, the code performs a quick "dry run", stopping just after initialization. This is useful to check for input correctness and to have the summary printed. |
1393 | 1397 | - **Default**: 1 for SCF, 50 for relax and cell-relax calcualtions |
1394 | 1398 |
|
1395 | 1399 | ### relax_cg_thr |
@@ -1717,7 +1721,7 @@ These variables are used to control the output of properties. |
1717 | 1721 |
|
1718 | 1722 | - **Type**: Boolean |
1719 | 1723 | - **Availability**: Numerical atomic orbital basis (not gamma-only algorithm) |
1720 | | -- **Description**: Whether to print the matrix representation of the position matrix (in Bohr) into a file named `data-rR-tr` in the directory `OUT.${suffix}`. For more information, please refer to [position_matrix.md](../elec_properties/position_matrix.md#extracting-position-matrices). |
| 1724 | +- **Description**: Whether to print the matrix representation of the position matrix (in Bohr) into a file named `data-rR-tr` in the directory `OUT.${suffix}`. If [calculation](#calculation) is set to `get_S`, the position matrix can be obtained without scf iterations. For more information, please refer to [position_matrix.md](../elec_properties/position_matrix.md#extracting-position-matrices). |
1721 | 1725 | - **Default**: False |
1722 | 1726 |
|
1723 | 1727 | ### out_mat_hs2 |
@@ -1760,14 +1764,14 @@ The band (KS orbital) energy for each (k-point, spin, band) will be printed in t |
1760 | 1764 |
|
1761 | 1765 | - **Type**: Boolean |
1762 | 1766 | - **Availability**: Numerical atomic orbital basis |
1763 | | -- **Description**: Whether to print Hamiltonian matrices H(R)/density matrics DM(R) in npz format. This feature does not work for gamma-only calculations. Currently only intended for internal usage. |
| 1767 | +- **Description**: Whether to print Hamiltonian matrices $H(R)$/density matrics $DM(R)$ in npz format. This feature does not work for gamma-only calculations. Currently only intended for internal usage. |
1764 | 1768 | - **Default**: False |
1765 | 1769 |
|
1766 | 1770 | ### dm_to_rho |
1767 | 1771 |
|
1768 | 1772 | - **Type**: Boolean |
1769 | 1773 | - **Availability**: Numerical atomic orbital basis |
1770 | | -- **Description**: Reads density matrix DM(R) in npz format and creates electron density on grids. This feature does not work for gamma-only calculations. Only supports serial calculations. Currently only intended for internal usage. |
| 1774 | +- **Description**: Reads density matrix $DM(R)$ in npz format and creates electron density on grids. This feature does not work for gamma-only calculations. Only supports serial calculations. Currently only intended for internal usage. |
1771 | 1775 | - **Default**: False |
1772 | 1776 |
|
1773 | 1777 | ### out_app_flag |
@@ -2926,7 +2930,7 @@ These variables are used to control DFT+U correlated parameters |
2926 | 2930 |
|
2927 | 2931 | - where $\gamma$ is a parameter that adjusts the relative weight of the error function to the derivative error function. |
2928 | 2932 | - **Unit**: Bohr |
2929 | | -- **Default**: 5.0 |
| 2933 | +- **Default**: 3.0 |
2930 | 2934 |
|
2931 | 2935 | [back to top](#full-list-of-input-keywords) |
2932 | 2936 |
|
@@ -3944,6 +3948,15 @@ These parameters are used to solve the excited states using. e.g. LR-TDDFT. |
3944 | 3948 | Currently supported: `RPA`, `LDA`, `PBE`, `HSE`, `HF`. |
3945 | 3949 | - **Default**: LDA |
3946 | 3950 |
|
| 3951 | +### lr_init_xc_kernel |
| 3952 | + |
| 3953 | +- **Type**: String |
| 3954 | +- **Description**: The method to initalize the xc kernel. |
| 3955 | + - "default": Calculate xc kerenel ($f_\text{xc}$) from the ground-state charge density. |
| 3956 | + - "file": Read the xc kernel $f_\text{xc}$ on grid from the provided files. The following words should be the paths of ".cube" files, where the first 1 (*[nspin](#nspin)==1*) or 3 (*[nspin](#nspin)==2*, namely spin-aa, spin-ab and spin-bb) will be read in. The parameter [xc_kernel](#xc_kernel) will be invalid. Now only LDA-type kernel is supproted as the potential will be calculated by directly multiplying the transition density. |
| 3957 | + - "from_charge_file": Calculate fxc from the charge density read from the provided files. The following words should be the paths of ".cube" files, where the first [nspin]($nspin) files will be read in. |
| 3958 | +- **Default**: "default" |
| 3959 | + |
3947 | 3960 | ### lr_solver |
3948 | 3961 |
|
3949 | 3962 | - **Type**: String |
@@ -4022,4 +4035,21 @@ The output files are `OUT.${suffix}/Excitation_Energy.dat` and `OUT.${suffix}/Ex |
4022 | 4035 | - **Description**: Atomic basis set size for each atom type (with the same order as in `STRU`) in FHI-aims. |
4023 | 4036 | - **Default**: {} (empty list, where ABACUS use its own basis set size) |
4024 | 4037 |
|
| 4038 | +## Reduced Density Matrix Functional Theory |
| 4039 | + |
| 4040 | +ab-initio methods and the xc-functional parameters used in RDMFT. |
| 4041 | +The physical quantities that RDMFT temporarily expects to output are the kinetic energy, total energy, and 1-RDM of the system in the ground state, etc. |
| 4042 | + |
| 4043 | +### rdmft |
| 4044 | + |
| 4045 | +- **Type**: Boolean |
| 4046 | +- **Description**: Whether to perform rdmft calculation (reduced density matrix funcional theory) |
| 4047 | +- **Default**: false |
| 4048 | + |
| 4049 | +### rdmft_power_alpha |
| 4050 | + |
| 4051 | +- **Type**: Real |
| 4052 | +- **Description**: The alpha parameter of power-functional(or other exx-type/hybrid functionals) which used in RDMFT, g(occ_number) = occ_number^alpha |
| 4053 | +- **Default**: 0.656 |
| 4054 | + |
4025 | 4055 | [back to top](#full-list-of-input-keywords) |
0 commit comments