torch.nn

Parameters

class torch.nn.Parameter()

Variable的一种,常被用于模块参数(module parameter)。

ParametersVariable 的子类。ParamentersModules一起使用的时候会有一些特殊的属性,即:当Paramenters赋值给Module的属性的时候,他会自动的被加到 Module的 参数列表中(即:会出现在 parameters() 迭代器中)。将Varibale赋值给Module属性则不会有这样的影响。这样做的原因是:我们有时候会需要缓存一些临时的状态(state), 比如:模型中RNN的最后一个隐状态。如果没有Parameter这个类的话,那么这些临时变量也会注册成为模型变量。

VariableParameter的另一个不同之处在于,Parameter不能被 volatile(即:无法设置volatile=True)而且默认requires_grad=TrueVariable默认requires_grad=False

参数说明:

  • data (Tensor) – parameter tensor.

  • requires_grad (bool, optional) – 默认为True,在BP的过程中会对其求微分。

Containers(容器):

class torch.nn.Module

所有网络的基类。

你的模型也应该继承这个类。

Modules也可以包含其它Modules,允许使用树结构嵌入他们。你可以将子模块赋值给模型属性。

  1. import torch.nn as nn
  2. import torch.nn.functional as F
  3. class Model(nn.Module):
  4. def __init__(self):
  5. super(Model, self).__init__()
  6. self.conv1 = nn.Conv2d(1, 20, 5)# submodule: Conv2d
  7. self.conv2 = nn.Conv2d(20, 20, 5)
  8. def forward(self, x):
  9. x = F.relu(self.conv1(x))
  10. return F.relu(self.conv2(x))

通过上面方式赋值的submodule会被注册。当调用 .cuda() 的时候,submodule的参数也会转换为cuda Tensor

add_module(name, module)

将一个 child module 添加到当前 modle。被添加的module可以通过 name属性来获取。例:

  1. import torch.nn as nn
  2. class Model(nn.Module):
  3. def __init__(self):
  4. super(Model, self).__init__()
  5. self.add_module("conv", nn.Conv2d(10, 20, 4))
  6. #self.conv = nn.Conv2d(10, 20, 4) 和上面这个增加module的方式等价
  7. model = Model()
  8. print(model.conv)

输出:

  1. Conv2d(10, 20, kernel_size=(4, 4), stride=(1, 1))

children()

Returns an iterator over immediate children modules.返回当前模型 子模块的迭代器。

  1. import torch.nn as nn
  2. class Model(nn.Module):
  3. def __init__(self):
  4. super(Model, self).__init__()
  5. self.add_module("conv", nn.Conv2d(10, 20, 4))
  6. self.add_module("conv1", nn.Conv2d(20 ,10, 4))
  7. model = Model()
  8. for sub_module in model.children():
  9. print(sub_module)
  1. Conv2d(10, 20, kernel_size=(4, 4), stride=(1, 1))
  2. Conv2d(20, 10, kernel_size=(4, 4), stride=(1, 1))

cpu(device_id=None)

将所有的模型参数(parameters)和buffers复制到CPU

NOTE:官方文档用的move,但我觉着copy更合理。

cuda(device_id=None)

将所有的模型参数(parameters)和buffers赋值GPU

参数说明:

  • device_id (int, optional) – 如果指定的话,所有的模型参数都会复制到指定的设备上。

double()

parametersbuffers的数据类型转换成double

eval()

将模型设置成evaluation模式

仅仅当模型中有DropoutBatchNorm是才会有影响。

float()

parametersbuffers的数据类型转换成float

forward(* input)

定义了每次执行的 计算步骤。在所有的子类中都需要重写这个函数。

half()

parametersbuffers的数据类型转换成half

load_state_dict(state_dict)

state_dict中的parametersbuffers复制到此module和它的后代中。state_dict中的key必须和 model.state_dict()返回的key一致。NOTE:用来加载模型参数。

参数说明:

  • state_dict (dict) – 保存parameterspersistent buffers的字典。

modules()

返回一个包含 当前模型 所有模块的迭代器。

  1. import torch.nn as nn
  2. class Model(nn.Module):
  3. def __init__(self):
  4. super(Model, self).__init__()
  5. self.add_module("conv", nn.Conv2d(10, 20, 4))
  6. self.add_module("conv1", nn.Conv2d(20 ,10, 4))
  7. model = Model()
  8. for module in model.modules():
  9. print(module)
  1. Model (
  2. (conv): Conv2d(10, 20, kernel_size=(4, 4), stride=(1, 1))
  3. (conv1): Conv2d(20, 10, kernel_size=(4, 4), stride=(1, 1))
  4. )
  5. Conv2d(10, 20, kernel_size=(4, 4), stride=(1, 1))
  6. Conv2d(20, 10, kernel_size=(4, 4), stride=(1, 1))

可以看出,modules()返回的iterator不止包含 子模块。这是和children()的不同。

NOTE:重复的模块只被返回一次(children()也是)。 在下面的例子中, submodule 只会被返回一次:

  1. import torch.nn as nn
  2. class Model(nn.Module):
  3. def __init__(self):
  4. super(Model, self).__init__()
  5. submodule = nn.Conv2d(10, 20, 4)
  6. self.add_module("conv", submodule)
  7. self.add_module("conv1", submodule)
  8. model = Model()
  9. for module in model.modules():
  10. print(module)
  1. Model (
  2. (conv): Conv2d(10, 20, kernel_size=(4, 4), stride=(1, 1))
  3. (conv1): Conv2d(10, 20, kernel_size=(4, 4), stride=(1, 1))
  4. )
  5. Conv2d(10, 20, kernel_size=(4, 4), stride=(1, 1))

named_children()

返回 包含 模型当前子模块 的迭代器,yield 模块名字和模块本身。

例子:

  1. for name, module in model.named_children():
  2. if name in ['conv4', 'conv5']:
  3. print(module)

named_modules(memo=None, prefix=’’)[source]

返回包含网络中所有模块的迭代器, yielding 模块名和模块本身。

注意:

重复的模块只被返回一次(children()也是)。 在下面的例子中, submodule 只会被返回一次。

parameters(memo=None)

返回一个 包含模型所有参数 的迭代器。

一般用来当作optimizer的参数。

例子:

  1. for param in model.parameters():
  2. print(type(param.data), param.size())
  3. <class 'torch.FloatTensor'> (20L,)
  4. <class 'torch.FloatTensor'> (20L, 1L, 5L, 5L)

register_backward_hook(hook)

module上注册一个bachward hook

每次计算moduleinputs的梯度的时候,这个hook会被调用。hook应该拥有下面的signature

hook(module, grad_input, grad_output) -> Variable or None

如果module有多个输入输出的话,那么grad_input grad_output将会是个tuplehook不应该修改它的arguments,但是它可以选择性的返回关于输入的梯度,这个返回的梯度在后续的计算中会替代grad_input

这个函数返回一个 句柄(handle)。它有一个方法 handle.remove(),可以用这个方法将hookmodule移除。

register_buffer(name, tensor)

module添加一个persistent buffer

persistent buffer通常被用在这么一种情况:我们需要保存一个状态,但是这个状态不能看作成为模型参数。例如:, BatchNorm’s running_mean 不是一个 parameter, 但是它也是需要保存的状态之一。

Buffers可以通过注册时候的name获取。

NOTE:我们可以用 buffer 保存 moving average

例子:

  1. self.register_buffer('running_mean', torch.zeros(num_features))
  2. self.running_mean

register_forward_hook(hook)

module上注册一个forward hook。每次调用forward()计算输出的时候,这个hook就会被调用。它应该拥有以下签名:

hook(module, input, output) -> None

hook不应该修改 inputoutput的值。 这个函数返回一个 句柄(handle)。它有一个方法 handle.remove(),可以用这个方法将hookmodule移除。

register_parameter(name, param)

module添加 parameter

parameter可以通过注册时候的name获取。

state_dict(destination=None, prefix=’’)[source]

返回一个字典,保存着module的所有状态(state)。

parameterspersistent buffers都会包含在字典中,字典的key就是parameterbuffernames

例子:

  1. import torch
  2. from torch.autograd import Variable
  3. import torch.nn as nn
  4. class Model(nn.Module):
  5. def __init__(self):
  6. super(Model, self).__init__()
  7. self.conv2 = nn.Linear(1, 2)
  8. self.vari = Variable(torch.rand([1]))
  9. self.par = nn.Parameter(torch.rand([1]))
  10. self.register_buffer("buffer", torch.randn([2,3]))
  11. model = Model()
  12. print(model.state_dict().keys())
  1. odict_keys(['par', 'buffer', 'conv2.weight', 'conv2.bias'])

train(mode=True)

module设置为 training mode

仅仅当模型中有DropoutBatchNorm是才会有影响。

zero_grad()

module中的所有模型参数的梯度设置为0.

class torch.nn.Sequential(* args)

一个时序容器。Modules 会以他们传入的顺序被添加到容器中。当然,也可以传入一个OrderedDict

为了更容易的理解如何使用Sequential, 下面给出了一个例子:

  1. # Example of using Sequential
  2. model = nn.Sequential(
  3. nn.Conv2d(1,20,5),
  4. nn.ReLU(),
  5. nn.Conv2d(20,64,5),
  6. nn.ReLU()
  7. )
  8. # Example of using Sequential with OrderedDict
  9. model = nn.Sequential(OrderedDict([
  10. ('conv1', nn.Conv2d(1,20,5)),
  11. ('relu1', nn.ReLU()),
  12. ('conv2', nn.Conv2d(20,64,5)),
  13. ('relu2', nn.ReLU())
  14. ]))

class torch.nn.ModuleList(modules=None)[source]

submodules保存在一个list中。

ModuleList可以像一般的Python list一样被索引。而且ModuleList中包含的modules已经被正确的注册,对所有的module method可见。

参数说明:

  • modules (list, optional) – 将要被添加到MuduleList中的 modules 列表

