qiskit.visualization.plot_distribution

qiskit.visualization.plot_distribution(data, figsize=(7, 5), color=None, number_to_keep=None, sort='asc', target_string=None, legend=None, bar_labels=True, title=None, ax=None, filename=None)

Tracer une distribution à partir de données échantillonnées en entrée.

Paramètres

• data (list ordict) – Il s'agit soit d'une liste de dictionnaires, soit d'un seul dictionnaire contenant les valeurs à représenter (par exemple : {‘001’: 130} )
• figsize (tuple) – Taille de la figure en pouces.
• color (list orstr) – Chaîne ou liste de chaînes pour les couleurs des barres de distribution.
• number_to_keep (int) – Le nombre de termes à tracer par ensemble de données. Le reste est transformé en une seule barre appelée "rest". Si plusieurs ensembles de données sont fournis, number_to_keep s'applique à chaque ensemble de données individuellement, ce qui peut donner plus de barres que number_to_keep + 1. Le site number_to_keep s'applique aux valeurs totales, plutôt qu'au tri sur l'axe des x.
• sort (string) – Peut être 'asc', 'desc', 'hamming', 'value', ou 'value_desc'. S'il est défini sur "value" ou "value_desc", l'axe des x sera trié en fonction de la probabilité maximale pour chaque chaîne de bits. La valeur par défaut est "asc".
• target_string (str) – Chaîne cible si "sort" est une mesure de distance.
• legend (list) – Une liste de chaînes de caractères à utiliser pour les libellés des données. Le nombre d'entrées doit correspondre à la longueur de la structure de données (s'il s'agit d'une liste) ou être égal à 1 (s'il s'agit d'un dictionnaire)
• bar_labels (bool) – Indiquez la valeur de probabilité de chaque barre de l'histogramme.
• title (str) – Chaîne de caractères à utiliser pour le titre de l'intrigue
• 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.
• filename (str) – chemin d'accès au fichier dans lequel l'image doit être enregistrée.

Retours

Un chiffre pour la distribution rendue, si le kwarg ax n'est pas défini.

Type de retour

matplotlib.Figure

Augmentations

• MissingOptionalLibraryError – Matplotlib n'est pas disponible.
• VisualizationError – Lorsque la légende est fournie et que sa longueur ne correspond pas à celle des données d'entrée.

Exemples

# Plot two counts in the same figure with legends and colors specified.

from qiskit.visualization import plot_distribution

counts1 = {'00': 525, '11': 499}
counts2 = {'00': 511, '11': 514}

legend = ['First execution', 'Second execution']

plot_distribution([counts1, counts2], legend=legend, color=['crimson','midnightblue'],
                title="New Distribution")

# You can sort the bitstrings using different methods.

counts = {'001': 596, '011': 211, '010': 50, '000': 117, '101': 33, '111': 8,
        '100': 6, '110': 3}

# Sort by the counts in descending order
dist1 = plot_distribution(counts, sort='value_desc')

# Sort by the hamming distance (the number of bit flips to change from
# one bitstring to the other) from a target string.
dist2 = plot_distribution(counts, sort='hamming', target_string='001')