已合并
add test for add_module and apply api in torch.jit.ScriptModule #38692
bobebest创建于 6月16日
add test for add_module and apply api in torch.jit.ScriptModule #38692
已合并
Pull Request已成功合入, 合并人@ascend-robot
(感谢 bobebest 的贡献)ascend-robot
6月16日 评论:
6月16日 评论:
6月16日 添加了label:stat/needs-squash
6月16日 添加了label:ascend-cla/yes
此处折叠了251条消息 查看更多
ascend-robot
7月10日 评论:
7月10日 评论:
重试流水线失败:PR-pipeline_pytorch 仅失败状态流水线支持重试操作。


7月10日 添加了label:ci-pipeline-passed
7月10日 合入了pull request
【合入来源】
【修改方案】
torch.jit.ScriptModule.add_module和torch.jit.ScriptModule.apply:已在 PyTorch 官方社区搜索 ,无针对该 API 的专门测试用例,因此自行编写测试用例。
Torch.jit.ScriptModule各属性介绍:把一个普通的 Python 模型(nn.Module)编译成 TorchScript 模型(ScriptModule),让它可以脱离 Python、在 NPU/C++/ 推理引擎上跑。
API介绍
torch.jit.ScriptModule.add_module是 PyTorch TorchScript 中用于动态添加子模块的核心方法,该子模块可以使用给定的名称作为属性进行访问;
**语法:**add_module(name, module)
参数:
name(str):子模块的名称,可以是任意字符串
module(torch.nn.Module 或 None):要添加的子模块实例;传入 None 时相当于删除该名称对应的子模块
**返回值:**None
核心特性:
1、TorchScript 静态性约束:只有 add_module 能让 TorchScript 识别并追踪新加入的子模块、参数和缓冲区;
2、动态网络构建:适用于运行时才决定网络结构的场景(如循环添加多层、条件分支添加模块);
3、状态管理:加入的子模块会被纳入 parameters()、state_dict()、to(device)、train()/eval() 等管理体系。
torch.jit.ScriptModule.apply是 PyTorch TorchScript 静态图模块 的递归遍历函数,递归遍历模块自身 + 所有子模块,对每一个模块执行传入的函数。
**语法:**apply(fn)
参数:
fn(Callable[[torch.nn.Module], None]):一个函数,接受一个 Module 实例作为输入,返回 None。该函数会被递归地应用到模块自身和每一个子模块上
返回值:self(即调用 apply 的 ScriptModule 实例本身)
核心特性如下:
1、递归执行:深度优先遍历所有子模块
2、原地修改:直接修改模块,不返回新模型
3、顺序固定:先处理自身,再处理子模块
4、TorchScript 安全:可在静态图中正常使用
5、生命周期统一管理:参数、设备、模式全部生效
具体测试内容如下:
torch.jit.ScriptModule.add_module能否正确添加子模块;torch.jit.ScriptModule.apply能否正确修改参数torch.jit.ScriptModule.apply是否递归访问所有嵌套子模块torch.jit.ScriptModule.apply是否返回自身以支持链式调用【资料变更】
【接口变更】
【功能验证】
【CheckList】