tf.where
Stay organized with collections
Save and categorize content based on your preferences.
Return the elements, either from x
or y
, depending on the condition
.
tf.where(
condition, x=None, y=None, name=None
)
If both x
and y
are None, then this operation returns the coordinates of
true elements of condition
. The coordinates are returned in a 2-D tensor
where the first dimension (rows) represents the number of true elements, and
the second dimension (columns) represents the coordinates of the true
elements. Keep in mind, the shape of the output tensor can vary depending on
how many true values there are in input. Indices are output in row-major
order.
If both non-None, condition
, x
and y
must be broadcastable to the same
shape.
The condition
tensor acts as a mask that chooses, based on the value at each
element, whether the corresponding element / row in the output should be taken
from x
(if true) or y
(if false).
Args |
condition
|
A Tensor of type bool
|
x
|
A Tensor which is of the same type as y , and may be broadcastable with
condition and y .
|
y
|
A Tensor which is of the same type as x , and may be broadcastable with
condition and x .
|
name
|
A name of the operation (optional).
|
Returns |
A Tensor with the same type as x and y , and shape that
is broadcast from condition , x , and y , if x , y are non-None.
A Tensor with shape (num_true, dim_size(condition)) .
|
Raises |
ValueError
|
When exactly one of x or y is non-None.
|
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.where\n\n\u003cbr /\u003e\n\n|------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|\n| [TensorFlow 1 version](/versions/r1.15/api_docs/python/tf/where) | [View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.0.0/tensorflow/python/ops/array_ops.py#L3758-L3801) |\n\nReturn the elements, either from `x` or `y`, depending on the `condition`.\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.where_v2`](/api_docs/python/tf/where)\n\n\u003cbr /\u003e\n\n tf.where(\n condition, x=None, y=None, name=None\n )\n\nIf both `x` and `y` are None, then this operation returns the coordinates of\ntrue elements of `condition`. The coordinates are returned in a 2-D tensor\nwhere the first dimension (rows) represents the number of true elements, and\nthe second dimension (columns) represents the coordinates of the true\nelements. Keep in mind, the shape of the output tensor can vary depending on\nhow many true values there are in input. Indices are output in row-major\norder.\n\nIf both non-None, `condition`, `x` and `y` must be broadcastable to the same\nshape.\n\nThe `condition` tensor acts as a mask that chooses, based on the value at each\nelement, whether the corresponding element / row in the output should be taken\nfrom `x` (if true) or `y` (if false).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Args ---- ||\n|-------------|-----------------------------------------------------------------------------------------------|\n| `condition` | A `Tensor` of type `bool` |\n| `x` | A Tensor which is of the same type as `y`, and may be broadcastable with `condition` and `y`. |\n| `y` | A Tensor which is of the same type as `x`, and may be broadcastable with `condition` and `x`. |\n| `name` | A name of the operation (optional). |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Returns ------- ||\n|---|---|\n| A `Tensor` with the same type as `x` and `y`, and shape that is broadcast from `condition`, `x`, and `y`, if `x`, `y` are non-None. A `Tensor` with shape `(num_true, dim_size(condition))`. ||\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Raises ------ ||\n|--------------|---------------------------------------------|\n| `ValueError` | When exactly one of `x` or `y` is non-None. |\n\n\u003cbr /\u003e"]]