From 6c5faea6ddee36e110d2c7cca3d832d24ab340fe Mon Sep 17 00:00:00 2001 From: Aidenwu0209 <1418557225@qq.com> Date: Thu, 5 Mar 2026 09:22:12 +0800 Subject: [PATCH 1/2] [API Compatibility No.155] Update docs for bce_with_logits alias support --- .../nn/functional/binary_cross_entropy_with_logits_cn.rst | 4 ++-- .../torch.nn.functional.binary_cross_entropy_with_logits.md | 6 ++++-- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/api/paddle/nn/functional/binary_cross_entropy_with_logits_cn.rst b/docs/api/paddle/nn/functional/binary_cross_entropy_with_logits_cn.rst index 72afe9e8945..5b43075c3d7 100644 --- a/docs/api/paddle/nn/functional/binary_cross_entropy_with_logits_cn.rst +++ b/docs/api/paddle/nn/functional/binary_cross_entropy_with_logits_cn.rst @@ -34,8 +34,8 @@ binary_cross_entropy_with_logits 参数 ::::::::: - - **logit** (Tensor) - :math:`[N, *]`，其中 N 是 batch_size， `*` 是任意其他维度。输入数据 ``logit`` 一般是线性层的输出，不需要经过 ``sigmoid`` 层。数据类型是 float32、float64。 - - **label** (Tensor) - :math:`[N, *]`，标签 ``label`` 的维度、数据类型与输入 ``logit`` 相同。 + - **logit** (Tensor) - :math:`[N, *]`，其中 N 是 batch_size， `*` 是任意其他维度。输入数据 ``logit`` 一般是线性层的输出，不需要经过 ``sigmoid`` 层。数据类型是 float32、float64。别名：``input``。 + - **label** (Tensor) - :math:`[N, *]`，标签 ``label`` 的维度、数据类型与输入 ``logit`` 相同。别名：``target``。 - **weight** (Tensor，可选) - 手动指定每个 batch 二值交叉熵的权重，如果指定的话，维度必须是一个 batch 的数据的维度。数据类型是 float32, float64。默认值是：None。 - **reduction** (str，可选) - 指定应用于输出结果的计算方式，可选值有：``'none'``, ``'mean'``, ``'sum'``。默认为 ``'mean'``，计算 `BCELoss` 的均值；设置为 ``'sum'`` 时，计算 `BCELoss` 的总和；设置为 ``'none'`` 时，则返回原始 loss。 - **pos_weight** (Tensor，可选) - 手动指定正类的权重，必须是与类别数相等长度的向量。数据类型是 float32, float64。默认值是：None。 diff --git a/docs/guides/model_convert/convert_from_pytorch/api_difference/torch_more_args/torch.nn.functional.binary_cross_entropy_with_logits.md b/docs/guides/model_convert/convert_from_pytorch/api_difference/torch_more_args/torch.nn.functional.binary_cross_entropy_with_logits.md index d11d7c496fb..bffe47ed2c8 100644 --- a/docs/guides/model_convert/convert_from_pytorch/api_difference/torch_more_args/torch.nn.functional.binary_cross_entropy_with_logits.md +++ b/docs/guides/model_convert/convert_from_pytorch/api_difference/torch_more_args/torch.nn.functional.binary_cross_entropy_with_logits.md @@ -9,14 +9,16 @@ torch.nn.functional.binary_cross_entropy_with_logits(input, target, weight=None, paddle.nn.functional.binary_cross_entropy_with_logits(logit, label, weight=None, reduction='mean', pos_weight=None, name=None) ``` +其中 `input` 是 Paddle 参数 `logit` 的别名，`target` 是 Paddle 参数 `label` 的别名。 + PyTorch 相比 Paddle 支持更多其他参数，具体如下： ### 参数映射 | PyTorch | PaddlePaddle | 备注 | | ------------- | ------------ | ------------------------------------------------------ | -| input | logit | 表示输入的 Tensor。 | -| target | label | 标签，和 input 具有相同的维度，仅参数名不一致。 | +| input | logit | 表示输入的 Tensor。Paddle 兼容 `input` 别名，无需改写。 | +| target | label | 标签，和 input 具有相同的维度。Paddle 兼容 `target` 别名，无需改写。 | | weight | weight | 类别权重。 | | size_average | - | 已废弃，和 reduce 组合决定损失计算方式。 Paddle 无此参数，需要转写。 | | reduce | - | 已废弃，和 size_average 组合决定损失计算方式。 Paddle 无此参数，需要转写。 | From 306bf5180b9d7e591d3778423d31808a9442e893 Mon Sep 17 00:00:00 2001 From: Aidenwu0209 <1418557225@qq.com> Date: Mon, 23 Mar 2026 13:44:23 +0800 Subject: [PATCH 2/2] [API Compatibility No.155] Align bce_with_logits docs with latest docs format -part --- .../nn/functional/binary_cross_entropy_with_logits_cn.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/paddle/nn/functional/binary_cross_entropy_with_logits_cn.rst b/docs/api/paddle/nn/functional/binary_cross_entropy_with_logits_cn.rst index 933992a7f2b..de5db60d29e 100644 --- a/docs/api/paddle/nn/functional/binary_cross_entropy_with_logits_cn.rst +++ b/docs/api/paddle/nn/functional/binary_cross_entropy_with_logits_cn.rst @@ -34,7 +34,7 @@ binary_cross_entropy_with_logits 参数 ::::::::: - - **logit** (Tensor) - :math:`[N, *]`，其中 N 是 batch_size， `*` 是任意其他维度。输入数据 ``logit`` 一般是线性层的输出，不需要经过 ``sigmoid`` 层。数据类型是 float32、float64。别名：``input``。 + - **logit** (Tensor) - :math:`[N, *]`，其中 N 是 batch_size， ``*`` 是任意其他维度。输入数据 ``logit`` 一般是线性层的输出，不需要经过 ``sigmoid`` 层。数据类型是 float32、float64。别名：``input``。 - **label** (Tensor) - :math:`[N, *]`，标签 ``label`` 的维度、数据类型与输入 ``logit`` 相同。别名：``target``。 - **weight** (Tensor，可选) - 手动指定每个 batch 二值交叉熵的权重，如果指定的话，维度必须是一个 batch 的数据的维度。数据类型是 float32, float64。默认值是：None。 - **reduction** (str，可选) - 指定应用于输出结果的计算方式，可选值有：``'none'``, ``'mean'``, ``'sum'``。默认为 ``'mean'``，计算 ``BCELoss`` 的均值；设置为 ``'sum'`` 时，计算 ``BCELoss`` 的总和；设置为 ``'none'`` 时，则返回原始 loss。