インストール

このページでは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
    
  • ローカルコンピュータからインストール

    1. GitHub からwheelパッケージをダウンロード

    2. wheelパッケージを任意のディレクトリに配置

    3. 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 .