numpy.unique_counts#

numpy.unique_counts(x)[source]#

Find the unique elements and counts of an input array x.

This function is an Array API compatible alternative to:

>>> x = np.array([1, 1, 2])
>>> np.unique(x, return_counts=True, equal_nan=False)
(array([1, 2]), array([2, 1]))
Parameters:
xarray_like

Input array. It will be flattened if it is not already 1-D.

Returns:
outnamedtuple

The result containing:

  • values - The unique elements of an input array.

  • counts - The corresponding counts for each unique element.

See also

unique

Find the unique elements of an array.

Examples

>>> import numpy as np
>>> np.unique_counts([1, 1, 2])
UniqueCountsResult(values=array([1, 2]), counts=array([2, 1]))