Pytorch 容器 - 1. Module类介绍
目录
1. 基于Module构建自己的网络
2. Module的初始化变量
3. Modules中需要子类 forward()
4. Modules中其他内置函数
1. 基于Module构建自己的网络
torch.nn.Module是所有神经网络模块的基类，如何定义自已的网络：
- 由于 Module 是神经网络模块的基类，自己的模型应该要继承这个类
- 要实现 torch.nn.Module 中的forward函数，从而进行网络的前向传播
- 一般把网络中具有可学习参数的层放在构造函数__init__()中
- 把不具有可学习参数的层(如ReLU)放在forward中，并通过nn.functional来代替
import torch.nn as nn
import torch.nn.functional as Fclass Model(nn.Module): # 继承nn.Module类def __init__(self):super(Model, self).__init__()# 把具有可学习参数的层放在构造函数中self.conv1 = nn.Conv2d(1, 20, 5) self.conv2 = nn.Conv2d(20, 20, 5)def forward(self, x): # 实现forward函数# 在forward中直接使用torch.nn.functional.relu()函数x = F.relu(self.conv1(x))return F.relu(self.conv2(x))2. Module的初始化变量
nn.Module 类内置了一些初始化变量。包括在模块 forward、 backward 和权重加载等时候会被调用的的 hooks，也定义了 parameters 和 buffers，如源码所示：
def __init__(self):"""Initializes internal Module state, shared by both nn.Module and ScriptModule."""torch._C._log_api_usage_once("python.nn_module")self.training = True # 当前训练/测试的状态self._parameters = OrderedDict() # 在训练过程中会随 BP 而更新的参数self._buffers = OrderedDict() # 在训练过程中不会随 BP 而更新的参数self._non_persistent_buffers_set = set() self._backward_hooks = OrderedDict() # Backward 完成后会被调用的 hookself._is_full_backward_hook = Noneself._forward_hooks = OrderedDict() # Forward 完成后会被调用的 hookself._forward_pre_hooks = OrderedDict() # Forward 前会被调用的 hookself._state_dict_hooks = OrderedDict() # 得到 state_dict 以后会被调用的 hookself._load_state_dict_pre_hooks = OrderedDict() # 加载state_dict 前会被调用的 hookself._modules = OrderedDict() # 网络的子模块3. Modules中需要子类 forward()
注意：在网络训练过程中，直接通过mode(input) 自动调用forward函数，而非model.forward(input)进行调用，因为前者mode(input) 除了forward()外还调用了额外的函数：先执行_forward_pre_hooks里的所有hooks
- 再调用forward()
- 执行_forward_hooks中所有hooks
- 执行_backward_hooks中所有hooks
4. Modules中其他内置函数
除了初始化的成员变量之外，Modules还内置了很多函数，具体包含以下几类：
(1) 属性访问：modules(), named_modules(), buffers(), named_buffers(), children(), named_children(), parameters(), named_parameters() 等
(2) 属性设置：register_parameter()，register_buffer()，register_forward_hook()，register_forward_pre_hook() 等
(3) 参数转换/转移：cpu(), cuda(), float(), double() 等
(4) 状态转换：train(), eval() 等
对于这些内置函数的详细介绍，在 PyTorch系列相关文章-Aaron_neil的csdn博客 持续更新中！
本文所参考的部分博客：
[1] pytorch 入坑三：nn module - 知乎
[2] torch.nn.Module模块简单介绍_allan2222的博客-CSDN博客
