tf.sparse.segment_sum

Вычисляет сумму по разреженным сегментам тензора.

tf.sparse.segment_sum(
    data,
    indices,
    segment_ids,
    num_segments=None,
    name=None,
    sparse_gradient=False
)

Прочитайте раздел по сегментации для объяснения сегментов.

Подобно tf.math.segment_sum, но segment_ids может иметь ранг меньше, чем ранг первого измерения data, выбирая подмножество нулевого измерения, указанное через indices. segment_ids разрешается иметь отсутствующие идентификаторы, в этом случае выходные значения в этих индексах будут нулевыми. В таких случаях num_segments используется для определения размера выходных данных.

Пример:

c = tf.constant([[1,2,3,4], [-1,-2,-3,-4], [5,6,7,8]])

# Select two rows, one segment.
tf.sparse.segment_sum(c, tf.constant([0, 1]), tf.constant([0, 0]))
# => [[0 0 0 0]]

# Select two rows, two segment.
tf.sparse.segment_sum(c, tf.constant([0, 1]), tf.constant([0, 1]))
# => [[ 1  2  3  4]
#     [-1 -2 -3 -4]]

# With missing segment ids.
tf.sparse.segment_sum(c, tf.constant([0, 1]), tf.constant([0, 2]),
                      num_segments=4)
# => [[ 1  2  3  4]
#     [ 0  0  0  0]
#     [-1 -2 -3 -4]
#     [ 0  0  0  0]]

# Select all rows, two segments.
tf.sparse.segment_sum(c, tf.constant([0, 1, 2]), tf.constant([0, 0, 1]))
# => [[0 0 0 0]
#     [5 6 7 8]]

# Which is equivalent to:
tf.math.segment_sum(c, tf.constant([0, 0, 1]))

Аргументы
`data`	A `Tensor` с данными, которые будут собраны в выходных данных.
`indices`	A 1-мерный `Tensor` с индексами в `data`. Имеет такой же ранг, как и `segment_ids`.
`segment_ids`	A 1-мерный `Tensor` с индексами в выходном `Tensor`. Значения должны быть отсортированы и могут повторяться.
`num_segments`	Необязательный скаляр int32. Указывает размер выходных `Tensor`.
`name`	Имя операции (необязательно).
`sparse_gradient`	Необязательный `bool`. По умолчанию `False`. Если `True`, градиент этой функции будет разреженным (`IndexedSlices`) вместо плотного (`Tensor`). Разреженный градиент будет содержать одну ненулевую строку для каждого уникального индекса в `indices`.

Возвращаемое значение
A `tensor` формы как data, за исключением измерения 0, имеющего размер `k`, количество сегментов, указанных через `num_segments` или выведенных для последнего элемента в `segments_ids`.

© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/api_docs/python/tf/sparse/segment_sum