`categorical`

Array de valores de um conjunto fixo de categorias, armazenados como rótulos.

Categoria: Language Fundamentals > Data Types

Sintaxe

C = categorical(A)

Cria categorias a partir dos valores únicos de A, em ordem.

C = categorical(A, valueset)

Usa os valores listados como categorias, nessa ordem.

C = categorical(A, valueset, catnames)

Também renomeia as categorias.

C = categorical(___, 'Ordinal', true)

Torna as categorias ordenadas, permitindo comparar com < e >.

Descrição

Um array categorical guarda um pequeno código inteiro por elemento mais a lista de nomes das categorias, de modo que rótulos repetidos usam pouca memória e as comparações são rápidas. Os valores podem ser testados com == contra o nome de uma categoria, e categories, countcats e summary descrevem o conteúdo.

Elementos que não pertencem a nenhuma categoria ficam <undefined>. Com 'Ordinal' verdadeiro, a ordem de valueset define a hierarquia.

Argumentos de entrada

A: Dados numéricos, lógicos, string, cell array de char ou categorical.
valueset: Valores a tratar como categorias; valores de A fora da lista ficam indefinidos.
catnames: Nomes das categorias, um por valor em valueset.

Argumentos de saída

C: Array categorical do mesmo tamanho de A.

Exemplo

Rótulos e lista de categorias

c = categorical({'lo','hi','lo','mid'}, {'lo','mid','hi'}, 'Ordinal', true)
categories(c)
countcats(c)

Saída

c = 1×4 categorical array

     lo      hi      lo      mid 
ans = 3×1 cell

    {'lo' }
    {'mid'}
    {'hi' }
ans = 1×3

     2     1     1

Veja também

categories countcats summary discretize unique