categories

Categories of categorical array

Syntax

Description

example

C = categories(A) returns a cell array of strings containing the categories of the categorical array, A.

Examples

expand all

List Categories in Categorical Array

Create a categorical array, A.

A = categorical({'plane' 'car' 'train' 'car' 'plane'})
A = 

     plane      car      train      car      plane 

A is a 1-by-5 categorical array.

Display the categories of A.

C = categories(A)
C = 

    'car'
    'plane'
    'train'

Since you created A by specifying only an input array, the categories appear in alphabetical order.

List Categories in Ordinal Categorical Array

Create an ordinal categorical array.

A = categorical({'medium' 'large'; 'small' 'xlarge'; 'large' 'medium'},...
    {'small' 'medium' 'large' 'xlarge'},'Ordinal',true)
A = 

     medium      large  
     small       xlarge 
     large       medium 

A is a 3-by-2 ordinal categorical array.

Display the categories of A.

C = categories(A)
C = 

    'small'
    'medium'
    'large'
    'xlarge'

The categories appear in the order in which you specified them. Since A is ordinal, the categories have the mathematical ordering small < medium < large < xlarge.

Input Arguments

expand all

A — Categorical arrayvector | matrix | multidimensional array

Categorical array, specified as a vector, matrix, or multidimensional array.

More About

expand all

Tips

  • C includes all categories in A, even if A does not contain any data from a category. To see the unique values in A, use unique(A).

  • The order of the categories listed in C is the same order used by functions, such as summary and hist. To change the order of the categories, use reordercats.

Was this topic helpful?