Copyright (C) 2018-2024 ENVIRON (www.quantum-environ.org)
Environ 3.1 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.
Environ 3.1 is distributed in the hope that it 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 detail, either the file
`License' in the root directory of the present distribution, or
online at <http://www.gnu.org/licenses/>.
Name | Institution |
---|---|
Oliviero Andreussi | Department of Chemistry and Biochemistry, Boise State University |
Francesco Nattino | THEOS and NCCR-MARVEL, Ecole Polytechnique Federale de Lausanne |
Iurii Timrov | PSI Zurich and NCCR-MARVEL |
Ismaila Dabo | Department of Materials Science and Engineering, Penn State |
Nicola Marzari | THEOS and NCCR-MARVEL, Ecole Polytechnique Federale de Lausanne |
Quinn Campbell | Sandia National Labs |
Edan Bainglass | PSI Zurich and NCCR-MARVEL |
Matthew Truscott | Department of Physics, University of North Texas |
Gabriel Medrano | Department of Physics, University of North Texas |
This distribution of the Environ module is intended for Quantum ESPRESSO.
The steps below will cover the following:
- configuration of QE and Environ
- QE compilation
- Environ compilation
- QE patching, dependency updating, and recompilation
Note that Environ now uses its own FFTXlib and UtilXlib libraries modeled
respectively after the FFTXlib and UtilXlib libraries of QE 6.7
If there are any problems with the QE compilation step, look for solutions
on the PW-forum, or refer to the Quantum ESPRESSO documentation and/or website:
http://www.quantum-espresso.org/
The following instructions refer to Environ 3.0 installed on QE >= 7.1
For previous versions, please refer to the instructions on the website:
https://environ.readthedocs.io/en/latest/install/install.html
From Environ root:
-
configure Environ with
./configure --with-qe=<absolute_path_to_QE>
- the script will attempt to find the necessary libraries/compilers
- if it fails, the user may need to manually modify
make.inc
- if it fails, the user may need to manually modify
-
compile Environ with
make -jN compile
N
= number of cores for compilation (default = 1)- if issues arise, retry with
N
= 1
- if issues arise, retry with
From QE root:
-
configure QE with
./configure --with-environ=<absolute_path_to_Environ>
- the script will attempt to find the necessary libraries/compilers
- if it fails, the user may need to manually modify
make.inc
- if it fails, the user may need to manually modify
-
compile desired QE package with
make -jN <package>
N
= number of cores for compilation (default = 1)- if issues arise, retry with
N = 1
- if issues arise, retry with
- Environ supports the following QE packages: PW, CP, TDDFPT, XSpectra, NEB
-
create and navigate to a new directory (
build/
is a common choice) -
generate build environment with
cmake -DCMAKE_Fortran_COMPILER=<...> -DCMAKE_C_COMPILER=<...> -DENVIRON_ROOT=<absolute_path_to_Environ> ..
- more information can be found at https://gitlab.com/QEF/q-e/-/wikis/Developers/CMake-build-system
-
compile desired QE package as described above
If using cmake, modify the ESPRESSO_ROOT variable in the following files to reflect the build dir:
- Environ/tests/environment
- Environ/examples/qe/environment
From Environ root:
-
make clean
-
(OPTIONAL)
make veryclean
to also remove configuration files