diff options
Diffstat (limited to 'tensorflow/core/api_def/base_api/api_def_UniqueV2.pbtxt')
-rw-r--r-- | tensorflow/core/api_def/base_api/api_def_UniqueV2.pbtxt | 40 |
1 files changed, 34 insertions, 6 deletions
diff --git a/tensorflow/core/api_def/base_api/api_def_UniqueV2.pbtxt b/tensorflow/core/api_def/base_api/api_def_UniqueV2.pbtxt index cd7ec6e551..2fb5bd5b88 100644 --- a/tensorflow/core/api_def/base_api/api_def_UniqueV2.pbtxt +++ b/tensorflow/core/api_def/base_api/api_def_UniqueV2.pbtxt @@ -9,7 +9,7 @@ END in_arg { name: "axis" description: <<END -A `Tensor` of type `int64` (default: 0). The axis of the Tensor to +A `Tensor` of type `int32` (default: None). The axis of the Tensor to find the unique elements. END } @@ -26,12 +26,15 @@ A 1-D Tensor. Has the same type as x that contains the index of each value of x in the output y. END } - summary: "Finds unique elements in a 1-D tensor." + summary: "Finds unique elements along an axis of a tensor." description: <<END -This operation returns a tensor `y` containing all of the unique elements of `x` -sorted in the same order that they occur in `x`. 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: +This operation either returns a tensor `y` containing unique elements +along the `axis` of a tensor. The returned unique elements is sorted +in the same order as they occur along `axis` in `x`. +This operation also returns a tensor `idx` that is the same size as +the number of the elements in `x` along the `axis` dimension. It +contains the index in the unique output `y`. +In other words, for an `1-D` tensor `x` with `axis = None: `y[idx[i]] = x[i] for i in [0, 1,...,rank(x) - 1]` @@ -43,5 +46,30 @@ y, idx = unique(x) y ==> [1, 2, 4, 7, 8] idx ==> [0, 0, 1, 2, 2, 2, 3, 4, 4] ``` + +For an `2-D` tensor `x` with `axis = 0`: + +``` +# tensor 'x' is [[1, 0, 0], +# [1, 0, 0], +# [2, 0, 0]] +y, idx = unique(x, axis=0) +y ==> [[1, 0, 0], + [2, 0, 0]] +idx ==> [0, 0, 1] +``` + +For an `2-D` tensor `x` with `axis = 1`: + +``` +# tensor 'x' is [[1, 0, 0], +# [1, 0, 0], +# [2, 0, 0]] +y, idx = unique(x, axis=1) +y ==> [[1, 0], + [1, 0], + [2, 0]] +idx ==> [0, 1, 1] +``` END } |