2.2. Installation

You can download \({\mathcal H}\Phi\) at the following location.

https://github.com/issp-center-dev/HPhi/releases

You can obtain the \({\mathcal H}\Phi\) directory by typing

$ tar xzvf HPhi-xxx.tar.gz

\({\mathcal H}\Phi\) can be installed by using cmake. We can compile \({\mathcal H}\Phi\) as:

cd $HOME/build/hphi
cmake -DCONFIG=gcc $PathTohphi
make

To use ScaLAPACK library for full diagonalization, the cmake option -DUSE_SCALAPACK=ON is needed. Here, we set a path to \({\mathcal H}\Phi\) as $PathTohphi and to a build directory as $HOME/build/hphi. After compilation, src folder is constructed below a $HOME/build/hphi folder and we obtain an executable HPhi in src/ directory. When no MPI library exists in the system, an executable HPhi is automatically compiled without an MPI library.

In the above example, we compile \({\mathcal H}\Phi\) by using a gcc compiler. We can select a compiler by using the following options:

  • sekirei : ISSP system-B "sekirei"

  • sekirei_acc: ISSP system-B "sekirei" (for using MAGMA library)

  • fujitsu : Fujitsu compiler

  • intel : Intel compiler + Linux PC

  • gcc : GCC compiler + Linux PC.

An example of compiling \({\mathcal H}\Phi\) by using the Intel compiler is shown as follows:

mkdir ./build
cd ./build
cmake -DCONFIG=intel ../
make

After compilation, src folder is created below the build folder and an execute \({\mathcal H}\Phi\) in the src folder. Please note that we must delete the build folder and repeat the above operations when we change the compiler.

Tip

CMake automatically trys to download StdFace package (https://github.com/issp-center-dev/StdFace, parser for standard mode),
but this may fail due to network problem (e.g., IP unreachable)
In such a case, please run sh src/StdFace/download.sh to download manually.

If you want to use StdFace downloaded into another directory,
pass -DSTDFACE_DIR=<path_to_stdface> to cmake command.