mindspore.train.Metric
=======================

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


.. py:class:: mindspore.train.Metric

    用于计算评估指标的基类。

    在计算评估指标时需要调用 `clear` 、 `update` 和 `eval` 三个方法，在继承该类自定义评估指标时，也需要实现这三个方法。其中，`update` 用于计算中间过程的内部结果，`eval` 用于计算最终评估结果，`clear` 用于重置中间结果。
    请勿直接使用该类，需使用子类如 :class:`mindspore.train.MAE` 、 :class:`mindspore.train.Recall` 等。

    .. py:method:: clear()
        :abstractmethod:

        清除内部评估结果。

        .. note::
            所有子类都必须重写此接口。

        教程样例：
            - `评价指标 Metrics - 自定义Metrics
              <https://mindspore.cn/tutorials/zh-CN/r2.2/advanced/model/metric.html#自定义metrics>`_

    .. py:method:: eval()
        :abstractmethod:

        计算最终评估结果。

        .. note::
            所有子类都必须重写此接口。

        教程样例：
            - `评价指标 Metrics - 自定义Metrics
              <https://mindspore.cn/tutorials/zh-CN/r2.2/advanced/model/metric.html#自定义metrics>`_

    .. py:method:: indexes
        :property:

        获取当前的 `indexes` 值。默认为None，调用 `set_indexes` 方法可修改 `indexes` 值。

    .. py:method:: set_indexes(indexes)

        该接口用于重排 `update` 的输入。

        给定(label0, label1, logits)作为 `update` 的输入，将 `indexes` 设置为[2, 1]，则最终使用(logits, label1)作为 `update` 的真实输入。

        .. note::
            在继承该类自定义评估函数时，需要用装饰器 `mindspore.train.rearrange_inputs` 修饰 `update` 方法，否则配置的 `indexes` 值不生效。

        参数：
            - **indexes** (List(int)) - logits和标签的目标顺序。

        输出：
            :class:`.Metric` ，类实例本身。

        异常：
            - **ValueError** - 如果输入的index类型不是list或其元素类型不全为int。

    .. py:method:: update(*inputs)
        :abstractmethod:

        更新内部评估结果。

        .. note::
            所有子类都必须重写此接口。

        参数：
            - **inputs** - 可变长度输入参数列表。通常是预测值和对应的真实标签。

        教程样例：
            - `评价指标 Metrics - 自定义Metrics
              <https://mindspore.cn/tutorials/zh-CN/r2.2/advanced/model/metric.html#自定义metrics>`_