quantum-espresso/README.md

65 lines
3.0 KiB
Markdown
Raw Normal View History

2018-01-28 19:11:52 +08:00
![q-e-logo](logo.jpg)
> This is the distribution of the Quantum ESPRESSO suite of codes (ESPRESSO:
> opEn-Source Package for Research in Electronic Structure, Simulation, and
> Optimization).
[![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)
## USAGE
Quick installation instructions for the impatient:
2018-01-28 19:11:52 +08:00
```
./configure [options]
make all
```
("make" alone prints a list of acceptable targets). Binaries go in bin/.
2018-01-28 19:11:52 +08:00
For more information, see the general documentation in directory Doc/,
package-specific documentation in \*/Doc/, and the web site
http://www.quantum-espresso.org/
2018-07-16 21:49:36 +08:00
## PACKAGES
- PWscf: structural optimisation and molecular dynamics on the electronic ground state, with self-consistent solution of DFT equations;
- CP: Car-Parrinello molecular dynamics;
2019-12-10 20:22:07 +08:00
- PHonon: vibrational and dielectric properties from DFPT (Density-Functional Perturbation Theory);
- TD-DFPT: spectra from Time-dependent DFPT;
- HP: calculation of Hubbard parameters from DFPT;
2018-07-16 21:49:36 +08:00
- EPW: calculation of electron-phonon coefficients in metals;
2019-12-10 20:22:07 +08:00
- PWCOND: ballistic transport;
- XSpectra: calculation of X-ray absorption spectra;
2018-07-16 21:49:36 +08:00
- PWneb: reaction pathways and transition states with the Nudged Elastic Band method;
- GWL: many-body perturbation theory in the GW approach using ultra-localised Wannier functions and Lanczos chains.
2018-07-16 21:56:58 +08:00
## Modular libraries
The following libraries have been isolated and partially encapsulated in view of their release for usage in other codes as well:
2018-07-19 15:06:33 +08:00
- UtilXlib: performing basic MPI handling, error handling, timing handling.
- FFTXlib: parallel (MPI and OpenMP) distributed three-dimensional FFTs, performing also load-balanced distribution of data (plane waves, G-vectors and real-space grids) across processors.
- LAXlib: parallel distributed dense-matrix diagonalization, using ELPA, SCALapack, or a custom algorithm.
- KS Solver: parallel iterative diagonalization for the Kohn-Sham Hamiltonian (represented as an operator),using block Davidson and band-by-band or block Conjugate-Gradient algorithms.
2018-07-19 15:06:33 +08:00
- LRlib: performs a variety of tasks connected with (time-dependent) DFPT, to be used also in connection with Many-Body Perturbation Theory.
## Contributing
Before contributing please read the [Contribution Guidelines](CONTRIBUTING.md).
2018-07-19 15:06:33 +08:00
2018-07-16 21:56:58 +08:00
2018-07-16 21:49:36 +08:00
2018-01-28 19:11:52 +08:00
## LICENSE
All the material included in this distribution is free software;
you can redistribute it and/or modify it under the terms of the GNU
General Public License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any later version.
These programs are distributed in the hope that they will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.