pytorch torch.isclose函数介绍

torch.isclose 是 PyTorch 中用于比较两个张量是否"近似相等"的函数。它主要用于判断两个张量的对应元素在数值上是否接近(考虑了浮点数精度的可能误差)。


函数定义

复制代码
torch.isclose(input, other, rtol=1e-05, atol=1e-08, equal_nan=False)

参数说明

  1. input (Tensor):

    • 第一个张量。
  2. other (Tensor):

    • 第二个张量,和 input 的形状必须相同,或者可以通过广播机制与 input 对齐。
  3. rtol (float, 可选,默认值:1e-05):

    • 相对容忍误差(relative tolerance)。比较时的相对误差阈值,定义了两个值相对距离的可接受范围。
  4. atol (float, 可选,默认值:1e-08):

    • 绝对容忍误差(absolute tolerance)。比较时的绝对误差阈值,定义了两个值绝对距离的可接受范围。
  5. equal_nan (bool, 可选,默认值:False):

    • 是否将 NaN 视为"接近"。
    • 如果为 True,则两个 NaN 会被认为是相等的。

返回值

  • 返回一个与 inputother 形状相同的布尔张量。
  • 每个元素表示 inputother 对应位置的元素是否"近似相等"。

比较规则

两个元素 aa 和 bb 被认为是"近似相等"的条件是:

  • |a - b|: 表示 inputother 对应元素之间的绝对差值。
  • atol: 绝对误差阈值。
  • rtol: 相对误差阈值。

常见用途

  • 比较浮点数是否相等(避免浮点数精度误差)。
  • 检查数值计算中张量的结果是否一致或接近。
  • 判断两个张量之间的元素是否在某个容忍范围内。

示例

复制代码
import torch

# 创建两个浮点张量
a = torch.tensor([1.0, 2.0, 3.0001])
b = torch.tensor([1.0, 2.0, 3.0])

# 默认参数下比较
result = torch.isclose(a, b)
print(result)  # tensor([True, True, False])

# 调整容忍误差
result = torch.isclose(a, b, rtol=1e-03, atol=1e-05)
print(result)  # tensor([True, True, True])

# 比较含有 NaN 的张量
a = torch.tensor([1.0, float('nan')])
b = torch.tensor([1.0, float('nan')])

# 默认不认为 NaN 相等
print(torch.isclose(a, b))  # tensor([ True, False])

# 允许 NaN 相等
print(torch.isclose(a, b, equal_nan=True))  # tensor([ True, True])

注意事项

  • rtolatol 的选择

    • 如果数值范围较大,可以增加 rtol
    • 如果数值精度要求较高,可以减小 atol
  • NaN 的比较

    • 默认情况下,torch.isclose 认为 NaN 是不相等的,除非 equal_nan=True
相关推荐
若兰幽竹11 分钟前
【从零开始编写数据库:基于Python语言实现数据库ToyDB的ACID特性】
数据库·python
东方佑12 分钟前
仅27M参数!SamOutVX轻量级语言模型刷新认知,小身材也有大智慧
人工智能·语言模型·自然语言处理
东临碣石8214 分钟前
【AI论文】OmniPart:基于语义解耦与结构连贯性的部件感知三维生成
人工智能
xiaocainiao88119 分钟前
Python 实战:构建 Git 自动化助手
git·python·自动化
啾啾Fun31 分钟前
咨询导览,AI发展趋势
人工智能
向阳逐梦32 分钟前
PID控制算法理论学习基础——单级PID控制
人工智能·算法
nightunderblackcat34 分钟前
新手向:使用Python将多种图像格式统一转换为JPG
开发语言·python
2zcode35 分钟前
基于Matlab多特征融合的可视化指纹识别系统
人工智能·算法·matlab
Liudef0636 分钟前
三维点云Transformer局部感受野构建:理论、方法与挑战
人工智能·深度学习·transformer
说私域38 分钟前
基于定制开发开源AI智能名片与S2B2C商城小程序的旅游日志创新应用研究
人工智能·小程序·旅游