Qiskitのインストール

要件

QiskitはPython 3.5あるいはそれ以降をサポートします。しかし、PythonもQiskitも進化中のエコシステムなので、どちらか一方が新しいリリースを発表すると、互換性の問題が発生することがあります。

Pythonをアップデートした後Qiskitのインストールや使用に問題が生じた場合は、 どのバージョンのPythonがサポートされているか、Qiskit Package metadata の**Programming Language** を確認して下さい。

科学技術計算用クロスプラットフォームのPythonディストリビューションである Anaconda をインストールすることをおすすめします。Qiskit tutorials とのやり取りには、Anacondaに含まれるJupyter Notebookをおすすめします。

Qiskitは以下の64ビットシステムでテストされサポートされています。

  • Ubuntu 16.04またはそれ以降

  • macOS 10.12.6またはそれ以降

  • Windows 7またはそれ以降

インストール

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

環境を使用するもっともシンプルな方法は、Anacondaに含まれている conda コマンドを使う方法です。Conda環境では、Pythonの特定のバージョンおよびライブラリを指定することができます。作業したいディレクトリでターミナルウィンドウを開きます。

It is preferred that you use Anaconda prompt installed with the Anaconda. All you have to do is create a virtual environment inside Anaconda and activate the environment. These commands can be run in Anaconda prompt irrespective of Windows or linux machine.

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

conda create -n name_of_my_env python=3

Activate your new environment.

conda activate name_of_my_env

注釈

If you are using conda versions prior to 4.6, use: For Linux or macOS: source activate name_of_my_env For Windows: activate name_of_my_env

次に、Qiskitパッケージをインストールします。Terra, Aer, Ignis, そしてAquaが含まれています。

pip install qiskit

注釈

Qiskit 0.13.0 以降は、qiskit-aer をLinux上のプリコンパイルされたライブラリからインストールするためには pip 19 以上のバージョンが必要です。pip 19がインストールされていない場合は pip install -U pip でアップグレード可能です。pip 19以降がインストールされていない状態でqiskit-aerをインストールしようとすると、sdist (source distribution) からのインストールが実行され、裏で aer をローカル・コンパイルしようとしてしまいます。

パッケージが正しくインストールされると、conda list で仮想環境に存在するアクティブなパッケージを見ることができます。

可視化機能またはjupyterノートブックを使用する場合は、可視化の追加要件を備えたqiskitをインストールすることをお勧めします。

pip install qiskit[visualization]

Zshユーザー(macOSの新しいバージョンではデフォルトのシェル)である場合は、引用符に qiskit[visualization] を入れる必要があります。

pip install 'qiskit[visualization]'

注釈

使いたいQiskitパッケージをインストールおよび検証したら、Pythonのある自分の環境にインポートして作業を始めます。

import qiskit

注釈

最新のQiskitコードに対して開発や寄与を行うことによってQiskitコミュニティに貢献したいときは、Build Qiskit packages from source を参照してください。

IBM Q Systemsへのアクセス

IBM Q では Qiskit の `量子クラウドサービス`を介して量子コンピューターの実機と高パフォーマンスの古典コンピューティング・シミュレーターを提供します。IBM Q システムにジョブを送るには次の手順にしたがって Qiskit 環境をセットアップしてください。

注釈

Qiskit 0.11のリリースに伴い, 過去にIBM Q credentialsをローカルに保存された場合は新しいIBM Q Experience V2を利用するために再度IBM Q Experience credentialsを更新する必要がある可能性があります。詳しくは Updating your IBM Q Experience Credentials を参照ください。

アカウントの設定には、ローカルの設定ファイルにAPIキーを追記します。

1. 無料のIBM Q Experience アカウントを作成します

手順 2: My Account に移動し、アカウントの設定を表示します。

Image of where to find the section 'My accounts'.

手順3: トークンをクリップボードにコピーするには、Copy token をクリックします。 このAPIトークンを一時的にあなたのお気に入りのテキストエディターに貼り付けておいて、後でアカウント設定ファイルを作成するときに使用できるようにします。

Image of where to get an API token.

手順4: 以下のコマンドを実行して、qiskitrc という設定ファイルで後に使用するために、ローカルにAPIトークンを保存します。 MY_API_TOKEN をテキストエディターに保存したAPIトークンの値に置き換えます。

from qiskit import IBMQ
IBMQ.save_account('MY_API_TOKEN')

複数のIBM Qアカウントの管理の仕方などの詳細については、The IBM Q Account を参照ください。

インストールされたバージョンの確認方法

Qiskit パッケージにはさまざまな要素の集まりが含まれているので、qiskit.__version__ の実行では、qiskit-terra パッケージのバージョンのみが返されるため、誤解を招く可能性があります。 これは Python の qiskit namespace が Qiskit パッケージから来ているのではなく、qiskit-terra パッケージの一部だからです。

import qiskit
qiskit.__version__
'0.14.2'

あなたの環境のすべての Qiskit 要素のバージョンを見るためには、__qiskit_version__ 属性を使います。例えば、次のコマンドを実行すると、インストールされている各 Qiskit パッケージのバージョンを含む dictionary が返されます。

qiskit.__qiskit_version__
{'qiskit-terra': '0.14.2',
 'qiskit-aer': '0.5.2',
 'qiskit-ignis': '0.3.3',
 'qiskit-ibmq-provider': '0.7.2',
 'qiskit-aqua': '0.7.3',
 'qiskit': '0.19.6'}

ちなみに

あなたが issue を出すときや、何かの理由であなたがインストールしている Qiskit バージョンを共有する必要があるときは、__qiskit_version__ attribute を使用してください。