tf.sparse.reduce_sum
| Просмотреть исходный код на GitHub |
Вычисляет сумму элементов по измерениям SparseTensor.
tf.sparse.reduce_sum(
sp_input, axis=None, keepdims=None, output_is_sparse=False, name=None
)
Это операция сокращения для элементной операции tf.sparse.add.
Этот оператор принимает SparseTensor и является разновидностью операции tf.reduce_sum() для разреженных данных. В частности, этот оператор также возвращает плотный Tensor если output_is_sparse является False, или SparseTensor если output_is_sparse является True.
Примечание: если output_is_sparse равно True, градиент для этой функции не определён, поэтому она не может использоваться в обучающих моделях, требующих градиентного спуска.
Вычисляет сумму sp_input по измерениям, указанным в axis. Если keepdims не равно True, ранг тензора уменьшается на 1 для каждого элемента в axis. Если keepdims равно True, уменьшенные измерения сохраняются с длиной 1.
Если у axis нет элементов, все измерения уменьшаются, и возвращается тензор с одним элементом. Кроме того, оси могут быть отрицательными, аналогично правилам индексации в Python.
Например:
'x' представляет [[1, ?, 1]
[?, 1, ?]]
где ? неявно равен нулю.
x = tf.sparse.SparseTensor([[0, 0], [0, 2], [1, 1]], [1, 1, 1], [2, 3])
tf.sparse.reduce_sum(x)
<tf.Tensor: shape=(), dtype=int32, numpy=3>
tf.sparse.reduce_sum(x, 0)
<tf.Tensor: shape=(3,), dtype=int32, numpy=array([1, 1, 1], dtype=int32)>
tf.sparse.reduce_sum(x, 1) # Can also use -1 as the axis
<tf.Tensor: shape=(2,), dtype=int32, numpy=array([2, 1], dtype=int32)>
tf.sparse.reduce_sum(x, 1, keepdims=True)
<tf.Tensor: shape=(2, 1), dtype=int32, numpy=
array([[2],
[1]], dtype=int32)>
tf.sparse.reduce_sum(x, [0, 1])
<tf.Tensor: shape=(), dtype=int32, numpy=3>
| Аргументы | |
|---|---|
sp_input | SparseTensor для сокращения. Должен иметь числовой тип. |
axis | Измерения для сокращения; список или скаляр. Если None (по умолчанию), сокращает все измерения. |
keepdims | Если True, сохраняет уменьшенные измерения с длиной 1. |
output_is_sparse | Если True, возвращает SparseTensor вместо плотного тензора (по умолчанию). |
name | Имя операции (необязательно). |
| Возвращаемое значение | |
|---|---|
Сокращённый тензор или сокращённый SparseTensor, если output_is_sparse равно True. |
© 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/versions/r2.9/api_docs/python/tf/sparse/reduce_sum