Istnieje kilka sposobów skonfigurowania środowiska do korzystania z TensorFlow Quantum (TFQ):
- Najprostszy sposób na naukę i korzystanie z TFQ nie wymaga instalacji — uruchom samouczki TensorFlow Quantum bezpośrednio w przeglądarce, korzystając z Google Colab .
- Aby używać TensorFlow Quantum na komputerze lokalnym, zainstaluj pakiet TFQ przy użyciu menedżera pakietów pip w języku Python.
- Lub zbuduj TensorFlow Quantum ze źródła.
TensorFlow Quantum jest obsługiwany w Pythonie 3.9, 3.10 i 3.11 i zależy bezpośrednio od Cirq .
Pakiet Pip
Wymagania
- pip 19.0 lub nowszy (wymaga obsługi
manylinux2014
) - TensorFlow == 2.15.0
Zobacz przewodnik instalacji TensorFlow , aby skonfigurować środowisko programistyczne Python i (opcjonalne) środowisko wirtualne.
Uaktualnij pip
i zainstaluj TensorFlow
pip3 install --upgrade pip
pip3 install tensorflow==2.15.0
Zainstaluj pakiet
Zainstaluj najnowszą stabilną wersję TensorFlow Quantum:
pip3 install -U tensorflow-quantum
Kompilacje nocne, które mogą zależeć od nowszej wersji TensorFlow, można zainstalować za pomocą:
pip3 install -U tfq-nightly
Kompiluj ze źródła
Poniższe kroki są testowane pod kątem systemów podobnych do Ubuntu.
1. Skonfiguruj środowisko programistyczne Python 3
Najpierw potrzebujemy narzędzi programistycznych Pythona 3.10.
sudo apt update
sudo apt-get install pkg-config zip g++ zlib1g-dev unzip python3.10
sudo apt install python3.10 python3.10-dev python3.10-venv python3-pip
python3.10 -m pip install --upgrade pip
2. Utwórz środowisko wirtualne
Przejdź do katalogu obszaru roboczego i utwórz wirtualne środowisko do programowania TFQ.
python3.10 -m venv quantum_env
source quantum_env/bin/activate
3. Zainstaluj Bazela
Jak zauważono w przewodniku dotyczącym kompilacji TensorFlow ze źródła , wymagany będzie system kompilacji Bazel .
Nasze najnowsze kompilacje źródłowe korzystają z TensorFlow 2.15.0. Aby zapewnić kompatybilność używamy wersji bazel
6.5.0. Aby usunąć istniejącą wersję Bazela:
sudo apt-get remove bazel
Pobierz i zainstaluj wersję bazel
6.5.0:
wget https://github.com/bazelbuild/bazel/releases/download/6.5.0/bazel_6.5.0-linux-x86_64.deb
sudo dpkg -i bazel_6.5.0-linux-x86_64.deb
Aby zapobiec automatycznej aktualizacji bazel
do niekompatybilnej wersji, uruchom następujące polecenie:
sudo apt-mark hold bazel
Na koniec potwierdź instalację poprawnej wersji bazel
:
bazel --version
4. Zbuduj TensorFlow ze źródła
Tutaj dostosowujemy instrukcje z przewodnika źródłowego dotyczącego kompilacji TensorFlow. Dalsze szczegóły znajdziesz w linku. TensorFlow Quantum jest kompatybilny z TensorFlow w wersji 2.15.0.
Pobierz kod źródłowy TensorFlow :
git clone https://github.com/tensorflow/tensorflow.git
cd tensorflow
git checkout v2.15.0
Upewnij się, że środowisko wirtualne utworzone w kroku 2 jest aktywowane. Następnie zainstaluj zależności 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.23.5
pip install packaging requests
Skonfiguruj kompilację TensorFlow. Gdy pojawi się pytanie o lokalizację interpretera Pythona i biblioteki, pamiętaj o określeniu lokalizacji w folderze środowiska wirtualnego. Pozostałe opcje można pozostawić na wartościach domyślnych.
./configure
Zbuduj pakiet TensorFlow (od TF v2.8, _GLIBCXX_USE_CXX11_ABI
jest ustawione na 1, a wszystkie kody C++ są kompilowane za pomocą -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
Po zakończeniu kompilacji zainstaluj pakiet i opuść katalog TensorFlow:
./bazel-bin/tensorflow/tools/pip_package/build_pip_package /tmp/tensorflow_pkg
pip install /tmp/tensorflow_pkg/name_of_generated_wheel.whl
cd ..
5. Pobierz TensorFlow Quantum
W przypadku wkładów korzystamy ze standardowego przepływu pracy związanego z żądaniem rozwidlenia i ściągnięcia . Po rozwidleniu ze strony TensorFlow Quantum GitHub pobierz źródło swojego rozwidlenia i zainstaluj wymagania:
git clone https://github.com/username/quantum.git
cd quantum
pip install -r requirements.txt
6. Zbuduj pakiet pip TensorFlow Quantum
Zbuduj pakiet pip TensorFlow Quantum i zainstaluj:
./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/name_of_generated_wheel.whl
Aby potwierdzić, że TensorFlow Quantum został pomyślnie zainstalowany, możesz uruchomić testy:
./scripts/test_all.sh