クイックスタート

インストール不要で試す: Playground を使えば、ブラウザ上ですぐに QUBO++ を試すことができます。

このページでは、クイックスタートの手順の概要を説明します。 Windows 11 の WSL 上に QUBO++ をインストールするより詳細な手順は Windows (WSL) でのクイックスタートをご覧ください。

インストール

インストール の手順に従って QUBO++ をインストールしてください。 Windows ユーザーは Windows (WSL) でのクイックスタート をご覧ください。

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

QUBO++ サンプルプログラムの作成

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

#include <qbpp/easy_solver.hpp>
#include <qbpp/qbpp.hpp>

int main() {
  auto a = qbpp::var("a");
  auto b = qbpp::var("b");
  auto c = qbpp::var("c");
  auto f = qbpp::sqr(a + 2 * b + 3 * c - 4);
  f.simplify_as_binary();

  std::cout << "f = " << f << std::endl;

  auto solver = qbpp::EasySolver(f);
  auto sol = solver.search({{"time_limit", 10}, {"target_energy", 0}});
  std::cout << "sol = " << sol << std::endl;
}

このプログラムでは，次の式$f$を展開整理して得られたQUBO式をEasySolverで解を求めます．

\[\begin{aligned} f &= (a+2b+3c-4)^2 \end{aligned}\]

プログラムのコンパイル

test.cpp をコンパイルして実行ファイル test を生成します：

g++ test.cpp -o test -std=c++17 -ldl -pthread

このコマンドにより、test という名前の実行ファイルが作成されます。コンパイラオプションの意味は以下の通りです：

-std=c++17: C++17 標準を使用します。
-ldl: 動的ローダライブラリをリンクします（QUBO++ は実行時に dlopen で .so をロードします）。
-pthread: POSIX スレッドのライブラリをリンクします（QUBO++ の .so が std::thread を内部で使用するため必須）。

プログラムの実行

test を以下のように実行すると，$f$を展開して得られた式と解を表示します：

./test
f = 16 -7*a -12*b -15*c +4*a*b +6*a*c +12*b*c
sol = 0:{{a,1},{b,0},{c,1}}

次のステップ

ライセンスをアクティベートしてください。詳細は ライセンス管理 をご覧ください。
QUBO++ の基本を学びましょう。QUBO++ (C++) の基礎から始めてください。
ケーススタディ で QUBO++ プログラムの例を探索してください。