KLDivergence< InputDataType, OutputDataType > Class Template Reference

The Kullback–Leibler divergence is often used for continuous distributions (direct regression). More...

Public Member Functions
	KLDivergence (const bool takeMean=false)
	Create the Kullback–Leibler Divergence object with the specified parameters. More...
template<typename InputType , typename TargetType , typename OutputType >
void	Backward (const InputType &input, const TargetType &target, OutputType &output)
	Ordinary feed backward pass of a neural network. More...
template<typename InputType , typename TargetType >
InputType::elem_type	Forward (const InputType &input, const TargetType &target)
	Computes the Kullback–Leibler divergence error function. More...
OutputDataType &	OutputParameter () const
	Get the output parameter. More...
OutputDataType &	OutputParameter ()
	Modify the output parameter. More...
template<typename Archive >
void	serialize (Archive &ar, const unsigned int)
	Serialize the loss function. More...
bool	TakeMean () const
	Get the value of takeMean. More...
bool &	TakeMean ()
	Modify the value of takeMean. More...

Detailed Description

template<typename InputDataType = arma::mat, typename OutputDataType = arma::mat>
class mlpack::ann::KLDivergence< InputDataType, OutputDataType >

The Kullback–Leibler divergence is often used for continuous distributions (direct regression).

For more information, see the following paper.

article{Kullback1951,
  title   = {On Information and Sufficiency},
  author  = {S. Kullback, R.A. Leibler},
  journal = {The Annals of Mathematical Statistics},
  year    = {1951}
}

Template Parameters

InputDataType	Type of the input data (arma::colvec, arma::mat, arma::sp_mat or arma::cube).
OutputDataType	Type of the output data (arma::colvec, arma::mat, arma::sp_mat or arma::cube).

Definition at line 45 of file kl_divergence.hpp.

Constructor & Destructor Documentation

KLDivergence

(

const bool

takeMean = false

)

Create the Kullback–Leibler Divergence object with the specified parameters.

Parameters

takeMean

Boolean variable to specify whether to take mean or not.

Member Function Documentation

void Backward	(	const InputType &	input,
		const TargetType &	target,
		OutputType &	output
	)

Ordinary feed backward pass of a neural network.

Parameters

input	The propagated input activation.
target	The target vector.
output	The calculated error.

InputType::elem_type Forward	(	const InputType &	input,
		const TargetType &	target
	)

Computes the Kullback–Leibler divergence error function.

Parameters

input	Input data used for evaluating the specified function.
target	Target data to compare with.

OutputDataType& OutputParameter ( ) const

inline

Get the output parameter.

Definition at line 79 of file kl_divergence.hpp.

OutputDataType& OutputParameter ( )

inline

Modify the output parameter.

Definition at line 81 of file kl_divergence.hpp.

void serialize	(	Archive &	ar,
		const unsigned	int
	)

Serialize the loss function.

bool TakeMean ( ) const

inline

Get the value of takeMean.

Definition at line 84 of file kl_divergence.hpp.

bool& TakeMean ( )

inline

Modify the value of takeMean.

Definition at line 86 of file kl_divergence.hpp.

---

The documentation for this class was generated from the following file:

• src/mlpack/methods/ann/loss_functions/kl_divergence.hpp