torch.jit.save

torch.jit.save(m, f, _extra_files=None)

保存模块的离线版本，以便在单独的进程中使用。

保存的模块序列化了该模块的所有方法、子模块、参数和属性。它可以使用 torch::jit::load(filename) 在 C++ API 中加载，或者使用 torch.jit.load 在 Python API 中加载。

要能够保存模块，它不能调用任何原生 Python 函数。这意味着所有子模块也必须是 ScriptModule 的子类。

危险

所有模块，无论其设备如何，在加载时总是被加载到 CPU 上。这与 torch.load() 的语义不同，并且未来可能会发生变化。

参数:

• m – 要保存的 ScriptModule。

• f – 一个类似文件的对象（必须实现 write 和 flush 功能）或一个包含文件名的字符串。

• _extra_files – 从文件名到内容的映射，这些内容将被存储为 f 的一部分。

注意

torch.jit.save 尝试跨版本保留某些运算符的行为。例如，在 PyTorch 1.5 中，两个整数张量相除执行的是整除，如果包含该代码的模块在 PyTorch 1.5 中保存，并在 PyTorch 1.6 中加载，其除法行为将会被保留。然而，在 PyTorch 1.6 中保存的同一个模块在 PyTorch 1.5 中加载将会失败，因为 1.6 中除法的行为发生了变化，而 1.5 无法复制 1.6 的行为。

示例: .. testcode

import torch
import io

class MyModule(torch.nn.Module):
    def forward(self, x):
        return x + 10

m = torch.jit.script(MyModule())

# Save to file
torch.jit.save(m, 'scriptmodule.pt')
# This line is equivalent to the previous
m.save("scriptmodule.pt")

# Save to io.BytesIO buffer
buffer = io.BytesIO()
torch.jit.save(m, buffer)

# Save with extra files
extra_files = {'foo.txt': b'bar'}
torch.jit.save(m, 'scriptmodule.pt', _extra_files=extra_files)