Python: pipコマンドを用いたインストール¶
対応環境¶
PyQBPP は以下の CPU を搭載した Linux ベースのシステムで動作します：
amd64: 64ビット Intel および AMD プロセッサ
arm64: 64ビット ARM プロセッサ (aarch64)
必要条件：
Ubuntu 20.04 以降（glibc 2.31 以上,manylinux_2_31 wheel）
Python 3.8 以降
pip20.3 以降（PEP 600 manylinux_2_31 wheel に対応するため）
Windows ユーザーは WSL (Windows Subsystem for Linux) を通じて PyQBPP を使用できます.
インストール¶
PyQBPP のインストール方法は2つあります：
方法1: PyPI（推奨） — Python Package Index から公開パッケージを直接インストール.
方法2: ローカル wheel — ダウンロードした
.whlファイルからインストール（オフライン環境や特定バージョンを固定したい場合に便利）.
どちらの方法も,Python 仮想環境（venv）内でインストールすれば sudo 権限は不要です.
方法1: PyPI によるインストール（推奨）¶
PyQBPP は PyPI で公開されています. パッケージの詳細については,PyQBPP PyPI ページを参照してください.
システムのパッケージと分離するため,Python 仮想環境（venv）の使用を推奨します：
python3 -m venv ~/qbpp-env
source ~/qbpp-env/bin/activate
pip install pyqbpp
アップグレード¶
pip install --upgrade pyqbpp
アンインストール¶
pip uninstall pyqbpp
方法2: ローカル wheel によるインストール¶
Latest Releases ページから最新の PyQBPP リリースの .whl ファイルをダウンロードし,pip でインストールします：
python3 -m venv ~/qbpp-env
source ~/qbpp-env/bin/activate
pip install pyqbpp-<VERSION>-py3-none-manylinux_2_31_x86_64.whl
<VERSION> は実際のリリースバージョンに置き換え,CPU アーキテクチャに応じて wheel を選択してください（amd64 なら x86_64,arm64 なら aarch64）.
環境変数の設定は不要です.
wheel には共有ライブラリ（qbpp_*.so,easysolver_*.so,exhaustive_*.so,abs3_*.so）と qbpp-license コマンドがすべて同梱されており,pip が仮想環境内に自動的に配置します.
PyQBPP のインポート¶
PyQBPP は,係数型・エネルギー型の組み合わせごとに複数のサブモジュールを提供しています.扱う係数・エネルギーの大きさに応じて選択してください：
import pyqbpp as qbpp # デフォルト: coeff=int32, energy=int64 (c32e64)
# import pyqbpp.c32e32 as qbpp # coeff=int32, energy=int32
# import pyqbpp.c64e64 as qbpp # coeff=int64, energy=int64
# import pyqbpp.c64e128 as qbpp # coeff=int64, energy=int128
# import pyqbpp.c128e128 as qbpp # coeff=int128, energy=int128
# import pyqbpp.cppint as qbpp # coeff=cpp_int, energy=cpp_int（任意精度）
import pyqbpp as qbpp は import pyqbpp.c32e64 as qbpp と等価であり,ほとんどの問題ではこれで十分です.
目的関数の係数やエネルギーが 32/64 ビット整数をオーバーフローし得る場合は,より大きい型のバリアントを使用してください.任意精度演算が必要な場合は pyqbpp.cppint を選びます.
1つの Python プロセスからは1つのバリアントのみをインポートしてください.
ライセンスのアクティベーション¶
インストール後,ライセンスをアクティベートして PyQBPP の使用を開始します：
qbpp-license -k XXXXXX-XXXXXX-XXXXXX-XXXXXX -a
qbpp-license コマンドは wheel によって仮想環境の bin/ ディレクトリにインストールされるため,venv をアクティベートすると自動的に PATH 上で利用可能になります.
無料の Trial ライセンス（30日間,10,000変数）は Hi-QUBO User Portal で取得できます.qbpp-license -s を実行してサインアップコードを得て,portal で登録,qbpp-license -k <KEY> -a で受け取ったキーをアクティベートしてください.
実行時に QBPP_LICENSE_KEY を使う¶
qbpp-license -a によるアクティベーションの代わりに,QBPP_LICENSE_KEY 環境変数でライセンスキーを渡すこともできます.コンテナ,CI ジョブ,Lambda／サーバレス環境など,ライセンスファイルを保存するのが難しい環境で特に便利です：
export QBPP_LICENSE_KEY=XXXXXX-XXXXXX-XXXXXX-XXXXXX
python3 my_qbpp_program.py
QBPP_LICENSE_KEY が設定されている場合,PyQBPP はディスクに状態を書き込まず,実行時にそのキーを直接使用します.
ライセンスの種類,ディアクティベーション,トラブルシューティングなどの詳細は ライセンス管理 をご覧ください.