org.deeplearning4j.nn.layers.samediff

Class SameDiffLayer

java.lang.Object

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

org.deeplearning4j.nn.layers.samediff.SameDiffLayer

All Implemented Interfaces:

Serializable, Cloneable, Layer, Model

public class SameDiffLayer
extends AbstractLayer<AbstractSameDiffLayer>

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 org.nd4j.linalg.api.ndarray.INDArray	gradients
static String	INPUT_KEY
protected List<String>	outputKeys
protected org.nd4j.linalg.api.ndarray.INDArray	params
protected Map<String,org.nd4j.linalg.api.ndarray.INDArray>	paramTable
protected org.nd4j.autodiff.samediff.SameDiff	sameDiff

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
SameDiffLayer(NeuralNetConfiguration conf)

Method Summary

Modifier and Type	Method and Description
org.nd4j.linalg.api.ndarray.INDArray	activate(boolean training, LayerWorkspaceMgr workspaceMgr) Perform forward pass and return the activations array with the last set input
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
void	clearNoiseWeightParams()
Layer	clone() Clone the layer
protected void	doInit()
org.nd4j.linalg.api.ndarray.INDArray	getGradientsViewArray()
org.nd4j.linalg.api.ndarray.INDArray	getParam(String param) Get the parameter
boolean	isPretrainLayer() Returns true if the layer can be trained in an unsupervised/pretrain manner (AE, VAE, etc)
org.nd4j.linalg.api.ndarray.INDArray	params() Returns the parameters of the neural network as a flattened row vector
Map<String,org.nd4j.linalg.api.ndarray.INDArray>	paramTable() The param table
Map<String,org.nd4j.linalg.api.ndarray.INDArray>	paramTable(boolean backpropParamsOnly) Table of parameters by key, for backprop For many models (dense layers, etc) - all parameters are backprop parameters
void	setBackpropGradientsViewArray(org.nd4j.linalg.api.ndarray.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	setParam(String key, org.nd4j.linalg.api.ndarray.INDArray val) Set the parameter with a new ndarray
void	setParams(org.nd4j.linalg.api.ndarray.INDArray params) Set the parameters for this model.
protected void	setParams(org.nd4j.linalg.api.ndarray.INDArray params, char order)
void	setParamsViewArray(org.nd4j.linalg.api.ndarray.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,org.nd4j.linalg.api.ndarray.INDArray> paramTable) Setter for the param table

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

accumulateScore, activate, addListeners, applyConstraints, applyDropOutIfNecessary, applyMask, assertInputSet, batchSize, calcL1, calcL2, clear, computeGradientAndScore, conf, feedForwardMaskArray, fit, fit, getIndex, getInput, getInputMiniBatchSize, getListeners, getMaskArray, getOptimizer, gradient, gradientAndScore, init, initParams, input, layerConf, layerId, numParams, numParams, score, setCacheMode, setConf, setIndex, setInput, setInputMiniBatchSize, setListeners, setListeners, setMaskArray, transpose, type, update, update, validateInput

Methods inherited from class java.lang.Object

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

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

getEpochCount, getIterationCount, setEpochCount, setIterationCount

Field Detail

INPUT_KEY

public static final String INPUT_KEY

See Also:

Constant Field Values

sameDiff

protected org.nd4j.autodiff.samediff.SameDiff sameDiff

outputKeys

protected List<String> outputKeys

params

protected org.nd4j.linalg.api.ndarray.INDArray params

gradients

protected org.nd4j.linalg.api.ndarray.INDArray gradients

paramTable

protected Map<String,org.nd4j.linalg.api.ndarray.INDArray> paramTable

Constructor Detail

SameDiffLayer

public SameDiffLayer(NeuralNetConfiguration conf)

Method Detail

clone

public Layer clone()

Description copied from interface: Layer

Clone the layer

Specified by:

clone in interface Layer

Specified by:

clone in class AbstractLayer<AbstractSameDiffLayer>

Returns:

isPretrainLayer

public boolean isPretrainLayer()

Description copied from interface: Layer

Returns true if the layer can be trained in an unsupervised/pretrain manner (AE, VAE, etc)

Returns:

true if the layer can be pretrained (using fit(INDArray), false otherwise

clearNoiseWeightParams

public void clearNoiseWeightParams()

activate

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

Description copied from interface: Layer

Perform forward pass and return the activations array with the last set input

Parameters:

training - training or test mode

workspaceMgr - Workspace manager

Returns:

the activation (layer output) of the last specified input. Note that the returned array should be placed in the ArrayType.ACTIVATIONS workspace via the workspace manager

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

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

params

public org.nd4j.linalg.api.ndarray.INDArray params()

Returns the parameters of the neural network as a flattened row vector

Specified by:

params in interface Model

Overrides:

params in class AbstractLayer<AbstractSameDiffLayer>

Returns:

the parameters of the neural network

getParam

public org.nd4j.linalg.api.ndarray.INDArray getParam(String param)

Description copied from interface: Model

Get the parameter

Specified by:

getParam in interface Model

Overrides:

getParam in class AbstractLayer<AbstractSameDiffLayer>

Parameters:

param - the key of the parameter

Returns:

the parameter vector/matrix with that particular key

setParam

public void setParam(String key,
                     org.nd4j.linalg.api.ndarray.INDArray val)

Description copied from interface: Model

Set the parameter with a new ndarray

Specified by:

setParam in interface Model

Overrides:

setParam in class AbstractLayer<AbstractSameDiffLayer>

Parameters:

key - the key to se t

val - the new ndarray

setParams

public void setParams(org.nd4j.linalg.api.ndarray.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

Overrides:

setParams in class AbstractLayer<AbstractSameDiffLayer>

Parameters:

params - the parameters for the model

setParams

protected void setParams(org.nd4j.linalg.api.ndarray.INDArray params,
                         char order)

Overrides:

setParams in class AbstractLayer<AbstractSameDiffLayer>

setParamsViewArray

public void setParamsViewArray(org.nd4j.linalg.api.ndarray.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

Overrides:

setParamsViewArray in class AbstractLayer<AbstractSameDiffLayer>

Parameters:

params - a 1 x nParams row vector that is a view of the larger (MLN/CG) parameters array

getGradientsViewArray

public org.nd4j.linalg.api.ndarray.INDArray getGradientsViewArray()

Specified by:

getGradientsViewArray in interface Model

Overrides:

getGradientsViewArray in class AbstractLayer<AbstractSameDiffLayer>

setBackpropGradientsViewArray

public void setBackpropGradientsViewArray(org.nd4j.linalg.api.ndarray.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

Overrides:

setBackpropGradientsViewArray in class AbstractLayer<AbstractSameDiffLayer>

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,org.nd4j.linalg.api.ndarray.INDArray> paramTable)

Description copied from interface: Model

Setter for the param table

Specified by:

setParamTable in interface Model

Overrides:

setParamTable in class AbstractLayer<AbstractSameDiffLayer>

paramTable

public Map<String,org.nd4j.linalg.api.ndarray.INDArray> paramTable()

Description copied from interface: Model

The param table

Specified by:

paramTable in interface Model

Overrides:

paramTable in class AbstractLayer<AbstractSameDiffLayer>

Returns:

paramTable

public Map<String,org.nd4j.linalg.api.ndarray.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

Overrides:

paramTable in class AbstractLayer<AbstractSameDiffLayer>

Parameters:

backpropParamsOnly - If true, return backprop params only. If false: return all params (equivalent to paramsTable())

doInit

protected void doInit()