AbstractLayer (deeplearning4j-nn 1.0.0-beta7 API)

java.lang.Object
- org.deeplearning4j.nn.layers.AbstractLayer<LayerConfT>

All Implemented Interfaces:

Serializable, Cloneable, Layer, Model, Trainable

Direct Known Subclasses:

ActivationLayer, BaseLayer, Cropping1DLayer, Cropping2DLayer, Cropping3DLayer, GlobalPoolingLayer, LocalResponseNormalization, MaskLayer, RepeatVector, SameDiffLayer, SameDiffOutputLayer, SpaceToBatch, SpaceToDepth, Subsampling3DLayer, SubsamplingLayer, Upsampling2D, Upsampling3D, Yolo2OutputLayer, ZeroPadding1DLayer, ZeroPadding3DLayer, ZeroPaddingLayer
```
public abstract class AbstractLayer<LayerConfT extends Layer>
extends Object
implements Layer
```
A layer with input and output, no parameters or gradients

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
Modifier and Type	Field and Description
`protected CacheMode`	`cacheMode`
`protected NeuralNetConfiguration`	`conf`
`protected DataType`	`dataType`
`protected boolean`	`dropoutApplied`
`protected int`	`epochCount`
`protected int`	`index`
`protected INDArray`	`input`
`protected boolean`	`inputModificationAllowed`
`protected int`	`iterationCount`
`protected INDArray`	`maskArray`
`protected MaskState`	`maskState`
`protected INDArray`	`preOutput`
`protected Collection<TrainingListener>`	`trainingListeners`

Constructor Summary

Constructors
Constructor and Description

AbstractLayer(NeuralNetConfiguration conf, DataType dataType)

