qiskit.visualization.plot_histogram

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

Tracer un histogramme des données de comptage d'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 l'histogramme.
• 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 du nombre de comptes 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) – Étiqueter chaque barre de l'histogramme avec une valeur de comptage.
• 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 l'histogramme rendu, 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.
• VisualizationError – Les données d'entrée doivent être des nombres ou un dictionnaire

Exemples

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

from qiskit.visualization import plot_histogram

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

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

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

# 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
hist1 = plot_histogram(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.
hist2 = plot_histogram(counts, sort='hamming', target_string='001')