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)

Traccia un istogramma dei dati dei conteggi in ingresso.

Parametri

• data (list ordict) – Si tratta di un elenco di dizionari oppure di un singolo dizionario contenente i valori da rappresentare (ad es. {'001': 130})
• figsize (tuple) – Dimensioni della figura in pollici.
• color (list orstr) – Stringa o elenco di stringhe per i colori delle barre dell'istogramma.
• number_to_keep (int) – Il numero di termini da tracciare per ogni set di dati. Il resto viene trasformato in un'unica barra chiamata "riposo". Se vengono forniti più set di dati, number_to_keep si applica a ciascun set di dati individualmente, il che può risultare in un numero maggiore di barre rispetto a number_to_keep + 1. Il sito number_to_keep si applica ai valori totali, piuttosto che all'ordinamento sull'asse delle ascisse.
• sort (string) – Può essere 'asc', 'desc', 'hamming', 'value' o 'value\desc'. Se impostato su 'value' o 'value_desc', l'asse x sarà ordinato in base al numero di conteggi per ogni bitstring. Valore predefinito: "asc".
• target_string (str) – Stringa di destinazione se 'sort' è una misura di distanza.
• legend (list) – Un elenco di stringhe da utilizzare come etichette per i dati. Il numero di voci deve corrispondere alla lunghezza di data (se data è una lista) oppure deve essere pari a 1 se si tratta di un dizionario
• bar_labels (bool) – Etichettare ogni barra dell'istogramma con il valore dei conteggi.
• title (str) – Una stringa da utilizzare per il titolo della trama
• ax (matplotlib.axes.Axes) – Un oggetto assi opzionale da utilizzare per l'output di visualizzazione. Se non viene specificato nulla, verrà creata e utilizzata una nuova Figura matplotlib. Inoltre, se specificato, non verrà restituita alcuna Figura, poiché è ridondante.
• filename (str) – percorso del file in cui salvare l'immagine.

Risultati

Una figura per l'istogramma renderizzato, se il kwarg di ax non è impostato.

Tipo di restituzione

matplotlib.Figure

Aumenti

• MissingOptionalLibraryError – Matplotlib non disponibile.
• VisualizationError – Quando viene fornita una legenda e la lunghezza non corrisponde a quella dei dati di input.
• VisualizationError – L'input deve essere di tipo Counts o un dizionario

Esempi

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