Constructors
Constructor and Description
`AbstractLayer(NeuralNetConfiguration conf, DataType dataType)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`INDArray`	`activate(INDArray input, boolean training, LayerWorkspaceMgr workspaceMgr)` Perform forward pass and return the activations array with the specified input
`void`	`addListeners(TrainingListener... listeners)` This method ADDS additional TrainingListener to existing listeners
`void`	`allowInputModification(boolean allow)` A performance optimization: mark whether the layer is allowed to modify its input array in-place.
`void`	`applyConstraints(int iteration, int epoch)` Apply any constraints to the model
`protected void`	`applyDropOutIfNecessary(boolean training, LayerWorkspaceMgr workspaceMgr)`
`protected void`	`applyMask(INDArray to)`
`void`	`assertInputSet(boolean backprop)`
`protected INDArray`	`backpropDropOutIfPresent(INDArray epsilon)`
`int`	`batchSize()` The current inputs batch size
`double`	`calcRegularizationScore(boolean backpropParamsOnly)` Calculate the regularization component of the score, for the parameters in this layer For example, the L1, L2 and/or weight decay components of the loss function
`void`	`clear()` Clear input
`void`	`close()`
`void`	`computeGradientAndScore(LayerWorkspaceMgr workspaceMgr)` Update the score
`NeuralNetConfiguration`	`conf()` The configuration for the neural network
`Pair<INDArray,MaskState>`	`feedForwardMaskArray(INDArray maskArray, MaskState currentMaskState, int minibatchSize)` Feed forward the input mask array, setting in the layer as appropriate.
`void`	`fit()` All models have a fit method
`void`	`fit(INDArray input, LayerWorkspaceMgr workspaceMgr)` Fit the model to the given data
`TrainingConfig`	`getConfig()`
`int`	`getEpochCount()`
`INDArray`	`getGradientsViewArray()`
`LayerHelper`	`getHelper()`
`int`	`getIndex()` Get the layer index.
`INDArray`	`getInput()`
`int`	`getInputMiniBatchSize()` Get current/last input mini-batch size, as set by setInputMiniBatchSize(int)
`Collection<TrainingListener>`	`getListeners()` Get the iteration listeners for this layer.
`INDArray`	`getMaskArray()`
`ConvexOptimizer`	`getOptimizer()` Returns this models optimizer
`INDArray`	`getParam(String param)` Get the parameter
`Gradient`	`gradient()` Get the gradient.
`Pair<Gradient,Double>`	`gradientAndScore()` Get the gradient and score
`void`	`init()` Init the model
`INDArray`	`input()` The input/feature matrix for the model
`LayerConfT`	`layerConf()`
`protected String`	`layerId()`
`long`	`numParams()` The number of parameters for the model
`long`	`numParams(boolean backwards)` the number of parameters for the model
`INDArray`	`params()` Returns the parameters of the neural network as a flattened row vector
`Map<String,INDArray>`	`paramTable()` The param table
`Map<String,INDArray>`	`paramTable(boolean backpropParamsOnly)` Table of parameters by key, for backprop For many models (dense layers, etc) - all parameters are backprop parameters
`double`	`score()` The score for the model
`void`	`setBackpropGradientsViewArray(INDArray gradients)` Set the gradients array as a view of the full (backprop) network parameters NOTE: this is intended to be used internally in MultiLayerNetwork and ComputationGraph, not by users.
`void`	`setCacheMode(CacheMode mode)` This method sets given CacheMode for current layer
`void`	`setConf(NeuralNetConfiguration conf)` Setter for the configuration
`void`	`setEpochCount(int epochCount)` Set the current epoch count (number of epochs passed ) for the layer/network
`void`	`setIndex(int index)` Set the layer index.
`void`	`setInput(INDArray input, LayerWorkspaceMgr workspaceMgr)` Set the layer input.
`void`	`setInputMiniBatchSize(int size)` Set current/last input mini-batch size. Used for score and gradient calculations.
`void`	`setListeners(Collection<TrainingListener> listeners)` Set the `TrainingListener`s for this model.
`void`	`setListeners(TrainingListener... listeners)` Set the `TrainingListener`s for this model.
`void`	`setMaskArray(INDArray maskArray)` Set the mask array.
`void`	`setParam(String key, INDArray val)` Set the parameter with a new ndarray
`void`	`setParams(INDArray params)` Set the parameters for this model.
`protected void`	`setParams(INDArray params, char order)`
`void`	`setParamsViewArray(INDArray params)` Set the initial parameters array as a view of the full (backprop) network parameters NOTE: this is intended to be used internally in MultiLayerNetwork and ComputationGraph, not by users.
`void`	`setParamTable(Map<String,INDArray> paramTable)` Setter for the param table
`Layer.Type`	`type()` Returns the layer type
`void`	`update(Gradient gradient)` Update layer weights and biases with gradient change
`void`	`update(INDArray gradient, String paramType)` Perform one update applying the gradient
`boolean`	`updaterDivideByMinibatch(String paramName)` DL4J layers typically produce the sum of the gradients during the backward pass for each layer, and if required (if minibatch=true) then divide by the minibatch size. However, there are some exceptions, such as the batch norm mean/variance estimate parameters: these "gradients" are actually not gradients, but are updates to be applied directly to the parameter vector.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.deeplearning4j.nn.api.Layer
activate, backpropGradient, clearNoiseWeightParams, getIterationCount, isPretrainLayer, setIterationCount

- Field Detail
  - input
```
protected INDArray input
```
  - preOutput
```
protected INDArray preOutput
```
  - conf
```
protected NeuralNetConfiguration conf
```
  - dropoutApplied
```
protected boolean dropoutApplied
```
  - trainingListeners
```
protected Collection<TrainingListener> trainingListeners
```
  - index
```
protected int index
```
  - maskArray
```
protected INDArray maskArray
```
  - maskState
```
protected MaskState maskState
```
  - cacheMode
```
protected CacheMode cacheMode
```
  - inputModificationAllowed
```
protected boolean inputModificationAllowed
```
  - dataType
```
protected DataType dataType
```
  - iterationCount
```
protected int iterationCount
```
  - epochCount
```
protected int epochCount
```
- Constructor Detail
  - AbstractLayer
```
public AbstractLayer(NeuralNetConfiguration conf,
                     DataType dataType)
