tf.compat.v1.sparse_reduce_max

Computes tf.sparse.maximum of elements across dimensions of a SparseTensor. (deprecated arguments) (deprecated arguments)

View aliases

Compat aliases for migration

See Migration guide for more details.

tf.compat.v1.sparse.reduce_max

tf.compat.v1.sparse_reduce_max(
    sp_input, axis=None, keepdims=None, reduction_axes=None, keep_dims=None
)

This is the reduction operation for the elementwise tf.sparse.maximum op.

This Op takes a SparseTensor and is the sparse counterpart to tf.reduce_max(). In particular, this Op also returns a dense Tensor instead of a sparse one.

Reduces sp_input along the dimensions given in reduction_axes. Unless keepdims is true, the rank of the tensor is reduced by 1 for each entry in reduction_axes. If keepdims is true, the reduced dimensions are retained with length 1.

If reduction_axes has no entries, all dimensions are reduced, and a tensor with a single element is returned. Additionally, the axes can be negative, similar to the indexing rules in Python.

The values not defined in sp_input don't participate in the reduce max, as opposed to be implicitly assumed 0 -- hence it can return negative values for sparse reduction_axes. But, in case there are no values in reduction_axes, it will reduce to 0. See second example below.

For example
'x' represents [[1, ?, 2] [?, 3, ?]] where ? is implicitly-zero. `x = tf.sparse.SparseTensor([[0, 0], [0, 2], [1, 1]], [1, 2, 3], [2, 3])` `tf.sparse.reduce_max(x)` `<tf.Tensor: shape=(), dtype=int32, numpy=3>` `tf.sparse.reduce_max(x, 0)` `<tf.Tensor: shape=(3,), dtype=int32, numpy=array([1, 3, 2], dtype=int32)>` `tf.sparse.reduce_max(x, 1)` `<tf.Tensor: shape=(2,), dtype=int32, numpy=array([2, 3], dtype=int32)>` `tf.sparse.reduce_max(x, 1, keepdims=True)` `<tf.Tensor: shape=(2, 1), dtype=int32, numpy=` `array([[2],` `[3]], dtype=int32)>` `tf.sparse.reduce_max(x, [0, 1])` `<tf.Tensor: shape=(), dtype=int32, numpy=3>` 'y' represents [[-7, ?] [ 4, 3] [ ?, ?] `y = tf.sparse.SparseTensor([[0, 0,], [1, 0], [1, 1]], [-7, 4, 3],` `[3, 2])` `tf.sparse.reduce_max(y, 1)` `<tf.Tensor: shape=(3,), dtype=int32, numpy=array([-7, 4, 0], dtype=int32)>`

For example

'x' represents [[1, ?, 2]

[?, 3, ?]]

where ? is implicitly-zero.

x = tf.sparse.SparseTensor([[0, 0], [0, 2], [1, 1]], [1, 2, 3], [2, 3])
tf.sparse.reduce_max(x)
<tf.Tensor: shape=(), dtype=int32, numpy=3>
tf.sparse.reduce_max(x, 0)
<tf.Tensor: shape=(3,), dtype=int32, numpy=array([1, 3, 2], dtype=int32)>
tf.sparse.reduce_max(x, 1)
<tf.Tensor: shape=(2,), dtype=int32, numpy=array([2, 3], dtype=int32)>
tf.sparse.reduce_max(x, 1, keepdims=True)
<tf.Tensor: shape=(2, 1), dtype=int32, numpy=
array([[2],
       [3]], dtype=int32)>
tf.sparse.reduce_max(x, [0, 1])
<tf.Tensor: shape=(), dtype=int32, numpy=3>

'y' represents [[-7, ?]

[ 4, 3]

[ ?, ?]

y = tf.sparse.SparseTensor([[0, 0,], [1, 0], [1, 1]], [-7, 4, 3],
[3, 2])
tf.sparse.reduce_max(y, 1)
<tf.Tensor: shape=(3,), dtype=int32, numpy=array([-7,  4,  0], dtype=int32)>

Args
`sp_input`	The SparseTensor to reduce. Should have numeric type.
`axis`	The dimensions to reduce; list or scalar. If `None` (the default), reduces all dimensions.
`keepdims`	If true, retain reduced dimensions with length 1.
`reduction_axes`	Deprecated name of `axis`.
`keep_dims`	Deprecated alias for `keepdims`.

Returns
The reduced Tensor.