OpenNN
Open-source neural networks library
Loading...
Searching...
No Matches
opennn::Pooling3d Class Referencefinal

Sequence pooling layer reducing the time axis of a (sequence, features) input. More...

#include <pooling_layer_3d.h>

Inheritance diagram for opennn::Pooling3d:
[legend]

Public Member Functions

 Pooling3d (const Shape &={0, 0}, const PoolingMethod &=PoolingMethod::MaxPooling, const string &="sequence_pooling_layer")
 Constructs a sequence pooling layer.
 
Shape get_input_shape () const override
 Returns the input tensor shape (sequence_length, input_features).
 
Shape get_output_shape () const override
 Returns the output tensor shape after sequence-axis pooling.
 
Index get_sequence_length () const
 
Index get_input_features () const
 
PoolingMethod get_pooling_method () const
 
vector< TensorSpecget_forward_specs (Index batch_size) const override
 Returns the tensor specifications used during forward propagation.
 
void set (const Shape &, const PoolingMethod &, const string &)
 Reconfigures the layer with a new input shape, pooling method and name.
 
void set_input_shape (const Shape &new_input_shape) override
 Updates the layer for a new input shape, preserving pooling method and label.
 
void set_output_shape (const Shape &) override
 Sets the output shape; subclasses override when the output is user-configurable.
 
void set_pooling_method (PoolingMethod)
 Sets the pooling method via enum.
 
void set_pooling_method (const string &)
 Sets the pooling method by name ("MaxPooling" or "AveragePooling").
 
void read_JSON_body (const Json *) override
 Reads the layer configuration from a JSON node.
 
void write_JSON_body (JsonWriter &) const override
 Writes the layer configuration to a JSON writer.
 
- Public Member Functions inherited from opennn::Layer
virtual ~Layer ()=default
 
const string & get_label () const
 
const string & get_name () const
 
LayerType get_type () const
 
void set_label (string new_label)
 
Index get_parameters_number () const
 Returns the total number of trainable parameters owned by this layer.
 
const vector< Operator * > & get_operators () const
 
virtual vector< TensorSpecget_parameter_specs () const
 Returns the tensor specs of trainable parameters; subclasses override.
 
virtual vector< TensorSpecget_state_specs () const
 Returns the tensor specs of persistent state (e.g. running mean/variance).
 
virtual vector< TensorSpecget_backward_specs (Index batch_size) const
 Returns the tensor specs of the backward workspace; empty for non-trainable layers.
 
virtual ActivationOp::Function get_output_activation () const
 Returns the layer's output activation (Identity for most layers; overridden by Dense/Bounding).
 
Index get_inputs_number () const
 
Index get_outputs_number () const
 
virtual void forward_propagate (ForwardPropagation &fp, size_t layer, bool is_training) noexcept
 Runs the forward pass by chaining the layer's operators in order.
 
virtual void back_propagate (ForwardPropagation &fp, BackPropagation &bp, size_t i) const noexcept
 Runs the backward pass by chaining the layer's operators in reverse order.
 
virtual void from_JSON (const JsonDocument &document)
 Restores layer configuration and parameters from a JSON document.
 
virtual void load_state_from_JSON (const JsonDocument &document)
 Restores persistent state (e.g. running statistics) from a JSON document.
 
virtual void to_JSON (JsonWriter &writer) const
 Serializes layer configuration and parameters to a JSON writer.
 
virtual string write_expression (const vector< string > &, const vector< string > &) const
 Returns a human-readable mathematical expression for this layer (empty by default).
 
virtual void print () const
 Prints a human-readable summary of the layer to standard output.
 
bool get_is_trainable () const
 
Type get_compute_dtype () const
 
void set_compute_dtype (Type new_compute_dtype)
 Sets the compute dtype and notifies subclasses via on_compute_dtype_changed().
 
virtual void on_compute_dtype_changed ()
 Subclass hook invoked when the compute dtype changes; default is no-op.
 
virtual float * link_states (float *pointer)
 Binds the persistent-state region of the shared buffer to operator views.
 