```
- Method Detail
  - setCacheMode
```
public void setCacheMode(CacheMode mode)
```
    Description copied from interface: Layer
    
    This method sets given CacheMode for current layer
    
    Specified by:
    
    setCacheMode in interface Layer
  - layerConf
```
public LayerConfT layerConf()
```
  - getConfig
```
public TrainingConfig getConfig()
```
    Specified by:
    
    getConfig in interface Trainable
    
    Returns:
    
    Training configuration
  - layerId
```
protected String layerId()
```
  - getInput
```
public INDArray getInput()
```
  - getEpochCount
```
public int getEpochCount()
```
    Specified by:
    
    getEpochCount in interface Layer
    
    Returns:
    
    The current epoch count (number of training epochs passed) for the layer/network
  - setEpochCount
```
public void setEpochCount(int epochCount)
```
    Description copied from interface: Layer
    
    Set the current epoch count (number of epochs passed ) for the layer/network
    
    Specified by:
    
    setEpochCount in interface Layer
  - init
```
public void init()
```
    Init the model
    
    Specified by:
    
    init in interface Model
  - setInput
```
public void setInput(INDArray input,
                     LayerWorkspaceMgr workspaceMgr)
```
    Description copied from interface: Layer
    
    Set the layer input.
    
    Specified by:
    
    setInput in interface Layer
  - getIndex
```
public int getIndex()
```
    Description copied from interface: Layer
    
    Get the layer index.
    
    Specified by:
    
    getIndex in interface Layer
  - setIndex
```
public void setIndex(int index)
```
    Description copied from interface: Layer
    
    Set the layer index.
    
    Specified by:
    
    setIndex in interface Layer
  - getListeners
```
public Collection<TrainingListener> getListeners()
```
    Description copied from interface: Layer
    
    Get the iteration listeners for this layer.
    
    Specified by:
    
    getListeners in interface Layer
  - setListeners
```
public void setListeners(Collection<TrainingListener> listeners)
```
    Description copied from interface: Layer
    
    Set the TrainingListeners for this model. If any listeners have previously been set, they will be replaced by this method
    
    Specified by:
    
    setListeners in interface Layer
    
    Specified by:
    
    setListeners in interface Model
  - addListeners
```
public void addListeners(TrainingListener... listeners)
```
    This method ADDS additional TrainingListener to existing listeners
    
    Specified by:
    
    addListeners in interface Model
    
    Parameters:
    
    listeners -
  - setListeners
```
public void setListeners(TrainingListener... listeners)
```
    Description copied from interface: Layer
    
    Set the TrainingListeners for this model. If any listeners have previously been set, they will be replaced by this method
    
    Specified by:
    
    setListeners in interface Layer
    
    Specified by:
    
    setListeners in interface Model
  - computeGradientAndScore
```
public void computeGradientAndScore(LayerWorkspaceMgr workspaceMgr)
```
    Description copied from interface: Model
    
    Update the score
    
    Specified by:
    
    computeGradientAndScore in interface Model
  - update
```
public void update(Gradient gradient)
```
    Description copied from interface: Model
    
    Update layer weights and biases with gradient change
    
    Specified by:
    
    update in interface Model
  - update
```
public void update(INDArray gradient,
                   String paramType)
```
    Description copied from interface: Model
    
    Perform one update applying the gradient
    
    Specified by:
    
    update in interface Model
    
    Parameters:
    
    gradient - the gradient to apply
  - getOptimizer
```
public ConvexOptimizer getOptimizer()
```
    Description copied from interface: Model
    
    Returns this models optimizer
    
    Specified by:
    
    getOptimizer in interface Model
    
    Returns:
    
    this models optimizer
  - setConf
```
public void setConf(NeuralNetConfiguration conf)
```
    Description copied from interface: Model
    
    Setter for the configuration
    
    Specified by:
    
    setConf in interface Model
  - params
```
public INDArray params()
```
    Returns the parameters of the neural network as a flattened row vector
    
    Specified by:
    
    params in interface Model
    
    Specified by:
    
    params in interface Trainable
    
    Returns:
    
    the parameters of the neural network
  - getParam
```
public INDArray getParam(String param)
```
    Description copied from interface: Model
    
    Get the parameter
    
    Specified by:
    
    getParam in interface Model
    
    Parameters:
    
    param - the key of the parameter
    
    Returns:
    
    the parameter vector/matrix with that particular key
  - setParam
```
public void setParam(String key,
                     INDArray val)
