histcounts

Conta quantos valores caem em cada intervalo (bin).

Categoria: Data Import and Analysis > Preprocessing Data

Sintaxe

[N, edges] = histcounts(X)

Distribui X em intervalos de largura igual escolhidos automaticamente.

[N, edges] = histcounts(X, nbins)

Usa nbins intervalos de largura igual.

[N, edges] = histcounts(X, edges)

Usa as bordas de intervalo fornecidas.

N = histcounts(___, 'Normalization', s)

Escala as contagens, por exemplo 'probability'.

N = histcounts(___, 'BinWidth', w)

Usa intervalos de largura w.

Descrição

Cada intervalo inclui a borda esquerda e exclui a direita, exceto o último, que inclui as duas. Valores fora da faixa das bordas, e NaN, não são contados. A função retorna apenas números; histogram desenha os mesmos dados.

Com 'probability' as contagens são divididas pelo total de elementos, de modo que somam 1 quando todos os dados caem dentro dos intervalos.

Argumentos de entrada

X
Array numérico; os elementos são contados qualquer que seja o formato.
nbins
Número de intervalos.
edges
Vetor crescente de bordas dos intervalos.
'Normalization'
'count' (padrão), 'probability', 'countdensity', 'pdf', 'cumcount' ou 'cdf'.

Argumentos de saída

N
Vetor linha com um valor por intervalo.
edges
Bordas dos intervalos; N tem um elemento a menos.

Exemplo

Bordas explícitas

x = [1 2 2 3 5 8];
N = histcounts(x, [0 2 4 10])
histcounts(x, [0 2 4 10], 'Normalization', 'probability')
[N, e] = histcounts(x)
Saída
N = 1×3

     1     3     2
ans = 1×3

    0.1667    0.5000    0.3333
N = 1×8

     1     2     1     0     1     0     0     1
e = 1×9

    0.5000    1.5000    2.5000    3.5000    4.5000    5.5000    6.5000    7.5000    8.5000

Veja também

histcounts2 histogram accumarray discretize