`histogram`

Plota um histograma dos dados e retorna um objeto com os bins e as contagens.

Sintaxe

histogram(X)

Escolhe os bins automaticamente e desenha as contagens.

histogram(X, nbins)

Usa nbins bins.

histogram(X, edges)

Usa o vetor edges como bordas dos bins.

histogram(___, Name, Value)

Define opções como 'Normalization', 'BinWidth', 'BinLimits' ou 'BinMethod'.

h = histogram(___)

Também retorna o objeto Histogram.

Descrição

Os bins são fechados à esquerda e abertos à direita, exceto o último, que inclui as duas bordas. Valores NaN são ignorados. Sem opções, o número e a largura dos bins vêm de uma regra automática que depende dos dados.

O objeto retornado permite inspecionar o resultado numericamente ou ajustá-lo depois, com morebins e fewerbins. Para obter contagens sem gráfico, use histcounts.

Argumentos de entrada

X: Dados numéricos. São tratados como vetor, seja qual for a forma.
'Normalization': 'count' (padrão), 'probability', 'percentage', 'countdensity', 'pdf', 'cumcount' ou 'cdf'.
'BinEdges': Vetor de bordas dos bins.
'BinWidth': Largura de todos os bins.

Argumentos de saída

h: Objeto Histogram. Leia h.Values, h.BinEdges, h.NumBins, h.BinWidth e h.BinLimits; alterá-los redesenha o gráfico.

Exemplos

Bordas explícitas

x = [1 2 2 3 3 3 4 4 5 9];
h = histogram(x, [0 2 4 10]);
h.Values
h.BinWidth

Saída

ans = 1×3

     1     5     4
ans = 'nonuniform'

Normalização por probabilidade

x = [1 2 2 3 3 3 4 4 5 9];
h = histogram(x, 'BinEdges', 0:3:9, 'Normalization', 'probability');
disp(h.Values)
disp(sum(h.Values))

Saída

    0.3000    0.6000    0.1000
    1.0000

Observações

Quando só o número de bins é dado, o MatLivre pode posicionar as bordas arredondadas de forma diferente do MATLAB. Com bordas, larguras ou limites explícitos, as contagens coincidem.

Veja também

histcounts histogram2 hist morebins fewerbins bar