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)

Tracer la représentation de la qsphère d'un état quantique. Ici, la taille des points est proportionnelle à la probabilité du terme correspondant dans l'état et la couleur représente la phase.

Paramètres

• state (Statevector orDensityMatrix or ndarray) – un état quantique à N qubits.
• figsize (tuple) – Taille de la figure en pouces.
• ax (matplotlib.axes.Axes) – Un objet Axes facultatif à utiliser pour la sortie de la visualisation. Si aucune n'est spécifiée, une nouvelle figure matplotlib sera créée et utilisée. De plus, s'il est spécifié, aucun chiffre ne sera renvoyé car il est redondant.
• show_state_labels (bool) – Un booléen facultatif indiquant s'il faut afficher les étiquettes pour chaque état de la base.
• show_state_phases (bool) – Un booléen facultatif indiquant si la phase doit être affichée pour chaque état de base.
• use_degrees (bool) – Un booléen optionnel indiquant s'il faut utiliser des radians ou des degrés pour les valeurs de phase dans le tracé.
• filename (str | None) – Chemin d'accès facultatif vers lequel enregistrer l'image. Si aucune indication n'est fournie, aucun fichier n'est créé pour la visualisation. Si cette option est activée, la valeur de retour de cette fonction sera None.

Retours

Une instance de figure matplotlib si le kwarg ax n'est pas défini

Type de retour

matplotlib.figure.Figure

Augmentations

• MissingOptionalLibraryError – Nécessite matplotlib.
• VisualizationError – L'entrée n'est pas un état N-qubit valide.
• QiskitError – Le vecteur d'état d'entrée n'a pas de dimensions valides.

Exemples

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)