2. インストール¶
2.1. 必要なライブラリ¶
DSQSSの使用には以下のプログラム・ライブラリが必要です.
(Optional) MPI (PMWAを使用する場合には必須)
python 2.7 or 3.4+
numpy
scipy
toml
2.2. ダウンロード¶
アーカイブファイル (tar.gz) をダウンロードする場合
DSQSSの最新版は https://github.com/issp-center-dev/dsqss/releases からダウンロードできます.
gitを利用する場合
Gitを利用されている方は, 端末から以下のコマンドを打つことで直接ダウンロードできます.
$ git clone https://github.com/issp-center-dev/dsqss.git
2.3. フォルダ構成¶
DSQSSのダウンロード後にzipファイルを解凍すると, ファイルが展開されます(gitを利用された方は, cloneを行ったファイル直下のフォルダ構成になります). 以下, 重要なファイル・フォルダについてその構成を記載します.
|-- CMakeLists.txt
|-- LICENSE
|-- README.md
|-- config/
|-- doc/
|-- sample/
| |-- dla/
| `-- pmwa/
|-- src/
| |-- common/
| |-- dla/
| |-- pmwa/
| `-- third-party/
|-- test/
| |-- dla/
| |-- pmwa/
| `-- tool/
`-- tool/
|-- cmake/
|-- dsqss/
`-- setup.py
2.4. インストール¶
インストールは以下の手順で行うことが出来ます. 以下, ダウンロードしたファイルの直下にいることを想定しています.
$ mkdir dsqss.build && cd dsqss.build
$ cmake ../ -DCMAKE_INSTALL_PREFIX=/path/to/install/to
$ make
/path/to/install/to
をインストールしたい先のパスに設定してください(例: $HOME/opt/dsqss
).
指定しなかった場合のデフォルト値は /usr/local
です.
注釈
CMake はデフォルトで /usr/bin/c++
を C++ コンパイラとして使用します.
これ以外のコンパイラ、例えば インテルコンパイラ icpc
を使いたい場合は,
-DCMAKE_CXX_COMPILER
オプションを用いて明示的に指定してください:
$ cmake ../ -DCMAKE_CXX_COMPILER=icpc
インテルコンパイラに関しては, コンパイルオプション込みで設定するためのオプションを DSQSS 側で用意してあります:
$ cmake ../ -DCONFIG=intel
詳細については https://github.com/issp-center-dev/HPhi/wiki/FAQ をご覧ください.
これにより各実行ファイルが dsqss.build/src
ディレクトリ以下に,
入力ファイルの生成ツールが dsqss.build/tool
ディレクトリ以下に作成されます.
次に作成された実行ファイルが正常に動作するかテストするため, 以下のコマンドを打ちます.
$ make test
テストが100%通過したことが確認できた後, 以下のコマンドを入力しインストールします.
$ make install
実行バイナリが先に指定したインストールパスにある bin
ディレクトリに,
サンプルが share/dsqss/VERSION/samples
にインストールされます.
また, 補助ツールを含めたDSQSS の実行に必要な環境変数を設定するためのファイルが share/dsqss/dsqssvar-VERSION.sh
に生成されます.
DSQSS の実行前にはこのファイルを source
コマンドで読み込んでください.
$ source share/dsqss/dsqssvar-VERSION.sh