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)

양자 상태의 큐스피어 표현을 플롯합니다. 여기서 점의 크기는 상태의 해당 항의 확률에 비례하며, 색상은 위상을 나타냅니다.

매개변수

• state (Statevector orDensityMatrix or ndarray) – n-큐비트 양자 상태입니다.
• figsize (tuple) – 그림 크기(인치).
• ax (matplotlib.axes.Axes) – 시각화 출력에 사용할 선택적 축 개체입니다. 아무것도 지정하지 않으면 새 matplotlib 그림이 생성되어 사용됩니다. 또한 지정한 경우 중복되므로 반환되는 그림이 없습니다.
• show_state_labels (bool) – 각 기준 상태에 대한 레이블을 표시할지 여부를 나타내는 선택적 부울입니다.
• show_state_phases (bool) – 각 기준 상태의 위상을 표시할지 여부를 나타내는 선택적 부울입니다.
• use_degrees (bool) – 플롯의 위상 값에 라디언 또는 도를 사용할지 여부를 나타내는 선택적 부울입니다.
• filename (str | None) – 이미지를 저장할 선택적 파일 경로입니다. 명시되지 않은 경우, 시각화를 위한 파일이 생성되지 않습니다. None이 옵션이 설정되면 이 함수의 반환값은.가 됩니다.

리턴

ax kwarg가 설정되지 않은 경우 matplotlib 그림 인스턴스

리턴 유형

matplotlib.figure.Figure

레이즈

• MissingOptionalLibraryError – matplotlib이 필요합니다.
• VisualizationError – 입력값이 유효한 N-큐비트 상태가 아닙니다.
• QiskitError – 입력 상태 벡터의 차원이 유효하지 않습니다.

예제

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)