|
- mindspore.nn.Metric
- ====================
-
- .. py:class:: mindspore.nn.Metric
-
- 用于计算评估指标的基类。
-
- 在计算评估指标时需要调用 `clear` 、 `update` 和 `eval` 三个方法,在继承该类自定义评估指标时,也需要实现这三个方法。其中,`update` 用于计算中间过程的内部结果,`eval` 用于计算最终评估结果,`clear` 用于重置中间结果。
- 请勿直接使用该类,需使用子类如 :class:`mindspore.nn.MAE` 、 :class:`mindspore.nn.Recall` 等。
-
- .. py:method:: clear()
- :abstractmethod:
-
- 清除内部评估结果。
-
- .. note::
- 所有子类都必须重写此接口。
-
- .. py:method:: eval()
- :abstractmethod:
-
- 计算最终评估结果。
-
- .. note::
- 所有子类都必须重写此接口。
-
- .. 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.nn.rearrange_inputs` 修饰 `update` 方法,否则配置的 `indexes` 值不生效。
-
-
- **参数:**
-
- - **indexes** (List(int)) - logits和标签的目标顺序。
-
- **输出:**
-
- :class:`Metric` ,类实例本身。
-
- **异常:**
-
- - **ValueError** - 如果输入的index类型不是list或其元素类型不全为int。
-
- .. py:method:: update(*inputs)
- :abstractmethod:
-
- 更新内部评估结果。
-
- .. note::
- 所有子类都必须重写此接口。
-
- **参数:**
-
- - **inputs** - 可变长度输入参数列表。通常是预测值和对应的真实标签。
|