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)

Traçar um histograma dos dados de contagem de entrada.

Parâmetros

• data (list ordict) – Esta é uma lista de dicionários ou um único dicionário contendo os valores a serem representados (ex. {'001': 130})
• figsize (tuple) – Tamanho da figura em polegadas.
• color (list orstr) – Cadeia de caracteres ou lista de cadeias de caracteres para as cores das barras do histograma.
• number_to_keep (int) – O número de termos a serem plotados por conjunto de dados. O restante é transformado em uma única barra chamada 'rest'. Se forem fornecidos vários conjuntos de dados, o number_to_keep se aplica a cada conjunto de dados individualmente, o que pode resultar em mais barras do que number_to_keep + 1. O endereço number_to_keep se aplica aos valores totais, e não à classificação do eixo x.
• sort (string) – Pode ser 'asc', 'desc', 'hamming', 'value' ou 'value_desc'. Se definido como "value" ou "value_desc", o eixo x será classificado pelo número de contagens de cada bitstring. O padrão é "asc".
• target_string (str) – Cadeia de caracteres de destino se "sort" for uma medida de distância.
• legend (list) – Uma lista de strings a serem usadas como rótulos dos dados. O número de entradas deve corresponder ao tamanho dos dados (se os dados forem uma lista ou 1, caso sejam um dicionário)
• bar_labels (bool) – Rotule cada barra do histograma com o valor da contagem.
• title (str) – Uma cadeia de caracteres a ser usada para o título do enredo
• ax (matplotlib.axes.Axes) – Um objeto opcional Axes a ser usado para a saída da visualização. Se nenhum for especificado, um novo matplotlib Figure será criado e usado. Além disso, se especificado, não haverá nenhuma figura retornada, pois ela é redundante.
• filename (str) – caminho do arquivo para salvar a imagem.

Retorna

Uma figura para o histograma renderizado, se o ax kwarg não estiver definido.

Tipo de retorno

matplotlib.Figure

Aumentos

• MissingOptionalLibraryError - Matplotlib não disponível.
• VisualizationError - Quando a legenda é fornecida e o comprimento não corresponde aos dados de entrada.
• VisualizationError - A entrada deve ser Counts ou um dict

Exemplos

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