# 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

collapse 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 3-by-2 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

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