Accelerating the pace of engineering and science

# Documentation Center

• Trial Software

# iscategory

Test for categorical array categories

## Syntax

• tf = iscategory(A,catnames) example

## Description

example

tf = iscategory(A,catnames) returns an array containing logical 1 (true) where the data in catnames is a category of A. Otherwise, iscategory returns logical 0 (false).

tf is the same size as catnames.

## Examples

expand all

### Test for Categories

Create an ordinal categorical array, A.

`A = categorical({'shirt' 'pants'; 'pants' 'hat'; 'shirt' 'pants'})`
```A =

shirt      pants
pants      hat
shirt      pants ```

A is a 1-by-5 categorical array.

Test if the articles of clothing, shirt, pants, socks, and shoes, are categories of A.

```catnames = {'shirt' 'pants' 'socks' 'shoes'};
tf = iscategory(A,catnames)```
```tf =

1     1     0     0
```

shirt and pants are categories of A, but socks, and shoes are not.

iscategory does not tell us anything about the category, hat, which we did not include in catnames.

### Test for Category with No Corresponding Data

Create a categorical array, A.

```A = categorical({'plane' 'car' 'train' 'car' 'plane'},...
{'boat' 'car' 'plane' 'train'})```
```A =

plane      car      train      car      plane ```

A is a 1-by-5 categorical array.

Test to see if boat is a category in A.

`tf = iscategory(A,'boat')`
```tf =

1```

iscategory returns true, even though A does not contain any values from the category boat.

## Input Arguments

expand all

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

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

### catnames — Category namesstring | cell array of strings | categorical array

Category names, specified as a string, cell array of strings, or categorical array.