Welcome to our Support Center

Convolution 3D

Description

Setup and add the convolution 3D layer into the model during the definition graph step. Type : polymorphic.

 

Input parameters

 

Graph in : model architecture.

parameters : layer parameters.

n_filters : integer, the dimensionality of the output space.
Default value “3”.
sizeย : array integer, specify the depth, height and width of the 3D convolution window. Can be a single integer to specify the same value for all spatial dimensions.
Default value “[3,3,3]”. Never more 3 values
strideย : array integer, specify the strides of the convolution along the depth, height and width. Can be a single integer to specify the same value for all spatial dimensions.
Default value “[1,1,1]”. Never more 3 values
dilation_rate : integer,ย specifying the dilation rate to use for dilated convolution.
Default value โ€œ[1,1,1]โ€. Never more 3 values
activation : enum, activation function to use.
Default value “relu”.
use_bias? : boolean, whether the layer uses a bias vector.
Default value “True”.
paddingย : boolean, False = “valid” means no padding. True = “same” results in padding with zeros evenly to the left/right or up/down of the input such that output has the same height/width dimension as the input.
Default value “False”.
ย data_format :ย enum, one ofย channels_lastย orย channels_firstย (default) . The ordering of the dimensions in the inputs.ย channel_lastย corresponds to inputs with shapeย (batch, steps, features)ย whileย channels_firstย corresponds to inputs with shapeย (batch, features, steps).
Default value โ€œchannels_firstโ€.
optimizer :

ย algorithm : enum, (name of optimizer) for optimizer instance.
Default value “adam”.
learning_rate : float, define the learning rate to use.
Default value “0.001”.
beta_1 : float, define the exponential decay rate for the 1st moment estimates.
Default value “0.9”.
beta_2 : float, define the exponential decay rate for the 2nd moment estimates.
Default value “0.999”.

filter_initializerย : enum, initializer for the kernel weights matrix.
Default value “glorot_uniform”.
bias_initializerย : enum, initializer for the bias vector.
Default value “zero”.
training?ย : boolean, whether the layer is in training mode (can store data for backward).
Default value “True”.
store?ย : boolean, whether the layer stores the last iteration gradient (accessible via the “get_gradients” function).
Default value “False”.
update?ย : boolean, whether the layer’s variables should be updated during backward. Equivalent to freeze the layer.
Default value “True”.
lda_coeff : float, defines the coefficient by which the loss derivative will be multiplied before being sent to the previous layer (since during the backward run we go backwards).
Default value “1”.

in/out param :

input_shape : integer array, shape (not including the batch axis). NB : To be used only if it is the first layer of the model.
ย output_behaviorย :ย enum, setup if the layer is an output layer.
Default โ€œNot Outputโ€โ€‹โ€‹โ€‹.

name (optional) : string, name of the layer.

 

Output parameters

 

Graph out : model architecture.

Dimension

Input shape

5-Dimension tensor with shape : [batch_size, channel, conv_dim1, conv_dim2, conv_dim3] (default โ€œchannel_first” parameters).
In case of “channel_last” setup, forward function will input shape [batch_size, conv_dim1, conv_dim2, conv_dim3, channel].

 

Output shape

Same shape as input 5-Dimension tensor with shape : [batch_size, channel, conv_dim1, conv_dim2 , conv_dim3] (default โ€œchannel_first” parameters).
In case of “channel_last” setup, forward function will input shape [batch_size, conv_dim1, conv_dim2, conv_dim3, channel].

Example

All these exemples are snippets PNG, you can drop these Snippet onto the block diagram and get the depicted code added to your VI (Do not forget to install HAIBAL library to run it).

Convolution 3D layer with explicit input layer

1 – Generate a set of data

We generate an array of data of type single and shape [batch_size = 10, channel = 5, conv_dim1 = 64, conv_dim2 = 64, conv_dim3 = 3] (channel first default layer configuration).
In case of channel last layer configuration, shape is [batch_size, conv_dim1, conv_dim2, conv_dim3, channel].

2 – Define graph

First, we define the first layer of the graph which is an Input layer (explicit input layer method). This layer is setup as an input array shaped [channel = 5, conv_dim1 = 64, conv_dim2 = 64, conv_dim3 = 3].
Then we add to the graph the Conv3D layer.

3 – Run graph

We call the forward method and retrieve the result with the โ€œPrediction 5Dโ€ method.
This method returns two variables, the first one is the layer information (cluster composed of the layer name, the graph index and the shape of the output layer) and the second one is the prediction with a shape of [batch_size, filter, new_conv_dim1, new_conv_dim2, new_conv_dim3].

 

Convolution 3D layer with implicit input layer

1 – Generate a set of data

We generate an array of data of type single and shape [batch_size = 10, channel = 5, conv_dim1 = 64, conv_dim2 = 64, conv_dim3 = 3] (channel first default layer configuration).
In case of channel last layer configuration, shape is [batch_size, conv_dim1, conv_dim2, conv_dim3, channel].

2 – Define graph

First, we define the Conv3D layer as the input layer of the graph (implicit input layer method). To do this, we send in the โ€œinput_shapeโ€ variable of the โ€œin/out paramโ€ cluster an array of shape [channel = 5, conv_dim1 = 64, conv_dim2 = 64, conv_dim3 = 3].
An input layer will be implicitly created and the name of this input layer will be the same name as its parent prefixed with โ€œinput_โ€.
Then we add to the graph the Conv3D layer.

3 – Run graph

We call the forward method and retrieve the result with the โ€œPrediction 5Dโ€ method.
This method returns two variables, the first one is the layer information (cluster composed of the layer name, the graph index and the shape of the output layer) and the second one is the prediction with a shape of [batch_size, filter, new_conv_dim1, new_conv_dim2, new_conv_dim3].

 

Convolution 3D layer, batch and dimension

1 – Generate a set of data

We generate an array of data of type single and shape [number of batch = 9, batch_size = 10, channel = 5, conv_dim1 = 64, conv_dim2 = 64, conv_dim3 = 3] (channel first default layer configuration).
In case of channel last layer configuration, shape is [batch_size, conv_dim1, conv_dim2, conv_dim3, channel].

2 – Define graph

First, we define the first layer of the graph which is an Input layer (explicit input layer method). This layer is setup as an input array shaped [channel = 5, conv_dim1 = 64, conv_dim2 = 64, conv_dim3 = 3].
Then we add to the graph the Conv3D layer.

3 – Run graph

We call the forward method and retrieve the result with the โ€œPrediction 5Dโ€ method.
This method returns two variables, the first one is the layer information (cluster composed of the layer name, the graph index and the shape of the output layer) and the second one is the prediction with a shape of [batch_size, filter, new_conv_dim1, new_conv_dim2, new_conv_dim3].

 

Table of Contents
Index