create_dl_layer_loss_distanceT_create_dl_layer_loss_distanceCreateDlLayerLossDistanceCreateDlLayerLossDistancecreate_dl_layer_loss_distance创建深度学习层损失距离（算子）

名称

create_dl_layer_loss_distanceT_create_dl_layer_loss_distanceCreateDlLayerLossDistanceCreateDlLayerLossDistancecreate_dl_layer_loss_distance — 创建距离损失层。

签名

描述

算子 create_dl_layer_loss_distancecreate_dl_layer_loss_distanceCreateDlLayerLossDistanceCreateDlLayerLossDistanceCreateDlLayerLossDistancecreate_dl_layer_loss_distance 创建一个距离损失层，其句柄通过 DLLayerLossDistanceDLLayerLossDistanceDLLayerLossDistanceDLLayerLossDistanceDLLayerLossDistancedllayer_loss_distance 返回。

该层期望接收多个层作为输入：

• DLLayerInputDLLayerInputDLLayerInputDLLayerInputDLLayerInputdllayer_input：指定预测层（例如 softmax 层）。

• DLLayerTargetDLLayerTargetDLLayerTargetDLLayerTargetDLLayerTargetdllayer_target：指定目标序列（源自真实标签信息）。

• DLLayerWeightsDLLayerWeightsDLLayerWeightsDLLayerWeightsDLLayerWeightsdllayer_weights：指定权重序列。此参数为可选项。若所有值均传递空元组 []，则采用权重因子 1.0。

参数 LayerNameLayerNameLayerNameLayerNamelayerNamelayer_name 用于设置单个层的名称。请注意，若使用 create_dl_modelcreate_dl_modelCreateDlModelCreateDlModelCreateDlModelcreate_dl_model 创建模型，则创建网络中的每个层必须具有唯一名称。

参数 LossWeightLossWeightLossWeightLossWeightlossWeightloss_weight 是网络中存在多个损失函数时的整体损失权重。

参数 DistanceTypeDistanceTypeDistanceTypeDistanceTypedistanceTypedistance_type 决定采用哪种距离度量方法。当前仅实现 'l2'"l2""l2""l2""l2""l2" 选项。根据泛型参数 'reduce'"reduce""reduce""reduce""reduce""reduce" 的值，结果如下

• L2 损失距离作为张量： 此时损失为与 DLLayerInputDLLayerInputDLLayerInputDLLayerInputDLLayerInputdllayer_input 同尺寸的张量。

• L2 损失距离作为标量： 其中 为 DLLayerInputDLLayerInputDLLayerInputDLLayerInputDLLayerInputdllayer_input 中的元素个数。

因此，DLLayerInputDLLayerInputDLLayerInputDLLayerInputDLLayerInputdllayer_input、DLLayerTargetDLLayerTargetDLLayerTargetDLLayerTargetDLLayerTargetdllayer_target 和 DLLayerWeightsDLLayerWeightsDLLayerWeightsDLLayerWeightsDLLayerWeightsdllayer_weights 应具有相同大小。将 DLLayerWeightsDLLayerWeightsDLLayerWeightsDLLayerWeightsDLLayerWeightsdllayer_weights 中的权重设置为 1 将导致损失被元素数量进行归一化。

支持以下泛型参数 GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name 及其对应值 GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value：

'is_inference_output'"is_inference_output""is_inference_output""is_inference_output""is_inference_output""is_inference_output"：

确定 apply_dl_modelapply_dl_modelApplyDlModelApplyDlModelApplyDlModelapply_dl_model 是否将此层的输出包含在字典 DLResultBatchDLResultBatchDLResultBatchDLResultBatchDLResultBatchdlresult_batch 中，即使未在 OutputsOutputsOutputsOutputsoutputsoutputs 中指定此层（'true'"true""true""true""true""true"）或不包含（'false'"false""false""false""false""false"）。

默认值： 'false'"false""false""false""false""false"

'reduce'"reduce""reduce""reduce""reduce""reduce"：

决定该层的输出是否被缩减：

• 'true'"true""true""true""true""true"：输出被缩减为标量。

• 'false'"false""false""false""false""false"：该层的输出为张量，其中每个元素表示“每像素”的损失（平方差）。

默认值： 'true'"true""true""true""true""true"。

使用 create_dl_layer_loss_distancecreate_dl_layer_loss_distanceCreateDlLayerLossDistanceCreateDlLayerLossDistanceCreateDlLayerLossDistancecreate_dl_layer_loss_distance 算子创建的层，其特定参数可通过其他算子进行设置与检索。下表概述了可通过 set_dl_model_layer_paramset_dl_model_layer_paramSetDlModelLayerParamSetDlModelLayerParamSetDlModelLayerParamset_dl_model_layer_param 设置的参数，以及可通过 get_dl_model_layer_paramget_dl_model_layer_paramGetDlModelLayerParamGetDlModelLayerParamGetDlModelLayerParamget_dl_model_layer_param 或 get_dl_layer_paramget_dl_layer_paramGetDlLayerParamGetDlLayerParamGetDlLayerParamget_dl_layer_param 检索的参数。请注意，算子 set_dl_model_layer_paramset_dl_model_layer_paramSetDlModelLayerParamSetDlModelLayerParamSetDlModelLayerParamset_dl_model_layer_param 和 get_dl_model_layer_paramget_dl_model_layer_paramGetDlModelLayerParamGetDlModelLayerParamGetDlModelLayerParamget_dl_model_layer_param 需基于 create_dl_modelcreate_dl_modelCreateDlModelCreateDlModelCreateDlModelcreate_dl_model 创建的模型。

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 未采用并行化处理。

参数

模块

深度学习训练

---