`maxk`

Os k maiores elementos de um array, em ordem decrescente.

Categoria: Data Import and Analysis > Descriptive Statistics

Sintaxe

B = maxk(A, k)

Os k maiores valores ao longo da primeira dimensão de tamanho diferente de 1.

B = maxk(A, k, dim)

Ao longo da dimensão dim.

[B, I] = maxk(___)

Também retorna os índices desses valores em A.

Descrição

maxk entrega os k primeiros sem que seja preciso ordenar o array inteiro manualmente. O resultado mantém a orientação da operação: para um vetor linha é uma linha, e para uma matriz traz os k maiores de cada coluna.

Se k for maior que o número de elementos, todos os elementos são retornados.

Argumentos de entrada

A: Array numérico.
k: Quantos valores retornar.
dim: Dimensão em que operar.

Argumentos de saída

B: Os k maiores valores, ordenados do maior para o menor.
I: Índices em A dos valores de B.

Exemplo

Os três maiores valores

x = [3 1 4 1 5 9 2 6 5 3];
[B, I] = maxk(x, 3)

Saída

B = 1×3

     9     6     5
I = 1×3

     6     8     5

Veja também

mink max sort bounds