This operator is similar to tf.math.unsorted_segment_sum,
Instead of computing the sum over segments, it computes the product of all
entries belonging to a segment such that:
\(output_i = \prod_{j...} data[j...]\) where the product is over tuples
j... such that segment_ids[j...] == i.
If there is no entry for a given segment ID i, it outputs 1.
If the given segment ID i is negative, then the corresponding value is
dropped, and will not be included in the result.
Caution: On CPU, values in segment_ids are always validated to be less than
num_segments, and an error is thrown for out-of-bound indices. On GPU, this
does not throw an error for out-of-bound indices. On Gpu, out-of-bound indices
result in safe but unspecified behavior, which may include ignoring
out-of-bound indices or outputting a tensor with a 0 stored in the first
dimension of its shape if num_segments is 0.
Args
data
A Tensor. Must be one of the following types: float32, float64, int32, uint8, int16, int8, complex64, int64, qint8, quint8, qint32, bfloat16, qint16, quint16, uint16, complex128, half, uint32, uint64.
segment_ids
A Tensor. Must be one of the following types: int32, int64.
A tensor whose shape is a prefix of data.shape.
The values must be less than num_segments.
num_segments
A Tensor. Must be one of the following types: int32, int64.
[null,null,["Last updated 2024-04-26 UTC."],[],[],null,["# tf.math.unsorted_segment_prod\n\nComputes the product along segments of a 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.math.unsorted_segment_prod`](https://www.tensorflow.org/api_docs/python/tf/math/unsorted_segment_prod), [`tf.compat.v1.unsorted_segment_prod`](https://www.tensorflow.org/api_docs/python/tf/math/unsorted_segment_prod)\n\n\u003cbr /\u003e\n\n tf.math.unsorted_segment_prod(\n data: Annotated[Any, ../../tf/raw_ops/Any],\n segment_ids: Annotated[Any, ../../tf/raw_ops/Any],\n num_segments: Annotated[Any, ../../tf/raw_ops/Any],\n name=None\n ) -\u003e Annotated[Any, ../../tf/raw_ops/Any]\n\nRead\n[the section on segmentation](https://tensorflow.org/api_docs/python/tf/math#Segmentation)\nfor an explanation of segments.\n\nThis operator is similar to [`tf.math.unsorted_segment_sum`](../../tf/math/unsorted_segment_sum),\nInstead of computing the sum over segments, it computes the product of all\nentries belonging to a segment such that:\n\n\\\\(output_i = \\\\prod_{j...} data\\[j...\\]\\\\) where the product is over tuples\n`j...` such that `segment_ids[j...] == i`.\n\n#### For example:\n\n c = tf.constant([[1,2,3,4], [5,6,7,8], [4,3,2,1]])\n tf.math.unsorted_segment_prod(c, tf.constant([0, 1, 0]), num_segments=2).numpy()\n array([[4, 6, 6, 4],\n [5, 6, 7, 8]], dtype=int32)\n\nIf there is no entry for a given segment ID `i`, it outputs 1.\n\nIf the given segment ID `i` is negative, then the corresponding value is\ndropped, and will not be included in the result.\nCaution: On CPU, values in `segment_ids` are always validated to be less than\n`num_segments`, and an error is thrown for out-of-bound indices. On GPU, this\ndoes not throw an error for out-of-bound indices. On Gpu, out-of-bound indices\nresult in safe but unspecified behavior, which may include ignoring\nout-of-bound indices or outputting a tensor with a 0 stored in the first\ndimension of its shape if `num_segments` is 0.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Args ---- ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `data` | A `Tensor`. Must be one of the following types: `float32`, `float64`, `int32`, `uint8`, `int16`, `int8`, `complex64`, `int64`, `qint8`, `quint8`, `qint32`, `bfloat16`, `qint16`, `quint16`, `uint16`, `complex128`, `half`, `uint32`, `uint64`. |\n| `segment_ids` | A `Tensor`. Must be one of the following types: `int32`, `int64`. A tensor whose shape is a prefix of `data.shape`. The values must be less than `num_segments`. \u003cbr /\u003e | **Caution:** The values are always validated to be in range on CPU, never validated on GPU. |\n| `num_segments` | A `Tensor`. Must be one of the following types: `int32`, `int64`. |\n| `name` | A name for the operation (optional). |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Returns ------- ||\n|---|---|\n| A `Tensor`. Has the same type as `data`. ||\n\n\u003cbr /\u003e"]]