Spec-Zone.ru › TensorFlow 2.3

tf.sparse.reduce_max

Просмотреть исходный код на GitHub

Вычисляет максимальное значение элементов по измерениям SparseTensor.

tf.sparse.reduce_max(
    sp_input, axis=None, keepdims=None, output_is_sparse=False, name=None
)

Этот оператор принимает SparseTensor и является аналогом tf.reduce_max() для разреженных тензоров. В частности, этот оператор также возвращает плотный Tensor если output_is_sparse равен False, или SparseTensor, если output_is_sparse равен True.

Примечание: Градиент для этой функции не определен, поэтому её нельзя использовать в обучаемых моделях, требующих градиентного спуска.

Вычисляет sp_input по измерениям, указанным в axis. Если keepdims не равно true, ранг тензора уменьшается на 1 для каждого элемента в axis. Если keepdims равно true, уменьшенные измерения сохраняются с длиной 1.

Если у axis нет элементов, все измерения уменьшаются, и возвращается тензор с одним элементом. Кроме того, индексы осей могут быть отрицательными, аналогично правилам индексации в Python.

Значения, не определённые в sp_input, не участвуют в вычислении reduce max, в отличие от неявного предположения о значении 0 — поэтому для разреженных axis может возвращать отрицательные значения. Но в случае, если в axis нет значений, результат уменьшится до 0. См. второй пример ниже.

Например:

# 'x' represents [[1, ?, 2]
#                 [?, 3, ?]]
# where ? is implicitly-zero.
tf.sparse.reduce_max(x) ==> 3
tf.sparse.reduce_max(x, 0) ==> [1, 3, 2]
tf.sparse.reduce_max(x, 1) ==> [2, 3]  # Can also use -1 as the axis.
tf.sparse.reduce_max(x, 1, keepdims=True) ==> [[2], [3]]
tf.sparse.reduce_max(x, [0, 1]) ==> 3

# 'y' represents [[-7, ?]
#                 [ 4, 3]
#                 [ ?, ?]
tf.sparse.reduce_max(x, 1) ==> [-7, 4, 0]
Аргументы
sp_input SparseTensor для уменьшения. Должен иметь числовой тип.
axis Измерения для уменьшения; список или скаляр. Если не указано (по умолчанию), уменьшаются все измерения.
keepdims Если true, сохраняет уменьшенные измерения длиной 1.
output_is_sparse Если true, возвращает SparseTensor вместо плотного тензора (по умолчанию).
name Имя операции (необязательно).
Возвращаемое значение
Уменьшенный тензор или SparseTensor, если output_is_sparse равно True.

© 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/sparse/reduce_max

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API