Installation

Requirements

Python (>=3.6)
NumPy (>=1.18.0)
f90wrap (latest)
Quantum ESPRESSO (==7.2)
Compiler (GNU(Recommended) or Intel)

Optional (highly recommended):

mpi4py MPI for python
ASE for atomic simulation
DFTpy for density functional

Installation

Pip

Using pip can easy install the release version (serial) of QEpy from PyPI:

$ python -m pip install qepy

Note

Install the QEpy using pip only support serial version. If want to run parallel version or use some custom features, please install QEpy from source.

Source

You can download the QEpy source file from gitlab.

git clone --recurse-submodules https://gitlab.com/shaoxc/qepy.git
python -m pip install -U ./qepy

or with all features:

oldxml=yes ldau=yes tddft=yes python -m pip install -U ./qepy

Example on Ubuntu 22.04

sudo apt-get update
sudo apt-get install --upgrade -y make git python3-dev python3-pip wget
sudo apt-get install --upgrade -y gcc gfortran libblas-dev liblapack-dev libopenmpi-dev libfftw3-dev
git clone --depth=1 -b qe-7.2 https://gitlab.com/QEF/q-e.git
cd q-e
./configure CFLAGS=-fPIC FFLAGS='-fPIC -fallow-argument-mismatch' MPIF90=mpif90 --with-scalapack=no BLAS_LIBS='-lblas' LAPACK_LIBS='-llapack'
make all -j 8
make all -j 8
cd ..
git clone --recurse-submodules https://gitlab.com/shaoxc/qepy.git
qedir=`pwd`/q-e/ python3 -m pip install -U ./qepy

Tips

Environment variable qedir should be the absolute path of QE, which contains the make.inc file. If not set qedir, the installation will download the QE code from gitlab and automatically compile it.
If not clone the submodules in the beginning, can update through:
```
git submodule update --init --recursive
```
Set the variables can help you customize your build.

e.g.
- “tddft=yes” support real-time TDDFT by using ce-tddft.

Install the QE

The QE should be compiled before QEpy with the -fPIC (position-independent code) compiler option. Add -fPIC to the configuration options. E.g.,
./configure CFLAGS=-fPIC FFLAGS=-fPIC
Then,
make all
export qedir=`pwd`

More examples for QE

pass

Unix

./configure FFLAGS='-fPIC -fallow-argument-mismatch' CFLAGS=-fPIC

MacOS

./configure FFLAGS='-fPIC -fallow-argument-mismatch -ff2c -fno-second-underscore' CFLAGS='-fPIC -arch arm64' CPP='gcc -E' LDFLAGS=-headerpad_max_install_names

Note

Because QEpy still under active development, non-backward-compatible changes can happen at any time. Please, clone the lastest release often.