qiskit.visualization.plot_state_qsphere

qiskit.visualization.plot_state_qsphere(state, figsize=None, ax=None, show_state_labels=True, show_state_phases=False, use_degrees=False, *, filename=None)

量子状態のqsphere表現をプロットする。 ここで、点の大きさは状態における対応する項の確率に比例し、色は位相を表す。

パラメーター

• state (Statevector orDensityMatrix or ndarray) – N量子ビットの量子状態。
• figsize (tuple) – フィギュアのサイズ（インチ）。
• ax (matplotlib.axes.Axes) – 可視化出力に使用するオプションのAxesオブジェクト。 何も指定しない場合、新しい matplotlib Figure が作成され、使用されます。 さらに、指定された場合、冗長であるため、返されるFigureはない。
• show_state_labels (bool) – 各基底状態のラベルを表示するかどうかを示すオプションのブール値。
• show_state_phases (bool) – 各基底状態の位相を表示するかどうかを示すオプションのブール値。
• use_degrees (bool) – プロットの位相値にラジアンを使うか度を使うかを示すオプションのブール値。

戻り値

ax kwarg が設定されていない場合の matplotlib 図インスタンス

戻りの型

matplotlib.figure.Figure

レイズ

• MissingOptionalLibraryError - matplotlibが必要。
• VisualizationError - 入力は有効なN量子ビット状態ではない。
• QiskitError - 入力 statevector が有効な次元を持っていない。

例

from qiskit import QuantumCircuit
from qiskit.quantum_info import Statevector
from qiskit.visualization import plot_state_qsphere

qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)

state = Statevector(qc)
plot_state_qsphere(state)

# You can show the phase of each state and use
# degrees instead of radians

from qiskit.quantum_info import DensityMatrix
import numpy as np
from qiskit import QuantumCircuit
from qiskit.visualization import plot_state_qsphere

qc = QuantumCircuit(2)
qc.h([0, 1])
qc.cz(0,1)
qc.ry(np.pi/3, 0)
qc.rx(np.pi/5, 1)
qc.z(1)

matrix = DensityMatrix(qc)
plot_state_qsphere(matrix,
     show_state_phases = True, use_degrees = True)