```
    Description copied from interface: Model
    
    Set the parameter with a new ndarray
    
    Specified by:
    
    setParam in interface Model
    
    Parameters:
    
    key - the key to se t
    
    val - the new ndarray
  - setParams
```
public void setParams(INDArray params)
```
    Description copied from interface: Model
    
    Set the parameters for this model. This expects a linear ndarray which then be unpacked internally relative to the expected ordering of the model
    
    Specified by:
    
    setParams in interface Model
    
    Parameters:
    
    params - the parameters for the model
  - setParams
```
protected void setParams(INDArray params,
                         char order)
```
  - setParamsViewArray
```
public void setParamsViewArray(INDArray params)
```
    Description copied from interface: Model
    
    Set the initial parameters array as a view of the full (backprop) network parameters NOTE: this is intended to be used internally in MultiLayerNetwork and ComputationGraph, not by users.
    
    Specified by:
    
    setParamsViewArray in interface Model
    
    Parameters:
    
    params - a 1 x nParams row vector that is a view of the larger (MLN/CG) parameters array
  - getGradientsViewArray
```
public INDArray getGradientsViewArray()
```
    Specified by:
    
    getGradientsViewArray in interface Model
    
    Specified by:
    
    getGradientsViewArray in interface Trainable
    
    Returns:
    
    1D gradients view array
  - setBackpropGradientsViewArray
```
public void setBackpropGradientsViewArray(INDArray gradients)
```
    Description copied from interface: Model
    
    Set the gradients array as a view of the full (backprop) network parameters NOTE: this is intended to be used internally in MultiLayerNetwork and ComputationGraph, not by users.
    
    Specified by:
    
    setBackpropGradientsViewArray in interface Model
    
    Parameters:
    
    gradients - a 1 x nParams row vector that is a view of the larger (MLN/CG) gradients array
  - setParamTable
```
public void setParamTable(Map<String,INDArray> paramTable)
```
    Description copied from interface: Model
    
    Setter for the param table
    
    Specified by:
    
    setParamTable in interface Model
  - paramTable
```
public Map<String,INDArray> paramTable()
```
    Description copied from interface: Model
    
    The param table
    
    Specified by:
    
    paramTable in interface Model
    
    Returns:
  - paramTable
```
public Map<String,INDArray> paramTable(boolean backpropParamsOnly)
```
    Description copied from interface: Model
    
    Table of parameters by key, for backprop For many models (dense layers, etc) - all parameters are backprop parameters
    
    Specified by:
    
    paramTable in interface Model
    
    Specified by:
    
    paramTable in interface Trainable
    
    Parameters:
    
    backpropParamsOnly - If true, return backprop params only. If false: return all params (equivalent to paramsTable())
    
    Returns:
    
    Parameter table
  - applyMask
```
protected void applyMask(INDArray to)
```
  - activate
```
public INDArray activate(INDArray input,
                         boolean training,
                         LayerWorkspaceMgr workspaceMgr)
```
    Description copied from interface: Layer
    
    Perform forward pass and return the activations array with the specified input
    
    Specified by:
    
    activate in interface Layer
    
    Parameters:
    
    input - the input to use
    
    training - train or test mode
    
    workspaceMgr - Workspace manager.
    
    Returns:
    
    Activations array. Note that the returned array should be placed in the ArrayType.ACTIVATIONS workspace via the workspace manager
  - calcRegularizationScore
```
public double calcRegularizationScore(boolean backpropParamsOnly)
```
    Description copied from interface: Layer
    
    Calculate the regularization component of the score, for the parameters in this layer
    For example, the L1, L2 and/or weight decay components of the loss function
    
    Specified by:
    
    calcRegularizationScore in interface Layer
    
    Parameters:
    
    backpropParamsOnly - If true: calculate regularization score based on backprop params only. If false: calculate based on all params (including pretrain params, if any)
    
    Returns:
    
    the regularization score of
  - batchSize
```
public int batchSize()
```
    Description copied from interface: Model
    
    The current inputs batch size
    
    Specified by:
    
    batchSize in interface Model
    
    Returns:
    
    the current inputs batch size
  - conf
```
public NeuralNetConfiguration conf()
```
    Description copied from interface: Model
    
    The configuration for the neural network
    
    Specified by:
    
    conf in interface Model
    
    Returns:
    
    the configuration for the neural network
  - clear
```
public void clear()
```
    Description copied from interface: Model
    
    Clear input
    
    Specified by:
    
    clear in interface Model
  - applyDropOutIfNecessary
```
protected void applyDropOutIfNecessary(boolean training,
                                       LayerWorkspaceMgr workspaceMgr)
