クイックスタート

このページでは、クイックスタート手順の概要を説明します。 Windows 11 の WSL 上に QUBO++ をインストールする詳細な手順については、「Windows (WSL) 向けクイックスタート」を参照してください。

ダウンロードとインストール

最新版を tar.gz を「リリース」ページからダウンロードし、解凍してください：

$ tar xf qbpp_<arch>_<version>.tar.gz

QUBO++ は、次のようなqbpp_<arch>_<version>ディレクトリに抽出されます。

環境変数の設定

以下の環境変数を設定してください:

$ export QBPP_PATH=[QUBO++ install directory]
$ export CPLUS_INCLUDE_PATH=$QBPP_PATH/include:$CPLUS_INCLUDE_PATH
$ export LIBRARY_PATH=$QBPP_PATH/lib:$LIBRARY_PATH
$ export LD_LIBRARY_PATH=$QBPP_PATH/lib:$LD_LIBRARY_PATH

これらの環境変数は、ライセンス管理およびQUBO++プログラムのコンパイル、リンク、実行に使用されます。

サンプルプログラムのコンパイルと実行

以下のQUBO++サンプルプログラムを作成し、ファイルとして保存test.cppします：

#include "qbpp.hpp"
#include "qbpp_exhaustive_solver.hpp"

int main() {
  auto x = 0 <= qbpp::var_int("x") <= 10;
  auto y = 0 <= qbpp::var_int("y") <= 10;
  auto f = x + y == 10;
  auto g = 2 * x + 4 * y == 28;
  auto h = f + g;
  h.simplify_as_binary();
  auto solver = qbpp::exhaustive_solver::ExhaustiveSolver(h);
  auto sol = solver.search();
  std::cout << "sol = " << sol << std::endl;
  std::cout << "x = " << sol(x) << ", y = " << sol(y) << std::endl;
}

プログラムをコンパイル

プログラムをコンパイルします:

$ g++ test.cpp -o test -std=c++17 -lqbpp -ltbb

このコマンドは test という名前の実行可能ファイルを作成します。 コンパイラオプションの意味は以下の通りです：

• -std=c++17: C++17標準を使用します。
• -lqbpp: QUBO++ 共有ライブラリに対してリンクします。
• -ltbb: oneTBB共有ライブラリに対してリンクする。

プログラムを実行:

プログラムを次のように実行します:

$ ./test
sol = 0:{{x[0],0},{x[1],1},{x[2],1},{x[3],0},{y[0],0},{y[1],0},{y[2],1},{y[3],0}}
x = 6, y = 4

次の手順

1. 匿名トライアルライセンスまたはライセンスキーを有効化してください。詳細はQUBO++ドキュメントの「インストール」セクションを参照してください。
2. QUBO++の基本を学びます。QUBO++ドキュメントの「基本」から開始してください。