TensorFlow Quantum (TFQ) を使用するために環境をセットアップするには、以下のような方法があります。
- TFQ を学習および使用する最も簡単な方法は、Google Colab を使用することです。ブラウザで直接 TensorFlow Quantum チュートリアルを実行します。インストールする必要はありません。
- ローカルマシンで TensorFlowQuantum を使用するには、Python の pip パッケージマネージャを使用して TFQ パッケージをインストールします。
- または、ソースから TensorFlow Quantum を構築します。
TensorFlow Quantum は Python 3.7、3.8 および 3.9 でサポートされています。また、Circq に直接依存しています。
Pip パッケージ
要件
- pip 19.0 以降 (
manylinux2010
サポートが必要) - TensorFlow == 2.11.0
Python 開発環境と(オプションの)仮想環境をセットアップするには、TensorFlow インストールガイドを参照してください。
pip
をアップグレードして TensorFlow をインストールします。
pip3 install --upgrade pip
pip3 install tensorflow==2.11.0
パッケージをインストールする
TensorFlow Quantum の最新のステーブル版をインストールします。
pip3 install -U tensorflow-quantum
成功: TensorFlow Quantum がインストールされました。
より新しいバージョンの TensorFlow に依存している可能性のある Nightly ビルドは、次のようにしてインストールできます。
pip3 install -U tfq-nightly
ソースから構築する
次の手順は、Ubuntu のようなシステムでテストされています。
1. Python 3 開発環境をセットアップする
まず、Python 3.8 開発ツールが必要です。
sudo apt update
sudo apt-get install pkg-config zip g++ zlib1g-dev unzip python3.8
sudo apt install python3.8 python3.8-dev python3.8-venv python3-pip
python3.8 -m pip install --upgrade pip
2. 仮想環境を作成する
ワークスペースディレクトリに移動し、TFQ 開発用の仮想環境を作成します。
python3.8 -m venv quantum_env
source quantum_env/bin/activate
3. Bazel をインストールする
TensorFlow のソースから構築するガイドに記載されているように、Bazel ビルドシステムが必要になります。
最新のソースビルドには、TensorFlow 2.11.0 が使用されています。互換性を確保するために、bazel
バージョン 5.3.0 を使用しています。Bazel の既存のバージョンを削除するには、以下を実行します。
sudo apt-get remove bazel
bazel
バージョン 5.3.0 をダウンロードしてインストールします。
wget https://github.com/bazelbuild/bazel/releases/download/5.3.0/bazel_5.3.0-linux-x86_64.deb
sudo dpkg -i bazel_5.3.0-linux-x86_64.deb
bazel
が互換性のないバージョンに自動更新されないようにするには、次のコマンドを実行します。
sudo apt-mark hold bazel
最後に、正しいbazel
バージョンのインストールを確認します。
bazel --version
4. ソースから TensorFlow Quantum を構築する
ここでは、TensorFlow のソースから構築するガイドからの説明を使用しました。詳細はリンクをご覧ください。TensorFlow Quantum は、TensorFlow バージョン 2.11.0 と互換性があります。
TensorFlow ソースコードをダウンロードします。
git clone https://github.com/tensorflow/tensorflow.git
cd tensorflow
git checkout v2.11.0
ステップ 2 で作成した仮想環境がアクティブになっていることを確認します。次に、TensorFlow の依存関係をインストールします。
pip install -U pip six numpy wheel setuptools mock 'future>=0.17.1'
pip install -U keras_applications --no-deps
pip install -U keras_preprocessing --no-deps
pip install numpy==1.24.2
pip install packaging requests
TensorFlow ビルドを構成します。Python インタープリタとライブラリの場所は、必ず仮想環境フォルダ内の場所に指定します。残りのオプションはデフォルト値のままにしておくことができます。
./configure
TensorFlow パッケージをビルドします(TF v2.8 以降、_GLIBCXX_USE_CXX11_ABI
は 1 に設定されており、c++ コードは -std=c++17
でコンパイルされています)。
bazel build -c opt --cxxopt="-O3" --cxxopt="-march=native" --cxxopt="-std=c++17" --cxxopt="-D_GLIBCXX_USE_CXX11_ABI=1" //tensorflow/tools/pip_package:build_pip_package
注:パッケージの構築には 1 時間以上かかる場合があります。
ビルドが完了したら、パッケージをインストールし、TensorFlow ディレクトリを離れます。
./bazel-bin/tensorflow/tools/pip_package/build_pip_package /tmp/tensorflow_pkg
pip install /tmp/tensorflow_pkg/<var>name_of_generated_wheel</var>.whl
cd ..
5. TensorFlow Quantum をダウンロードする
貢献には、標準のフォークとプルリクエストのワークフローを使用します。TensorFlow Quantum GitHub ページからフォークした後、フォークのソースをダウンロードして、要件をインストールします。
git clone https://github.com/<var>username</var>/quantum.git
cd quantum
pip install -r requirements.txt
6. TensorFlow Quantum pip パッケージを構築する
TensorFlow Quantum pip パッケージを構築し、以下をインストールします。
./configure.sh
bazel build -c opt --cxxopt="-O3" --cxxopt="-march=native" --cxxopt="-std=c++17" --cxxopt="-D_GLIBCXX_USE_CXX11_ABI=1" release:build_pip_package
bazel-bin/release/build_pip_package /tmp/tfquantum/
python3 -m pip install /tmp/tfquantum/<var>name_of_generated_wheel</var>.whl
TensorFlow Quantum が正常にインストールされたことを確認するには、次のテストを実行します。
./scripts/test_all.sh
成功: TensorFlow Quantum がインストールされました。