2.2. Installation

You can download HΦ at the following location.

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

You can obtain the HΦ directory by typing

$ tar xzvf HPhi-xxx.tar.gz

HΦ can be installed by using cmake. We can compile HΦ 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 HΦ 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 HΦ 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 HΦ 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 HΦ 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.