float * link_gradients (float *pointer, vector< TensorView > &gradient_views)
 Binds the gradient slice of the shared buffer to operator gradient views.
 
vector< TensorView > & get_parameter_views ()
 
const vector< TensorView > & get_parameter_views () const
 
void redistribute_parameters_to_operators ()
 Re-binds operator parameter views after the parameter buffer has been resized or moved.
 

Additional Inherited Members

- Protected Types inherited from opennn::Layer
enum  Forward { Input , Output }
 
enum  Backward { OutputDelta , InputDelta }
 
- Protected Member Functions inherited from opennn::Layer
 Layer ()=default
 
 Layer (LayerType t, bool trainable=true)
 
float * link_views_to_operators (vector< TensorView > &views, float *pointer, vector< TensorSpec >(Operator::*specs_fn)() const, void(Operator::*link_fn)(span< const TensorView >))
 
- Protected Attributes inherited from opennn::Layer
string label = "my_layer"
 
LayerType layer_type = LayerType::Dense
 
bool is_trainable = true
 
Shape input_shape
 
Type compute_dtype = Type::FP32
 
vector< TensorViewparameters
 
vector< TensorViewstates
 
vector< Operator * > operators
 

Detailed Description

Sequence pooling layer reducing the time axis of a (sequence, features) input.

Constructor & Destructor Documentation

◆ Pooling3d()

opennn::Pooling3d::Pooling3d ( const Shape & = {0, 0},
const PoolingMethod & = PoolingMethod::MaxPooling,
const string & = "sequence_pooling_layer" )

Constructs a sequence pooling layer.

Parameters
input_shapeShape of the input as (sequence_length, input_features).
pooling_methodReduction method applied along the sequence axis.
nameLayer name used for serialization.

Member Function Documentation

◆ get_forward_specs()

vector< TensorSpec > opennn::Pooling3d::get_forward_specs ( Index batch_size) const
overridevirtual

Returns the tensor specifications used during forward propagation.

Reimplemented from opennn::Layer.

◆ get_input_features()

Index opennn::Pooling3d::get_input_features ( ) const
inline

◆ get_input_shape()

Shape opennn::Pooling3d::get_input_shape ( ) const
inlineoverridevirtual

Returns the input tensor shape (sequence_length, input_features).

Reimplemented from opennn::Layer.

◆ get_output_shape()

Shape opennn::Pooling3d::get_output_shape ( ) const
overridevirtual

Returns the output tensor shape after sequence-axis pooling.

Implements opennn::Layer.

◆ get_pooling_method()

PoolingMethod opennn::Pooling3d::get_pooling_method ( ) const
inline

◆ get_sequence_length()

Index opennn::Pooling3d::get_sequence_length ( ) const
inline

◆ read_JSON_body()

void opennn::Pooling3d::read_JSON_body ( const Json * )
overridevirtual

Reads the layer configuration from a JSON node.

Reimplemented from opennn::Layer.

◆ set()

void opennn::Pooling3d::set ( const Shape & ,
const PoolingMethod & ,
const string &  )

Reconfigures the layer with a new input shape, pooling method and name.

◆ set_input_shape()

void opennn::Pooling3d::set_input_shape ( const Shape & new_input_shape)
inlineoverridevirtual

Updates the layer for a new input shape, preserving pooling method and label.

Reimplemented from opennn::Layer.

◆ set_output_shape()

void opennn::Pooling3d::set_output_shape ( const Shape & )
inlineoverridevirtual

Sets the output shape; subclasses override when the output is user-configurable.

Reimplemented from opennn::Layer.

◆ set_pooling_method() [1/2]

void opennn::Pooling3d::set_pooling_method ( const string & )

Sets the pooling method by name ("MaxPooling" or "AveragePooling").

◆ set_pooling_method() [2/2]

void opennn::Pooling3d::set_pooling_method ( PoolingMethod )

Sets the pooling method via enum.

◆ write_JSON_body()

void opennn::Pooling3d::write_JSON_body ( JsonWriter & ) const
overridevirtual

Writes the layer configuration to a JSON writer.

Reimplemented from opennn::Layer.