稼働環境
nAG Library for Pythonの動作環境（OS）は以下となります。
- 64-bit Linux
- 64-bit Intel Mac
- 64-bit Windows
※ Python 3.7 以上が必要です。
インストール
python -m pip install --extra-index-url https://www.nag.com/downloads/py/naginterfaces_mkl naginterfaces
上記方法ではIntel MKLの最適化された線形代数ルーチンが内部的に利用されます。通常はこれで問題ありませんが、もしもnAGが提供する線形代数ルーチンを代わりに利用したい場合には、以下のようにインストールを行ってください。
python -m pip install --extra-index-url https://www.nag.com/downloads/py/naginterfaces_nag naginterfaces
依存パッケージであるNumPyは（まだインストールされていなければ）Pythonパッケージインデックスから自動的にインストールされます。
nAG Library for Python を既にインストールしている場合は、--upgrade オプションを付けてください。
python -m pip install --upgrade --extra-index-url https://www.nag.com/downloads/py/naginterfaces_mkl naginterfaces
※ インストールの詳細につきましては、ライブラリマニュアルの インストール をご参照ください。
アンインストール
python -m pip uninstall naginterfaces
ライセンスキーのインストール
nAG Library for Pythonを利用するためには以下のいずれかのnAGライブラリのライセンスキーが必要です。
- NLL6I31XVL (64-bit Linux)
- NLMI631XBL (64-bit Intel Mac)
- NLW6I31XEL (64-bit Windows)
Linux / Mac の場合
● テキスト形式のライセンスキーは「nag.key」という名前でホームディレクトリに保存してください。
~/nag.key
● USBキーライセンスの場合はご利用マシンにUSBキーを装着してください。
Windows（ノードロックライセンス）の場合
Windowsでノードロックライセンスをご利用の場合は、以下の手順でライセンスキーを取得・設定してください。
【手順1】KUSARI IDの確認
ライブラリをインストール後、コマンドプロンプトで以下を実行してください。
python -c "from naginterfaces.kusari import hostid; hostid()"
以下の例のようにKUSARI IDと製品コードが表示されます。
KUSARI ID = "JzouxncAcUekfxdbRoAoJDatimFsisIjf7nsxpcQoYeaalk" NAG Library product licensing code = NLW6I31XEL Host name = MyWinPC
【手順2】ライセンスキーの申請
以下のURLからライセンスキーを申請してください。
https://www.nag-j.co.jp/kusari/userReg/
申請の際には、上記で確認したKUSARI IDと製品コード（例：NLW6I31XEL）をご記入ください。通常2営業日以内でライセンスキーがメールで届きます。
届くライセンスキーの例：
NLW6I31XE FULL "XMnxidA3oeoj0F1Yvi5ibxPjB7"
【手順3】ライセンスキーの設定
以下のコマンドでGUIツールを起動します。
python -m naginterfaces.kusari
届いたライセンスキーを編集ボックスに貼り付けて「Install Licence Key」ボタンをクリックしてください。これでライセンスがWindowsレジストリに登録され、すぐに本製品をご利用いただけます。
トライアルライセンスご希望の方
トライアルをご希望の方は こちら からお申込み下さい。お申し込みが受け付けられるとメールでテキスト形式のトライアルライセンスファイル「nag.key」が送られてきますので、それをホームディレクトリに保存して下さい。
インストールの確認
インストールが上手くいったかどうかの確認は以下のコマンドで行っていただけます。
python -c "from naginterfaces import quick_check; quick_check()"
何も問題が無い場合は、各種情報が表示され、最後に以下のように表示されます。
QUICK CHECK: all ok
何か問題があった場合（例えばライセンスが見つかれない等）はその旨のエラーメッセージが表示されます。
Exampleを実行する
ここでは最適化問題を解いて答えを表示するExampleコードを実行してみます。nAG Library for Pythonに含まれる各ExampleはPythonモジュールとして実行可能です。例えば以下の様に行います。
python -m naginterfaces.library.examples.opt.handle_solve_ipopt_ex出力例
python -m naginterfaces.library.examples.opt.handle_solve_ipopt_ex
Trying:
main()
Expecting:
naginterfaces.library.opt.handle_solve_ipopt Python Example Results.
Solving a problem based on Hock and Schittkowski Problem 73.
Solving with a nonlinear objective.
At the solution the objective function is 2.9894378e+01.
ok
Exampleソースコードの場所の確認は、以下のコマンド例のように行う事が可能です。
python -m pydoc naginterfaces.library.examples.opt.handle_solve_ipopt_ex
マニュアルの参照方法
nAG Library for Pythonの完全なドキュメントは、以下のコマンドで参照可能です。
python -m pydoc naginterfaces
もしくはWeb上にもマニュアルは公開されています。
https://www.nag.com/numeric/py/nagdoc_latest/naginterfaces.html#ni-pkg