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)

Trazar una distribución a partir de datos muestreados de entrada.

Parámetros

• data (list ordict) – Se trata de una lista de diccionarios o de un único diccionario que contiene los valores que se van a representar (por ejemplo, {‘001’: 130} )
• figsize (tuple) – Tamaño de la figura en pulgadas.
• color (list orstr) – Cadena o lista de cadenas para los colores de las barras de distribución.
• number_to_keep (int) – El número de términos a trazar por conjunto de datos. El resto se convierte en una única barra denominada "resto". Si se dan varios conjuntos de datos, la number_to_keep se aplica a cada conjunto de datos individualmente, lo que puede dar lugar a más barras que number_to_keep + 1. La dirección number_to_keep se aplica a los valores totales, y no a la ordenación del eje x.
• sort (string) – Puede ser 'asc', 'desc', 'hamming', 'value' o 'value_desc'. Si se establece en 'value' o 'value_desc', el eje x se ordenará por la probabilidad máxima de cada cadena de bits. Por defecto es 'asc'.
• target_string (str) – Cadena objetivo si 'sort' es una medida de distancia.
• legend (list) – Una lista de cadenas que se utilizarán como etiquetas para los datos. El número de entradas debe coincidir con la longitud de los datos (si los datos son una lista, o 1 si se trata de un diccionario)
• bar_labels (bool) – Etiqueta cada barra del histograma con el valor de probabilidad.
• title (str) – Cadena que se utilizará para el título de la parcela
• ax (matplotlib.axes.Axes) – Un objeto opcional Ejes que se utilizará para la salida de visualización. Si no se especifica ninguna, se creará y utilizará una nueva figura matplotlib. Además, si se especifica no se devolverá la Figura ya que es redundante.
• filename (str) – ruta de archivo donde guardar la imagen.

Devuelve

Una cifra para la distribución renderizada, si no se establece el kwarg ax .

Tipo de retorno

matplotlib.Figure

Eleva

• MissingOptionalLibraryError - Matplotlib no disponible.
• VisualizationError - Cuando se proporciona la leyenda y la longitud no coincide con los datos de entrada.

Ejemplos

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