jax.numpy.unique_values#
- jax.numpy.unique_values(x, /, *, size=None, fill_value=None)[source]#
Return unique values from x, along with indices, inverse indices, and counts.
JAX implementation of
numpy.unique_values()
; this is equivalent to callingjax.numpy.unique()
with equal_nan set to True.Because the size of the output of
unique_values
is data-dependent, the function semantics are not typically compatible withjit()
and other JAX transformations. The JAX version adds the optionalsize
argument which must be specified statically forjnp.unique
to be used in such contexts.- Parameters:
x (ArrayLike) – N-dimensional array from which unique values will be extracted.
size (int | None) – if specified, return only the first
size
sorted unique elements. If there are fewer unique elements thansize
indicates, the return value will be padded withfill_value
.fill_value (ArrayLike | None) – when
size
is specified and there are fewer than the indicated number of elements, fill the remaining entriesfill_value
. Defaults to the minimum unique value.
- Returns:
An array
values
of shape(n_unique,)
containing the unique values fromx
.- Return type:
See also
jax.numpy.unique()
: general function for computing unique values.jax.numpy.unique_values()
: compute onlyvalues
.jax.numpy.unique_counts()
: compute onlyvalues
andcounts
.jax.numpy.unique_inverse()
: compute onlyvalues
andinverse
.
Examples
Here we compute the unique values in a 1D array:
>>> x = jnp.array([3, 4, 1, 3, 1]) >>> jnp.unique_values(x) Array([1, 3, 4], dtype=int32)
For examples of the
size
andfill_value
arguments, seejax.numpy.unique()
.