Zainstaluj TensorFlow Quantum

Istnieje kilka sposobów skonfigurowania środowiska do korzystania z TensorFlow Quantum (TFQ):

  • Najprostszy sposób nauki i korzystania 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 języka Python.
  • Albo zbuduj TensorFlow Quantum ze źródła.

TensorFlow Quantum jest obsługiwany przez Python 3.10, 3.11 i 3.12 i bezpośrednio zależy od Cirq .

Pakiet Pip

Wymagania

Zapoznaj się z instrukcją instalacji TensorFlow , aby dowiedzieć się, jak skonfigurować środowisko programistyczne Pythona oraz (opcjonalne) środowisko wirtualne.

Zaktualizuj pip i zainstaluj TensorFlow 

  pip install --upgrade pip
  pip install tensorflow==2.16.2

Zainstaluj pakiet

Zainstaluj najnowszą stabilną wersję TensorFlow Quantum: 

  pip install -U tensorflow-quantum

Kompilacja ze źródła

Poniższe kroki zostały przetestowane w systemach typu Ubuntu.

1. Skonfiguruj środowisko programistyczne Python 3

Najpierw potrzebujemy narzędzi programistycznych Python 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 swojego obszaru roboczego i utwórz wirtualne środowisko do tworzenia TFQ. 

  python3.10 -m venv quantum_env
  source quantum_env/bin/activate

Upewnij się, że środowisko wirtualne jest aktywne na potrzeby pozostałych kroków poniżej oraz za każdym razem, gdy będziesz chciał użyć TFQ w przyszłości.

3. Zainstaluj Bazel

Jak zaznaczono w przewodniku kompilacji TensorFlow ze źródła , wymagany będzie system kompilacji Bazel .

Nasze najnowsze kompilacje źródłowe korzystają z TensorFlow 2.16.2. Aby zapewnić kompatybilność, używamy bazel w wersji 6.5.0. Aby usunąć dowolną istniejącą wersję Bazel: 

  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ę prawidłowej wersji oprogramowania bazel : 

  bazel --version

4. Zbuduj TensorFlow ze źródła

TensorFlow Quantum jest zgodny z TensorFlow w wersji 2.16.2. Aby skompilować TensorFlow ze źródeł, pobierz kod źródłowy TensorFlow, klonując repozytorium Git, a następnie przełącz się na gałąź r2.16 : 

  git clone https://github.com/tensorflow/tensorflow.git
  cd tensorflow
  git checkout r2.16

Upewnij się, że środowisko wirtualne utworzone w kroku 2 jest aktywowane, a następnie postępuj zgodnie z instrukcjami TensorFlow dotyczącymi tworzenia i instalowania pakietu pip w systemie.

Po zakończeniu kompilacji i zainstalowaniu pakietu pip opuść katalog TensorFlow, zanim przejdziesz do kroku 5: 

  cd ..

5. Pobierz TensorFlow Quantum

Do tworzenia wkładów używamy standardowego procesu forkowania i pull requestów . Po forkowaniu ze strony TensorFlow Quantum na GitHubie, pobierz kod źródłowy forka i zainstaluj wymagania: 

  git clone https://github.com/username/quantum.git
  cd quantum
  pip install -r requirements.txt

6. Zbuduj i zainstaluj TensorFlow Quantum

Upewnij się, że środowisko wirtualne utworzone w kroku 2 jest aktywowane. Następnie uruchom poniższe polecenie, aby zainstalować zależności TensorFlow Quantum: 

  pip install -r requirements.txt

Następnie użyj skryptu configure.sh pakietu TensorFlow Quantum, aby skonfigurować kompilację TFQ: 

  ./configure.sh

Teraz zbuduj TensorFlow Quantum: 

  bazel build -c opt --cxxopt="-O3" --cxxopt="-march=native" release:build_pip_package

Po zakończeniu kompilacji uruchom kolejne dwa polecenia, aby utworzyć pakiet Pythona dla TensorFlow Quantum i zapisać go w katalogu tymczasowym (w tym przykładzie używamy /tmp/tfquantum/ ), a następnie zainstaluj go za pomocą pip: 

  bazel-bin/release/build_pip_package /tmp/tfquantum/
  pip install /tmp/tfquantum/name_of_generated_wheel.whl

Aby potwierdzić, że instalacja TensorFlow Quantum przebiegła pomyślnie, możesz uruchomić testy: 

  ./scripts/test_all.sh