Installation
Downloading
Koopmans is available to download on github. You can clone it directly with
git clone --recursive git@github.com:epfl-theos/koopmans.git
Installing
Quick installation
For a quick installation one can simply run make; sudo make install
Detailed installation
Setting up a virtual environment
You are encouraged (but it is not necessary) to first create and activate a virtual environment as follows:
sudo apt-get install python3-pip
pip3 install virtualenv
virtualenv ~/venvs/koopmans
source ~/venvs/koopmans/bin/activate
Note that koopmans
requires python v3.7 or later. If your computer’s version of python3 corresponds to an earlier version, install python v3.7 or later, and then direct virtualenv
to create the virtual environment using that specific installation of python via
virtualenv ~/venvs/koopmans -p /usr/bin/python3.x
Fetching the submodules
Now, ensure you have downloaded the various git
submodules. To do so, run make submodules
, or equivalently
git submodule init
git submodule update
Compiling Quantum ESPRESSO
Then you need to compile the copies of Quantum ESPRESSO
. To do this, run
make espresso MPIF90=<mpif90>
where <mpif90>
should be replaced by the name of your chosen MPI Fortran90 compiler e.g. MPIF90=mpiifort
. The code should automatically detect and link the requisite libraries. (If this fails you may need to manually compile the two versions of Quantum ESPRESSO
contained in the quantum_espresso/
directory.)
Adding Quantum ESPRESSO to your path
To add all of the Quantum ESPRESSO binaries to your path, run
sudo make install
By default this will copy the Quantum ESPRESSO binaries to /usr/local/bin
. This requires sudo privileges. If you do not have sudo privileges, you can either (a) install the codes in a different location by running make install PREFIX=/path/to/bin/
(substitute /path/to/bin/
with any directory of your choosing that is on your path) or (b) append bin/
from the current directory to your path.
Installing the workflow manager
Finally, install the python workflow manager, either via make workflow
, or
python3 -m pip install --upgrade pip
python3 -m pip install -e .