mlpack  master
Public Member Functions | Private Attributes | List of all members
mlpack::amf::CompleteIncrementalTermination< TerminationPolicy > Class Template Reference

This class acts as a wrapper for basic termination policies to be used by SVDCompleteIncrementalLearning. More...

Public Member Functions

 CompleteIncrementalTermination (TerminationPolicy tPolicy=TerminationPolicy())
 Empty constructor. More...
 
const double & Index () const
 Get current value of residue. More...
 
template<class MatType >
void Initialize (const MatType &V)
 Initializes the termination policy before stating the factorization. More...
 
void Initialize (const arma::sp_mat &V)
 Initializes the termination policy before stating the factorization. More...
 
bool IsConverged (arma::mat &W, arma::mat &H)
 Check if termination criterion is met, if the current iteration means that each point has been visited. More...
 
const size_t & Iteration () const
 Get current iteration count. More...
 
const size_t & MaxIterations () const
 Access upper limit of iteration count. More...
 
size_t & MaxIterations ()
 Modify maximum number of iterations. More...
 
const TerminationPolicy & TPolicy () const
 Access the wrapped termination policy. More...
 
TerminationPolicy & TPolicy ()
 Modify the wrapped termination policy. More...
 

Private Attributes

size_t incrementalIndex
 Number of iterations after which wrapped termination policy will be called. More...
 
size_t iteration
 Current iteration number. More...
 
TerminationPolicy tPolicy
 Wrapped termination policy. More...
 

Detailed Description

template<class TerminationPolicy>
class mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >

This class acts as a wrapper for basic termination policies to be used by SVDCompleteIncrementalLearning.

This class calls the wrapped class functions after every n calls to main class functions where n is the number of non-zero entries in the matrix being factorized. This is necessary for SVDCompleteIncrementalLearning, because otherwise IsConverged() is called after every point, which is very slow.

See also
AMF, SVDCompleteIncrementalLearning

Definition at line 29 of file complete_incremental_termination.hpp.

Constructor & Destructor Documentation

template<class TerminationPolicy >
mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::CompleteIncrementalTermination ( TerminationPolicy  tPolicy = TerminationPolicy())
inline

Empty constructor.

Parameters
tPolicyobject of wrapped class.

Definition at line 37 of file complete_incremental_termination.hpp.

Member Function Documentation

template<class TerminationPolicy >
const double& mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::Index ( ) const
inline

Get current value of residue.

Definition at line 92 of file complete_incremental_termination.hpp.

References mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::tPolicy.

template<class TerminationPolicy >
template<class MatType >
void mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::Initialize ( const MatType &  V)
inline
template<class TerminationPolicy >
void mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::Initialize ( const arma::sp_mat &  V)
inline

Initializes the termination policy before stating the factorization.

This is a specialization for sparse matrices.

Parameters
VInput matrix to be factorized.

Definition at line 62 of file complete_incremental_termination.hpp.

References mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::incrementalIndex, mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::iteration, and mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::tPolicy.

template<class TerminationPolicy >
bool mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::IsConverged ( arma::mat &  W,
arma::mat &  H 
)
inline

Check if termination criterion is met, if the current iteration means that each point has been visited.

Parameters
WBasis matrix of output.
HEncoding matrix of output.

Definition at line 78 of file complete_incremental_termination.hpp.

References mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::incrementalIndex, mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::iteration, and mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::tPolicy.

template<class TerminationPolicy >
const size_t& mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::Iteration ( ) const
inline
template<class TerminationPolicy >
const size_t& mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::MaxIterations ( ) const
inline

Access upper limit of iteration count.

Definition at line 98 of file complete_incremental_termination.hpp.

References mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::tPolicy.

template<class TerminationPolicy >
size_t& mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::MaxIterations ( )
inline

Modify maximum number of iterations.

Definition at line 100 of file complete_incremental_termination.hpp.

References mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::tPolicy.

template<class TerminationPolicy >
const TerminationPolicy& mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::TPolicy ( ) const
inline

Access the wrapped termination policy.

Definition at line 103 of file complete_incremental_termination.hpp.

References mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::tPolicy.

template<class TerminationPolicy >
TerminationPolicy& mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::TPolicy ( )
inline

Modify the wrapped termination policy.

Definition at line 105 of file complete_incremental_termination.hpp.

References mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::tPolicy.

Member Data Documentation

template<class TerminationPolicy >
size_t mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::incrementalIndex
private
template<class TerminationPolicy >
size_t mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::iteration
private
template<class TerminationPolicy >
TerminationPolicy mlpack::amf::CompleteIncrementalTermination< TerminationPolicy >::tPolicy
private

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