org.deeplearning4j.nn.layers.convolution

Class Convolution3DLayer

java.lang.Object

org.deeplearning4j.nn.layers.AbstractLayer<LayerConfT>

org.deeplearning4j.nn.layers.BaseLayer<ConvolutionLayer>

org.deeplearning4j.nn.layers.convolution.ConvolutionLayer

org.deeplearning4j.nn.layers.convolution.Convolution3DLayer

All Implemented Interfaces:

Serializable, Cloneable, Layer, Model

public class Convolution3DLayer
extends ConvolutionLayer

3D convolution layer implementation.

Author:

Max Pumperla

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.deeplearning4j.nn.api.Layer

Layer.TrainingMode, Layer.Type

Field Summary

Fields inherited from class org.deeplearning4j.nn.layers.convolution.ConvolutionLayer

convolutionMode, dummyBias, dummyBiasGrad, helper, helperCountFail, i2d, log

Fields inherited from class org.deeplearning4j.nn.layers.BaseLayer

gradient, gradientsFlattened, gradientViews, optimizer, params, paramsFlattened, score, solver, weightNoiseParams

Fields inherited from class org.deeplearning4j.nn.layers.AbstractLayer

cacheMode, conf, dropoutApplied, dropoutMask, epochCount, index, input, iterationCount, maskArray, maskState, preOutput, trainingListeners

Constructor Summary

Constructors

Constructor and Description
Convolution3DLayer(NeuralNetConfiguration conf)
Convolution3DLayer(NeuralNetConfiguration conf, org.nd4j.linalg.api.ndarray.INDArray input)

Method Summary

Modifier and Type	Method and Description
org.nd4j.linalg.primitives.Pair<Gradient,org.nd4j.linalg.api.ndarray.INDArray>	backpropGradient(org.nd4j.linalg.api.ndarray.INDArray epsilon, LayerWorkspaceMgr workspaceMgr) Calculate the gradient relative to the error in the next layer
protected org.nd4j.linalg.primitives.Pair<org.nd4j.linalg.api.ndarray.INDArray,org.nd4j.linalg.api.ndarray.INDArray>	preOutput(boolean training, boolean forBackprop, LayerWorkspaceMgr workspaceMgr) PreOutput method that also returns the im2col2d array (if being called for backprop), as this can be re-used instead of being calculated again.
org.nd4j.linalg.api.ndarray.INDArray	preOutput(boolean training, LayerWorkspaceMgr workspaceMgr)

Methods inherited from class org.deeplearning4j.nn.layers.convolution.ConvolutionLayer

activate, fit, hasBias, isPretrainLayer, params, preOutput4d, setParams, transpose, type

Methods inherited from class org.deeplearning4j.nn.layers.BaseLayer

accumulateScore, calcL1, calcL2, clear, clearNoiseWeightParams, clone, computeGradientAndScore, fit, getGradientsViewArray, getOptimizer, getParam, getParamWithNoise, gradient, initParams, layerConf, numParams, paramTable, paramTable, score, setBackpropGradientsViewArray, setParam, setParams, setParamsViewArray, setParamTable, setScoreWithZ, toString, update, update

Methods inherited from class org.deeplearning4j.nn.layers.AbstractLayer

activate, addListeners, applyConstraints, applyDropOutIfNecessary, applyMask, assertInputSet, batchSize, conf, feedForwardMaskArray, getIndex, getInput, getInputMiniBatchSize, getListeners, getMaskArray, gradientAndScore, init, input, layerId, numParams, setCacheMode, setConf, setIndex, setInput, setInputMiniBatchSize, setListeners, setListeners, setMaskArray, validateInput

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.deeplearning4j.nn.api.Layer

getEpochCount, getIterationCount, setEpochCount, setIterationCount

Constructor Detail

Convolution3DLayer

public Convolution3DLayer(NeuralNetConfiguration conf)

Convolution3DLayer

public Convolution3DLayer(NeuralNetConfiguration conf,
                          org.nd4j.linalg.api.ndarray.INDArray input)

Method Detail

backpropGradient

public org.nd4j.linalg.primitives.Pair<Gradient,org.nd4j.linalg.api.ndarray.INDArray> backpropGradient(org.nd4j.linalg.api.ndarray.INDArray epsilon,
                                                                                                       LayerWorkspaceMgr workspaceMgr)

Description copied from interface: Layer

Calculate the gradient relative to the error in the next layer

Specified by:

backpropGradient in interface Layer

Overrides:

backpropGradient in class ConvolutionLayer

Parameters:

epsilon - w^(L+1)*delta^(L+1). Or, equiv: dC/da, i.e., (dC/dz)*(dz/da) = dC/da, where C is cost function a=sigma(z) is activation.

workspaceMgr - Workspace manager

Returns:

Pair where Gradient is gradient for this layer, INDArray is epsilon (activation gradient) needed by next layer, but before element-wise multiply by sigmaPrime(z). So for standard feed-forward layer, if this layer is L, then return.getSecond() == dL/dIn = (w^(L)*(delta^(L))^T)^T. Note that the returned array should be placed in the ArrayType.ACTIVATION_GRAD workspace via the workspace manager

preOutput

public org.nd4j.linalg.api.ndarray.INDArray preOutput(boolean training,
                                                      LayerWorkspaceMgr workspaceMgr)

Overrides:

preOutput in class BaseLayer<ConvolutionLayer>

preOutput

protected org.nd4j.linalg.primitives.Pair<org.nd4j.linalg.api.ndarray.INDArray,org.nd4j.linalg.api.ndarray.INDArray> preOutput(boolean training,
                                                                                                                               boolean forBackprop,
                                                                                                                               LayerWorkspaceMgr workspaceMgr)

Description copied from class: ConvolutionLayer

PreOutput method that also returns the im2col2d array (if being called for backprop), as this can be re-used instead of being calculated again.

Overrides:

preOutput in class ConvolutionLayer

Parameters:

training - Train or test time (impacts dropout)

forBackprop - If true: return the im2col2d array for re-use during backprop. False: return null for second pair entry. Note that it may still be null in the case of CuDNN and the like.

Returns:

Pair of arrays: preOutput (activations) and optionally the im2col2d array