diff --git a/README.md b/README.md index 31857eeac9..e0c81ae655 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ # About ABACUS -ABACUS (Atomic-orbital Based Ab-initio Computation at UStc) is an open-source package based on density functional theory (DFT). The package utilizes both plane wave and numerical atomic basis sets with the usage of norm-conserving pseudopotentials to describe the interactions between nuclear ions and valence electrons. ABACUS supports LDA, GGA, meta-GGA, and hybrid functionals. Apart from single-point calculations, the package allows geometry optimizations and ab-initio molecular dynamics with various ensembles. The package also provides a variety of advanced functionalities for simulating materials, including the DFT+U, VdW corrections, and implicit solvation model, etc. In addition, ABACUS strives to provide a general infrastructure to facilitate the developments and applications of novel machine-learning-assisted DFT methods (DeePKS, DP-GEN, DeepH, DeePTB etc.) in molecular and material simulations. +ABACUS (**A**tomic-orbital **B**ased **A**b-initio **C**omputation at **US**tc) is an open-source package based on density functional theory (DFT). The package utilizes both plane wave and numerical atomic basis sets with the usage of pseudopotentials to describe the interactions between nuclear ions and valence electrons. ABACUS supports LDA, GGA, meta-GGA, and hybrid functionals. Apart from single-point calculations, the package allows geometry optimizations and ab-initio molecular dynamics with various ensembles. The package also provides a variety of advanced functionalities for simulating materials, including the DFT+U, VdW corrections, and implicit solvation model, etc. In addition, ABACUS strives to provide a general infrastructure to facilitate the developments and applications of novel machine-learning-assisted DFT methods (DeePKS, DP-GEN, DeepH, DeePTB etc.) in molecular and material simulations. # Online Documentation For detailed documentation, please refer to [our documentation website](https://abacus.deepmodeling.com/). diff --git a/docs/CITATIONS.md b/docs/CITATIONS.md index 406fc91205..5f2508f82a 100644 --- a/docs/CITATIONS.md +++ b/docs/CITATIONS.md @@ -4,10 +4,18 @@ The following references are required to be cited when using ABACUS. Specificall - **For general purpose:** + *For LCAO basis:* + Mohan Chen, G. C. Guo, and Lixin He. "Systematically improvable optimized atomic basis sets for ab initio calculations." Journal of Physics: Condensed Matter 22.44 (2010): 445501. Pengfei Li, et al. "Large-scale ab initio simulations based on systematically improvable atomic basis." Computational Materials Science 112 (2016): 503-517. + Peize Lin, Xinguo Ren, Xiaohui Liu, Lixin He. Ab initio electronic structure calculations based on numerical atomic orbitals: Basic fomalisms and recent progresses. Wiley Interdisciplinary Reviews: Computational Molecular Science, 2024, 14(1): e1687. + + *For LCAO and PW basis:* + + Weiqing Zhou, Deye Zheng, Qianrui Liu, et al. ABACUS: An Electronic Structure Analysis Package for the AI Era. arXiv preprint arXiv:2501.08697, 2025. + - **If Stochastic DFT is used:** Qianrui Liu, and Mohan Chen. "Plane-Wave-Based Stochastic-Deterministic Density Functional Theory for Extended Systems." . diff --git a/docs/DevelopingTeam.md b/docs/DevelopingTeam.md index 1862994511..333e923c67 100644 --- a/docs/DevelopingTeam.md +++ b/docs/DevelopingTeam.md @@ -4,5 +4,5 @@ The current development team consists the following research groups/affiliations - University of Science and Technology of China (Dr. Lixin He) - Peking University (Dr. Mohan Chen) - Institute of Physics, Chinese Academy of Sciences (Dr. Xinguo Ren) -- Beijing AI for Science Institute -- Institute of Artificial Intelligence, Hefei Comprehensive National Science Center. +- Beijing AI for Science Institute (Dr. Daye Zheng) +- Institute of Artificial Intelligence, Hefei Comprehensive National Science Center (Dr. Lixin He). diff --git a/docs/index.rst b/docs/index.rst index f0a5dcd8e3..93e15b0e3b 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -7,10 +7,10 @@ ABACUS Documentation ================================================= -ABACUS (Atomic-orbital Based Ab-initio Computation at UStc) is +ABACUS (**A**tomic-orbital **B**ased **A**b-initio **C**omputation at **US**tc) is an open-source computer code package based on density functional theory (DFT). The package utilizes both plane wave and numerical -atomic basis sets with the usage of norm-conserving pseudopotentials +atomic basis sets with the usage of pseudopotentials to describe the interactions between nuclear ions and valence electrons. ABACUS supports LDA, GGA, meta-GGA, and hybrid functionals. Apart from single-point calculations, the package allows geometry optimizations diff --git a/docs/quick_start/easy_install.md b/docs/quick_start/easy_install.md index 332300475a..edc82806a6 100644 --- a/docs/quick_start/easy_install.md +++ b/docs/quick_start/easy_install.md @@ -1,6 +1,6 @@ # Easy Installation -This guide helps you install ABACUS with basic features. **For DeePKS, DeePMD and Libxc support, or building with `make`, please refer to [the advanced installation guide](../advanced/install.md)** after going through this page. We recommend building ABACUS with `cmake` to avoid dependency issues. We recommend compiling ABACUS(and possibly its requirements) from the source code using the latest compiler for the best performace. You can try [toolchain](#install-requirements-by-toolchain) to install ABACUS and dependencies in a source-code compilation way with convience. You can also deploy ABACUS **without building** by [Docker](#container-deployment) or [conda](#install-by-conda). Please note that ABACUS only supports Linux; for Windows users, please consider using [WSL](https://learn.microsoft.com/en-us/windows/wsl/) or docker. +This guide helps you install ABACUS with basic features. **For DeePKS, DeePMD and Libxc support, or building with `make`, please refer to [the advanced installation guide](../advanced/install.md)** after going through this page. We recommend building ABACUS with `cmake` to avoid dependency issues. We recommend compiling ABACUS (and possibly its requirements) from the source code using the latest compiler for the best performace. You can try [toolchain](#install-requirements-by-toolchain) to install ABACUS and dependencies in a source-code compilation way with convience. You can also deploy ABACUS **without building** by [Docker](#container-deployment) or [conda](#install-by-conda). Please note that ABACUS only supports Linux; for Windows users, please consider using [WSL](https://learn.microsoft.com/en-us/windows/wsl/) or docker. ## Get ABACUS source code @@ -79,7 +79,7 @@ git remote -v # Replace "origin" with "upstream" or the remote name corresponding to deepmodeling/abacus-develop if necessary git fetch origin -git checkout v3.8.4 # Replace the tag with the latest version +git checkout v3.x.x # Replace the tag with the latest version, like v3.10.0 git describe --tags # Verify if the tag has been successfully checked out ``` diff --git a/docs/quick_start/hands_on.md b/docs/quick_start/hands_on.md index 2e0e768169..fe0111ea4c 100644 --- a/docs/quick_start/hands_on.md +++ b/docs/quick_start/hands_on.md @@ -4,7 +4,7 @@ ### A quick LCAO example -ABACUS is well known for its support of LCAO (Linear Combination of Atomic Orbital) basis set in calculating periodic condensed matter systems, so it's a good choice to start from a LCAO example of self-consistent field (SCF) calculation. Here, FCC MgO has been chosen as a quick start example. The default name of a structure file in ABACUS is `STRU`. The `STRU` file for FCC MgO in a LCAO calculation is shown below: +ABACUS is well known for its support of LCAO (Linear Combination of Atomic Orbital) basis set in calculating periodic condensed matter systems. It's a good choice to start from a LCAO example of self-consistent field (SCF) calculation. Here, FCC MgO has been chosen as a quick start example. The default name of a structure file in ABACUS is `STRU`. The `STRU` file for FCC MgO in a LCAO calculation is shown below: ``` #This is the atom file containing all the information @@ -48,11 +48,10 @@ Next, the `INPUT` file is required, which sets all key parameters to direct ABAC ``` INPUT_PARAMETERS suffix MgO -ntype 2 pseudo_dir ./ orbital_dir ./ ecutwfc 100 # Rydberg -scf_thr 1e-4 # Rydberg +scf_thr 1e-6 # SCF criterion basis_type lcao calculation scf # this is the key parameter telling abacus to do a scf calculation ``` @@ -71,7 +70,7 @@ Gamma After all the above input files have been set, one should be able to run the first quick example. The simplest way is to use the command line, e.g.: ``` -mpirun -np 2 abacus +OMP_NUM_THREADS=1 mpirun -np 2 abacus ``` The main output information is stored in the file `OUT.MgO/running_scf.log`, which starts with @@ -138,10 +137,9 @@ The `INPUT` file follows as: ``` INPUT_PARAMETERS suffix MgO -ntype 2 pseudo_dir ./ ecutwfc 100 # Rydberg -scf_thr 1e-4 # Rydberg +scf_thr 1e-6 # SCF criterion basis_type pw # changes the type of basis set calculation scf # this is the key parameter telling abacus to do a scf calculation ``` @@ -201,12 +199,11 @@ The `INPUT` is provided as follows: ``` INPUT_PARAMETERS suffix MgO -ntype 2 nelec 0.0 pseudo_dir ./ orbital_dir ./ ecutwfc 100 # Rydberg -scf_thr 1e-4 # Rydberg +scf_thr 1e-6 # SCF criterion basis_type lcao calculation cell-relax # this is the key parameter telling abacus to do a optimization calculation force_thr_ev 0.01 # the threshold of the force convergence, in unit of eV/Angstrom @@ -223,11 +220,10 @@ The `INPUT` is provided as follows: ``` INPUT_PARAMETERS suffix MgO -ntype 2 nelec 0.0 pseudo_dir ./ ecutwfc 100 # Rydberg -scf_thr 1e-4 # Rydberg +scf_thr 1e-6 # SCF criterion basis_type pw calculation cell-relax # this is the key parameter telling abacus to do a optimization calculation force_thr_ev 0.01 # the threshold of the force convergence, in unit of eV/Angstrom @@ -236,4 +232,4 @@ relax_nmax 100 # the maximal number of ionic iteration steps out_stru 1 ``` -Use the same `KPT`, `STRU`, and pseudopotential files as in the above SCF-PW examples. The final optimized structure can be found in `STRU_NOW.cif` and `OUT.MgO/running_cell-relax.log`. +Use the same `KPT`, `STRU`, and pseudopotential files as in the above SCF-PW examples. The final optimized structure can be found in `STRU_NOW.cif` and `STRU_ION_D` with different format. diff --git a/docs/quick_start/output.md b/docs/quick_start/output.md index ac649265f7..6a6e150d8e 100644 --- a/docs/quick_start/output.md +++ b/docs/quick_start/output.md @@ -6,7 +6,7 @@ The following files are the central output files for ABACUS. After executing the Different from `INPUT` given by the users, `OUT.suffix/INPUT` contains all parameters in ABACUS. -> **Note:** `OUT.suffix/INPUT` contain the initial default of ABACUS instead of the real parameters used in calculations. If you want to figure out the real parameters used in calculations, you can open `OUT.suffix/runing_scf.log` and research corresponding parameter you are interested. +> **Note:** `OUT.suffix/INPUT` contain the initial default of ABACUS instead of the real parameters used in calculations. This file is stored for reproduction in case the default value is changed during development. If you want to figure out the real parameters used in calculations, you can open `OUT.suffix/runing_scf.log` and research corresponding parameter you are interested. For a complete list of input parameters, please consult this [instruction](../advanced/input_files/input-main.md). @@ -33,9 +33,9 @@ BAND Energy(ev) Occupation Kpoint = 1 5 9.41058 0 ``` -## *STRU_SIMPLE.cif* +## *STRU.cif* -ABACUS generates a `.cif` format structure file based on the input file `STRU`, facilitating users to visualize with commonly used software. `STRU_READIN_ADJUST.cif` is the structure after considering symmetry. +ABACUS generates a `.cif` format structure file based on the input file `STRU`, facilitating users to visualize with commonly used software. ## *warning.log*