histc

Conta quantos valores caem em cada intervalo definido por um vetor de bordas.

Categoria: Graphics > 2-D and 3-D Plots

Sintaxe

n = histc(x, edges)

Conta os elementos de x em cada bin edges(k) <= x < edges(k+1).

[n, bin] = histc(x, edges)

Também retorna o índice do bin de cada elemento de x.

n = histc(x, edges, dim)

Conta ao longo da dimensão dim.

Descrição

Todo bin é fechado à esquerda e aberto à direita, exceto o último, que contém apenas valores exatamente iguais à última borda. Valores abaixo da primeira borda ou acima da última não são contados. Para uma matriz, cada coluna é contada separadamente.

histc é mantida por compatibilidade; histcounts é a substituta recomendada e seu último bin inclui a borda direita.

Argumentos de entrada

x
Vetor ou array de valores.
edges
Vetor de bordas, monotonicamente não decrescente.
dim
Dimensão ao longo da qual contar; por padrão a primeira não unitária.

Argumentos de saída

n
Contagens, com tantos elementos na dimensão de contagem quanto edges. O último elemento conta valores iguais a edges(end).
bin
Índice do bin de cada elemento de x, ou 0 quando cai fora de todos os bins.

Exemplo

Contagens e índices de bin

x = [1 2 2 3 3 3 4 4 5 9];
[n, bin] = histc(x, [0 3 6 9])
Saída
n = 1×4

     3     6     0     1
bin = 1×10

     1     1     1     2     2     2     2     2     2     4

Veja também

histcounts discretize hist accumarray histogram