torch::nn::Cloneable< Derived > Class Template Reference

The clone() method in the base Module class does not have knowledge of the concrete runtime type of its subclasses. More...

#include <cloneable.h>

Inheritance diagram for torch::nn::Cloneable< Derived >:

Public Member Functions
virtual void	reset ()=0
	reset() must perform initialization of all members with reference semantics, most importantly parameters, buffers and submodules. More...
std::shared_ptr< Module >	clone (const optional< Device > &device=nullopt) const override
	Performs a recursive "deep copy" of the Module, such that all parameters and submodules in the cloned module are different from those in the original module. More...
Public Member Functions inherited from torch::nn::Module
	Module (std::string name)
	Tells the base Module about the name of the submodule.
	Module ()
	Constructs the module without immediate knowledge of the submodule's name. More...
const std::string &	name () const noexcept
	Returns the name of the Module. More...
void	apply (const ModuleApplyFunction &function)
	Applies the function to the Module and recursively to every submodule. More...
void	apply (const ConstModuleApplyFunction &function) const
	Applies the function to the Module and recursively to every submodule. More...
void	apply (const NamedModuleApplyFunction &function, const std::string &name_prefix=std::string())
	Applies the function to the Module and recursively to every submodule. More...
void	apply (const ConstNamedModuleApplyFunction &function, const std::string &name_prefix=std::string()) const
	Applies the function to the Module and recursively to every submodule. More...
void	apply (const ModulePointerApplyFunction &function) const
	Applies the function to the Module and recursively to every submodule. More...
void	apply (const NamedModulePointerApplyFunction &function, const std::string &name_prefix=std::string()) const
	Applies the function to the Module and recursively to every submodule. More...
std::vector< Tensor >	parameters (bool recurse=true) const
	Returns the parameters of this Module and if recurse is true, also recursively of every submodule. More...
OrderedDict< std::string, Tensor >	named_parameters (bool recurse=true) const
	Returns an OrderedDict with the parameters of this Module along with their keys, and if recurse is true also recursively of every submodule. More...
std::vector< Tensor >	buffers (bool recurse=true) const
	Returns the buffers of this Module and if recurse is true, also recursively of every submodule. More...
OrderedDict< std::string, Tensor >	named_buffers (bool recurse=true) const
	Returns an OrderedDict with the buffers of this Module along with their keys, and if recurse is true also recursively of every submodule. More...
std::vector< std::shared_ptr< Module > >	modules (bool include_self=true) const
	Returns the submodules of this Module (the entire submodule hierarchy) and if include_self is true, also inserts a shared_ptr to this module in the first position. More...
OrderedDict< std::string, std::shared_ptr< Module > >	named_modules (const std::string &name_prefix=std::string(), bool include_self=true) const
	Returns an OrderedDict of he submodules of this Module (the entire submodule hierarchy) and thei keys, and if include_self is true, also inserts a shared_ptr to this module in the first position. More...
std::vector< std::shared_ptr< Module > >	children () const
	Returns the direct submodules of this Module.
OrderedDict< std::string, std::shared_ptr< Module > >	named_children () const
	Returns an OrderedDict of the direct submodules of this Module and their keys. More...
virtual void	train (bool on=true)
	Enables "training" mode.
void	eval ()
	Calls train(false) to enable "eval" mode. More...
virtual bool	is_training () const noexcept
	True if the module is in training mode. More...
virtual void	to (torch::Device device, torch::Dtype dtype, bool non_blocking=false)
	Recursively casts all parameters to the given dtype and device. More...
virtual void	to (torch::Dtype dtype, bool non_blocking=false)
	Recursively casts all parameters to the given dtype. More...
virtual void	to (torch::Device device, bool non_blocking=false)
	Recursively moves all parameters to the given device. More...
virtual void	zero_grad ()
	Recursively zeros out the grad value of each registered parameter.
template<typename ModuleType >
ModuleType::ContainedType *	as () noexcept
	Attempts to cast this Module to the given ModuleType. More...
template<typename ModuleType >
const ModuleType::ContainedType *	as () const noexcept
	Attempts to cast this Module to the given ModuleType. More...
