torch.utils.module_tracker

此实用程序可用于跟踪 torch.nn.Module 层级结构中的当前位置。它可以在其他跟踪工具中使用，以便轻松地将测量量与用户友好的名称关联起来。这尤其用于今天的 FlopCounterMode 中。

类 torch.utils.module_tracker.ModuleTracker

ModuleTracker 是一个上下文管理器，用于在执行期间跟踪 nn.Module 层级结构，以便其他系统可以查询当前正在执行的 Module（或其反向传播正在执行的 Module）。

您可以访问此上下文管理器上的 parents 属性，以获取当前正在执行的所有 Module 的集合，通过它们的 fqn（完全限定名称，也用作 state_dict 中的键）。您可以访问 is_bw 属性，以了解您当前是否在反向传播中运行。

请注意，parents 永远不会为空，并且始终包含 “Global” 键。is_bw 标志在正向传播之后将保持 True，直到执行另一个 Module。如果您需要它更准确，请提交 issue 请求此功能。从 fqn 到模块实例添加映射是可能的，但尚未完成，如果您需要它，请提交 issue 请求此功能。

使用示例

mod = torch.nn.Linear(2, 2)

with ModuleTracker() as tracker:
    # Access anything during the forward pass
    def my_linear(m1, m2, bias):
        print(f"Current modules: {tracker.parents}")
        return torch.mm(m1, m2.t()) + bias
    torch.nn.functional.linear = my_linear

    mod(torch.rand(2, 2))