```
  - backpropDropOutIfPresent
```
protected INDArray backpropDropOutIfPresent(INDArray epsilon)
```
  - type
```
public Layer.Type type()
```
    Description copied from interface: Layer
    
    Returns the layer type
    
    Specified by:
    
    type in interface Layer
    
    Returns:
  - numParams
```
public long numParams()
```
    The number of parameters for the model
    
    Specified by:
    
    numParams in interface Model
    
    Specified by:
    
    numParams in interface Trainable
    
    Returns:
    
    the number of parameters for the model
  - numParams
```
public long numParams(boolean backwards)
```
    Description copied from interface: Model
    
    the number of parameters for the model
    
    Specified by:
    
    numParams in interface Model
    
    Returns:
    
    the number of parameters for the model
  - fit
```
public void fit(INDArray input,
                LayerWorkspaceMgr workspaceMgr)
```
    Description copied from interface: Model
    
    Fit the model to the given data
    
    Specified by:
    
    fit in interface Model
    
    Parameters:
    
    input - the data to fit the model to
  - gradientAndScore
```
public Pair<Gradient,Double> gradientAndScore()
```
    Description copied from interface: Model
    
    Get the gradient and score
    
    Specified by:
    
    gradientAndScore in interface Model
    
    Returns:
    
    the gradient and score
  - input
```
public INDArray input()
```
    Description copied from interface: Model
    
    The input/feature matrix for the model
    
    Specified by:
    
    input in interface Model
    
    Returns:
    
    the input/feature matrix for the model
  - setInputMiniBatchSize
```
public void setInputMiniBatchSize(int size)
```
    Description copied from interface: Layer
    
    Set current/last input mini-batch size.
    Used for score and gradient calculations. Mini batch size may be different from getInput().size(0) due to reshaping operations - for example, when using RNNs with DenseLayer and OutputLayer. Called automatically during forward pass.
    
    Specified by:
    
    setInputMiniBatchSize in interface Layer
  - getInputMiniBatchSize
```
public int getInputMiniBatchSize()
```
    Description copied from interface: Layer
    
    Get current/last input mini-batch size, as set by setInputMiniBatchSize(int)
    
    Specified by:
    
    getInputMiniBatchSize in interface Layer
    
    See Also:
    
    Layer.setInputMiniBatchSize(int)
  - setMaskArray
```
public void setMaskArray(INDArray maskArray)
```
    Description copied from interface: Layer
    
    Set the mask array. Note: In general, Layer.feedForwardMaskArray(INDArray, MaskState, int) should be used in preference to this.
    
    Specified by:
    
    setMaskArray in interface Layer
    
    Parameters:
    
    maskArray - Mask array to set
  - getMaskArray
```
public INDArray getMaskArray()
```
    Specified by:
    
    getMaskArray in interface Layer
  - feedForwardMaskArray
```
public Pair<INDArray,MaskState> feedForwardMaskArray(INDArray maskArray,
                                                     MaskState currentMaskState,
                                                     int minibatchSize)
