mindspore.ops.cummax
====================

.. image:: https://mindspore-website.obs.cn-north-4.myhuaweicloud.com/website-images/master/resource/_static/logo_source.svg
    :target: https://gitee.com/mindspore/mindspore/blob/master/docs/api/api_python/ops/mindspore.ops.func_cummax.rst
    :alt: 查看源文件


.. py:function:: mindspore.ops.cummax(input, axis)

    返回一个元组（最值、索引），其中最值是输入Tensor `input` 沿维度 `axis` 的累积最大值，索引是每个最大值的索引位置。

    .. math::
        \begin{array}{ll} \\
            y_{i} = \max(x_{1}, x_{2}, ... , x_{i})
        \end{array}

    参数：
        - **input** (Tensor) - 输入Tensor，要求维度大于0。
        - **axis** (int) - 算子操作的维度，维度的大小范围是[-input.ndim, input.ndim - 1]。

    返回：
        一个包含两个Tensor的元组，分别表示累积最大值和对应索引。每个输出Tensor的形状和输入Tensor的形状相同。

    异常：
        - **TypeError** - 如果 `input` 不是Tensor。
        - **TypeError** - 如果 `axis` 不是int。
        - **ValueError** - 如果 `axis` 不在范围[-input.ndim, input.ndim - 1]内。