tf.unique
Stay organized with collections
Save and categorize content based on your preferences.
Finds unique elements in a 1-D tensor.
tf.unique(
x,
out_idx=tf.dtypes.int32
,
name=None
)
Used in the notebooks
This operation returns a tensor y
containing all of the unique elements of x
sorted in the same order that they occur in x
; x
does not need to be sorted.
This operation also returns a tensor idx
the same size as x
that contains
the index of each value of x
in the unique output y
. In other words:
y[idx[i]] = x[i] for i in [0, 1,...,rank(x) - 1]
Examples:
# tensor 'x' is [1, 1, 2, 4, 4, 4, 7, 8, 8]
y, idx = unique(x)
y ==> [1, 2, 4, 7, 8]
idx ==> [0, 0, 1, 2, 2, 2, 3, 4, 4]
# tensor 'x' is [4, 5, 1, 2, 3, 3, 4, 5]
y, idx = unique(x)
y ==> [4, 5, 1, 2, 3]
idx ==> [0, 1, 2, 3, 4, 4, 0, 1]
Args |
x
|
A Tensor . 1-D.
|
out_idx
|
An optional tf.DType from: tf.int32, tf.int64 . Defaults to tf.int32 .
|
name
|
A name for the operation (optional).
|
Returns |
A tuple of Tensor objects (y, idx).
|
y
|
A Tensor . Has the same type as x .
|
idx
|
A Tensor of type out_idx .
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates. Some content is licensed under the numpy license.
Last updated 2024-04-26 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-04-26 UTC."],[],[],null,["# tf.unique\n\n\u003cbr /\u003e\n\n|-------------------------------------------------------------------------------------------------------------------------------|\n| [View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.16.1/tensorflow/python/ops/array_ops.py#L1609-L1651) |\n\nFinds unique elements in a 1-D tensor.\n\n#### View aliases\n\n\n**Compat aliases for migration**\n\nSee\n[Migration guide](https://www.tensorflow.org/guide/migrate) for\nmore details.\n\n[`tf.compat.v1.unique`](https://www.tensorflow.org/api_docs/python/tf/unique)\n\n\u003cbr /\u003e\n\n tf.unique(\n x,\n out_idx=../tf/dtypes#int32,\n name=None\n )\n\n### Used in the notebooks\n\n| Used in the tutorials |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| - [MoViNet for streaming action recognition](https://www.tensorflow.org/hub/tutorials/movinet) - [Client-efficient large-model federated learning via \\`federated_select\\` and sparse aggregation](https://www.tensorflow.org/federated/tutorials/sparse_federated_learning) |\n\nThis operation returns a tensor `y` containing all of the unique elements of `x`\nsorted in the same order that they occur in `x`; `x` does not need to be sorted.\nThis operation also returns a tensor `idx` the same size as `x` that contains\nthe index of each value of `x` in the unique output `y`. In other words:\n\n`y[idx[i]] = x[i] for i in [0, 1,...,rank(x) - 1]`\n\n#### Examples:\n\n # tensor 'x' is [1, 1, 2, 4, 4, 4, 7, 8, 8]\n y, idx = unique(x)\n y ==\u003e [1, 2, 4, 7, 8]\n idx ==\u003e [0, 0, 1, 2, 2, 2, 3, 4, 4]\n\n # tensor 'x' is [4, 5, 1, 2, 3, 3, 4, 5]\n y, idx = unique(x)\n y ==\u003e [4, 5, 1, 2, 3]\n idx ==\u003e [0, 1, 2, 3, 4, 4, 0, 1]\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Args ---- ||\n|-----------|-----------------------------------------------------------------------------------------------------------------|\n| `x` | A `Tensor`. 1-D. |\n| `out_idx` | An optional [`tf.DType`](../tf/dtypes/DType) from: `tf.int32, tf.int64`. Defaults to [`tf.int32`](../tf#int32). |\n| `name` | A name for the operation (optional). |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Returns ------- ||\n|-------|---------------------------------------|\n| A tuple of `Tensor` objects (y, idx). ||\n| `y` | A `Tensor`. Has the same type as `x`. |\n| `idx` | A `Tensor` of type `out_idx`. |\n\n\u003cbr /\u003e"]]