はじめに#

インストール#

Qiskitを使い始めましょう！ 最初に行うことは、パッケージの実行方法とインストール方法を選択することです。 これを行うには、主に3つの方法があります。

Qiskit は Python 3.7 以降をサポートしています。ただし、Python と Qiskit はどちらも進化しているエコシステムであり、どちらか一方で新しいリリースが発生すると、互換性に問題が生じる場合があります。

始めるには Python をローカルシステムにダウンロードする必要があります。 Jupyter は Qiskit とのやり取りに推奨されます。

Qiskitを他のアプリケーションから明確に分離して、経験をよりよいものにするため、 Python仮想環境 を使用することをおすすめします。

Pythonのみをインストールした最小環境を作ります。

python3 -m venv /path/to/virtual/environment

新しい環境をアクティブにします。

source /path/to/virtual/environment/bin/activate

注: Windowsを使用している場合は、 PowerShellで以下のコマンドを使用します。

python3 -m venv c:\path\to\virtual\environment
c:\path\to\virtual\environment\Scripts\Activate.ps1

次に、 Qiskit パッケージをインストールします。

pip install qiskit

パッケージが正しくインストールされている場合は、 pip list を実行して、仮想環境でアクティブなパッケージを確認できます。

可視化機能やJupyter notebookを使用する場合は、Qiskitに visualization 機能を追加してインストールすることをお勧めします。

pip install qiskit[visualization]

zshユーザー（新しいバージョンのmacOSのデフォルトシェル）の場合は、 qiskit[visualization] を引用符で囲む必要があります。

pip install 'qiskit[visualization]'

以下のクラウドベンダーの環境では、Qiskitがプレインストールされています。

IBM Quantum Lab

Build quantum applications and experiments with Qiskit in a cloud programming environment.

Strangeworks

A platform that enables users and organizations to easily apply quantum computing to their most pressing problems and research.

Installing Qiskit from source allows you to access the current development version, instead of using the version in the Python Package Index (PyPI) repository. This will give you the ability to inspect and extend the latest version of the Qiskit code more efficiently.

Begin by making a new virtual environment and activating it:

python3 -m venv QiskitDevenv
source QiskitDevenv/bin/activate

ソースからインストールするには、システムにRustコンパイラがインストールされている必要があります。Rustコンパイラをインストールするには、クロスプラットフォームのRustインストーラである rustup を使用することをお勧めします。rustup を使用するには、次のURLにアクセスできます。

https://rustup.rs/

これは、プラットフォームに rust をインストールする方法の説明を提供します。rustup の他に、 他のインストール方法 も利用できます。

Once the Rust compiler is installed, you are ready to install Qiskit.

  1. Clone the Qiskit repository.

    git clone https://github.com/Qiskit/qiskit-terra.git

  2. レポジトリをクローンすると、``qiskit-terra``という名前のローカル・フォルダが作成されます。

    cd qiskit-terra

  3. もし、テストを実行したり文法をチェックしたい場合は、開発者向けライブラリーをインストールします。

    pip install -r requirements-dev.txt

  4. qiskit-terra をインストールします。

    pip install .

編集可能モード(プロジェクトのコードを変更しても再インストールする必要なし) でインストールする場合は、次の手順を実行します:

pip install -e .

編集可能モードでインストールすると、コンパイルされた拡張機能が最適化なしでデバッグモードでビルドされます。これは、コンパイルされたコードの実行時のパフォーマンスに影響します。編集可能モードを使用し、最適化を有効にしてリリースでコンパイルされたコードをビルドする場合は、次を実行できます。

python setup.py build_rust --release --inplace

pip を実行すると、バイナリーがリリース モードで再構築されます。Qiskit で Rust コードを使用している場合は、ローカルで変更を加えるたびに拡張コードを再構築する必要があります。 pip install -e . は、呼び出されたときにのみRust拡張機能をビルドするため、拡張機能を再構築しない限り、pip の実行後に Rust コードに加えたローカル変更はインストールされたパッケージに反映されません。上記の build_rust コマンドを利用してこれを行うことができます（ --release の有無にかかわらず、デバッグモードとリリースモードのどちらでビルドするかに基づきます）。

You can then run the code examples after installing Qiskit. You can run the example with the following command.

python examples/python/using_qiskit_terra_level_0.py

プラットフォーム・サポート#

Qiskit は可能な限り多くのプラットフォームをサポートするよう努めていますが、利用可能なテストリソースとプラットフォームの可用性に制限があるため、すべてのプラットフォームをサポートできるわけではありません。Qiskit のプラットフォーム・サポートは3つの層に分かれており、各層のサポートレベルは異なります。これら以外のプラットフォームの場合、Qiskit はおそらくまだインストール可能ですが、テストされていないため、ソースから Qiskit（およびおそらく Qiskit の依存関係）を構築する必要があります。

さらに、 Qiskit は CPython のみをサポートします。他の Python インタプリタとの実行は現在サポートされていません。

ティア 1#

ティア１がサポートするプラットフォームは、開発プロセスの一環としてアップストリームで完全にテストされ、提案された変更が正しく機能することを確認します。コンパイル済みのバイナリは、リリースプロセスの一部としてビルド、テスト、および PyPI に公開されます。これらのプラットフォームではすべての依存関係が利用可能であるため、これらのプラットフォームは、機能している Python環境だけでインストール可能であることが期待されます。

ティア１プラットフォームの現在：

  • Linux x86_64（ manylinux 2014 パッケージ仕様と互換性のあるディストリビューション）。

  • macOS x86_64 (10.9 以降 )

  • Windows 64ビット

ティア２#

ティア２プラットフォームは、開発プロセスの一部としてアップストリームでテストされていません。ただし、プリコンパイルされたバイナリは、リリースプロセスの一部としてビルド、テスト、および PyPI に公開され、これらのパッケージは、機能している Python環境のみでインストールされることが期待できます。

ティア２プラットフォームの現在：

  • Python < 3.10 向けの Linux i686（ manylinux 2014 パッケージ仕様と互換性のあるディストリビューション）。

  • Python < 3.10 向けの Windows 32ビット

  • Linux aarch64（ manylinux 2014 パッケージ仕様と互換性のあるディストリビューション）

ティア３#

ティア３プラットフォームは、開発プロセスの一部としてアップストリームでテストされていません。コンパイル済みのバイナリは、リリースプロセスの一部としてビルドされ、PyPI に公開されます。テストはまったく行われません。Python環境が機能しているだけではインストールできない場合があり、インストールプロセスの一部としてソースから依存関係を構築するためにC / C ++コンパイラまたは追加のプログラムが必要になる場合があります。これらのプラットフォームのサポートは最善の努力のみです。

ティア３プラットフォームの現在：

  • Linux ppc64le （ manylinux 2014 パッケージ仕様と互換性のあるディストリビューション）

  • Linux s390x （ manylinux 2014 パッケージ仕様と互換性のあるディストリビューション）

  • macOS arm64 (10.15 以降)

  • Python >= 3.10 向けの Linux i686（ manylinux 2014 パッケージ仕様と互換性のあるディストリビューション）

  • Python >= 3.10 向けの Windows 32ビット版

準備はいいですか？…#

Qiskit from the ground up

Learn how to build, execute, and post-process quantum circuits with Qiskit.

Start learning Qiskit

Dive into the tutorials

Find out how to leverage Qiskit for everything from single-circuits to full quantum application development.

Qiskit tutorials