Struct burn::nn::GroupNorm

pub struct GroupNorm<B>
where
    B: Backend,
{
    pub gamma: Option<Param<Tensor<B, 1>>>,
    pub beta: Option<Param<Tensor<B, 1>>>,
    pub num_groups: usize,
    pub num_channels: usize,
    pub epsilon: f64,
    pub affine: bool,
}

Applies Group Normalization over a mini-batch of inputs as described in the paper Group Normalization.

Y = groupnorm(X) * γ + β

Where:

• X is the input tensor
• Y is the output tensor
• γ is the learnable weight
• β is the learnable bias

Should be created using GroupNormConfig.

Fields

gamma: Option<Param<Tensor<B, 1>>>

The learnable weight

beta: Option<Param<Tensor<B, 1>>>

The learnable bias

num_groups: usize

The number of groups to separate the channels into

num_channels: usize

The number of channels expected in the input

epsilon: f64

A value required for numerical stability

affine: bool

A boolean value that when set to true, this module has learnable

Implementations

impl<B> GroupNorm<B>

where B: Backend,

pub fn forward<const D: usize>(&self, input: Tensor<B, D>) -> Tensor<B, D>

Applies the forward pass on the input tensor.

See GroupNorm for more information.

Shapes

• input: [batch_size, num_channels, *]
• output: [batch_size, num_channels, *]

Trait Implementations

impl<B> AutodiffModule<B> for GroupNorm<B>

where B: Backend + AutodiffBackend, <B as AutodiffBackend>::InnerBackend: Backend,

type InnerModule = GroupNorm<<B as AutodiffBackend>::InnerBackend>

Inner module without auto-differentiation.

fn valid(&self) -> <GroupNorm<B> as AutodiffModule<B>>::InnerModule

Get the same module, but on the inner backend without auto-differentiation.

impl<B> Clone for GroupNorm<B>

where B: Backend,

fn clone(&self) -> GroupNorm<B>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<B> Debug for GroupNorm<B>

where B: Debug + Backend,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<B> Display for GroupNorm<B>

where B: Backend,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<B> Module<B> for GroupNorm<B>

where B: Backend,

type Record = GroupNormRecord<B>

Type to save and load the module.

fn load_record( self, record: <GroupNorm<B> as Module<B>>::Record, ) -> GroupNorm<B>

Load the module state from a record.

fn into_record(self) -> <GroupNorm<B> as Module<B>>::Record

Convert the module into a record containing the state.

fn num_params(&self) -> usize

Get the number of parameters the module has, including all of its sub-modules.

fn visit<Visitor>(&self, visitor: &mut Visitor)

where Visitor: ModuleVisitor<B>,

Visit each tensor parameter in the module with a visitor.

fn map<Mapper>(self, mapper: &mut Mapper) -> GroupNorm<B>

where Mapper: ModuleMapper<B>,

Map each tensor parameter in the module with a mapper.

fn collect_devices( &self, devices: Vec<<B as Backend>::Device>, ) -> Vec<<B as Backend>::Device>

Return all the devices found in the underneath module tree added to the given vector without duplicates.

fn to_device(self, device: &<B as Backend>::Device) -> GroupNorm<B>

Move the module and all of its sub-modules to the given device.

fn fork(self, device: &<B as Backend>::Device) -> GroupNorm<B>

Fork the module and all of its sub-modules to the given device.

fn devices(&self) -> Vec<<B as Backend>::Device>

Return all the devices found in the underneath module tree without duplicates.

fn no_grad(self) -> Self

Each tensor in the module tree will not require grad.

fn save_file<FR, PB>( self, file_path: PB, recorder: &FR, ) -> Result<(), RecorderError>

where FR: FileRecorder<B>, PB: Into<PathBuf>,

Save the module to a file using the provided file recorder.

fn load_file<FR, PB>( self, file_path: PB, recorder: &FR, device: &<B as Backend>::Device, ) -> Result<Self, RecorderError>

where FR: FileRecorder<B>, PB: Into<PathBuf>,

Load the module from a file using the provided file recorder.

fn quantize_weights<C>(self, quantizer: &mut Quantizer<C>) -> Self

where C: Calibration,

Quantize the weights of the module.

impl<B> ModuleDisplay for GroupNorm<B>

where B: Backend,

fn custom_settings(&self) -> Option<DisplaySettings>

Custom display settings for the module.

fn custom_content(&self, content: Content) -> Option<Content>

Custom attributes for the module.

fn format(&self, passed_settings: DisplaySettings) -> String

Formats the module with provided display settings.

impl<B> ModuleDisplayDefault for GroupNorm<B>

where B: Backend,

fn content(&self, content: Content) -> Option<Content>

Attributes of the module used for display purposes.

fn num_params(&self) -> usize

Gets the number of the parameters of the module.