tf.math.reduce_sum
| Просмотреть исходный код на GitHub |
Вычисляет сумму элементов по измерениям тензора.
tf.math.reduce_sum(
input_tensor, axis=None, keepdims=False, name=None
)
Сводит input_tensor по измерениям, указанным в axis. Если keepdims не имеет значения true, ранг тензора уменьшается на 1 для каждого элемента в axis. Если keepdims имеет значение true, уменьшенные измерения сохраняются с длиной 1.
Если axis имеет значение None, все измерения сводятся, и возвращается тензор с одним элементом.
Например:
# x has a shape of (2, 3) (two rows and three columns):
x = tf.constant([[1, 1, 1], [1, 1, 1]])
x.numpy()
array([[1, 1, 1],
[1, 1, 1]], dtype=int32)
# sum all the elements
# 1 + 1 + 1 + 1 + 1+ 1 = 6
tf.reduce_sum(x).numpy()
6
# reduce along the first dimension
# the result is [1, 1, 1] + [1, 1, 1] = [2, 2, 2]
tf.reduce_sum(x, 0).numpy()
array([2, 2, 2], dtype=int32)
# reduce along the second dimension
# the result is [1, 1] + [1, 1] + [1, 1] = [3, 3]
tf.reduce_sum(x, 1).numpy()
array([3, 3], dtype=int32)
# keep the original dimensions
tf.reduce_sum(x, 1, keepdims=True).numpy()
array([[3],
[3]], dtype=int32)
# reduce along both dimensions
# the result is 1 + 1 + 1 + 1 + 1 + 1 = 6
# or, equivalently, reduce along rows, then reduce the resultant array
# [1, 1, 1] + [1, 1, 1] = [2, 2, 2]
# 2 + 2 + 2 = 6
tf.reduce_sum(x, [0, 1]).numpy()
6
| Аргументы | |
|---|---|
input_tensor | Тензор для сводки. Должен иметь числовой тип. |
axis | Измерения для сводки. Если None (по умолчанию), сводит все измерения. Должно быть в диапазоне [-rank(input_tensor), rank(input_tensor)]. |
keepdims | Если имеет значение true, сохраняет уменьшенные измерения с длиной 1. |
name | Имя операции (необязательно). |
| Возвращаемые значения | |
|---|---|
| Сведённый тензор того же типа, что и входной тензор input_tensor. |
Совместимость с NumPy
Эквивалентно np.sum, за исключением того, что NumPy преобразует uint8 и int32 к int64, в то время как TensorFlow возвращает тот же тип, что и входной.
© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.3/api_docs/python/tf/math/reduce_sum