例子:

  1. class MyModule(nn.Module):
  2. def __init__(self):
  3. super(MyModule, self).__init__()
  4. self.linears = nn.ModuleList([nn.Linear(10, 10) for i in range(10)])
  5. def forward(self, x):
  6. # ModuleList can act as an iterable, or be indexed using ints
  7. for i, l in enumerate(self.linears):
  8. x = self.linears[i // 2](x) + l(x)
  9. return x

append(module)[source]

等价于 list 的 append()

参数说明:

  • module (nn.Module) – 要 append 的module

    extend(modules)[source]

    等价于 listextend() 方法

参数说明:

  • modules (list) – list of modules to append

class torch.nn.ParameterList(parameters=None)

submodules保存在一个list中。

ParameterList可以像一般的Python list一样被索引。而且ParameterList中包含的parameters已经被正确的注册,对所有的module method可见。

参数说明:

  • modules (list, optional) – a list of nn.Parameter

例子:

  1. class MyModule(nn.Module):
  2. def __init__(self):
  3. super(MyModule, self).__init__()
  4. self.params = nn.ParameterList([nn.Parameter(torch.randn(10, 10)) for i in range(10)])
  5. def forward(self, x):
  6. # ModuleList can act as an iterable, or be indexed using ints
  7. for i, p in enumerate(self.params):
  8. x = self.params[i // 2].mm(x) + p.mm(x)
  9. return x

append(parameter)[source]

等价于python listappend 方法。

参数说明:

  • parameter (nn.Parameter) – parameter to append

    extend(parameters)[source]

    等价于python listextend 方法。

参数说明:

  • parameters (list) – list of parameters to append

卷积层

class torch.nn.Conv1d(in_channels, out_channels, kernel_size, stride=1, padding=0, dilation=1, groups=1, bias=True)

一维卷积层,输入的尺度是(N, C_in,L),输出尺度 (N,C_out,L_out)的计算方式:

out(Ni, C{outj})=bias(C {outj})+\sum^{C{in}-1}{k=0}weight(C{out_j},k)\bigotimes input(N_i,k)

说明

bigotimes: 表示相关系数计算stride: 控制相关系数的计算步长dilation: 用于控制内核点之间的距离,详细描述在这里groups: 控制输入和输出之间的连接, group=1,输出是所有的输入的卷积;group=2,此时相当于有并排的两个卷积层,每个卷积层计算输入通道的一半,并且产生的输出是输出通道的一半,随后将这两个输出连接起来。

Parameters:

  • in_channels(int) – 输入信号的通道
  • out_channels(int) – 卷积产生的通道
  • kerner_size(int or tuple) - 卷积核的尺寸
  • stride(int or tuple, optional) - 卷积步长
  • padding (int or tuple, optional)- 输入的每一条边补充0的层数
  • dilation(int or tuple, `optional``) – 卷积核元素之间的间距
  • groups(int, optional) – 从输入通道到输出通道的阻塞连接数
  • bias(bool, optional) - 如果bias=True,添加偏置

shape:输入: (N,Cin,L_in)输出: (N,C_out,L_out)输入输出的计算方式:L{out}=floor((L_{in}+2padding-dilation(kernerl_size-1)-1)/stride+1)

变量:weight(tensor) - 卷积的权重,大小是(out_channels, in_channels, kernel_size)bias(tensor) - 卷积的偏置系数,大小是(out_channel

example:

  1. >>> m = nn.Conv1d(16, 33, 3, stride=2)
  2. >>> input = autograd.Variable(torch.randn(20, 16, 50))
  3. >>> output = m(input)

class torch.nn.Conv2d(in_channels, out_channels, kernel_size, stride=1, padding=0, dilation=1, groups=1, bias=True)

二维卷积层, 输入的尺度是(N, C_in,H,W),输出尺度(N,C_out,H_out,W_out)的计算方式:

out(Ni, C{outj})=bias(C{outj})+\sum^{C{in}-1}{k=0}weight(C{out_j},k)\bigotimes input(N_i,k)

说明bigotimes: 表示二维的相关系数计算stride: 控制相关系数的计算步长dilation: 用于控制内核点之间的距离,详细描述在这里groups: 控制输入和输出之间的连接: group=1,输出是所有的输入的卷积;group=2,此时相当于有并排的两个卷积层,每个卷积层计算输入通道的一半,并且产生的输出是输出通道的一半,随后将这两个输出连接起来。

参数kernel_sizestride,paddingdilation也可以是一个int的数据,此时卷积height和width值相同;也可以是一个tuple数组,tuple的第一维度表示height的数值,tuple的第二维度表示width的数值

Parameters:

  • in_channels(int) – 输入信号的通道
  • out_channels(int) – 卷积产生的通道
  • kerner_size(int or tuple) - 卷积核的尺寸
  • stride(int or tuple, optional) - 卷积步长
  • padding(int or tuple, optional) - 输入的每一条边补充0的层数
  • dilation(int or tuple, optional) – 卷积核元素之间的间距
  • groups(int, optional) – 从输入通道到输出通道的阻塞连接数
  • bias(bool, optional) - 如果bias=True,添加偏置

shape:input: (N,Cin,H_in,W_in)output: (N,C_out,H_out,W_out)H{out}=floor((H_{in}+2padding[0]-dilation[0](kernerl_size[0]-1)-1)/stride[0]+1)

W{out}=floor((W{in}+2padding[1]-dilation[1](kernerl_size[1]-1)-1)/stride[1]+1)

变量:weight(tensor) - 卷积的权重,大小是(out_channels, in_channels,kernel_size)bias(tensor) - 卷积的偏置系数,大小是(out_channel

example:

  1. >>> # With square kernels and equal stride
  2. >>> m = nn.Conv2d(16, 33, 3, stride=2)
  3. >>> # non-square kernels and unequal stride and with padding
  4. >>> m = nn.Conv2d(16, 33, (3, 5), stride=(2, 1), padding=(4, 2))
  5. >>> # non-square kernels and unequal stride and with padding and dilation
  6. >>> m = nn.Conv2d(16, 33, (3, 5), stride=(2, 1), padding=(4, 2), dilation=(3, 1))
  7. >>> input = autograd.Variable(torch.randn(20, 16, 50, 100))
  8. >>> output = m(input)

class torch.nn.Conv3d(in_channels, out_channels, kernel_size, stride=1, padding=0, dilation=1, groups=1, bias=True)

三维卷积层, 输入的尺度是(N, Cin,D,H,W),输出尺度(N,C_out,D_out,H_out,W_out)的计算方式:out(N_i, C{outj})=bias(C{outj})+\sum^{C{in}-1}{k=0}weight(C{out_j},k)\bigotimes input(N_i,k)

说明bigotimes: 表示二维的相关系数计算stride: 控制相关系数的计算步长dilation: 用于控制内核点之间的距离,详细描述在这里groups: 控制输入和输出之间的连接: group=1,输出是所有的输入的卷积;group=2,此时相当于有并排的两个卷积层,每个卷积层计算输入通道的一半,并且产生的输出是输出通道的一半,随后将这两个输出连接起来。参数kernel_sizestridepaddingdilation可以是一个int的数据 - 卷积height和width值相同,也可以是一个有三个int数据的tuple数组,tuple的第一维度表示depth的数值,tuple的第二维度表示height的数值,tuple的第三维度表示width的数值

Parameters:

  • in_channels(int) – 输入信号的通道
  • out_channels(int) – 卷积产生的通道
  • kernel_size(int or tuple) - 卷积核的尺寸
  • stride(int or tuple, optional) - 卷积步长
  • padding(int or tuple, optional) - 输入的每一条边补充0的层数
  • dilation(int or tuple, optional) – 卷积核元素之间的间距
  • groups(int, optional) – 从输入通道到输出通道的阻塞连接数
  • bias(bool, optional) - 如果bias=True,添加偏置

shape:input: (N,Cin,D_in,H_in,W_in)output: (N,C_out,D_out,H_out,W_out)D{out}=floor((D_{in}+2padding[0]-dilation[0](kernerl_size[0]-1)-1)/stride[0]+1)

H{out}=floor((H{in}+2padding[1]-dilation[2](kernerl_size[1]-1)-1)/stride[1]+1)

W{out}=floor((W{in}+2padding[2]-dilation[2](kernerl_size[2]-1)-1)/stride[2]+1)

变量:

  • weight(tensor) - 卷积的权重,shape是(out_channels, in_channels,kernel_size)`
  • bias(tensor) - 卷积的偏置系数,shape是(out_channel

example:

  1. >>> # With square kernels and equal stride
  2. >>> m = nn.Conv3d(16, 33, 3, stride=2)
  3. >>> # non-square kernels and unequal stride and with padding
  4. >>> m = nn.Conv3d(16, 33, (3, 5, 2), stride=(2, 1, 1), padding=(4, 2, 0))
  5. >>> input = autograd.Variable(torch.randn(20, 16, 10, 50, 100))
  6. >>> output = m(input)

class torch.nn.ConvTranspose1d(in_channels, out_channels, kernel_size, stride=1, padding=0, output_padding=0, groups=1, bias=True)

1维的解卷积操作(transposed convolution operator,注意改视作操作可视作解卷积操作,但并不是真正的解卷积操作)该模块可以看作是Conv1d相对于其输入的梯度,有时(但不正确地)被称为解卷积操作。

注意由于内核的大小,输入的最后的一些列的数据可能会丢失。因为输入和输出是不是完全的互相关。因此,用户可以进行适当的填充(padding操作)。

参数

  • in_channels(int) – 输入信号的通道数
  • out_channels(int) – 卷积产生的通道
  • kernel_size(int or tuple) - 卷积核的大小
  • stride(int or tuple, optional) - 卷积步长
  • padding(int or tuple, optional) - 输入的每一条边补充0的层数
  • output_padding(int or tuple, optional) - 输出的每一条边补充0的层数
  • dilation(int or tuple, optional) – 卷积核元素之间的间距
  • groups(int, optional) – 从输入通道到输出通道的阻塞连接数
  • bias(bool, optional) - 如果bias=True,添加偏置

shape:输入: (N,Cin,L_in)输出: (N,C_out,L_out)L{out}=(L_{in}-1)stride-2padding+kernel_size+output_padding

变量:

  • weight(tensor) - 卷积的权重,大小是(in_channels, in_channels,kernel_size)
  • bias(tensor) - 卷积的偏置系数,大小是(out_channel)

class torch.nn.ConvTranspose2d(in_channels, out_channels, kernel_size, stride=1, padding=0, output_padding=0, groups=1, bias=True)

2维的转置卷积操作(transposed convolution operator,注意改视作操作可视作解卷积操作,但并不是真正的解卷积操作)该模块可以看作是Conv2d相对于其输入的梯度,有时(但不正确地)被称为解卷积操作。

说明

stride: 控制相关系数的计算步长dilation: 用于控制内核点之间的距离,详细描述在这里groups: 控制输入和输出之间的连接: group=1,输出是所有的输入的卷积;group=2,此时相当于有并排的两个卷积层,每个卷积层计算输入通道的一半,并且产生的输出是输出通道的一半,随后将这两个输出连接起来。

参数kernel_sizestridepaddingdilation数据类型:可以是一个int类型的数据,此时卷积height和width值相同;也可以是一个tuple数组(包含来两个int类型的数据),第一个int数据表示height的数值,第二个int类型的数据表示width的数值

注意由于内核的大小,输入的最后的一些列的数据可能会丢失。因为输入和输出是不是完全的互相关。因此,用户可以进行适当的填充(padding操作)。

参数:

  • in_channels(int) – 输入信号的通道数
  • out_channels(int) – 卷积产生的通道数
  • kerner_size(int or tuple) - 卷积核的大小
  • stride(int or tuple,optional) - 卷积步长
  • padding(int or tuple, optional) - 输入的每一条边补充0的层数
  • output_padding(int or tuple, optional) - 输出的每一条边补充0的层数
  • dilation(int or tuple, optional) – 卷积核元素之间的间距
  • groups(int, optional) – 从输入通道到输出通道的阻塞连接数
  • bias(bool, optional) - 如果bias=True,添加偏置

shape:输入: (N,Cin,H_in,W_in)输出: (N,C_out,H_out,W_out)H{out}=(H_{in}-1)stride[0]-2padding[0]+kernel_size[0]+output_padding[0]

W{out}=(W{in}-1)stride[1]-2padding[1]+kernel_size[1]+output_padding[1]

变量:

  • weight(tensor) - 卷积的权重,大小是(in_channels, in_channels,kernel_size)
  • bias(tensor) - 卷积的偏置系数,大小是(out_channel

Example

  1. >>> # With square kernels and equal stride
  2. >>> m = nn.ConvTranspose2d(16, 33, 3, stride=2)
  3. >>> # non-square kernels and unequal stride and with padding
  4. >>> m = nn.ConvTranspose2d(16, 33, (3, 5), stride=(2, 1), padding=(4, 2))
  5. >>> input = autograd.Variable(torch.randn(20, 16, 50, 100))
  6. >>> output = m(input)
  7. >>> # exact output size can be also specified as an argument
  8. >>> input = autograd.Variable(torch.randn(1, 16, 12, 12))
  9. >>> downsample = nn.Conv2d(16, 16, 3, stride=2, padding=1)
  10. >>> upsample = nn.ConvTranspose2d(16, 16, 3, stride=2, padding=1)
  11. >>> h = downsample(input)
  12. >>> h.size()
  13. torch.Size([1, 16, 6, 6])
  14. >>> output = upsample(h, output_size=input.size())
  15. >>> output.size()
  16. torch.Size([1, 16, 12, 12])

torch.nn.ConvTranspose3d(in_channels, out_channels, kernel_size, stride=1, padding=0, output_padding=0, groups=1, bias=True)

3维的转置卷积操作(transposed convolution operator,注意改视作操作可视作解卷积操作,但并不是真正的解卷积操作)转置卷积操作将每个输入值和一个可学习权重的卷积核相乘,输出所有输入通道的求和

该模块可以看作是Conv3d相对于其输入的梯度,有时(但不正确地)被称为解卷积操作。

说明

stride: 控制相关系数的计算步长dilation: 用于控制内核点之间的距离,详细描述在这里groups: 控制输入和输出之间的连接: group=1,输出是所有的输入的卷积;group=2,此时相当于有并排的两个卷积层,每个卷积层计算输入通道的一半,并且产生的输出是输出通道的一半,随后将这两个输出连接起来。

参数kernel\_sizestride, paddingdilation数据类型:一个int类型的数据,此时卷积height和width值相同;也可以是一个tuple数组(包含来两个int类型的数据),第一个int数据表示height的数值,tuple的第二个int类型的数据表示width的数值

注意由于内核的大小,输入的最后的一些列的数据可能会丢失。因为输入和输出是不是完全的互相关。因此,用户可以进行适当的填充(padding操作)。

参数:

  • in_channels(int) – 输入信号的通道数
  • out_channels(int) – 卷积产生的通道数
  • kernel_size(int or tuple) - 卷积核的大小
  • stride(int or tuple, optional) - 卷积步长
  • padding(int or tuple, optional) - 输入的每一条边补充0的层数
  • output_padding(int or tuple, optional) - 输出的每一条边补充0的层数
  • dilation(int or tuple, optional) – 卷积核元素之间的间距
  • groups(int, optional) – 从输入通道到输出通道的阻塞连接数
  • bias(bool, optional) - 如果bias=True,添加偏置

shape:输入: (N,Cin,H_in,W_in)输出: (N,C_out,H_out,W_out)D{out}=(D_{in}-1)stride[0]-2padding[0]+kernel_size[0]+output_padding[0]

H{out}=(H{in}-1)stride[1]-2padding[1]+kernel_size[1]+output_padding[0]

W{out}=(W{in}-1)stride[2]-2padding[2]+kernel_size[2]+output_padding[2]

变量:

  • weight(tensor) - 卷积的权重,大小是(in_channels, in_channels,kernel_size)
  • bias(tensor) - 卷积的偏置系数,大小是(out_channel

Example

  1. >>> # With square kernels and equal stride
  2. >>> m = nn.ConvTranspose3d(16, 33, 3, stride=2)
  3. >>> # non-square kernels and unequal stride and with padding
  4. >>> m = nn.Conv3d(16, 33, (3, 5, 2), stride=(2, 1, 1), padding=(0, 4, 2))
  5. >>> input = autograd.Variable(torch.randn(20, 16, 10, 50, 100))
  6. >>> output = m(input)

池化层

class torch.nn.MaxPool1d(kernel_size, stride=None, padding=0, dilation=1, return_indices=False, ceil_mode=False)

对于输入信号的输入通道,提供1维最大池化(max pooling)操作

如果输入的大小是(N,C,L),那么输出的大小是(N,C,Lout)的计算方式是:out(N_i, C_j,k)=max^{kernel_size-1}{m=0}input(N_{i},C_j,stride*k+m)

如果padding不是0,会在输入的每一边添加相应数目0dilation用于控制内核点之间的距离,详细描述在这里

参数:

  • kernel_size(int or tuple) - max pooling的窗口大小
  • stride(int or tuple, optional) - max pooling的窗口移动的步长。默认值是kernel_size
  • padding(int or tuple, optional) - 输入的每一条边补充0的层数
  • dilation(int or tuple, optional) – 一个控制窗口中元素步幅的参数
  • return_indices - 如果等于True,会返回输出最大值的序号,对于上采样操作会有帮助
  • ceil_mode - 如果等于True,计算输出信号大小的时候,会使用向上取整,代替默认的向下取整的操作

shape:输入: (N,Cin,L_in)输出: (N,C_out,L_out)L{out}=floor((L_{in} + 2padding - dilation(kernel_size - 1) - 1)/stride + 1

example:

  1. >>> # pool of size=3, stride=2
  2. >>> m = nn.MaxPool1d(3, stride=2)
  3. >>> input = autograd.Variable(torch.randn(20, 16, 50))
  4. >>> output = m(input)

class torch.nn.MaxPool2d(kernel_size, stride=None, padding=0, dilation=1, return_indices=False, ceil_mode=False)

对于输入信号的输入通道,提供2维最大池化(max pooling)操作

如果输入的大小是(N,C,H,W),那么输出的大小是(N,C,Hout,W_out)和池化窗口大小(kH,kW)的关系是:out(N_i, C_j,k)=max^{kH-1}{m=0}max^{kW-1}{m=0}input(N{i},C_j,stride[0]h+m,stride[1]w+n)

如果padding不是0,会在输入的每一边添加相应数目0dilation用于控制内核点之间的距离,详细描述在这里

参数kernel_sizestride, paddingdilation数据类型:可以是一个int类型的数据,此时卷积height和width值相同;也可以是一个tuple数组(包含来两个int类型的数据),第一个int数据表示height的数值,tuple的第二个int类型的数据表示width的数值

参数:

  • kernel_size(int or tuple) - max pooling的窗口大小
  • stride(int or tuple, optional) - max pooling的窗口移动的步长。默认值是kernel_size
  • padding(int or tuple, optional) - 输入的每一条边补充0的层数
  • dilation(int or tuple, optional) – 一个控制窗口中元素步幅的参数
  • return_indices - 如果等于True,会返回输出最大值的序号,对于上采样操作会有帮助
  • ceil_mode - 如果等于True,计算输出信号大小的时候,会使用向上取整,代替默认的向下取整的操作

shape:输入: (N,C,H{in},W_in)输出: (N,C,H_out,W_out)H{out}=floor((H_{in} + 2padding[0] - dilation[0](kernel_size[0] - 1) - 1)/stride[0] + 1

W{out}=floor((W{in} + 2padding[1] - dilation[1](kernel_size[1] - 1) - 1)/stride[1] + 1

example:

  1. >>> # pool of square window of size=3, stride=2
  2. >>> m = nn.MaxPool2d(3, stride=2)
  3. >>> # pool of non-square window
  4. >>> m = nn.MaxPool2d((3, 2), stride=(2, 1))
  5. >>> input = autograd.Variable(torch.randn(20, 16, 50, 32))
  6. >>> output = m(input)

class torch.nn.MaxPool3d(kernel_size, stride=None, padding=0, dilation=1, return_indices=False, ceil_mode=False)

对于输入信号的输入通道,提供3维最大池化(max pooling)操作

如果输入的大小是(N,C,D,H,W),那么输出的大小是(N,C,D,Hout,W_out)和池化窗口大小(kD,kH,kW)的关系是:out(N_i,C_j,d,h,w)=max^{kD-1}{m=0}max^{kH-1}{m=0}max^{kW-1}{m=0}

input(N_{i},C_j,stride[0]k+d,stride[1]h+m,stride[2]*w+n)

如果padding不是0,会在输入的每一边添加相应数目0dilation用于控制内核点之间的距离,详细描述在这里

参数kernel_sizestride, paddingdilation数据类型:可以是int类型的数据,此时卷积height和width值相同;也可以是一个tuple数组(包含来两个int类型的数据),第一个int数据表示height的数值,tuple的第二个int类型的数据表示width的数值

参数:

  • kernel_size(int or tuple) - max pooling的窗口大小
  • stride(int or tuple, optional) - max pooling的窗口移动的步长。默认值是kernel_size
  • padding(int or tuple, optional) - 输入的每一条边补充0的层数
  • dilation(int or tuple, optional) – 一个控制窗口中元素步幅的参数
  • return_indices - 如果等于True,会返回输出最大值的序号,对于上采样操作会有帮助
  • ceil_mode - 如果等于True,计算输出信号大小的时候,会使用向上取整,代替默认的向下取整的操作

shape:输入: (N,C,Hin,W_in)输出: (N,C,H_out,W_out)D{out}=floor((D_{in} + 2padding[0] - dilation[0](kernel_size[0] - 1) - 1)/stride[0] + 1)

H{out}=floor((H{in} + 2padding[1] - dilation[1](kernel_size[0] - 1) - 1)/stride[1] + 1)

W{out}=floor((W{in} + 2padding[2] - dilation[2](kernel_size[2] - 1) - 1)/stride[2] + 1)

example:

  1. >>> # pool of square window of size=3, stride=2
  2. >>>m = nn.MaxPool3d(3, stride=2)
  3. >>> # pool of non-square window
  4. >>> m = nn.MaxPool3d((3, 2, 2), stride=(2, 1, 2))
  5. >>> input = autograd.Variable(torch.randn(20, 16, 50,44, 31))
  6. >>> output = m(input)

class torch.nn.MaxUnpool1d(kernel_size, stride=None, padding=0)

Maxpool1d的逆过程,不过并不是完全的逆过程,因为在maxpool1d的过程中,一些最大值的已经丢失。MaxUnpool1d输入MaxPool1d的输出,包括最大值的索引,并计算所有maxpool1d过程中非最大值被设置为零的部分的反向。

注意:MaxPool1d可以将多个输入大小映射到相同的输出大小。因此,反演过程可能会变得模棱两可。 为了适应这一点,可以在调用中将输出大小(output_size)作为额外的参数传入。 具体用法,请参阅下面的输入和示例

参数:

  • kernel_size(int or tuple) - max pooling的窗口大小
  • stride(int or tuple, optional) - max pooling的窗口移动的步长。默认值是kernel_size
  • padding(int or tuple, optional) - 输入的每一条边补充0的层数

输入:input:需要转换的tensorindices:Maxpool1d的索引号output_size:一个指定输出大小的torch.Size

shape:input: (N,C,Hin)output:(N,C,H_out)H{out}=(H_{in}-1)stride[0]-2padding[0]+kernel_size[0]也可以使用output_size指定输出的大小

Example:

  1. >>> pool = nn.MaxPool1d(2, stride=2, return_indices=True)
  2. >>> unpool = nn.MaxUnpool1d(2, stride=2)
  3. >>> input = Variable(torch.Tensor([[[1, 2, 3, 4, 5, 6, 7, 8]]]))
  4. >>> output, indices = pool(input)
  5. >>> unpool(output, indices)
  6. Variable containing:
  7. (0 ,.,.) =
  8. 0 2 0 4 0 6 0 8
  9. [torch.FloatTensor of size 1x1x8]
  10. >>> # Example showcasing the use of output_size
  11. >>> input = Variable(torch.Tensor([[[1, 2, 3, 4, 5, 6, 7, 8, 9]]]))
  12. >>> output, indices = pool(input)
  13. >>> unpool(output, indices, output_size=input.size())
  14. Variable containing:
  15. (0 ,.,.) =
  16. 0 2 0 4 0 6 0 8 0
  17. [torch.FloatTensor of size 1x1x9]
  18. >>> unpool(output, indices)
  19. Variable containing:
  20. (0 ,.,.) =
  21. 0 2 0 4 0 6 0 8
  22. [torch.FloatTensor of size 1x1x8]

class torch.nn.MaxUnpool2d(kernel_size, stride=None, padding=0)

Maxpool2d的逆过程,不过并不是完全的逆过程,因为在maxpool2d的过程中,一些最大值的已经丢失。MaxUnpool2d的输入是MaxPool2d的输出,包括最大值的索引,并计算所有maxpool2d过程中非最大值被设置为零的部分的反向。

注意:MaxPool2d可以将多个输入大小映射到相同的输出大小。因此,反演过程可能会变得模棱两可。 为了适应这一点,可以在调用中将输出大小(output_size)作为额外的参数传入。具体用法,请参阅下面示例

参数:

  • kernel_size(int or tuple) - max pooling的窗口大小
  • stride(int or tuple, optional) - max pooling的窗口移动的步长。默认值是kernel_size
  • padding(int or tuple, optional) - 输入的每一条边补充0的层数

输入:input:需要转换的tensorindices:Maxpool1d的索引号output_size:一个指定输出大小的torch.Size

大小:input: (N,C,H_in,W_in)output:(N,C,H_out,W_out)

H{out}=(H{in}-1)stride[0]-2padding[0]+kernel_size[0]

W{out}=(W{in}-1)stride[1]-2padding[1]+kernel_size[1]

也可以使用output_size指定输出的大小

Example:

  1. >>> pool = nn.MaxPool2d(2, stride=2, return_indices=True)
  2. >>> unpool = nn.MaxUnpool2d(2, stride=2)
  3. >>> input = Variable(torch.Tensor([[[[ 1, 2, 3, 4],
  4. ... [ 5, 6, 7, 8],
  5. ... [ 9, 10, 11, 12],
  6. ... [13, 14, 15, 16]]]]))
  7. >>> output, indices = pool(input)
  8. >>> unpool(output, indices)
  9. Variable containing:
  10. (0 ,0 ,.,.) =
  11. 0 0 0 0
  12. 0 6 0 8
  13. 0 0 0 0
  14. 0 14 0 16
  15. [torch.FloatTensor of size 1x1x4x4]
  16. >>> # specify a different output size than input size
  17. >>> unpool(output, indices, output_size=torch.Size([1, 1, 5, 5]))
  18. Variable containing:
  19. (0 ,0 ,.,.) =
  20. 0 0 0 0 0
  21. 6 0 8 0 0
  22. 0 0 0 14 0
  23. 16 0 0 0 0
  24. 0 0 0 0 0
  25. [torch.FloatTensor of size 1x1x5x5]

class torch.nn.MaxUnpool3d(kernel_size, stride=None, padding=0)

Maxpool3d的逆过程,不过并不是完全的逆过程,因为在maxpool3d的过程中,一些最大值的已经丢失。MaxUnpool3d的输入就是MaxPool3d的输出,包括最大值的索引,并计算所有maxpool3d过程中非最大值被设置为零的部分的反向。

注意:MaxPool3d可以将多个输入大小映射到相同的输出大小。因此,反演过程可能会变得模棱两可。为了适应这一点,可以在调用中将输出大小(output_size)作为额外的参数传入。具体用法,请参阅下面的输入和示例

参数:

  • kernel_size(int or tuple) - Maxpooling窗口大小
  • stride(int or tuple, optional) - max pooling的窗口移动的步长。默认值是kernel_size
  • padding(int or tuple, optional) - 输入的每一条边补充0的层数

输入:input:需要转换的tensorindicesMaxpool1d的索引序数output_size:一个指定输出大小的torch.Size

大小:input: (N,C,Din,H_in,W_in)output:(N,C,D_out,H_out,W_out)\begin{aligned}D{out}=(D{in}-1)stride[0]-2padding[0]+kernel_size[0]\H{out}=(H{in}-1)stride[1]-2padding[0]+kernel_size[1]\ W{out}=(W_{in}-1)stride[2]-2padding[2]+kernel_size[2]\end{aligned}

也可以使用output_size指定输出的大小

Example:

  1. >>> # pool of square window of size=3, stride=2
  2. >>> pool = nn.MaxPool3d(3, stride=2, return_indices=True)
  3. >>> unpool = nn.MaxUnpool3d(3, stride=2)
  4. >>> output, indices = pool(Variable(torch.randn(20, 16, 51, 33, 15)))
  5. >>> unpooled_output = unpool(output, indices)
  6. >>> unpooled_output.size()
  7. torch.Size([20, 16, 51, 33, 15])

class torch.nn.AvgPool1d(kernel_size, stride=None, padding=0, ceil_mode=False, count_include_pad=True)

对信号的输入通道,提供1维平均池化(average pooling )输入信号的大小(N,C,L),输出大小(N,C,Lout)和池化窗口大小k的关系是:out(N_i,C_j,l)=1/k*\sum^{k}{m=0}input(N{i},C{j},stride*l+m)如果padding不是0,会在输入的每一边添加相应数目0

参数:

  • kernel_size(int or tuple) - 池化窗口大小
  • stride(int or tuple, optional) - max pooling的窗口移动的步长。默认值是kernel_size
  • padding(int or tuple, optional) - 输入的每一条边补充0的层数
  • dilation(int or tuple, optional) – 一个控制窗口中元素步幅的参数
  • return_indices - 如果等于True,会返回输出最大值的序号,对于上采样操作会有帮助
  • ceil_mode - 如果等于True,计算输出信号大小的时候,会使用向上取整,代替默认的向下取整的操作

大小:input:(N,C,Lin)output:(N,C,L_out)L{out}=floor((L_{in}+2*padding-kernel_size)/stride+1)

Example:

  1. >>> # pool with window of size=3, stride=2
  2. >>> m = nn.AvgPool1d(3, stride=2)
  3. >>> m(Variable(torch.Tensor([[[1,2,3,4,5,6,7]]])))
  4. Variable containing:
  5. (0 ,.,.) =
  6. 2 4 6
  7. [torch.FloatTensor of size 1x1x3]

class torch.nn.AvgPool2d(kernel_size, stride=None, padding=0, ceil_mode=False, count_include_pad=True)

对信号的输入通道,提供2维的平均池化(average pooling )输入信号的大小(N,C,H,W),输出大小(N,C,Hout,W_out)和池化窗口大小(kH,kW)的关系是:out(N_i,C_j,h,w)=1/(kHkW)\sum^{kH-1}{m=0}\sum^{kW-1}{n=0}input(N{i},C_{j},stride[0]h+m,stride[1]w+n)

如果padding不是0,会在输入的每一边添加相应数目0

参数:

  • kernel_size(int or tuple) - 池化窗口大小
  • stride(int or tuple, optional) - max pooling的窗口移动的步长。默认值是kernel_size
  • padding(int or tuple, optional) - 输入的每一条边补充0的层数
  • dilation(int or tuple, optional) – 一个控制窗口中元素步幅的参数
  • ceil_mode - 如果等于True,计算输出信号大小的时候,会使用向上取整,代替默认的向下取整的操作
  • count_include_pad - 如果等于True,计算平均池化时,将包括padding填充的0

shape:input: (N,C,Hin,W_in)output: (N,C,H_out,W_out)\begin{aligned}H{out}=floor((H{in}+2*padding[0]-kernel_size[0])/stride[0]+1)\W{out}=floor((W_{in}+2*padding[1]-kernel_size[1])/stride[1]+1)\end{aligned}

Example:

  1. >>> # pool of square window of size=3, stride=2
  2. >>> m = nn.AvgPool2d(3, stride=2)
  3. >>> # pool of non-square window
  4. >>> m = nn.AvgPool2d((3, 2), stride=(2, 1))
  5. >>> input = autograd.Variable(torch.randn(20, 16, 50, 32))
  6. >>> output = m(input)

class torch.nn.AvgPool3d(kernel_size, stride=None)

对信号的输入通道,提供3维的平均池化(average pooling)输入信号的大小(N,C,D,H,W),输出大小(N,C,D_out,H_out,W_out)和池化窗口大小(kD,kH,kW)的关系是:

\begin{aligned}out(Ni,C_j,d,h,w)=1/(kDkHkW)*\sum^{kD-1}{k=0}\sum^{kH-1}{m=0}\sum^{kW-1}{n=0}input(N{i},C{j},stride[0]d+k,stride[1]h+m,stride[2]*w+n)\end{aligned}如果padding不是0,会在输入的每一边添加相应数目0

参数:

  • kernel_size(int or tuple) - 池化窗口大小
  • stride(int or tuple, optional) - max pooling的窗口移动的步长。默认值是kernel_size

shape:输入大小:(N,C,Din,H_in,W_in)输出大小:(N,C,D_out,H_out,W_out)\begin{aligned}D{out}=floor((D{in}+2*padding[0]-kernel_size[0])/stride[0]+1)\H{out}=floor((H{in}+2*padding[1]-kernel_size[1])/stride[1]+1)\W{out}=floor((W_{in}+2*padding[2]-kernel_size[2])/stride[2]+1)\end{aligned}

Example:

  1. >>> # pool of square window of size=3, stride=2
  2. >>> m = nn.AvgPool3d(3, stride=2)
  3. >>> # pool of non-square window
  4. >>> m = nn.AvgPool3d((3, 2, 2), stride=(2, 1, 2))
  5. >>> input = autograd.Variable(torch.randn(20, 16, 50,44, 31))
  6. >>> output = m(input)

class torch.nn.FractionalMaxPool2d(kernel_size, output_size=None, output_ratio=None, return_indices=False, _random_samples=None)

对输入的信号,提供2维的分数最大化池化操作分数最大化池化的细节请阅读论文由目标输出大小确定的随机步长,在$kH*kW$区域进行最大池化操作。输出特征和输入特征的数量相同。

参数:

  • kernel_size(int or tuple) - 最大池化操作时的窗口大小。可以是一个数字(表示K*K的窗口),也可以是一个元组(kh*kw
  • output_size - 输出图像的尺寸。可以使用一个tuple指定(oH,oW),也可以使用一个数字oH指定一个oH*oH的输出。
  • output_ratio – 将输入图像的大小的百分比指定为输出图片的大小,使用一个范围在(0,1)之间的数字指定
  • return_indices - 默认值False,如果设置为True,会返回输出的索引,索引对 nn.MaxUnpool2d有用。

Example:

  1. >>> # pool of square window of size=3, and target output size 13x12
  2. >>> m = nn.FractionalMaxPool2d(3, output_size=(13, 12))
  3. >>> # pool of square window and target output size being half of input image size
  4. >>> m = nn.FractionalMaxPool2d(3, output_ratio=(0.5, 0.5))
  5. >>> input = autograd.Variable(torch.randn(20, 16, 50, 32))
  6. >>> output = m(input)

class torch.nn.LPPool2d(norm_type, kernel_size, stride=None, ceil_mode=False)

对输入信号提供2维的幂平均池化操作。输出的计算方式:f(x)=pow(sum(X,p),1/p)

  • 当p为无穷大的时候时,等价于最大池化操作
  • p=1时,等价于平均池化操作

参数kernel_size, stride的数据类型:

  • int,池化窗口的宽和高相等
  • tuple数组(两个数字的),一个元素是池化窗口的高,另一个是宽

参数

  • kernel_size: 池化窗口的大小
  • stride:池化窗口移动的步长。kernel_size是默认值
  • ceil_mode: ceil_mode=True时,将使用向下取整代替向上取整

shape

  • 输入:(N,C,H_in,W_in)
  • 输出:(N,C,Hout,W_out)$$\begin{aligned}H{out} = floor((H{in}+2padding[0]-dilation[0](kernel_size[0]-1)-1)/stride[0]+1)\W{out} = floor((W_{in}+2padding[1]-dilation[1](kernel_size[1]-1)-1)/stride[1]+1)\end{aligned}$$

Example:

  1. >>> # power-2 pool of square window of size=3, stride=2
  2. >>> m = nn.LPPool2d(2, 3, stride=2)
  3. >>> # pool of non-square window of power 1.2
  4. >>> m = nn.LPPool2d(1.2, (3, 2), stride=(2, 1))
  5. >>> input = autograd.Variable(torch.randn(20, 16, 50, 32))
  6. >>> output = m(input)

class torch.nn.AdaptiveMaxPool1d(output_size, return_indices=False)

对输入信号,提供1维的自适应最大池化操作对于任何输入大小的输入,可以将输出尺寸指定为H,但是输入和输出特征的数目不会变化。

参数:

  • output_size: 输出信号的尺寸
  • return_indices: 如果设置为True,会返回输出的索引。对 nn.MaxUnpool1d有用,默认值是False

Example:

  1. >>> # target output size of 5
  2. >>> m = nn.AdaptiveMaxPool1d(5)
  3. >>> input = autograd.Variable(torch.randn(1, 64, 8))
  4. >>> output = m(input)

class torch.nn.AdaptiveMaxPool2d(output_size, return_indices=False)

对输入信号,提供2维的自适应最大池化操作对于任何输入大小的输入,可以将输出尺寸指定为H*W,但是输入和输出特征的数目不会变化。

参数:

  • output_size: 输出信号的尺寸,可以用(H,W)表示H*W的输出,也可以使用数字H表示H*H大小的输出
  • return_indices: 如果设置为True,会返回输出的索引。对 nn.MaxUnpool2d有用,默认值是False

Example:

  1. >>> # target output size of 5x7
  2. >>> m = nn.AdaptiveMaxPool2d((5,7))
  3. >>> input = autograd.Variable(torch.randn(1, 64, 8, 9))
  4. >>> # target output size of 7x7 (square)
  5. >>> m = nn.AdaptiveMaxPool2d(7)
  6. >>> input = autograd.Variable(torch.randn(1, 64, 10, 9))
  7. >>> output = m(input)

class torch.nn.AdaptiveAvgPool1d(output_size)

对输入信号,提供1维的自适应平均池化操作对于任何输入大小的输入,可以将输出尺寸指定为H*W,但是输入和输出特征的数目不会变化。

参数:

  • output_size: 输出信号的尺寸

Example:

  1. >>> # target output size of 5
  2. >>> m = nn.AdaptiveAvgPool1d(5)
  3. >>> input = autograd.Variable(torch.randn(1, 64, 8))
  4. >>> output = m(input)

class torch.nn.AdaptiveAvgPool2d(output_size)

对输入信号,提供2维的自适应平均池化操作对于任何输入大小的输入,可以将输出尺寸指定为H*W,但是输入和输出特征的数目不会变化。

参数:

  • output_size: 输出信号的尺寸,可以用(H,W)表示H*W的输出,也可以使用耽搁数字H表示H*H大小的输出

Example:

  1. >>> # target output size of 5x7
  2. >>> m = nn.AdaptiveAvgPool2d((5,7))
  3. >>> input = autograd.Variable(torch.randn(1, 64, 8, 9))
  4. >>> # target output size of 7x7 (square)
  5. >>> m = nn.AdaptiveAvgPool2d(7)
  6. >>> input = autograd.Variable(torch.randn(1, 64, 10, 9))
  7. >>> output = m(input)

Non-Linear Activations [source]

class torch.nn.ReLU(inplace=False) [source]

对输入运用修正线性单元函数${ReLU}(x)= max(0, x)$,

参数: inplace-选择是否进行覆盖运算

shape:

  • 输入:$(N, )$,代表任意数目附加维度
  • 输出:$(N, *)$,与输入拥有同样的shape属性

例子:

  1. >>> m = nn.ReLU()
  2. >>> input = autograd.Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.ReLU6(inplace=False) [source]

对输入的每一个元素运用函数${ReLU6}(x) = min(max(0,x), 6)$,

参数: inplace-选择是否进行覆盖运算

shape:

  • 输入:$(N, )$,代表任意数目附加维度
  • 输出:$(N, *)$,与输入拥有同样的shape属性

例子:

  1. >>> m = nn.ReLU6()
  2. >>> input = autograd.Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.ELU(alpha=1.0, inplace=False) [source]

对输入的每一个元素运用函数$f(x) = max(0,x) + min(0, alpha * (e^x - 1))$,

shape:

  • 输入:$(N, *)$,星号代表任意数目附加维度
  • 输出:$(N, *)$与输入拥有同样的shape属性

例子:

  1. >>> m = nn.ELU()
  2. >>> input = autograd.Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.PReLU(num_parameters=1, init=0.25)[source]

对输入的每一个元素运用函数$PReLU(x) = max(0,x) + a * min(0,x)$,a是一个可学习参数。当没有声明时,nn.PReLU()在所有的输入中只有一个参数a;如果是nn.PReLU(nChannels)a将应用到每个输入。

注意:当为了表现更佳的模型而学习参数a时不要使用权重衰减(weight decay)

参数:

  • num_parameters:需要学习的a的个数,默认等于1
  • init:a的初始值,默认等于0.25

shape:

  • 输入:$(N, )$,代表任意数目附加维度
  • 输出:$(N, *)$,与输入拥有同样的shape属性

例子:

  1. >>> m = nn.PReLU()
  2. >>> input = autograd.Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.LeakyReLU(negative_slope=0.01, inplace=False) [source]

对输入的每一个元素运用$f(x) = max(0, x) + {negative_slope} * min(0, x)$

参数:

  • negative_slope:控制负斜率的角度,默认等于0.01
  • inplace-选择是否进行覆盖运算

shape:

  • 输入:$(N, )$,代表任意数目附加维度
  • 输出:$(N, *)$,与输入拥有同样的shape属性

例子:

  1. >>> m = nn.LeakyReLU(0.1)
  2. >>> input = autograd.Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.Threshold(threshold, value, inplace=False) [source]

Threshold定义:

y = x ,if\ x >= threshold\y = value,if\ x < threshold

参数:

  • threshold:阈值
  • value:输入值小于阈值则会被value代替
  • inplace:选择是否进行覆盖运算

shape:

  • 输入:$(N, )$,代表任意数目附加维度
  • 输出:$(N, *)$,与输入拥有同样的shape属性

例子:

  1. >>> m = nn.Threshold(0.1, 20)
  2. >>> input = Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.Hardtanh(min_value=-1, max_value=1, inplace=False) [source]

对每个元素,

f(x) = +1, if\ x > 1;\f(x) = -1, if\ x < -1;\f(x) = x, otherwise

线性区域的范围[-1,1]可以被调整

参数:

  • min_value:线性区域范围最小值
  • max_value:线性区域范围最大值
  • inplace:选择是否进行覆盖运算

shape:

  • 输入:(N, *),*表示任意维度组合
  • 输出:(N, *),与输入有相同的shape属性

例子:

  1. >>> m = nn.Hardtanh()
  2. >>> input = autograd.Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.Sigmoid [source]

对每个元素运用Sigmoid函数,Sigmoid 定义如下:

f(x) = 1 / ( 1 + e^{-x})

shape:

  • 输入:(N, *),*表示任意维度组合
  • 输出:(N, *),与输入有相同的shape属性

例子:

  1. >>> m = nn.Sigmoid()
  2. >>> input = autograd.Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.Tanh [source]

对输入的每个元素,

f(x) = \frac{e^{x} - e^{-x}} {e^{x} + e^{x}}

shape:

  • 输入:(N, *),*表示任意维度组合
  • 输出:(N, *),与输入有相同的shape属性

例子:

  1. >>> m = nn.Tanh()
  2. >>> input = autograd.Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.LogSigmoid [source]

对输入的每个元素,$LogSigmoid(x) = log( 1 / ( 1 + e^{-x}))$

shape:

  • 输入:(N, *),*表示任意维度组合
  • 输出:(N, *),与输入有相同的shape属性

例子:

  1. >>> m = nn.LogSigmoid()
  2. >>> input = autograd.Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.Softplus(beta=1, threshold=20)[source]

对每个元素运用Softplus函数,Softplus 定义如下:

f(x) = \frac{1}{beta} log(1 + e^{(beta x_i)})

Softplus函数是ReLU函数的平滑逼近,Softplus函数可以使得输出值限定为正数。

为了保证数值稳定性,线性函数的转换可以使输出大于某个值。

参数:

  • beta:Softplus函数的beta值
  • threshold:阈值

shape:

  • 输入:(N, *),*表示任意维度组合
  • 输出:(N, *),与输入有相同的shape属性

例子:

  1. >>> m = nn.Softplus()
  2. >>> input = autograd.Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.Softshrink(lambd=0.5)[source]

对每个元素运用Softshrink函数,Softshrink函数定义如下:

f(x) = x-lambda, if\ x > lambda\f(x) = x+lambda, if\ x < -lambda\f(x) = 0, otherwise

参数:

lambd:Softshrink函数的lambda值,默认为0.5

shape:

  • 输入:(N, *),*表示任意维度组合
  • 输出:(N, *),与输入有相同的shape属性

例子:

  1. >>> m = nn.Softshrink()
  2. >>> input = autograd.Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.Softsign [source]

$f(x) = x / (1 + |x|)$

shape:

  • 输入:(N, *),*表示任意维度组合
  • 输出:(N, *),与输入有相同的shape属性

例子:

  1. >>> m = nn.Softsign()
  2. >>> input = autograd.Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.Softshrink(lambd=0.5)[source]

对每个元素运用Tanhshrink函数,Tanhshrink函数定义如下:

Tanhshrink(x) = x - Tanh(x)

shape:

  • 输入:(N, *),*表示任意维度组合
  • 输出:(N, *),与输入有相同的shape属性

例子:

  1. >>> m = nn.Tanhshrink()
  2. >>> input = autograd.Variable(torch.randn(2))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.Softmin [source]

对n维输入张量运用Softmin函数,将张量的每个元素缩放到(0,1)区间且和为1。Softmin函数定义如下:

f_i(x) = \frac{e^{(-x_i - shift)}} { \sum^j e^{(-x_j - shift)}},shift = max (x_i)

shape:

  • 输入:(N, L)
  • 输出:(N, L)

例子:

  1. >>> m = nn.Softmin()
  2. >>> input = autograd.Variable(torch.randn(2, 3))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.Softmax [source]

对n维输入张量运用Softmax函数,将张量的每个元素缩放到(0,1)区间且和为1。Softmax函数定义如下:

f_i(x) = \frac{e^{(x_i - shift)}} { \sum^j e^{(x_j - shift)}},shift = max (x_i)

shape:

  • 输入:(N, L)
  • 输出:(N, L)

返回结果是一个与输入维度相同的张量,每个元素的取值范围在(0,1)区间。

例子:

  1. >>> m = nn.Softmax()
  2. >>> input = autograd.Variable(torch.randn(2, 3))
  3. >>> print(input)
  4. >>> print(m(input))

class torch.nn.LogSoftmax [source]

对n维输入张量运用LogSoftmax函数,LogSoftmax函数定义如下:

f_i(x) = log \frac{e^{(x_i)}} {a}, a = \sum^j e^{(x_j)}

shape:

  • 输入:(N, L)
  • 输出:(N, L)

例子:

  1. >>> m = nn.LogSoftmax()
  2. >>> input = autograd.Variable(torch.randn(2, 3))
  3. >>> print(input)
  4. >>> print(m(input))

Normalization layers [source]

class torch.nn.BatchNorm1d(num_features, eps=1e-05, momentum=0.1, affine=True) [source]

对小批量(mini-batch)的2d或3d输入进行批标准化(Batch Normalization)操作

y = \frac{x - mean[x]}{ \sqrt{Var[x]} + \epsilon} * gamma + beta

在每一个小批量(mini-batch)数据中,计算输入各个维度的均值和标准差。gamma与beta是可学习的大小为C的参数向量(C为输入大小)

在训练时,该层计算每次输入的均值与方差,并进行移动平均。移动平均默认的动量值为0.1。

在验证时,训练求得的均值/方差将用于标准化验证数据。

参数:

  • num_features: 来自期望输入的特征数,该期望输入的大小为’batch_size x num_features [x width]’
  • eps: 为保证数值稳定性(分母不能趋近或取0),给分母加上的值。默认为1e-5。
  • momentum: 动态均值和动态方差所使用的动量。默认为0.1。
  • affine: 一个布尔值,当设为true,给该层添加可学习的仿射变换参数。

Shape:

  • 输入:(N, C)或者(N, C, L)
  • 输出:(N, C)或者(N,C,L)(输入输出相同)

例子

  1. >>> # With Learnable Parameters
  2. >>> m = nn.BatchNorm1d(100)
  3. >>> # Without Learnable Parameters
  4. >>> m = nn.BatchNorm1d(100, affine=False)
  5. >>> input = autograd.Variable(torch.randn(20, 100))
  6. >>> output = m(input)

class torch.nn.BatchNorm2d(num_features, eps=1e-05, momentum=0.1, affine=True)[source]

对小批量(mini-batch)3d数据组成的4d输入进行批标准化(Batch Normalization)操作

y = \frac{x - mean[x]}{ \sqrt{Var[x]} + \epsilon} * gamma + beta

在每一个小批量(mini-batch)数据中,计算输入各个维度的均值和标准差。gamma与beta是可学习的大小为C的参数向量(C为输入大小)

在训练时,该层计算每次输入的均值与方差,并进行移动平均。移动平均默认的动量值为0.1。

在验证时,训练求得的均值/方差将用于标准化验证数据。

参数:

  • num_features: 来自期望输入的特征数,该期望输入的大小为’batch_size x num_features x height x width’
  • eps: 为保证数值稳定性(分母不能趋近或取0),给分母加上的值。默认为1e-5。
  • momentum: 动态均值和动态方差所使用的动量。默认为0.1。
  • affine: 一个布尔值,当设为true,给该层添加可学习的仿射变换参数。

Shape:

  • 输入:(N, C,H, W)
  • 输出:(N, C, H, W)(输入输出相同)

例子

  1. >>> # With Learnable Parameters
  2. >>> m = nn.BatchNorm2d(100)
  3. >>> # Without Learnable Parameters
  4. >>> m = nn.BatchNorm2d(100, affine=False)
  5. >>> input = autograd.Variable(torch.randn(20, 100, 35, 45))
  6. >>> output = m(input)

class torch.nn.BatchNorm3d(num_features, eps=1e-05, momentum=0.1, affine=True)[source]

对小批量(mini-batch)4d数据组成的5d输入进行批标准化(Batch Normalization)操作

y = \frac{x - mean[x]}{ \sqrt{Var[x]} + \epsilon} * gamma + beta

在每一个小批量(mini-batch)数据中,计算输入各个维度的均值和标准差。gamma与beta是可学习的大小为C的参数向量(C为输入大小)

在训练时,该层计算每次输入的均值与方差,并进行移动平均。移动平均默认的动量值为0.1。

在验证时,训练求得的均值/方差将用于标准化验证数据。

参数:

  • num_features: 来自期望输入的特征数,该期望输入的大小为’batch_size x num_features depth x height x width’
  • eps: 为保证数值稳定性(分母不能趋近或取0),给分母加上的值。默认为1e-5。
  • momentum: 动态均值和动态方差所使用的动量。默认为0.1。
  • affine: 一个布尔值,当设为true,给该层添加可学习的仿射变换参数。

Shape:

  • 输入:(N, C,D, H, W)
  • 输出:(N, C, D, H, W)(输入输出相同)

例子

  1. >>> # With Learnable Parameters
  2. >>> m = nn.BatchNorm3d(100)
  3. >>> # Without Learnable Parameters
  4. >>> m = nn.BatchNorm3d(100, affine=False)
  5. >>> input = autograd.Variable(torch.randn(20, 100, 35, 45, 10))
  6. >>> output = m(input)

Recurrent layers

class torch.nn.RNN( args, * kwargs)[source]

将一个多层的 Elman RNN,激活函数为tanh或者ReLU,用于输入序列。

对输入序列中每个元素,RNN每层的计算公式为ht=tanh(w{ih} xt+b{ih}+w_{hh} h{t-1}+b{hh})$h_t$是时刻$t$的隐状态。 $x_t$是上一层时刻$t$的隐状态,或者是第一层在时刻$t$的输入。如果nonlinearity='relu',那么将使用relu代替tanh作为激活函数。

参数说明:

  • input_size – 输入x的特征数量。

  • hidden_size – 隐层的特征数量。

  • num_layers – RNN的层数。

  • nonlinearity – 指定非线性函数使用tanh还是relu。默认是tanh

  • bias – 如果是False,那么RNN层就不会使用偏置权重 $b_ih$和$b_hh$,默认是True

  • batch_first – 如果True的话,那么输入Tensor的shape应该是[batch_size, time_step, feature],输出也是这样。

  • dropout – 如果值非零,那么除了最后一层外,其它层的输出都会套上一个dropout层。

  • bidirectional – 如果True,将会变成一个双向RNN,默认为False

RNN的输入:(input, h_0)

  • input (seq_len, batch, input_size): 保存输入序列特征的tensorinput可以是被填充的变长的序列。细节请看torch.nn.utils.rnn.pack_padded_sequence()

  • h_0 (num_layers * num_directions, batch, hidden_size): 保存着初始隐状态的tensor

RNN的输出:(output, h_n)

  • output (seq_len, batch, hidden_size * num_directions): 保存着RNN最后一层的输出特征。如果输入是被填充过的序列,那么输出也是被填充的序列。
  • h_n (num_layers * num_directions, batch, hidden_size): 保存着最后一个时刻隐状态。

RNN模型参数:

  • weight_ih_l[k] – 第k层的 input-hidden 权重, 可学习,形状是(input_size x hidden_size)

  • weight_hh_l[k] – 第k层的 hidden-hidden 权重, 可学习,形状是(hidden_size x hidden_size)

  • bias_ih_l[k] – 第k层的 input-hidden 偏置, 可学习,形状是(hidden_size)

  • bias_hh_l[k] – 第k层的 hidden-hidden 偏置, 可学习,形状是(hidden_size)

示例:

  1. rnn = nn.RNN(10, 20, 2)
  2. input = Variable(torch.randn(5, 3, 10))
  3. h0 = Variable(torch.randn(2, 3, 20))
  4. output, hn = rnn(input, h0)

class torch.nn.LSTM( args, * kwargs)[source]

将一个多层的 (LSTM) 应用到输入序列。

对输入序列的每个元素,LSTM的每层都会执行以下计算:\begin{aligned}it &= sigmoid(W{ii}xt+b{ii}+W{hi}h{t-1}+b{hi}) \f_t &= sigmoid(W{if}xt+b{if}+W{hf}h{t-1}+b{hf}) \o_t &= sigmoid(W{io}xt+b{io}+W{ho}h{t-1}+b{ho})\g_t &= tanh(W{ig}xt+b{ig}+W{hg}h{t-1}+b{hg})\c_t &= f_t*c{t-1}+i_tg_t\h_t &= o_ttanh(c_t)\end{aligned}$h_t$是时刻$t$的隐状态,$c_t$是时刻$t$的细胞状态,$x_t$是上一层的在时刻$t$的隐状态或者是第一层在时刻$t$的输入。$i_t, f_t, g_t, o_t$ 分别代表 输入门,遗忘门,细胞和输出门。

参数说明:

  • input_size – 输入的特征维度

  • hidden_size – 隐状态的特征维度

  • num_layers – 层数(和时序展开要区分开)

  • bias – 如果为False,那么LSTM将不会使用$b{ih},b{hh}$,默认为True

  • batch_first – 如果为True,那么输入和输出Tensor的形状为(batch, seq, feature)

  • dropout – 如果非零的话,将会在RNN的输出上加个dropout,最后一层除外。

  • bidirectional – 如果为True,将会变成一个双向RNN,默认为False

LSTM输入:input, (h_0, c_0)

  • input (seq_len, batch, input_size): 包含输入序列特征的Tensor。也可以是packed variable ,详见 pack_padded_sequence

  • h_0 (num_layers * num_directions, batch, hidden_size):保存着batch中每个元素的初始化隐状态的Tensor

  • c_0 (num_layers * num_directions, batch, hidden_size): 保存着batch中每个元素的初始化细胞状态的Tensor

LSTM输出output, (h_n, c_n)

  • output (seq_len, batch, hidden_size * num_directions): 保存RNN最后一层的输出的Tensor。 如果输入是torch.nn.utils.rnn.PackedSequence,那么输出也是torch.nn.utils.rnn.PackedSequence

  • h_n (num_layers * num_directions, batch, hidden_size): Tensor,保存着RNN最后一个时间步的隐状态。

  • c_n (num_layers * num_directions, batch, hidden_size): Tensor,保存着RNN最后一个时间步的细胞状态。

LSTM模型参数:

  • weightih_l[k] – 第k层可学习的input-hidden权重($W{ii}|W{if}|W{ig}|W_{io}$),形状为(input_size x 4*hidden_size)

  • weighthh_l[k] – 第k层可学习的hidden-hidden权重($W{hi}|W{hf}|W{hg}|W_{ho}$),形状为(hidden_size x 4*hidden_size)

  • biasih_l[k] – 第k层可学习的input-hidden偏置($b{ii}|b{if}|b{ig}|b_{io}$),形状为( 4*hidden_size)

  • biashh_l[k] – 第k层可学习的hidden-hidden偏置($b{hi}|b{hf}|b{hg}|b_{ho}$),形状为( 4*hidden_size)。示例:

    1. lstm = nn.LSTM(10, 20, 2)
    2. input = Variable(torch.randn(5, 3, 10))
    3. h0 = Variable(torch.randn(2, 3, 20))
    4. c0 = Variable(torch.randn(2, 3, 20))
    5. output, hn = lstm(input, (h0, c0))

class torch.nn.GRU( args, * kwargs)[source]

将一个多层的GRU用于输入序列。

对输入序列中的每个元素,每层进行了一下计算:

\begin{aligned}rt&=sigmoid(W{ir}xt+b{ir}+W{hr}h{(t-1)}+b{hr})\i_t&=sigmoid(W{ii}xt+b{ii}+W{hi}h{(t-1)}+b{hi})\n_t&=tanh(W{in}xt+b{in}+rt(W{hn}h{(t-1)}+b_{hn}))\h_t&=(1-i_t) nt+i_t*h(t-1)\end{aligned}$h_t$是是时间$t$的上的隐状态,$x_t$是前一层$t$时刻的隐状态或者是第一层的$t$时刻的输入,$r_t, i_t, n_t$分别是重置门,输入门和新门。

参数说明:

  • input_size – 期望的输入$x$的特征值的维度
  • hidden_size – 隐状态的维度
  • num_layers – RNN的层数。
  • bias – 如果为False,那么RNN层将不会使用bias,默认为True
  • batch_first – 如果为True的话,那么输入和输出的tensor的形状是(batch, seq, feature)
  • dropout – 如果非零的话,将会在RNN的输出上加个dropout,最后一层除外。
  • bidirectional – 如果为True,将会变成一个双向RNN,默认为False

输入:input, h_0

  • input (seq_len, batch, input_size): 包含输入序列特征的Tensor。也可以是packed variable ,详见 pack_padded_sequence

  • h_0 (num_layers * num_directions, batch, hidden_size):保存着batch中每个元素的初始化隐状态的Tensor

输出:output, h_n

  • output (seq_len, batch, hidden_size * num_directions): ten保存RNN最后一层的输出的Tensor。 如果输入是torch.nn.utils.rnn.PackedSequence,那么输出也是torch.nn.utils.rnn.PackedSequence

  • h_n (num_layers * num_directions, batch, hidden_size): Tensor,保存着RNN最后一个时间步的隐状态。

变量:

  • weightih_l[k] – 第k层可学习的input-hidden权重($W{ir}|W{ii}|W{in}$),形状为(input_size x 3*hidden_size)

  • weighthh_l[k] – 第k层可学习的hidden-hidden权重($W{hr}|W{hi}|W{hn}$),形状为(hidden_size x 3*hidden_size)

  • biasih_l[k] – 第k层可学习的input-hidden偏置($b{ir}|b{ii}|b{in}$),形状为( 3*hidden_size)

  • biashh_l[k] – 第k层可学习的hidden-hidden偏置($b{hr}|b{hi}|b{hn}$),形状为( 3*hidden_size)

例子:

  1. rnn = nn.GRU(10, 20, 2)
  2. input = Variable(torch.randn(5, 3, 10))
  3. h0 = Variable(torch.randn(2, 3, 20))
  4. output, hn = rnn(input, h0)

class torch.nn.RNNCell(input_size, hidden_size, bias=True, nonlinearity=’tanh’)[source]

一个 Elan RNN cell,激活函数是tanhReLU,用于输入序列。将一个多层的 Elman RNNCell,激活函数为tanh或者ReLU,用于输入序列。h’=tanh(w{ih}* x+b{ih}+w{hh}* h+b{hh})如果nonlinearity=relu,那么将会使用ReLU来代替tanh

参数:

  • input_size – 输入$x$,特征的维度。

  • hidden_size – 隐状态特征的维度。

  • bias – 如果为FalseRNN cell中将不会加入bias,默认为True

  • nonlinearity – 用于选择非线性激活函数 [tanh|relu]. 默认值为: tanh

输入:input, hidden

  • input (batch, input_size): 包含输入特征的tensor

  • hidden (batch, hidden_size): 保存着初始隐状态值的tensor

输出: h’

  • h’ (batch, hidden_size):下一个时刻的隐状态。

变量:

  • weight_ih – input-hidden 权重, 可学习,形状是(input_size x hidden_size)

  • weight_hh – hidden-hidden 权重, 可学习,形状是(hidden_size x hidden_size)

  • bias_ih – input-hidden 偏置, 可学习,形状是(hidden_size)

  • bias_hh – hidden-hidden 偏置, 可学习,形状是(hidden_size)

例子:

  1. rnn = nn.RNNCell(10, 20)
  2. input = Variable(torch.randn(6, 3, 10))
  3. hx = Variable(torch.randn(3, 20))
  4. output = []
  5. for i in range(6):
  6. hx = rnn(input[i], hx)
  7. output.append(hx)

class torch.nn.LSTMCell(input_size, hidden_size, bias=True)[source]

LSTM cell\begin{aligned}i &= sigmoid(W{ii}x+b{ii}+W{hi}h+b{hi}) \f &= sigmoid(W{if}x+b{if}+W{hf}h+b{hf}) \o &= sigmoid(W{io}x+b{io}+W{ho}h+b{ho})\g &= tanh(W{ig}x+b{ig}+W{hg}h+b{hg})\c’ &= ft*c{t-1}+i_tg_t\h’ &= o_ttanh(c’)\end{aligned}

参数:

  • input_size – 输入的特征维度。
  • hidden_size – 隐状态的维度。
  • bias – 如果为False,那么将不会使用bias。默认为True

LSTM输入:input, (h_0, c_0)

  • input (seq_len, batch, input_size): 包含输入序列特征的Tensor。也可以是packed variable ,详见 pack_padded_sequence

  • h_0 ( batch, hidden_size):保存着batch中每个元素的初始化隐状态的Tensor

  • c_0 (batch, hidden_size): 保存着batch中每个元素的初始化细胞状态的Tensor

输出:h_1, c_1

  • h_1 (batch, hidden_size): 下一个时刻的隐状态。
  • c_1 (batch, hidden_size): 下一个时刻的细胞状态。

LSTM模型参数:

  • weightih – input-hidden权重($W{ii}|W{if}|W{ig}|W_{io}$),形状为(input_size x 4*hidden_size)

  • weighthh – hidden-hidden权重($W{hi}|W{hf}|W{hg}|W_{ho}$),形状为(hidden_size x 4*hidden_size)

  • biasih – input-hidden偏置($b{ii}|b{if}|b{ig}|b_{io}$),形状为( 4*hidden_size)

  • biashh – hidden-hidden偏置($b{hi}|b{hf}|b{hg}|b_{ho}$),形状为( 4*hidden_size)

Examples:

  1. rnn = nn.LSTMCell(10, 20)
  2. input = Variable(torch.randn(6, 3, 10))
  3. hx = Variable(torch.randn(3, 20))
  4. cx = Variable(torch.randn(3, 20))
  5. output = []
  6. for i in range(6):
  7. hx, cx = rnn(input[i], (hx, cx))
  8. output.append(hx)

class torch.nn.GRUCell(input_size, hidden_size, bias=True)[source]

一个GRU cell\begin{aligned}r&=sigmoid(W{ir}x+b{ir}+W{hr}h+b{hr})\i&=sigmoid(W{ii}x+b{ii}+W{hi}h+b{hi})\n&=tanh(W{in}x+b{in}+r(W{hn}h+b{hn}))\h’&=(1-i) n+i*h\end{aligned}

参数说明:

  • input_size – 期望的输入$x$的特征值的维度
  • hidden_size – 隐状态的维度
  • bias – 如果为False,那么RNN层将不会使用bias,默认为True

输入:input, h_0

  • input (batch, input_size): 包含输入特征的Tensor

  • h_0 (batch, hidden_size):保存着batch中每个元素的初始化隐状态的Tensor

输出:h_1

  • h_1 (batch, hidden_size): Tensor,保存着RNN下一个时刻的隐状态。

变量:

  • weightih – input-hidden权重($W{ir}|W{ii}|W{in}$),形状为(input_size x 3*hidden_size)

  • weighthh – hidden-hidden权重($W{hr}|W{hi}|W{hn}$),形状为(hidden_size x 3*hidden_size)

  • biasih – input-hidden偏置($b{ir}|b{ii}|b{in}$),形状为( 3*hidden_size)

  • biashh – hidden-hidden偏置($b{hr}|b{hi}|b{hn}$),形状为( 3*hidden_size)

例子:

  1. rnn = nn.GRUCell(10, 20)
  2. input = Variable(torch.randn(6, 3, 10))
  3. hx = Variable(torch.randn(3, 20))
  4. output = []
  5. for i in range(6):
  6. hx = rnn(input[i], hx)
  7. output.append(hx)

Linear layers

  1. class torch.nn.Linear(in_features, out_features, bias=True)

对输入数据做线性变换:\(y = Ax + b\)

参数:

  • in_features - 每个输入样本的大小
  • out_features - 每个输出样本的大小
  • bias - 若设置为False,这层不会学习偏置。默认值:True

形状:

  • 输入: \((N, in\_features)\)
  • 输出: \((N, out\_features)\)

变量:

  • weight -形状为(out_features x in_features)的模块中可学习的权值
  • bias -形状为(out_features)的模块中可学习的偏置

例子:

  1. >>> m = nn.Linear(20, 30)
  2. >>> input = autograd.Variable(torch.randn(128, 20))
  3. >>> output = m(input)
  4. >>> print(output.size())

Dropout layers

  1. class torch.nn.Dropout(p=0.5, inplace=False)

随机将输入张量中部分元素设置为0。对于每次前向调用,被置0的元素都是随机的。

参数:

  • p - 将元素置0的概率。默认值:0.5
  • in-place - 若设置为True,会在原地执行操作。默认值:False

形状:

  • 输入: 任意。输入可以为任意形状。
  • 输出: 相同。输出和输入形状相同。

例子:

  1. >>> m = nn.Dropout(p=0.2)
  2. >>> input = autograd.Variable(torch.randn(20, 16))
  3. >>> output = m(input)
  1. class torch.nn.Dropout2d(p=0.5, inplace=False)

随机将输入张量中整个通道设置为0。对于每次前向调用,被置0的通道都是随机的。

通常输入来自Conv2d模块。

像在论文Efficient Object Localization Using Convolutional Networks,如果特征图中相邻像素是强相关的(在前几层卷积层很常见),那么iid dropout不会归一化激活,而只会降低学习率。

在这种情形,nn.Dropout2d()可以提高特征图之间的独立程度,所以应该使用它。

参数:

  • p(float, optional) - 将元素置0的概率。
  • in-place(bool, optional) - 若设置为True,会在原地执行操作。

形状:

  • 输入: \((N, C, H, W)\)
  • 输出: \((N, C, H, W)\)(与输入形状相同)

例子:

  1. >>> m = nn.Dropout2d(p=0.2)
  2. >>> input = autograd.Variable(torch.randn(20, 16, 32, 32))
  3. >>> output = m(input)
  1. class torch.nn.Dropout3d(p=0.5, inplace=False)

随机将输入张量中整个通道设置为0。对于每次前向调用,被置0的通道都是随机的。

通常输入来自Conv3d模块。

像在论文Efficient Object Localization Using Convolutional Networks,如果特征图中相邻像素是强相关的(在前几层卷积层很常见),那么iid dropout不会归一化激活,而只会降低学习率。

在这种情形,nn.Dropout3d()可以提高特征图之间的独立程度,所以应该使用它。

参数:

  • p(float, optional) - 将元素置0的概率。
  • in-place(bool, optional) - 若设置为True,会在原地执行操作。

形状:

  • 输入: \(N, C, D, H, W)\)
  • 输出: \((N, C, D, H, W)\)(与输入形状相同)

例子:

  1. >>> m = nn.Dropout3d(p=0.2)
  2. >>> input = autograd.Variable(torch.randn(20, 16, 4, 32, 32))
  3. >>> output = m(input)

Sparse layers

  1. class torch.nn.Embedding(num_embeddings, embedding_dim, padding_idx=None, max_norm=None, norm_type=2, scale_grad_by_freq=False, sparse=False)

一个保存了固定字典和大小的简单查找表。

这个模块常用来保存词嵌入和用下标检索它们。模块的输入是一个下标的列表,输出是对应的词嵌入。

参数:

  • num_embeddings (int) - 嵌入字典的大小
  • embedding_dim (int) - 每个嵌入向量的大小
  • padding_idx (int, optional) - 如果提供的话,输出遇到此下标时用零填充
  • max_norm (float, optional) - 如果提供的话,会重新归一化词嵌入,使它们的范数小于提供的值
  • norm_type (float, optional) - 对于max_norm选项计算p范数时的p
  • scale_grad_by_freq (boolean, optional) - 如果提供的话,会根据字典中单词频率缩放梯度

变量:

  • weight (Tensor) -形状为(num_embeddings, embedding_dim)的模块中可学习的权值

形状:

  • 输入: LongTensor (N, W), N = mini-batch, W = 每个mini-batch中提取的下标数
  • 输出: (N, W, embedding_dim)

例子:

  1. >>> # an Embedding module containing 10 tensors of size 3
  2. >>> embedding = nn.Embedding(10, 3)
  3. >>> # a batch of 2 samples of 4 indices each
  4. >>> input = Variable(torch.LongTensor([[1,2,4,5],[4,3,2,9]]))
  5. >>> embedding(input)
  6. Variable containing:
  7. (0 ,.,.) =
  8. -1.0822 1.2522 0.2434
  9. 0.8393 -0.6062 -0.3348
  10. 0.6597 0.0350 0.0837
  11. 0.5521 0.9447 0.0498
  12. (1 ,.,.) =
  13. 0.6597 0.0350 0.0837
  14. -0.1527 0.0877 0.4260
  15. 0.8393 -0.6062 -0.3348
  16. -0.8738 -0.9054 0.4281
  17. [torch.FloatTensor of size 2x4x3]
  18. >>> # example with padding_idx
  19. >>> embedding = nn.Embedding(10, 3, padding_idx=0)
  20. >>> input = Variable(torch.LongTensor([[0,2,0,5]]))
  21. >>> embedding(input)
  22. Variable containing:
  23. (0 ,.,.) =
  24. 0.0000 0.0000 0.0000
  25. 0.3452 0.4937 -0.9361
  26. 0.0000 0.0000 0.0000
  27. 0.0706 -2.1962 -0.6276
  28. [torch.FloatTensor of size 1x4x3]

Distance functions

  1. class torch.nn.PairwiseDistance(p=2, eps=1e-06)

按批计算向量v1, v2之间的距离:

\Vert x \Vert p := \left( \sum\{i=1}^n \vert x_i \vert ^ p \right) ^ {1/p}

参数:

  • x (Tensor): 包含两个输入batch的张量
  • p (real): 范数次数,默认值:2

形状:

  • 输入: \((N, D)\),其中D=向量维数
  • 输出: \((N, 1)\)
  1. >>> pdist = nn.PairwiseDistance(2)
  2. >>> input1 = autograd.Variable(torch.randn(100, 128))
  3. >>> input2 = autograd.Variable(torch.randn(100, 128))
  4. >>> output = pdist(input1, input2)

Loss functions

基本用法:

  1. criterion = LossCriterion() #构造函数有自己的参数
  2. loss = criterion(x, y) #调用标准时也有参数

计算出来的结果已经对mini-batch取了平均。

class torch.nn.L1Loss(size_average=True)[source]

创建一个衡量输入x(模型预测输出)和目标y之间差的绝对值的平均值的标准。loss(x,y)=1/n\sum|x_i-y_i|

  • xy 可以是任意形状,每个包含n个元素。

  • n个元素对应的差值的绝对值求和,得出来的结果除以n

  • 如果在创建L1Loss实例的时候在构造函数中传入size_average=False,那么求出来的绝对值的和将不会除以n

class torch.nn.MSELoss(size_average=True)[source]

创建一个衡量输入x(模型预测输出)和目标y之间均方误差标准。loss(x,y)=1/n\sum(x_i-y_i)^2

  • xy 可以是任意形状,每个包含n个元素。

  • n个元素对应的差值的绝对值求和,得出来的结果除以n

  • 如果在创建MSELoss实例的时候在构造函数中传入size_average=False,那么求出来的平方和将不会除以n

class torch.nn.CrossEntropyLoss(weight=None, size_average=True)[source]

此标准将LogSoftMaxNLLLoss集成到一个类中。

当训练一个多类分类器的时候,这个方法是十分有用的。

  • weight(tensor): 1-D tensor,n个元素,分别代表n类的权重,如果你的训练样本很不均衡的话,是非常有用的。默认值为None。

调用时参数:

  • input : 包含每个类的得分,2-D tensor,shapebatch*n

  • target: 大小为 n1—D tensor,包含类别的索引(0到 n-1)。

Loss可以表述为以下形式:\begin{aligned}loss(x, class) &= -\text{log}\frac{exp(x[class])}{\sum_j exp(x[j]))}\ &= -x[class] + log(\sum_j exp(x[j]))\end{aligned}weight参数被指定的时候,loss的计算公式变为:loss(x, class) = weights[class] * (-x[class] + log(\sum_j exp(x[j])))计算出的lossmini-batch的大小取了平均。

形状(shape):

  • Input: (N,C) C 是类别的数量

  • Target: (N) Nmini-batch的大小,0 <= targets[i] <= C-1

class torch.nn.NLLLoss(weight=None, size_average=True)[source]

负的log likelihood loss损失。用于训练一个n类分类器。

如果提供的话,weight参数应该是一个1-Dtensor,里面的值对应类别的权重。当你的训练集样本不均衡的话,使用这个参数是非常有用的。

输入是一个包含类别log-probabilities2-D tensor,形状是(mini-batch, n)

可以通过在最后一层加LogSoftmax来获得类别的log-probabilities

如果您不想增加一个额外层的话,您可以使用CrossEntropyLoss

loss期望的target是类别的索引 (0 to N-1, where N = number of classes)

loss可以被表示如下:loss(x, class) = -x[class]如果weights参数被指定的话,loss可以表示如下:loss(x, class) = -weights[class] * x[class]参数说明:

  • weight (Tensor, optional) – 手动指定每个类别的权重。如果给定的话,必须是长度为nclasses

  • size_average (bool, optional) – 默认情况下,会计算mini-batch``loss的平均值。然而,如果size_average=False那么将会把mini-batch中所有样本的loss累加起来。

形状:

  • Input: (N,C) , C是类别的个数

  • Target: (N) , target中每个值的大小满足 0 <= targets[i] <= C-1

例子:

  1. m = nn.LogSoftmax()
  2. loss = nn.NLLLoss()
  3. # input is of size nBatch x nClasses = 3 x 5
  4. input = autograd.Variable(torch.randn(3, 5), requires_grad=True)
  5. # each element in target has to have 0 <= value < nclasses
  6. target = autograd.Variable(torch.LongTensor([1, 0, 4]))
  7. output = loss(m(input), target)
  8. output.backward()

class torch.nn.NLLLoss2d(weight=None, size_average=True)[source]

对于图片的 negative log likehood loss。计算每个像素的 NLL loss

参数说明:

  • weight (Tensor, optional) – 用来作为每类的权重,如果提供的话,必须为1-Dtensor,大小为C:类别的个数。

  • size_average – 默认情况下,会计算 mini-batch loss均值。如果设置为 False 的话,将会累加mini-batch中所有样本的loss值。默认值:True

形状:

  • Input: (N,C,H,W) C 类的数量

  • Target: (N,H,W) where each value is 0 <= targets[i] <= C-1

例子:

  1. m = nn.Conv2d(16, 32, (3, 3)).float()
  2. loss = nn.NLLLoss2d()
  3. # input is of size nBatch x nClasses x height x width
  4. input = autograd.Variable(torch.randn(3, 16, 10, 10))
  5. # each element in target has to have 0 <= value < nclasses
  6. target = autograd.Variable(torch.LongTensor(3, 8, 8).random_(0, 4))
  7. output = loss(m(input), target)
  8. output.backward()

class torch.nn.KLDivLoss(weight=None, size_average=True)[source]

计算 KL 散度损失。

KL散度常用来描述两个分布的距离,并在输出分布的空间上执行直接回归是有用的。

NLLLoss一样,给定的输入应该是log-probabilities。然而。和NLLLoss不同的是,input不限于2-D tensor,因为此标准是基于element的。

target 应该和 input的形状相同。

此loss可以表示为:loss(x,target)=\frac{1}{n}\sum_i(target_i*(log(target_i)-x_i))默认情况下,loss会基于element求平均。如果 size_average=False loss 会被累加起来。

class torch.nn.BCELoss(weight=None, size_average=True)[source]

计算 targetoutput 之间的二进制交叉熵。loss(o,t)=-\frac{1}{n}\sum_i(t[i] log(o[i])+(1-t[i]) log(1-o[i]))如果weight被指定 :loss(o,t)=-\frac{1}{n}\sum_iweights[i] (t[i] log(o[i])+(1-t[i])* log(1-o[i]))

这个用于计算 auto-encoderreconstruction error。注意 0<=target[i]<=1。

默认情况下,loss会基于element平均,如果size_average=False的话,loss会被累加。

class torch.nn.MarginRankingLoss(margin=0, size_average=True)[source]

创建一个标准,给定输入 $x1$,$x2$两个1-D mini-batch Tensor’s,和一个$y$(1-D mini-batch tensor) ,$y$里面的值只能是-1或1。

如果 y=1,代表第一个输入的值应该大于第二个输入的值,如果y=-1的话,则相反。

mini-batch中每个样本的loss的计算公式如下:

loss(x, y) = max(0, -y * (x1 - x2) + margin)

如果size_average=True,那么求出的loss将会对mini-batch求平均,反之,求出的loss会累加。默认情况下,size_average=True

class torch.nn.HingeEmbeddingLoss(size_average=True)[source]

给定一个输入 $x$(2-D mini-batch tensor)和对应的 标签 $y$ (1-D tensor,1,-1),此函数用来计算之间的损失值。这个loss通常用来测量两个输入是否相似,即:使用L1 成对距离。典型是用在学习非线性 embedding或者半监督学习中:

loss(x,y)=\frac{1}{n}\sum_i\begin{cases}x_i, &\text if~y_i==1 \max(0, margin-x_i), &if ~y_i==-1\end{cases}$x$和$y$可以是任意形状,且都有n的元素,loss的求和操作作用在所有的元素上,然后除以n。如果您不想除以n的话,可以通过设置size_average=False

margin的默认值为1,可以通过构造函数来设置。

class torch.nn.MultiLabelMarginLoss(size_average=True)[source]

计算多标签分类的 hinge loss(margin-based loss) ,计算loss时需要两个输入: input x(2-D mini-batch Tensor),和 output y(2-D tensor表示mini-batch中样本类别的索引)。

loss(x, y) = \frac{1}{x.size(0)}\sum_{i=0,j=0}^{I,J}(max(0, 1 - (x[y[j]] - x[i])))其中 I=x.size(0),J=y.size(0)。对于所有的 ij,满足 $y[j]\neq0, i \neq y[j]$

xy 必须具有同样的 size

这个标准仅考虑了第一个非零 y[j] targets此标准允许了,对于每个样本来说,可以有多个类别。

class torch.nn.SmoothL1Loss(size_average=True)[source]

平滑版L1 loss

loss的公式如下:loss(x, y) = \frac{1}{n}\sum_i\begin{cases}0.5*(x_i-y_i)^2, & if~|x_i - y_i| < 1\|x_i - y_i| - 0.5, & otherwise\end{cases}此loss对于异常点的敏感性不如MSELoss,而且,在某些情况下防止了梯度爆炸,(参照 Fast R-CNN)。这个loss有时也被称为 Huber loss

x 和 y 可以是任何包含n个元素的tensor。默认情况下,求出来的loss会除以n,可以通过设置size_average=True使loss累加。

class torch.nn.SoftMarginLoss(size_average=True)[source]

创建一个标准,用来优化2分类的logistic loss。输入为 x(一个 2-D mini-batch Tensor)和 目标y(一个包含1或-1的Tensor)。loss(x, y) = \frac{1}{x.nelement()}\sum_i (log(1 + exp(-y[i]* x[i])))如果求出的loss不想被平均可以通过设置size_average=False

class torch.nn.MultiLabelSoftMarginLoss(weight=None, size_average=True)[source]

创建一个标准,基于输入x和目标y的 max-entropy,优化多标签 one-versus-all 的损失。x:2-D mini-batch Tensor;y:binary 2D Tensor。对每个mini-batch中的样本,对应的loss为:$$loss(x, y) = - \frac{1}{x.nElement()}\sum_{i=0}^I y[i]\text{log}\frac{exp(x[i])}{(1 + exp(x[i])}

  1. + (1-y[i])\text{log}\frac{1}{1+exp(x[i])}

$$其中 I=x.nElement()-1, $y[i] \in {0,1}$,yx必须要有同样size

class torch.nn.CosineEmbeddingLoss(margin=0, size_average=True)[source]

给定 输入 Tensorsx1, x2 和一个标签Tensor y(元素的值为1或-1)。此标准使用cosine距离测量两个输入是否相似,一般用来用来学习非线性embedding或者半监督学习。

margin应该是-1到1之间的值,建议使用0到0.5。如果没有传入margin实参,默认值为0。

每个样本的loss是:loss(x, y) =\begin{cases}1 - cos(x1, x2), &if~y == 1 \max(0, cos(x1, x2) - margin), &if~y == -1\end{cases}如果size_average=True 求出的loss会对batch求均值,如果size_average=False的话,则会累加loss。默认情况size_average=True

class torch.nn.MultiMarginLoss(p=1, margin=1, weight=None, size_average=True)[source]

用来计算multi-class classification的hinge loss(magin-based loss)。输入是 x(2D mini-batch Tensor), y(1D Tensor)包含类别的索引, 0 <= y <= x.size(1))

对每个mini-batch样本:loss(x, y) = \frac{1}{x.size(0)}\sum_{i=0}^I(max(0, margin - x[y] + x[i])^p)其中 I=x.size(0) $i\neq y$。可选择的,如果您不想所有的类拥有同样的权重的话,您可以通过在构造函数中传入weights参数来解决这个问题,weights是一个1D权重Tensor。

传入weights后,loss函数变为:loss(x, y) = \frac{1}{x.size(0)}\sum_imax(0, w[y] * (margin - x[y] - x[i]))^p默认情况下,求出的loss会对mini-batch取平均,可以通过设置size_average=False来取消取平均操作。

Vision layers

class torch.nn.PixelShuffle(upscale_factor)[source]

将shape为$[N, Cr^2, H, W]$的Tensor重新排列为shape为$[N, C, Hr, W*r]$的Tensor。当使用stride=1/r 的sub-pixel卷积的时候,这个方法是非常有用的。

请看paperReal-Time Single Image and Video Super-Resolution Using an Efficient Sub-Pixel Convolutional Neural Network by Shi et. al (2016) 获取详细信息。

参数说明:

  • upscale_factor (int) – 增加空间分辨率的因子

Shape:

  • Input: $[N,C*upscale_factor^2,H,W$]

  • Output: $[N,C,Hupscale_factor,Wupscale_factor]$

例子:

  1. >>> ps = nn.PixelShuffle(3)
  2. >>> input = autograd.Variable(torch.Tensor(1, 9, 4, 4))
  3. >>> output = ps(input)
  4. >>> print(output.size())
  5. torch.Size([1, 1, 12, 12])

class torch.nn.UpsamplingNearest2d(size=None, scale_factor=None)[source]

对于多channel 输入 进行 2-D 最近邻上采样。

可以通过size或者scale_factor来指定上采样后的图片大小。

当给定size时,size的值将会是输出图片的大小。

参数:

  • size (tuple, optional) – 一个包含两个整数的元组 (H_out, W_out)指定了输出的长宽
  • scale_factor (int, optional) – 长和宽的一个乘子

形状:

  • Input: (N,C,H_in,W_in)
  • Output: (N,C,H_out,W_out) Hout=floor(H_in∗scale_factor) Wout=floor(W_in∗scale_factor)

例子:

  1. >>> inp
  2. Variable containing:
  3. (0 ,0 ,.,.) =
  4. 1 2
  5. 3 4
  6. [torch.FloatTensor of size 1x1x2x2]
  7. >>> m = nn.UpsamplingNearest2d(scale_factor=2)
  8. >>> m(inp)
  9. Variable containing:
  10. (0 ,0 ,.,.) =
  11. 1 1 2 2
  12. 1 1 2 2
  13. 3 3 4 4
  14. 3 3 4 4
  15. [torch.FloatTensor of size 1x1x4x4]

class torch.nn.UpsamplingBilinear2d(size=None, scale_factor=None)[source]

对于多channel 输入 进行 2-D bilinear 上采样。

可以通过size或者scale_factor来指定上采样后的图片大小。

当给定size时,size的值将会是输出图片的大小。

参数:

  • size (tuple, optional) – 一个包含两个整数的元组 (H_out, W_out)指定了输出的长宽
  • scale_factor (int, optional) – 长和宽的一个乘子

形状:

  • Input: (N,C,H_in,W_in)
  • Output: (N,C,H_out,W_out) Hout=floor(H_in∗scale_factor) Wout=floor(W_in∗scale_factor)

例子:

  1. >>> inp
  2. Variable containing:
  3. (0 ,0 ,.,.) =
  4. 1 2
  5. 3 4
  6. [torch.FloatTensor of size 1x1x2x2]
  7. >>> m = nn.UpsamplingBilinear2d(scale_factor=2)
  8. >>> m(inp)
  9. Variable containing:
  10. (0 ,0 ,.,.) =
  11. 1.0000 1.3333 1.6667 2.0000
  12. 1.6667 2.0000 2.3333 2.6667
  13. 2.3333 2.6667 3.0000 3.3333
  14. 3.0000 3.3333 3.6667 4.0000
  15. [torch.FloatTensor of size 1x1x4x4]

Multi-GPU layers

class torch.nn.DataParallel(module, device_ids=None, output_device=None, dim=0)[source]

在模块级别上实现数据并行。

此容器通过将mini-batch划分到不同的设备上来实现给定module的并行。在forward过程中,module会在每个设备上都复制一遍,每个副本都会处理部分输入。在backward过程中,副本上的梯度会累加到原始module上。

batch的大小应该大于所使用的GPU的数量。还应当是GPU个数的整数倍,这样划分出来的每一块都会有相同的样本数量。

请看: Use nn.DataParallel instead of multiprocessing

除了Tensor,任何位置参数和关键字参数都可以传到DataParallel中。所有的变量会通过指定的dim来划分(默认值为0)。原始类型将会被广播,但是所有的其它类型都会被浅复制。所以如果在模型的forward过程中写入的话,将会被损坏。

参数说明:

  • module – 要被并行的module
  • device_ids – CUDA设备,默认为所有设备。
  • output_device – 输出设备(默认为device_ids[0])

例子:

  1. net = torch.nn.DataParallel(model, device_ids=[0, 1, 2])
  2. output = net(input_var)

Utilities

工具函数

torch.nn.utils.clip_grad_norm(parameters, max_norm, norm_type=2)[source]

Clips gradient norm of an iterable of parameters.

正则項的值由所有的梯度计算出来,就像他们连成一个向量一样。梯度被in-place operation修改。

参数说明:

  • parameters (Iterable[Variable]) – 可迭代的Variables,它们的梯度即将被标准化。
  • max_norm (float or int) – clip后,gradients p-norm 值
  • norm_type (float or int) – 标准化的类型,p-norm. 可以是inf 代表 infinity norm.

关于norm

返回值:

所有参数的p-norm值。

torch.nn.utils.rnn.PackedSequence(_cls, data, batch_sizes)[source]

Holds the data and list of batch_sizes of a packed sequence.

All RNN modules accept packed sequences as inputs.所有的RNN模块都接收这种被包裹后的序列作为它们的输入。

NOTE:这个类的实例不能手动创建。它们只能被 pack_padded_sequence() 实例化。

参数说明:

  • data (Variable) – 包含打包后序列的Variable

  • batch_sizes (list[int]) – 包含 mini-batch 中每个序列长度的列表。

torch.nn.utils.rnn.pack_padded_sequence(input, lengths, batch_first=False)[source]

这里的pack,理解成压紧比较好。将一个 填充过的变长序列 压紧。(填充时候,会有冗余,所以压紧一下)

输入的形状可以是(T×B× )。T是最长序列长度,Bbatch size,`代表任意维度(可以是0)。如果batch_first=True的话,那么相应的input size就是(B×T×*)`。

Variable中保存的序列,应该按序列长度的长短排序,长的在前,短的在后。即input[:,0]代表的是最长的序列,input[:, B-1]保存的是最短的序列。

NOTE:只要是维度大于等于2的input都可以作为这个函数的参数。你可以用它来打包labels,然后用RNN的输出和打包后的labels来计算loss。通过PackedSequence对象的.data属性可以获取 Variable

参数说明:

  • input (Variable) – 变长序列 被填充后的 batch

  • lengths (list[int]) – Variable 中 每个序列的长度。

  • batch_first (bool, optional) – 如果是True,input的形状应该是B*T*size

返回值:

一个PackedSequence 对象。

torch.nn.utils.rnn.pad_packed_sequence(sequence, batch_first=False)[source]

填充packed_sequence

上面提到的函数的功能是将一个填充后的变长序列压紧。 这个操作和pack_padded_sequence()是相反的。把压紧的序列再填充回来。

返回的Varaible的值的sizeT×B×*, T 是最长序列的长度,B 是 batch_size,如果 batch_first=True,那么返回值是B×T×*

Batch中的元素将会以它们长度的逆序排列。

参数说明:

  • sequence (PackedSequence) – 将要被填充的 batch

  • batch_first (bool, optional) – 如果为True,返回的数据的格式为 B×T×*

返回值:一个tuple,包含被填充后的序列,和batch中序列的长度列表。

例子:

  1. import torch
  2. import torch.nn as nn
  3. from torch.autograd import Variable
  4. from torch.nn import utils as nn_utils
  5. batch_size = 2
  6. max_length = 3
  7. hidden_size = 2
  8. n_layers =1
  9. tensor_in = torch.FloatTensor([[1, 2, 3], [1, 0, 0]]).resize_(2,3,1)
  10. tensor_in = Variable( tensor_in ) #[batch, seq, feature], [2, 3, 1]
  11. seq_lengths = [3,1] # list of integers holding information about the batch size at each sequence step
  12. # pack it
  13. pack = nn_utils.rnn.pack_padded_sequence(tensor_in, seq_lengths, batch_first=True)
  14. # initialize
  15. rnn = nn.RNN(1, hidden_size, n_layers, batch_first=True)
  16. h0 = Variable(torch.randn(n_layers, batch_size, hidden_size))
  17. #forward
  18. out, _ = rnn(pack, h0)
  19. # unpack
  20. unpacked = nn_utils.rnn.pad_packed_sequence(out)
  21. print(unpacked)

关于packed_sequence