# クイックスタート(quick start) :::{container} prog-cpp このページでは QUBO++ のクイックスタート手順を概説します。 ::: :::{container} prog-python このページでは PyQBPP のクイックスタート手順を概説します。 ::: Windows 11 上の WSL にインストールする詳細手順は[Windows（WSL）でのクイックスタート](https://hi-qubo.com/docs/startUp/WSL-quick-start.html)を参照してください。 ## ダウンロードとインストール :::{container} prog-cpp QUBO++ のインストール方法は2つあります： - 方法1: `apt`（推奨） — パスの自動設定を含むシンプルなインストール。`sudo` 権限が必要です。 - 方法2: `tar.gz` — `apt` リポジトリの設定が不要な手動インストール。`sudo` 権限は不要です。 ### 方法1: apt によるインストール（推奨）まず、QUBO++ の `apt` リポジトリを追加します： ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` 次に QUBO++ をインストールします： ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` これにより、ヘッダファイルが `/usr/local/include/qbpp/` に、共有ライブラリが `/usr/local/lib/` に、`qbpp-license` コマンドが `/usr/local/bin/` に自動的にインストールされます。環境変数の設定は不要です。新しいバージョンにアップグレードするには： ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` アンインストールするには： ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` ### 方法2: tar.gz によるインストール [2026.05.09 Releases](https://github.com/qubo-plus/qbpp/releases/tag/2026.05.09) ページから、最新の QUBO++ リリースの `.tar.gz` ファイルをダウンロードしてください。お使いの Windows PC のアーキテクチャに応じて、以下のいずれかのファイルをダウンロードしてください。 - `qbpp_amd64_.tar.gz` : Intel または AMD ベースの Windows PC 用 - `qbpp_arm64_.tar.gz` : ARM ベースの Windows PC 用（例：Copilot+ PC）ダウンロードできたら展開します: ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` QUBO++ は `qbpp__` のようなディレクトリに展開されます。このディレクトリへのシンボリックリンクを作成することを推奨します。 ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` これにより `qbpp` という名前のシンボリックリンクが作成され、インストールディレクトリへのアクセスが簡単になります。 QUBO++ の新バージョンへのアップグレードするには：新しい QUBO++ リリースをダウンロードし、上記の方法で `tar` を使って展開してください。その後、`qbpp` シンボリックリンクを新しいバージョンを指すように更新します。以下のコマンドを実行してください: ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` このコマンドは既存の qbpp シンボリックリンクを上書きし、新たにインストールしたバージョンを参照するようにします。 ::: :::{container} prog-python PyQBPPは**PyPI**で公開されています。パッケージの詳細については、[PyQBPP PyPIページ](https://pypi.org/project/pyqbpp/)を参照してください。 PyQBPPのインストールには、Python仮想環境(venv)の使用を推奨します。 sudo権限は不要です。 ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` 最新バージョンへのアップグレード: ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` ::: :::{container} prog-cpp ### 環境変数の設定以下の環境変数を設定してください: ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` これらの環境変数は、ライセンス管理および QUBO++ プログラムのコンパイル、リンク、実行に使用されます。これらのコマンドは、WSL シェル起動時に自動的に実行されるよう、`~/.bashrc` ファイルの末尾に追記することを推奨します。 ::: ## サンプルプログラムのコンパイルと実行 :::{container} prog-cpp ### QUBO++ サンプルプログラムの作成以下の内容でファイル `test.cpp` を作成します: ```{literalinclude} ../../programFiles/cppPrograms/startUp/quick-start-program1.cpp :language: cpp :caption: test.cpp ``` ::: :::{container} prog-python ### PyQBPP サンプルプログラムの作成以下の内容でファイル `test.py` を作成します: ```{literalinclude} ../../programFiles/pythonPrograms/startUp/quick-start-program1.py :language: python :caption: test.py ``` ::: :::{container} prog-cpp ### プログラムのコンパイル `test.cpp` をコンパイルして実行ファイル `test` を生成します: ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` このコマンドにより、test という名前の実行ファイルが作成されます。コンパイラオプションの意味は以下の通りです： - `-std=c++17`: C++17 標準を使用します。 - `-ldl`: 動的ローダライブラリをリンクします（Hi-QUBO は実行時に `dlopen` で `.so` をロードします）。 - `-pthread`: POSIX スレッドのライブラリをリンクします（Hi-QUBO の `.so` が `std::thread` を内部で使用するため必須）。 ::: ### プログラムの実行以下のように実行します: :::{container} prog-cpp ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` ::: :::{container} prog-python ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` ::: ## ライセンスについて ### Trial ライセンスの取得 ```{include} ../licenseManage/license-manage.md :start-after: :end-before: ``` ### ライセンスの有効化 QUBO++/PyQBPP のライセンスキーをお持ちの場合は、以下のいずれかの方法で設定してください。 ```{include} ../licenseManage/license-manage.md :start-after: :end-before: ``` 詳しくは[ライセンス管理](https://hi-qubo.com/docs/licenseManage/license-manage.html)を参照してください。

## ABS3 GPU Solver の実行システムに CUDA 対応 GPU が搭載されている場合、ABS3 GPU Solver は WSL 上で実行できます。 WSL で GPU アクセラレーションを有効にするには、以下のページから Windows 用 NVIDIA GPU ドライバーをインストールしてください: **注意:** WSL 内に Linux 用 GPU ドライバーをインストールしないでください。WSL は統合レイヤーを介して Windows GPU ドライバーを使用します。ドライバーをインストールした後、以下を実行して WSL 上で GPU が利用可能か確認してください: ```{include} ../../programFiles/markDown/startUp/quick-start-program.md :start-after: :end-before: ``` ドライバーが正しくインストールされていれば、このコマンドでインストールされている GPU に関する情報が表示されます。 ## 次のステップ - QUBO++/PyQBPP の基本を学習します。[変数の定義と式の作成](https://hi-qubo.com/docs/basic/variables-and-expressions.html)から開始。 - QUBO++/PyQBPP のサンプルプログラムを確認します。[最大公約数](https://hi-qubo.com/docs/tutorial/greatest-common-divisor-include.html)を参照。