template<typename ModuleType , typename = torch::detail::disable_if_module_holder_t<ModuleType>>
ModuleType *	as () noexcept
	Attempts to cast this Module to the given ModuleType. More...
template<typename ModuleType , typename = torch::detail::disable_if_module_holder_t<ModuleType>>
const ModuleType *	as () const noexcept
	Attempts to cast this Module to the given ModuleType. More...
virtual void	save (serialize::OutputArchive &archive) const
	Serializes the Module into the given OutputArchive.
virtual void	load (serialize::InputArchive &archive)
	Deserializes the Module from the given InputArchive.
virtual void	pretty_print (std::ostream &stream) const
	Streams a pretty representation of the Module into the given stream. More...

Additional Inherited Members
Public Types inherited from torch::nn::Module
using	ModuleApplyFunction = std::function< void(Module &)>
using	ConstModuleApplyFunction = std::function< void(const Module &)>
using	NamedModuleApplyFunction = std::function< void(const std::string &, Module &)>
using	ConstNamedModuleApplyFunction = std::function< void(const std::string &, const Module &)>
using	ModulePointerApplyFunction = std::function< void(const std::shared_ptr< Module > &)>
using	NamedModulePointerApplyFunction = std::function< void(const std::string &, const std::shared_ptr< Module > &)>
Protected Member Functions inherited from torch::nn::Module
Tensor &	register_parameter (std::string name, Tensor tensor, bool requires_grad=true)
	Registers a parameter with this Module. More...
Tensor &	register_buffer (std::string name, Tensor tensor)
	Registers a buffer with this Module. More...
template<typename ModuleType >
std::shared_ptr< ModuleType >	register_module (std::string name, std::shared_ptr< ModuleType > module)
	Registers a submodule with this Module. More...
template<typename ModuleType >
std::shared_ptr< ModuleType >	register_module (std::string name, ModuleHolder< ModuleType > module_holder)
	Registers a submodule with this Module. More...

Detailed Description

template<typename Derived>
class torch::nn::Cloneable< Derived >

The clone() method in the base Module class does not have knowledge of the concrete runtime type of its subclasses.

Therefore, clone() must either be called from within the subclass, or from a base class that has knowledge of the concrete type. Cloneable uses the CRTP to gain knowledge of the subclass' static type and provide an implementation of the clone() method. We do not want to use this pattern in the base class, because then storing a module would always require templatizing it.

Definition at line 23 of file cloneable.h.

Member Function Documentation

template<typename Derived>

std::shared_ptr<Module> torch::nn::Cloneable< Derived >::clone ( const optional< Device > &  device = nullopt ) const

inlineoverridevirtual

Performs a recursive "deep copy" of the Module, such that all parameters and submodules in the cloned module are different from those in the original module.

Reimplemented from torch::nn::Module.

Definition at line 34 of file cloneable.h.

template<typename Derived>

virtual void torch::nn::Cloneable< Derived >::reset ( )

pure virtual

reset() must perform initialization of all members with reference semantics, most importantly parameters, buffers and submodules.

Implemented in torch::nn::SequentialImpl, torch::nn::ConvImpl< D, Derived >, torch::nn::ConvImpl< 1, Conv1dImpl >, torch::nn::ConvImpl< 3, Conv3dImpl >, torch::nn::ConvImpl< 2, Conv2dImpl >, torch::nn::detail::RNNImplBase< Derived >, torch::nn::detail::RNNImplBase< RNNImpl >, torch::nn::detail::RNNImplBase< LSTMImpl >, torch::nn::detail::RNNImplBase< GRUImpl >, torch::nn::BatchNormImpl, torch::nn::LinearImpl, torch::nn::EmbeddingImpl, torch::nn::detail::DropoutImplBase< Derived >, torch::nn::detail::DropoutImplBase< DropoutImpl >, torch::nn::detail::DropoutImplBase< FeatureDropoutImpl >, torch::test::SimpleContainer, and Net.

---

The documentation for this class was generated from the following file:

• torch/csrc/api/include/torch/nn/cloneable.h