Sequential — PyTorch 2.7 documentation (original) (raw)
class torch.nn.Sequential(*args: Module)[source][source]¶
class torch.nn.Sequential(arg: OrderedDict[str, Module])
A sequential container.
Modules will be added to it in the order they are passed in the constructor. Alternatively, an OrderedDict
of modules can be passed in. The forward()
method of Sequential
accepts any input and forwards it to the first module it contains. It then “chains” outputs to inputs sequentially for each subsequent module, finally returning the output of the last module.
The value a Sequential
provides over manually calling a sequence of modules is that it allows treating the whole container as a single module, such that performing a transformation on theSequential
applies to each of the modules it stores (which are each a registered submodule of the Sequential
).
What’s the difference between a Sequential
and atorch.nn.ModuleList? A ModuleList
is exactly what it sounds like–a list for storing Module
s! On the other hand, the layers in a Sequential
are connected in a cascading way.
Example:
Using Sequential to create a small model. When model
is run,
input will first be passed to Conv2d(1,20,5)
. The output of
Conv2d(1,20,5)
will be used as the input to the first
ReLU
; the output of the first ReLU
will become the input
for Conv2d(20,64,5)
. Finally, the output of
Conv2d(20,64,5)
will be used as input to the second ReLU
model = nn.Sequential( nn.Conv2d(1,20,5), nn.ReLU(), nn.Conv2d(20,64,5), nn.ReLU() )
Using Sequential with OrderedDict. This is functionally the
same as the above code
model = nn.Sequential(OrderedDict([ ('conv1', nn.Conv2d(1,20,5)), ('relu1', nn.ReLU()), ('conv2', nn.Conv2d(20,64,5)), ('relu2', nn.ReLU()) ]))
append(module)[source][source]¶
Append a given module to the end.
Parameters
module (nn.Module) – module to append
Return type