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
)
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.
Last updated 2020-10-01 UTC.
[null,null,["Last updated 2020-10-01 UTC."],[],[],null,["# tf.unique\n\n\u003cbr /\u003e\n\n|-------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|\n| [TensorFlow 1 version](/versions/r1.15/api_docs/python/tf/unique) | [View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.1.0/tensorflow/python/ops/array_ops.py#L1704-L1710) |\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`](/api_docs/python/tf/unique)\n\n\u003cbr /\u003e\n\n tf.unique(\n x, out_idx=tf.dtypes.int32, name=None\n )\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"]]