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)

Zeichnen Sie ein Histogramm der eingegebenen Zähldaten.

Parameter

• data (list ordict) – Dies ist entweder eine Liste von Wörterbüchern oder ein einzelnes Wörterbuch, das die darzustellenden Werte enthält (z. B. {'001': 130})
• figsize (tuple) – Größe der Figur in Zoll.
• color (list orstr) – Zeichenkette oder Liste von Zeichenketten für Histogrammbalkenfarben.
• number_to_keep (int) – Die Anzahl der Terme, die pro Datensatz dargestellt werden sollen. Der Rest wird zu einem einzigen Balken mit der Bezeichnung "Rest" zusammengefasst. Wenn mehrere Datensätze angegeben werden, gilt number_to_keep für jeden einzelnen Datensatz, was zu mehr Balken als number_to_keep + 1 führen kann. Die Website number_to_keep gilt für die Gesamtwerte und nicht für die Sortierung auf der x-Achse.
• sort (string) – Kann 'asc', 'desc', 'hamming', 'value' oder 'value_desc' sein. Bei der Einstellung "value" oder "value_desc" wird die x-Achse nach der Anzahl der Zählungen für jeden Bitstring sortiert. Der Standardwert ist 'asc'.
• target_string (str) – Zielzeichenfolge, wenn "sort" ein Abstandsmaß ist.
• legend (list) – Eine Liste von Zeichenfolgen, die als Beschriftungen für die Daten verwendet werden sollen. Die Anzahl der Einträge muss mit der Länge von „data“ übereinstimmen (sofern „data“ eine Liste ist; andernfalls muss der Wert 1 sein, wenn es sich um ein Wörterbuch handelt)
• bar_labels (bool) – Beschriften Sie jeden Balken im Histogramm mit einem Zählwert.
• title (str) – Eine Zeichenkette, die für den Titel der Handlung verwendet wird
• ax (matplotlib.axes.Axes) – Ein optionales Achsenobjekt, das für die Visualisierungsausgabe verwendet werden soll. Wenn keine angegeben wird, wird eine neue Matplotlib-Figur erstellt und verwendet. Außerdem wird, falls angegeben, keine Abbildung zurückgegeben, da sie redundant ist.
• filename (str) – dateipfad, in dem das Bild gespeichert werden soll.

Rückgabe

Eine Zahl für das gerenderte Histogramm, wenn die ax kwarg nicht eingestellt ist.

Rückgabetyp

matplotlib.Figure

Erhöht

• MissingOptionalLibraryError – Matplotlib ist nicht verfügbar.
• VisualizationError – Wenn eine Legende angegeben wird und deren Länge nicht mit den Eingabedaten übereinstimmt.
• VisualizationError – Die Eingabe muss entweder „Counts“ oder ein Dict sein

Beispiele

# 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')