# categories

Categories of categorical array

## Syntax

• `C = categories(A)` example

## Description

example

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

## Examples

collapse 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

collapse all

### `A` — Categorical arrayvector | matrix | multidimensional array

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

collapse 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`.