AF3 identity_trans函数解读

AlphaFold3 rigid_utils 模块的 identity_trans 函数的功能是生成带有批次维度的全零平移向量张量。

源代码:

复制代码
@lru_cache(maxsize=None)
def identity_trans(
    batch_dims: Tuple[int], 
    dtype: Optional[torch.dtype] = None,
    device: Optional[torch.device] = None, 
    requires_grad: bool = True,
) -> torch.Tensor:
    trans = torch.zeros(
        (*batch_dims, 3), 
        dtype=dtype, 
        device=device, 
        requires_grad=requires_grad
    )
    return trans

源码解读:

1. 函数定义
复制代码
def identity_trans(
    batch_dims: Tuple[int], 
    dtype: Optional[torch.dtype] = None,
    device: Optional[torch.device] = None, 
    requires_grad: bool = True,
) -> torch.Tensor:

参数解析

  • batch_dims : 表示输入的批次维度,比如 (16,) 就创建 16 个零向量 (16, 3)

  • dtype : 数据类型,float32, float64 之类的。

  • device : 张量在哪个设备上,cpucuda

  • requires_grad : 是否需要梯度,默认为 True,适合训练场景。

👉 目标 :创建一个形状 [*, 3] 的零向量,代表初始平移向量 (0, 0, 0)

2. 创建张量
复制代码
trans = torch.zeros(
    (*batch_dims, 3), 
    dtype=dtype, 
    device=device, 
    requires_grad=requires_grad
)

解析逐项看

  • (*batch_dims, 3) :

    • batch_dims 展开成多个批次维度,比如 (16,) 展开后就是 16

    • 3 是每个向量的长度,表示 (x, y, z) 三个方向的位移。

    • 最终形状类似 torch.Size([16, 3])

  • dtype : 控制数据类型,比如 torch.float32

  • device : 控制张量生成在哪个设备,比如 cuda:0

  • requires_grad : 如果 True,这个张量就会参与梯度计算(适合训练用)。

3. 返回张量
复制代码
  return trans

最终返回 形状 [*, 3] 的全零平移向量张量。

4. 总结

identity_trans() 的核心功能:

生成初始位移向量 ------ 形状 [*, 3] 的零向量,代表 "不移动"

支持多批次输入 ------ batch_dims 灵活扩展支持多维数据,比如 [(8, 4, 3)]

缓存加速 ------ 重复调用相同参数时,不重复创建张量,直接用缓存结果。

支持梯度训练 ------ 默认开启 requires_grad=True,可以在训练时更新平移向量。

相关推荐
wangjun51596 分钟前
人工智能、机器学习、深度学习、大模型、智能体知识点汇总
人工智能·深度学习·机器学习
音视频牛哥8 分钟前
无人机 × 巡检 × AI识别:一套可复制的超低延迟低空视频感知系统搭建实践
人工智能·音视频·无人机·大牛直播sdk·低空感知·无人机视频回传·ai边缘识别
一年春又来13 分钟前
AI-03a1.Python深度学习-Tensorflow和Keras入门
人工智能·深度学习·tensorflow
Funny_AI_LAB17 分钟前
Google AI 发布 MLE-STAR:一款能够自动执行各种 AI 任务的先进机器学习工程代理
人工智能·科技·机器学习
2501_9247319921 分钟前
智慧能源场景设备缺陷漏检率↓76%:陌讯多模态融合检测方案实战解析
大数据·人工智能·算法·目标检测·计算机视觉·视觉检测
白葵新23 分钟前
C#案例实战
c++·python·算法·计算机视觉·c#
Cosolar28 分钟前
下一代 Python Web 框架?FastAPI 全面解析与实战对比
后端·python
AIGC_北苏32 分钟前
本地使用uv管理的python项目怎么部署到服务器?
python·uv
上海云盾商务经理杨杨39 分钟前
2025年服务器僵尸攻防战:从AI勒索到量子免疫,构建下一代“数字抗体”
运维·服务器·人工智能
FL162386312940 分钟前
电线杆损坏倒塌断裂分割数据集labelme格式2597张1类别
人工智能·深度学习