```
    Description copied from interface: Layer
    
    Feed forward the input mask array, setting in the layer as appropriate. This allows different layers to handle masks differently - for example, bidirectional RNNs and normal RNNs operate differently with masks (the former sets activations to 0 outside of the data present region (and keeps the mask active for future layers like dense layers), whereas normal RNNs don't zero out the activations/errors )instead relying on backpropagated error arrays to handle the variable length case.
    This is also used for example for networks that contain global pooling layers, arbitrary preprocessors, etc.
    
    Specified by:
    
    feedForwardMaskArray in interface Layer
    
    Parameters:
    
    maskArray - Mask array to set
    
    currentMaskState - Current state of the mask - see MaskState
    
    minibatchSize - Current minibatch size. Needs to be known as it cannot always be inferred from the activations array due to reshaping (such as a DenseLayer within a recurrent neural network)
    
    Returns:
    
    New mask array after this layer, along with the new mask state.
  - gradient
```
public Gradient gradient()
```
    Description copied from interface: Model
    
    Get the gradient. Note that this method will not calculate the gradient, it will rather return the gradient that has been computed before. For calculating the gradient, see Model.computeGradientAndScore(LayerWorkspaceMgr) } .
    
    Specified by:
    
    gradient in interface Model
    
    Returns:
    
    the gradient for this model, as calculated before
  - fit
```
public void fit()
```
    Description copied from interface: Model
    
    All models have a fit method
    
    Specified by:
    
    fit in interface Model
  - score
```
public double score()
```
    Description copied from interface: Model
    
    The score for the model
    
    Specified by:
    
    score in interface Model
    
    Returns:
    
    the score for the model
  - applyConstraints
```
public void applyConstraints(int iteration,
                             int epoch)
```
    Description copied from interface: Model
    
    Apply any constraints to the model
    
    Specified by:
    
    applyConstraints in interface Model
  - assertInputSet
```
public void assertInputSet(boolean backprop)
```
  - allowInputModification
```
public void allowInputModification(boolean allow)
```
    Description copied from interface: Layer
    
    A performance optimization: mark whether the layer is allowed to modify its input array in-place. In many cases, this is totally safe - in others, the input array will be shared by multiple layers, and hence it's not safe to modify the input array. This is usually used by ops such as dropout.
    
    Specified by:
    
    allowInputModification in interface Layer
    
    Parameters:
    
    allow - If true: the input array is safe to modify. If false: the input array should be copied before it is modified (i.e., in-place modifications are un-safe)
  - getHelper
```
public LayerHelper getHelper()
```
    Specified by:
    
    getHelper in interface Layer
    
    Returns:
    
    Get the layer helper, if any
  - updaterDivideByMinibatch
```
public boolean updaterDivideByMinibatch(String paramName)
```
    Description copied from interface: Trainable
    
    DL4J layers typically produce the sum of the gradients during the backward pass for each layer, and if required (if minibatch=true) then divide by the minibatch size.
    However, there are some exceptions, such as the batch norm mean/variance estimate parameters: these "gradients" are actually not gradients, but are updates to be applied directly to the parameter vector. Put another way, most gradients should be divided by the minibatch to get the average; some "gradients" are actually final updates already, and should not be divided by the minibatch size.
    
    Specified by:
    
    updaterDivideByMinibatch in interface Trainable
    
    Parameters:
    
    paramName - Name of the parameter
    
    Returns:
    
    True if gradients should be divided by minibatch (most params); false otherwise (edge cases like batch norm mean/variance estimates)
  - close
```
public void close()
```
    Specified by:
    
    close in interface Model

Class AbstractLayer<LayerConfT extends Layer>

Nested Class Summary

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

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

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

Field Detail

input

preOutput

conf

dropoutApplied

trainingListeners

index

maskArray

maskState

cacheMode

inputModificationAllowed

dataType

iterationCount

epochCount

Constructor Detail

AbstractLayer

Method Detail

setCacheMode

layerConf

getConfig

layerId

getInput

getEpochCount

setEpochCount

init

setInput

getIndex

setIndex

getListeners

setListeners

addListeners

setListeners

computeGradientAndScore

update

update

getOptimizer

setConf

params

getParam

setParam

setParams

setParams

setParamsViewArray

getGradientsViewArray

setBackpropGradientsViewArray

setParamTable

paramTable

paramTable

applyMask

activate

calcRegularizationScore

batchSize

conf

clear

applyDropOutIfNecessary

backpropDropOutIfPresent

type

numParams

numParams

fit

gradientAndScore

input

setInputMiniBatchSize

getInputMiniBatchSize

setMaskArray

getMaskArray

feedForwardMaskArray

gradient

fit

score

applyConstraints

assertInputSet