levelcounts

(Not Recommended) Element counts by level of a nominal or ordinal array

collapse all in page

The nominal and ordinal array data types are not recommended. To represent ordered and unordered discrete, nonnumeric data, use the Categorical Arrays data type instead.

Syntax

C = levelcounts(A)
C = levelcounts(A,dim)

Description

C = levelcounts(A) returns counts of the number of elements in the nominal or ordinal array A equal to each possible level in A.

  • If A is a vector, then C is a vector containing as many elements as the number of levels in A.

  • If A is a matrix, then C is a matrix of column counts.

  • If A is an N-dimensional array, then levelcounts operates along the first nonsingleton dimension.

C = levelcounts(A,dim) operates along the dimension dim.

example

Examples

collapse all

Open Live Script

Create a nominal array from data in a cell array.

colors = nominal({'r','b','g';'g','r','b';'b','r','g'},...
                 {'blue','green','red'})
colors = 3×3 nominal
     red        blue      green 
     green      red       blue  
     blue       red       green

Count the number of observations of each level in each column.

levelcounts(colors)
ans = 3×3

     1     1     1
     1     0     2
     1     2     0

Count the number of observations of each level in each row.

levelcounts(colors,2)
ans = 3×3

     1     1     1
     1     1     1
     1     1     1

Alternatively, you can use summary to display the counts with their labels. The default is to count elements in each column.

summary(colors)
     blue       1      1      1 
     green      1      0      2 
     red        1      2      0

You can also count elements in each row.

summary(colors,2)
     blue      green      red 
     1         1          1   
     1         1          1   
     1         1          1

Input Arguments

collapse all

Nominal or ordinal array, specified as a nominal or ordinal array object created with nominal or ordinal.

Dimension along which to count the number of elements in each level, specified as a positive integer value. For example, if the dimension is 1, then levelcounts counts along each column, while if the dimension is 2, then levelcounts counts along each row.

Data Types: double | single

Version History

Introduced in R2007a

See Also

| |