Qiskitをインストールする
ローカルでもクラウド環境でも、すべてのユーザーにとって最初のステップはQiskitをインストールすることです。
(初めてQiskitをインストールする場合は、 インストールとセットアップのセクションに進んでください。 この通知は、以前にQiskitをインストールしたことのあるユーザーにのみ関係します)
バージョン 0.x から 1.0 以降にアップグレードされる方へ: Qiskit v1.0 は新しいパッケージ構造を使用しているため、 pip install -U qiskit を使用して Qiskit 0.x のどのバージョンからも 1.0 にアップグレードすることはできません。
詳細および手順については、 Qiskit 1.0 移行ガイドを参照してください。
Qiskit 1.0 から始まる将来のアップデートでは、インプレースアップグレードが可能になります。
Qiskit SDK をインストールする
-
Python をインストールします。 Qiskitの PyPI プロジェクトページにある「プログラミング言語」セクションを確認し、最新リリースでサポートされている Python のバージョンを確認してください。 ダウンロード方法については、『 Python 初心者ガイド 』をご覧ください。
Qiskitを他のアプリケーションから分離するために、 Python 仮想環境を使用することをお勧めします。
Note仮想 Python 環境は、特定の目的のために Python で作業するための隔離された空間です。そのため、マシンの「基本」 Python 環境に影響を与えることなく、好きなパッケージをインストールしたり、ライブラリや依存関係を設定したりすることができます。
仮想環境の重要な利点のひとつは、 Python 環境が途中で壊れても、簡単に仮想環境を削除してやり直せることだ!
仮想環境に関する情報を保存する場所を選択します。 通常は、作業中の各プロジェクト・ディレクトリ内の
.venvという名前のディレクトリに保存される。
まず、プロジェクト・ディレクトリに移動し、 Python のみをインストールした最小限の環境を作成する。
python3 -m venv .venvpython3 -m venv .venvpython -m venv .venv次に、新しい環境をアクティブにする。
source .venv/bin/activatesource .venv/bin/activateを使用する場合 PowerShell:
.venv\Scripts\Activate.ps1Git Bashを使用する場合:
source .venv/scripts/activateコマンドプロンプトを使用する場合:
.venv\Scripts\activate -
環境に pip がまだインストールされていない場合はインストールしてください。 Pipは Python パッケージマネージャで、Qiskitやその他の Python パッケージをインストールするのに使います。
pip listを使って、仮想環境にあるものを確認する。 ほとんどの Python 環境では、pipはすでにインストールされている。 -
Qiskit SDK をインストールしてください。
pip install qiskit可視化機能のサポートを追加する可視化機能やJupyterノートブックを使用する場合は、
qiskit.visualizationmoduleもインストールしてください。 詳細については、Visualizations API リファレンスを参照してください。
-
インストールしたQiskitパッケージでJupyterノートブックを実行したい場合は、Jupyterを環境にインストールする必要があります。
pip install jupyter次にノートブックを次のように開く:
jupyter notebook <path/to/notebook.ipynb>
ローカルで作業し、Qiskitに組み込まれたシミュレータを使用する予定であれば、インストールは完了です。 IBM QPUでジョブを実行したい場合は、 IBM Cloud アカウントのセットアップに進んでください。
新しいリリースの有無を確認するため、 定期的にQiskitのリリースノートを確認してください。 . pip install -U qiskitを実行して qiskit 、要件を頻繁に更新することをお勧めします。
Need help? Try asking Qiskit Code Assistant.
# Print the version of Qiskit we're using# Return True if the version of Qiskit is 1.0 or greater# Install Qiskit 1.0.2コードアシスタントは初めてですか? Qiskit Code Assistant を参照。 これは実験的な機能であり、 IBM Quantum Premium Plan ユーザーだけが利用できることに注意してください。
トラブルシューティング
pip install qiskitを使用し、仮想環境を で仮想環境をセットアップした場合、No Module 'qiskit'でチュートリアルを実行すると エラーが発生する可能性があります。 を実行すると Jupyter Notebook エラーが発生する可能性があります。 Qiskit をインストールしていない場合や仮想環境をセットアップしていない場合は、 インストール手順に従ってください。Qiskitがインストールされていない環境でQiskitパッケージをインポートしようとするとエラーが発生します。 Qiskitがインストールされていない環境で から起動した場合 Jupyter Notebook Navigator から起動した場合、 Jupyter Notebook が仮想環境ではなくベース(ルート)環境で実行されている可能性があります。 が実行されている可能性があります。 環境で実行されている可能性があります。 ドロップダウンメニューから Anaconda- Navigator の仮想環境を選択します。 の仮想環境を選択します。 このメニューでは Anaconda 内のすべての仮想環境を見ることができます。 Qiskit がインストールされている環境を選択して Jupyter Notebook を起動できます。
Qiskitは他の多くのオープンソース Python パッケージに依存しています。
pip install qiskitを実行すると自動的にインストールされる。 システムのプラットフォームと システムのプラットフォームと Python のバージョンによっては、特定のパッケージがあなたのシステム用のビルド済みバイナリを提供していない可能性があります。 パッケージがあなたのシステム用のビルド済みバイナリを提供していない可能性があります。 Qiskitがサポートしているプラットフォームの一覧は オペレーティングシステムサポートを参照してください。 を参照してください。 プリコンパイルされたバイナリが プリコンパイルされたバイナリがない場合、pipはパッケージをソースからコンパイルしようとします。 をソースからコンパイルしようとします。 を手動でインストールする必要があります。pip install qiskitの出力に似たような行がある場合:Failed building wheel for SOME_PACKAGE ... build/temp.linux-x86_64-3.5/_openssl.c:498:30: fatal error compilation terminated. error: command 'x86_64-linux-gnu-gcc' failed with exit status 1インストールに失敗したパッケージのドキュメントを確認してください。 ソースからのコンパイルに必要なライブラリのインストール方法については、インストールに失敗したパッケージのドキュメント(サンプル・コードでは、
SOME_PACKAGE)を確認してください。 をインストールする方法については、インストールに失敗したパッケージのドキュメントを参照してください。
オペレーティング・システム・サポート
Qiskitは可能な限り多くのオペレーティングシステムをサポートするよう努めていますが、利用可能なテストリソースやオペレーティングシステムの利用可能性に制限があるため、すべてのオペレーティングシステムをサポートできるわけではありません。 Qiskitのオペレーティングシステムのサポートは3つの階層に分かれており、それぞれの階層でサポートレベルが異なります。 FreeBSD や WebAssembly (WASI)など、これらのプラットフォーム以外の場合、Qiskitはまだインストール可能かもしれませんが、テストされていないため、Qiskit(およびおそらくQiskitの依存関係)をソースからビルドする必要があります。
さらに、Qiskitは Python 言語のCPython実装のみをサポートしています。 PyPy のような他の Python インタプリタでの実行はサポートされていません。
Qiskit v2.x
Qiskit v2.x リリースシリーズでは、対応プラットフォームは以下の通りです:
ティア1のオペレーティング・システムは、開発プロセスの一環として完全にテストされ、提案された変更が正しく機能することを確認する。 プリコンパイルされたバイナリはビルド、テストされ、リリースプロセスの一環として PyPI に公開される。 通常、 Python 環境がインストールされている限り、Qiskit はこれらのオペレーティングシステムにインストールすることができます。
ティア1オペレーティングシステム:
- Linux x86_64 ( manylinux 2014 パッケージング仕様と互換性のあるディストリビューション)。
- macOS ARM64 ( 11.0 またはそれ以降)
- Windows 64ビット(Windows 10以降に対応)
- Linux AArch64 ( manylinux2014 パッケージング仕様と互換性のあるディストリビューション)
ティア2オペレーティングシステムは、開発プロセスの一環としてテストされません。 ただし、事前コンパイル済みバイナリは、リリースプロセスの一環として構築、テストされ、 PyPI に公開されます。これらのパッケージは、正常に動作する Python 環境さえあればインストールできると期待できます。 これらのシステム向けのパッケージリリースには遅延が生じる可能性があります。テスト失敗がかなり後になってから検出される場合があり、また公開時の失敗はTier 1システム向けパッケージの公開をブロックしないためです。
ティア2オペレーティングシステム:
- macOS x86_64 ( 10.12 またはそれ以降)
ティア3のオペレーティングシステムは、開発プロセスの一環としてテストされることはない。 プリコンパイルされたバイナリは、リリースプロセスの一環としてビルドされ、 PyPI に公開されますが、テストは行われません。 これらは、 Python の環境だけではインストールできないかもしれません。また、インストールプロセスの一環として、C/C++コンパイラや、依存関係をソースからビルドするための追加プログラムが必要になるかもしれません。 これらのOSのサポートはベストエフォートのみです。
ティア3のオペレーティングシステム:
- Linux ppc64le ( manylinux 2014packaging 仕様と互換性のあるディストリビューション)
- Linux s390x ( manylinux2014 パッケージング仕様と互換性のあるディストリビューション)
Qiskit v2.0.0 からは64ビットプラットフォームのみがサポートされ、32ビットプラットフォームはサポートされません。 32ビットプラットフォーム上ではソース なぜならQiskit Rustコードは内部的に64ビットのポインタ幅を想定しているからです。
Qiskit v1.x
Qiskit v1.x リリースシリーズでは、対応プラットフォームは以下の通りです:
ティア1のオペレーティング・システムは、開発プロセスの一環として完全にテストされ、提案された変更が正しく機能することを確認する。 プリコンパイルされたバイナリはビルド、テストされ、リリースプロセスの一環として PyPI に公開される。 通常、 Python 環境がインストールされている限り、Qiskit はこれらのオペレーティングシステムにインストールすることができます。
ティア1オペレーティングシステム:
- Linux x86_64 ( manylinux 2014 パッケージング仕様と互換性のあるディストリビューション)。
- macOS x86_64 ( 10.12 またはそれ以降)
- macOS ARM64 ( 11.0 またはそれ以降)
- Windows 64ビット(Windows 10以降に対応)
ティア2のオペレーティングシステムは、開発プロセスの一環としてテストされない。 しかし、コンパイル済みのバイナリはビルドされ、テストされ、リリースプロセスの一環として PyPI に公開されており、これらのパッケージは Python 環境が機能しているだけでインストールされることが期待できる。
ティア2オペレーティングシステム:
- Linux AArch64 ( manylinux2014 パッケージング仕様と互換性のあるディストリビューション)
ティア3のオペレーティングシステムは、開発プロセスの一環としてテストされることはない。 プリコンパイルされたバイナリは、リリースプロセスの一環としてビルドされ、 PyPI に公開されますが、テストは行われません。 これらは、 Python 環境だけではインストー ルできないかもしれないし、インストール・プロセスの一環として、C/C++ コンパイラや、依存関係をソースからビルドするための追加プログラムが必要になるかもしれない。 これらのOSのサポートはベストエフォートのみです。
ティア3のオペレーティングシステム:
- Linux ppc64le ( manylinux 2014packaging 仕様と互換性のあるディストリビューション)
- Linux s390x ( manylinux2014 パッケージング仕様と互換性のあるディストリビューション)
- Linux i686 ( manylinux2014 パッケージング仕様と互換性のあるディストリビューション)
- Windows 10 32ビット
次のステップ
-
IBM Cloud アカウントを設定してください。
-
ハードウェアで最初の回路を実行するガイドの手順に従って、量子プログラムを記述し実行してください。
-
IBM Quantum Learning のチュートリアルを試してみてください。