Documentation Center

  • Trial Software
  • Product Updates

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.

See Also

| | | | | | |

Was this topic helpful?