インストール¶
このページではNLCPyのインストール方法について説明します。
注意
2021年4月から、NLCPyはNEC SDK (NEC Software Development Kit for Vector Engine)の中で提供されています。それ以降にNEC SDKがマシンに適切にインストールまたは更新されていれば、本ページに記載のインストールを実施することなく、
/usr/bin/python3
コマンドを使ってNLCPyをご利用いただけます。しかし、その他のPythonコマンド(/usr/local/bin/python3
や仮想環境の python3 等)をご利用の場合は、本ページに記載の通りにwheelパッケージまたはソースからインストールしてください。
NEC SDKがインストールされたら、NLCPyのライブラリは以下のディレクトリにあります。
/opt/nec/ve/nlcpy/X.X.X/lib/python36/nlcpy
ここで、X.X.XはNLCPyのバージョン番号を表します。もし、NEC SDKをインストールまたはアップデートした場合は、NLCPyの最新バージョンのディレクトリがPythonモジュール検索パスに追加されます。NLCPyの特定のバージョンを使用するときは、環境変数 PYTHONPATH を以下のように設定してください。
$ export PYTHONPATH=/opt/nec/ve/nlcpy/X.X.X/lib/python36/
インストール要件¶
NLCPyをインストールする前に、以下のコンポーネントをSX-Aurora TSUBASAのx86ノードにインストールする必要があります。
-
必要なNEC C/C++ コンパイラバージョン: >= 3.1.1
必要なNLCバージョン: >= 2.2.0
-
注意
VEOS 2.5.1以降がマシンにインストールされていれば、以下のAVEOパッケージのインストールは不要です。
yum コマンドでパッケージをインストールするためには、root権限で以下のコマンドを実行します。NLCPyをwheelパッケージからインストールする場合は、Alternative VE Offloading(AVEO)のランタイムパッケージが必要です。
$ yum install veoffload-aveo veoffload-aveorun
NLCPyをソースコードからビルドしてインストールする場合は、Alternative VE Offloading(AVEO)のdevelopmentパッケージが必要です。
$ yum install veoffload-aveo-devel veoffload-aveorun-devel
-
必要なバージョン: 3.6, 3.7, 3.8 のいずれか
-
必要なバージョン: v1.17, v1.18, v1.19, or v1.20 のいずれか
wheelパッケージからインストール¶
NLCPyは、次のいずれかのコマンドを実行してインストールできます。
PyPIからのインストール
$ pip install nlcpy
ローカルコンピュータからインストール
GitHub からwheelパッケージをダウンロード
wheelパッケージを任意のディレクトリに配置
pipコマンドを使用してローカルのwheelパッケージをインストール
$ pip install <path_to_wheel>
wheelパッケージに含まれているVector Engine用の共有オブジェクトは、NEC C/C++ バージョン3.1.1とNumPy v1.17.4を使用してコンパイルおよびテストしています。
ソースからインストール(ビルドあり)¶
ソースファイルをビルドする前に、以下のパッケージをインストールしてください。
$ pip install numpy cython wheel
そして、gcc および ncc コマンドが使用可能な環境で以下のコマンドを入力します。
$ git clone https://github.com/SX-Aurora/nlcpy.git
$ cd nlcpy
$ pip install .