C APIのインストール

前提条件

始める前に、Rustツールチェーンとclangコンパイラーがインストールされていることを確認してください。

次に、qiskit-fermions リポジトリをクローンします。

git clone git@github.com:Qiskit/qiskit-fermions.git
cd qiskit-fermions

次に、Qiskit C APIもコンパイルする必要があります。任意の場所で実行できますが、すぐに始めるには次の手順に従ってください。

git clone git@github.com:Qiskit/qiskit.git build/qiskit
cd build/qiskit
## git-checkout the latest stable tag
make c

ヒント

Windows のみ、追加のライブラリ・ファイルをコピーする必要があります。

Windows

cp target/release/qiskit_cext.dll dist/c/lib/qiskit_cext.dll
cp target/release/qiskit_cext.dll.lib dist/c/lib/qiskit_cext.dll.lib
cp target/release/qiskit_cext.dll.lib dist/c/lib/qiskit.dll.lib

これで、次のセクションの手順に従って qiskit-fermions C APIをコンパイルできます。

ソースからのコンパイル

まず、コンパイル済みのQiskit C APIライブラリとインクルード・ディレクトリの場所を、シェル環境に設定します。

重要

C APIはQiskitの C ライブラリにリンクするため、QISKIT_LIB と QISKIT_INCLUDE はそれを指している必要があります。未設定の場合、ビルドはC成果物を同梱するインストール済みの qiskit Pythonパッケージからこれらを推測しようとします（qiskit.capi.get_lib()/get_include()）。上記の build/qiskit クローンのような、別途コンパイルしたQiskit C APIに対してビルドするには、以下のように明示的に設定してください。

ヒント

このコードは、このページ冒頭のコードにある build/qiskit パスを使用しています。ご自身の環境に合わせてパスを調整してください。

UNIX

export QISKIT_LIB=$(find $(pwd)/build/qiskit/dist/c/lib -name "libqiskit.*")
export QISKIT_INCLUDE=$(pwd)/build/qiskit/dist/c/include

Windows

export QISKIT_LIB=$(find $(pwd)/build/qiskit/dist/c/lib -name "qiskit_cext.dll.lib")
export QISKIT_INCLUDE=$(pwd)/build/qiskit/dist/c/include

次に、qiskit-fermions C APIをコンパイルします。

make cext

インストールをテストしたい場合は、CMakeもインストールする必要があります。その後、Cのユニットテストを実行して、コンパイルをテストできます。

make testc

最後に、次の関連ファイルが存在することを確認します。

• dist/c/lib/libqiskit_fermions.so（拡張子はオペレーティング・システムによって異なる場合があります）

• dist/c/include/qiskit_fermions.h