The local search with tabu list learning algorithm (for directed graphs) More...

#include <localSearchWithTabuList.h>

Inheritance diagram for gum::learning::LocalSearchWithTabuList:

Collaboration diagram for gum::learning::LocalSearchWithTabuList:

Public Attributes
Signaler3< Size, double, double >	onProgress
	Progression, error and time. More...

Signaler1< std::string >	onStop
	Criteria messageApproximationScheme. More...

Public Member Functions
Constructors / Destructors
	LocalSearchWithTabuList ()
	default constructor More...

	LocalSearchWithTabuList (const LocalSearchWithTabuList &from)
	copy constructor More...

	LocalSearchWithTabuList (LocalSearchWithTabuList &&from)
	move constructor More...

virtual	~LocalSearchWithTabuList ()
	destructor More...

Operators
LocalSearchWithTabuList &	operator= (const LocalSearchWithTabuList &from)
	copy operator More...

LocalSearchWithTabuList &	operator= (LocalSearchWithTabuList &&from)
	move operator More...

Accessors / Modifiers
ApproximationScheme &	approximationScheme ()
	returns the approximation policy of the learning algorithm More...

void	setMaxNbDecreasingChanges (Size nb)
	set the max number of changes decreasing the score that we allow to apply More...

template<typename GRAPH_CHANGES_SELECTOR >
DAG	learnStructure (GRAPH_CHANGES_SELECTOR &selector, DAG initial_dag=DAG())
	learns the structure of a Bayes net More...

template<typename GUM_SCALAR = double, typename GRAPH_CHANGES_SELECTOR , typename PARAM_ESTIMATOR >
BayesNet< GUM_SCALAR >	learnBN (GRAPH_CHANGES_SELECTOR &selector, PARAM_ESTIMATOR &estimator, DAG initial_dag=DAG())
	learns the structure and the parameters of a BN More...

Getters and setters
void	setEpsilon (double eps)
	Given that we approximate f(t), stopping criterion on \|f(t+1)-f(t)\|. More...

double	epsilon () const
	Returns the value of epsilon. More...

void	disableEpsilon ()
	Disable stopping criterion on epsilon. More...

void	enableEpsilon ()
	Enable stopping criterion on epsilon. More...

bool	isEnabledEpsilon () const
	Returns true if stopping criterion on epsilon is enabled, false otherwise. More...

void	setMinEpsilonRate (double rate)
	Given that we approximate f(t), stopping criterion on d/dt(\|f(t+1)-f(t)\|). More...

double	minEpsilonRate () const
	Returns the value of the minimal epsilon rate. More...

void	disableMinEpsilonRate ()
	Disable stopping criterion on epsilon rate. More...

void	enableMinEpsilonRate ()
	Enable stopping criterion on epsilon rate. More...

bool	isEnabledMinEpsilonRate () const
	Returns true if stopping criterion on epsilon rate is enabled, false otherwise. More...

void	setMaxIter (Size max)
	Stopping criterion on number of iterations. More...

Size	maxIter () const
	Returns the criterion on number of iterations. More...

void	disableMaxIter ()
	Disable stopping criterion on max iterations. More...

void	enableMaxIter ()
	Enable stopping criterion on max iterations. More...

bool	isEnabledMaxIter () const
	Returns true if stopping criterion on max iterations is enabled, false otherwise. More...

void	setMaxTime (double timeout)
	Stopping criterion on timeout. More...

double	maxTime () const
	Returns the timeout (in seconds). More...

double	currentTime () const
	Returns the current running time in second. More...

void	disableMaxTime ()
	Disable stopping criterion on timeout. More...

void	enableMaxTime ()
	Enable stopping criterion on timeout. More...

bool	isEnabledMaxTime () const
	Returns true if stopping criterion on timeout is enabled, false otherwise. More...

void	setPeriodSize (Size p)
	How many samples between two stopping is enable. More...

Size	periodSize () const
	Returns the period size. More...

void	setVerbosity (bool v)
	Set the verbosity on (true) or off (false). More...

bool	verbosity () const
	Returns true if verbosity is enabled. More...

ApproximationSchemeSTATE	stateApproximationScheme () const
	Returns the approximation scheme state. More...

Size	nbrIterations () const
	Returns the number of iterations. More...

const std::vector< double > &	history () const
	Returns the scheme history. More...

void	initApproximationScheme ()
	Initialise the scheme. More...

bool	startOfPeriod ()
	Returns true if we are at the beginning of a period (compute error is mandatory). More...

void	updateApproximationScheme (unsigned int incr=1)
	Update the scheme w.r.t the new error and increment steps. More...

Size	remainingBurnIn ()
	Returns the remaining burn in. More...

void	stopApproximationScheme ()
	Stop the approximation scheme. More...

bool	continueApproximationScheme (double error)
	Update the scheme w.r.t the new error. More...

Getters and setters
std::string	messageApproximationScheme () const
	Returns the approximation scheme message. More...

Public Types
enum	ApproximationSchemeSTATE : char { ApproximationSchemeSTATE::Undefined, ApproximationSchemeSTATE::Continue, ApproximationSchemeSTATE::Epsilon, ApproximationSchemeSTATE::Rate, ApproximationSchemeSTATE::Limit, ApproximationSchemeSTATE::TimeLimit, ApproximationSchemeSTATE::Stopped }
	The different state of an approximation scheme. More...

Protected Attributes
double	_current_epsilon
	Current epsilon. More...

double	_last_epsilon
	Last epsilon value. More...

double	_current_rate
	Current rate. More...

Size	_current_step
	The current step. More...

Timer	_timer
	The timer. More...

ApproximationSchemeSTATE	_current_state
	The current state. More...

std::vector< double >	_history
	The scheme history, used only if verbosity == true. More...

double	_eps
	Threshold for convergence. More...

bool	_enabled_eps
	If true, the threshold convergence is enabled. More...

double	_min_rate_eps
	Threshold for the epsilon rate. More...

bool	_enabled_min_rate_eps
	If true, the minimal threshold for epsilon rate is enabled. More...

double	_max_time
	The timeout. More...

bool	_enabled_max_time
	If true, the timeout is enabled. More...

Size	_max_iter
	The maximum iterations. More...

bool	_enabled_max_iter
	If true, the maximum iterations stopping criterion is enabled. More...

Size	_burn_in
	Number of iterations before checking stopping criteria. More...

Size	_period_size
	Checking criteria frequency. More...

bool	_verbosity
	If true, verbosity is enabled. More...

Detailed Description

The local search with tabu list learning algorithm (for directed graphs)

The LocalSearchWithTabuList class implements a greedy search in which we allow applying at most N consecutive graph changes that decrease the score. To prevent infinite loops, when using local search, you should use a structural constraint that includes a tabu list of at least N elements.

Definition at line 58 of file localSearchWithTabuList.h.

Member Enumeration Documentation

◆ ApproximationSchemeSTATE

enum gum::IApproximationSchemeConfiguration::ApproximationSchemeSTATE : char

stronginherited

The different state of an approximation scheme.

Enumerator
Undefined
Continue
Epsilon
Rate
Limit
TimeLimit
Stopped

Definition at line 63 of file IApproximationSchemeConfiguration.h.

                                         : char {
       Undefined,
       Continue,
       Epsilon,
       Rate,
       Limit,
       TimeLimit,
       Stopped
     };

Constructor & Destructor Documentation

◆ LocalSearchWithTabuList() [1/3]

gum::learning::LocalSearchWithTabuList::LocalSearchWithTabuList ( )

default constructor

◆ LocalSearchWithTabuList() [2/3]

gum::learning::LocalSearchWithTabuList::LocalSearchWithTabuList ( const LocalSearchWithTabuList & from )

copy constructor

◆ LocalSearchWithTabuList() [3/3]

gum::learning::LocalSearchWithTabuList::LocalSearchWithTabuList ( LocalSearchWithTabuList && from )

move constructor

◆ ~LocalSearchWithTabuList()

virtual gum::learning::LocalSearchWithTabuList::~LocalSearchWithTabuList ( )

virtual

destructor

Member Function Documentation

◆ approximationScheme()

ApproximationScheme& gum::learning::LocalSearchWithTabuList::approximationScheme ( )

returns the approximation policy of the learning algorithm

◆ continueApproximationScheme()

INLINE bool gum::ApproximationScheme::continueApproximationScheme ( double error )

inherited

Update the scheme w.r.t the new error.

Test the stopping criterion that are enabled.

Parameters

error The new error value.

Returns: false if state become != ApproximationSchemeSTATE::Continue

Exceptions

OperationNotAllowed Raised if state != ApproximationSchemeSTATE::Continue.

Definition at line 225 of file approximationScheme_inl.h.

Referenced by gum::GibbsBNdistance< GUM_SCALAR >::_computeKL(), gum::SamplingInference< GUM_SCALAR >::_loopApproxInference(), gum::learning::DAG2BNLearner< ALLOC >::createBN(), gum::learning::GreedyHillClimbing::learnStructure(), learnStructure(), and gum::credal::CNMonteCarloSampling< GUM_SCALAR, BNInferenceEngine >::makeInference().

                                                                            {
     // For coherence, we fix the time used in the method
 
     double timer_step = _timer.step();
 
     if (_enabled_max_time) {
       if (timer_step > _max_time) {
         _stopScheme(ApproximationSchemeSTATE::TimeLimit);
         return false;
       }
     }
 
     if (!startOfPeriod()) { return true; }
 
     if (_current_state != ApproximationSchemeSTATE::Continue) {
       GUM_ERROR(OperationNotAllowed,
                 "state of the approximation scheme is not correct : "
                    + messageApproximationScheme());
     }
 
     if (verbosity()) { _history.push_back(error); }
 
     if (_enabled_max_iter) {
       if (_current_step > _max_iter) {
         _stopScheme(ApproximationSchemeSTATE::Limit);
         return false;
       }
     }
 
     _last_epsilon = _current_epsilon;
     _current_epsilon = error;   // eps rate isEnabled needs it so affectation was
     // moved from eps isEnabled below
 
     if (_enabled_eps) {
       if (_current_epsilon <= _eps) {
         _stopScheme(ApproximationSchemeSTATE::Epsilon);
         return false;
       }
     }
 
     if (_last_epsilon >= 0.) {
       if (_current_epsilon > .0) {
         // ! _current_epsilon can be 0. AND epsilon
         // isEnabled can be disabled !
         _current_rate =
            std::fabs((_current_epsilon - _last_epsilon) / _current_epsilon);
       }
       // limit with current eps ---> 0 is | 1 - ( last_eps / 0 ) | --->
       // infinity the else means a return false if we isEnabled the rate below,
       // as we would have returned false if epsilon isEnabled was enabled
       else {
         _current_rate = _min_rate_eps;
       }
 
       if (_enabled_min_rate_eps) {
         if (_current_rate <= _min_rate_eps) {
           _stopScheme(ApproximationSchemeSTATE::Rate);
           return false;
         }
       }
     }
 
     if (stateApproximationScheme() == ApproximationSchemeSTATE::Continue) {
       if (onProgress.hasListener()) {
         GUM_EMIT3(onProgress, _current_step, _current_epsilon, timer_step);
       }
 
       return true;
     } else {
       return false;
     }
   }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ currentTime()

INLINE double gum::ApproximationScheme::currentTime ( ) const

virtualinherited

Returns the current running time in second.

Returns: Returns the current running time in second.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 126 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_timer, and gum::Timer::step().

Referenced by gum::learning::genericBNLearner::currentTime().

126 { return _timer.step(); }

gum::Timer::step

double step() const

Returns the delta time between now and the last reset() call (or the constructor).

Definition: timer_inl.h:39

gum::ApproximationScheme::_timer

Timer _timer

The timer.

Definition: approximationScheme.h:379

Here is the call graph for this function:

Here is the caller graph for this function:

◆ disableEpsilon()

INLINE void gum::ApproximationScheme::disableEpsilon ( )

virtualinherited

Disable stopping criterion on epsilon.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 52 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_eps.

Referenced by gum::learning::genericBNLearner::disableEpsilon().

52 { _enabled_eps = false; }

gum::ApproximationScheme::_enabled_eps

bool _enabled_eps

If true, the threshold convergence is enabled.

Definition: approximationScheme.h:391

Here is the caller graph for this function:

◆ disableMaxIter()

INLINE void gum::ApproximationScheme::disableMaxIter ( )

virtualinherited

Disable stopping criterion on max iterations.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 103 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_max_iter.

Referenced by gum::credal::CNMonteCarloSampling< GUM_SCALAR, BNInferenceEngine >::__mcInitApproximationScheme(), gum::learning::genericBNLearner::disableMaxIter(), and gum::learning::GreedyHillClimbing::GreedyHillClimbing().

103 { _enabled_max_iter = false; }

gum::ApproximationScheme::_enabled_max_iter

bool _enabled_max_iter

If true, the maximum iterations stopping criterion is enabled.

Definition: approximationScheme.h:409

Here is the caller graph for this function:

◆ disableMaxTime()

INLINE void gum::ApproximationScheme::disableMaxTime ( )

virtualinherited

Disable stopping criterion on timeout.

Returns: Disable stopping criterion on timeout.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 129 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_max_time.

Referenced by gum::learning::genericBNLearner::disableMaxTime(), and gum::learning::GreedyHillClimbing::GreedyHillClimbing().

129 { _enabled_max_time = false; }

gum::ApproximationScheme::_enabled_max_time

bool _enabled_max_time

If true, the timeout is enabled.

Definition: approximationScheme.h:403

Here is the caller graph for this function:

◆ disableMinEpsilonRate()

INLINE void gum::ApproximationScheme::disableMinEpsilonRate ( )

virtualinherited

Disable stopping criterion on epsilon rate.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 77 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_min_rate_eps.

Referenced by gum::credal::CNMonteCarloSampling< GUM_SCALAR, BNInferenceEngine >::__mcInitApproximationScheme(), gum::GibbsBNdistance< GUM_SCALAR >::_computeKL(), gum::learning::genericBNLearner::disableMinEpsilonRate(), and gum::learning::GreedyHillClimbing::GreedyHillClimbing().

                                                          {
     _enabled_min_rate_eps = false;
   }

Here is the caller graph for this function:

◆ enableEpsilon()

INLINE void gum::ApproximationScheme::enableEpsilon ( )

virtualinherited

Enable stopping criterion on epsilon.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 55 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_eps.

Referenced by gum::credal::CNMonteCarloSampling< GUM_SCALAR, BNInferenceEngine >::__mcInitApproximationScheme(), and gum::learning::genericBNLearner::enableEpsilon().

55 { _enabled_eps = true; }

gum::ApproximationScheme::_enabled_eps

bool _enabled_eps

If true, the threshold convergence is enabled.

Definition: approximationScheme.h:391

Here is the caller graph for this function:

◆ enableMaxIter()

INLINE void gum::ApproximationScheme::enableMaxIter ( )

virtualinherited

Enable stopping criterion on max iterations.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 106 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_max_iter.

Referenced by gum::learning::genericBNLearner::enableMaxIter().

106 { _enabled_max_iter = true; }

gum::ApproximationScheme::_enabled_max_iter

bool _enabled_max_iter

If true, the maximum iterations stopping criterion is enabled.

Definition: approximationScheme.h:409

Here is the caller graph for this function:

◆ enableMaxTime()

INLINE void gum::ApproximationScheme::enableMaxTime ( )

virtualinherited

Enable stopping criterion on timeout.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 132 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_max_time.

Referenced by gum::credal::CNMonteCarloSampling< GUM_SCALAR, BNInferenceEngine >::CNMonteCarloSampling(), and gum::learning::genericBNLearner::enableMaxTime().

132 { _enabled_max_time = true; }

gum::ApproximationScheme::_enabled_max_time

bool _enabled_max_time

If true, the timeout is enabled.

Definition: approximationScheme.h:403

Here is the caller graph for this function:

◆ enableMinEpsilonRate()

INLINE void gum::ApproximationScheme::enableMinEpsilonRate ( )

virtualinherited

Enable stopping criterion on epsilon rate.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 82 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_min_rate_eps.

Referenced by gum::GibbsBNdistance< GUM_SCALAR >::_computeKL(), and gum::learning::genericBNLearner::enableMinEpsilonRate().

                                                         {
     _enabled_min_rate_eps = true;
   }

Here is the caller graph for this function:

◆ epsilon()

INLINE double gum::ApproximationScheme::epsilon ( ) const

virtualinherited

Returns the value of epsilon.

Returns: Returns the value of epsilon.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 49 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_eps.

Referenced by gum::ImportanceSampling< GUM_SCALAR >::_onContextualize(), and gum::learning::genericBNLearner::epsilon().

49 { return _eps; }

gum::ApproximationScheme::_eps

double _eps

Threshold for convergence.

Definition: approximationScheme.h:388

Here is the caller graph for this function:

◆ history()

INLINE const std::vector< double > & gum::ApproximationScheme::history ( ) const

virtualinherited

Returns the scheme history.

Returns: Returns the scheme history.

Exceptions

OperationNotAllowed Raised if the scheme did not performed or if verbosity is set to false.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 171 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_history, GUM_ERROR, gum::ApproximationScheme::stateApproximationScheme(), gum::IApproximationSchemeConfiguration::Undefined, and gum::ApproximationScheme::verbosity().

Referenced by gum::learning::genericBNLearner::history().

                                                                        {
     if (stateApproximationScheme() == ApproximationSchemeSTATE::Undefined) {
       GUM_ERROR(OperationNotAllowed,
                 "state of the approximation scheme is udefined");
     }
 
     if (verbosity() == false) {
       GUM_ERROR(OperationNotAllowed, "No history when verbosity=false");
     }
 
     return _history;
   }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initApproximationScheme()

INLINE void gum::ApproximationScheme::initApproximationScheme ( )

inherited

Initialise the scheme.

Definition at line 185 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_current_epsilon, gum::ApproximationScheme::_current_rate, gum::ApproximationScheme::_current_state, gum::ApproximationScheme::_current_step, gum::ApproximationScheme::_history, gum::ApproximationScheme::_timer, gum::IApproximationSchemeConfiguration::Continue, and gum::Timer::reset().

Referenced by gum::credal::CNMonteCarloSampling< GUM_SCALAR, BNInferenceEngine >::__mcInitApproximationScheme(), gum::GibbsBNdistance< GUM_SCALAR >::_computeKL(), gum::SamplingInference< GUM_SCALAR >::_loopApproxInference(), gum::SamplingInference< GUM_SCALAR >::_onStateChanged(), gum::learning::DAG2BNLearner< ALLOC >::createBN(), gum::learning::GreedyHillClimbing::learnStructure(), and learnStructure().

                                                            {
     _current_state = ApproximationSchemeSTATE::Continue;
     _current_step = 0;
     _current_epsilon = _current_rate = -1.0;
     _history.clear();
     _timer.reset();
   }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isEnabledEpsilon()

INLINE bool gum::ApproximationScheme::isEnabledEpsilon ( ) const

virtualinherited

Returns true if stopping criterion on epsilon is enabled, false otherwise.

Returns: Returns true if stopping criterion on epsilon is enabled, false otherwise.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 59 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_eps.

Referenced by gum::learning::genericBNLearner::isEnabledEpsilon().

                                                           {
     return _enabled_eps;
   }

Here is the caller graph for this function:

◆ isEnabledMaxIter()

INLINE bool gum::ApproximationScheme::isEnabledMaxIter ( ) const

virtualinherited

Returns true if stopping criterion on max iterations is enabled, false otherwise.

Returns: Returns true if stopping criterion on max iterations is enabled, false otherwise.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 110 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_max_iter.

Referenced by gum::learning::genericBNLearner::isEnabledMaxIter().

                                                           {
     return _enabled_max_iter;
   }

Here is the caller graph for this function:

◆ isEnabledMaxTime()

INLINE bool gum::ApproximationScheme::isEnabledMaxTime ( ) const

virtualinherited

Returns true if stopping criterion on timeout is enabled, false otherwise.

Returns: Returns true if stopping criterion on timeout is enabled, false otherwise.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 136 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_max_time.

Referenced by gum::learning::genericBNLearner::isEnabledMaxTime().

                                                           {
     return _enabled_max_time;
   }

Here is the caller graph for this function:

◆ isEnabledMinEpsilonRate()

INLINE bool gum::ApproximationScheme::isEnabledMinEpsilonRate ( ) const

virtualinherited

Returns true if stopping criterion on epsilon rate is enabled, false otherwise.

Returns: Returns true if stopping criterion on epsilon rate is enabled, false otherwise.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 88 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_min_rate_eps.

Referenced by gum::GibbsBNdistance< GUM_SCALAR >::_computeKL(), and gum::learning::genericBNLearner::isEnabledMinEpsilonRate().

                                                                  {
     return _enabled_min_rate_eps;
   }

Here is the caller graph for this function:

◆ learnBN()

template<typename GUM_SCALAR , typename GRAPH_CHANGES_SELECTOR , typename PARAM_ESTIMATOR >

BayesNet< GUM_SCALAR > gum::learning::LocalSearchWithTabuList::learnBN	(	GRAPH_CHANGES_SELECTOR &	selector,
		PARAM_ESTIMATOR &	estimator,
		DAG	initial_dag = `DAG()`
	)

learns the structure and the parameters of a BN

Definition at line 199 of file localSearchWithTabuList_tpl.h.

References learnStructure().

                                                                              {
       return DAG2BNLearner<>::createBN< GUM_SCALAR >(
          estimator, learnStructure(selector, initial_dag));
     }

Here is the call graph for this function:

◆ learnStructure()

template<typename GRAPH_CHANGES_SELECTOR >

DAG gum::learning::LocalSearchWithTabuList::learnStructure	(	GRAPH_CHANGES_SELECTOR &	selector,
		DAG	initial_dag = `DAG()`
	)

learns the structure of a Bayes net

Parameters

selector	A selector class that computes the best changes that can be applied and that enables the user to get them very easily. Typically, the selector is a GraphChangesSelector4DiGraph<SCORE, STRUCT_CONSTRAINT, GRAPH_CHANGES_GENERATOR>.
initial_dag	the DAG we start from for our learning

Definition at line 36 of file localSearchWithTabuList_tpl.h.

References __MaxNbDecreasing, gum::DAG::addArc(), gum::learning::ARC_ADDITION, gum::learning::ARC_DELETION, gum::learning::ARC_REVERSAL, gum::ApproximationScheme::continueApproximationScheme(), gum::ArcGraphPart::eraseArc(), GUM_ERROR, gum::ApproximationScheme::initApproximationScheme(), gum::learning::GraphChange::node1(), gum::learning::GraphChange::node2(), gum::NodeGraphPart::size(), gum::ApproximationScheme::stopApproximationScheme(), gum::learning::GraphChange::type(), and gum::ApproximationScheme::updateApproximationScheme().

Referenced by gum::learning::genericBNLearner::__learnDAG(), and learnBN().

                                                                              {
       selector.setGraph(dag);
 
       unsigned int nb_changes_applied = 0;
       Idx          applied_change_with_positive_score = 0;
       Idx          current_N = 0;
 
       initApproximationScheme();
 
       // a vector that indicates which queues have valid scores, i.e., scores
       // that were not invalidated by previously applied changes
       std::vector< bool > impacted_queues(dag.size(), false);
 
       // the best dag found so far with its score
       DAG    best_dag = dag;
       double best_score = 0;
       double current_score = 0;
       double delta_score = 0;
 
       do {
         applied_change_with_positive_score = 0;
         delta_score = 0;
 
         std::vector< std::pair< NodeId, double > > ordered_queues =
            selector.nodesSortedByBestScore();
 
         for (Idx j = 0; j < dag.size(); ++j) {
           NodeId i = ordered_queues[j].first;
 
           if (!selector.empty(i)
               && (!nb_changes_applied || (selector.bestScore(i) > 0))) {
             // pick up the best change
             const GraphChange& change = selector.bestChange(i);
 
             // perform the change
             switch (change.type()) {
               case GraphChangeType::ARC_ADDITION:
                 if (!impacted_queues[change.node2()]
                     && selector.isChangeValid(change)) {
                   if (selector.bestScore(i) > 0) {
                     ++applied_change_with_positive_score;
                   } else if (current_score > best_score) {
                     best_score = current_score;
                     best_dag = dag;
                   }
 
                   // std::cout << "apply arc addition " << change.node1()
                   //           << " -> " << change.node2()
                   //           << "  delta = " << selector.bestScore( i )
                   //           << std::endl;
 
                   delta_score += selector.bestScore(i);
                   current_score += selector.bestScore(i);
                   dag.addArc(change.node1(), change.node2());
                   impacted_queues[change.node2()] = true;
                   selector.applyChangeWithoutScoreUpdate(change);
                   ++nb_changes_applied;
                 }
 
                 break;
 
               case GraphChangeType::ARC_DELETION:
                 if (!impacted_queues[change.node2()]
                     && selector.isChangeValid(change)) {
                   if (selector.bestScore(i) > 0) {
                     ++applied_change_with_positive_score;
                   } else if (current_score > best_score) {
                     best_score = current_score;
                     best_dag = dag;
                   }
 
                   // std::cout << "apply arc deletion " << change.node1()
                   //           << " -> " << change.node2()
                   //           << "  delta = " << selector.bestScore( i )
                   //           << std::endl;
 
                   delta_score += selector.bestScore(i);
                   current_score += selector.bestScore(i);
                   dag.eraseArc(Arc(change.node1(), change.node2()));
                   impacted_queues[change.node2()] = true;
                   selector.applyChangeWithoutScoreUpdate(change);
                   ++nb_changes_applied;
                 }
 
                 break;
 
               case GraphChangeType::ARC_REVERSAL:
                 if ((!impacted_queues[change.node1()])
                     && (!impacted_queues[change.node2()])
                     && selector.isChangeValid(change)) {
                   if (selector.bestScore(i) > 0) {
                     ++applied_change_with_positive_score;
                   } else if (current_score > best_score) {
                     best_score = current_score;
                     best_dag = dag;
                   }
 
                   // std::cout << "apply arc reversal " << change.node1()
                   //           << " -> " << change.node2()
                   //           << "  delta = " << selector.bestScore( i )
                   //           << std::endl;
 
                   delta_score += selector.bestScore(i);
                   current_score += selector.bestScore(i);
                   dag.eraseArc(Arc(change.node1(), change.node2()));
                   dag.addArc(change.node2(), change.node1());
                   impacted_queues[change.node1()] = true;
                   impacted_queues[change.node2()] = true;
                   selector.applyChangeWithoutScoreUpdate(change);
                   ++nb_changes_applied;
                 }
 
                 break;
 
               default:
                 GUM_ERROR(OperationNotAllowed,
                           "edge modifications are not "
                           "supported by local search");
             }
 
             break;
           }
         }
 
         selector.updateScoresAfterAppliedChanges();
 
         // reset the impacted queue and applied changes structures
         for (auto iter = impacted_queues.begin(); iter != impacted_queues.end();
              ++iter) {
           *iter = false;
         }
 
         updateApproximationScheme(nb_changes_applied);
 
         // update current_N
         if (applied_change_with_positive_score) {
           current_N = 0;
           nb_changes_applied = 0;
         } else {
           ++current_N;
         }
 
         // std::cout << "current N = " << current_N << std::endl;
       } while ((current_N <= __MaxNbDecreasing)
                && continueApproximationScheme(delta_score));
 
       stopApproximationScheme();   // just to be sure of the
                                    // approximationScheme has
                                    // been notified of the end of looop
 
       if (current_score > best_score) {
         return dag;
       } else {
         return best_dag;
       }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ maxIter()

INLINE Size gum::ApproximationScheme::maxIter ( ) const

virtualinherited

Returns the criterion on number of iterations.

Returns: Returns the criterion on number of iterations.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 100 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_max_iter.

Referenced by gum::learning::genericBNLearner::maxIter().

100 { return _max_iter; }

gum::ApproximationScheme::_max_iter

Size _max_iter

The maximum iterations.

Definition: approximationScheme.h:406

Here is the caller graph for this function:

◆ maxTime()

INLINE double gum::ApproximationScheme::maxTime ( ) const

virtualinherited

Returns the timeout (in seconds).

Returns: Returns the timeout (in seconds).

Implements gum::IApproximationSchemeConfiguration.

Definition at line 123 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_max_time.

Referenced by gum::learning::genericBNLearner::maxTime().

123 { return _max_time; }

gum::ApproximationScheme::_max_time

double _max_time

The timeout.

Definition: approximationScheme.h:400

Here is the caller graph for this function:

◆ messageApproximationScheme()

INLINE std::string gum::IApproximationSchemeConfiguration::messageApproximationScheme ( ) const

inherited

Returns the approximation scheme message.

Returns: Returns the approximation scheme message.

Definition at line 38 of file IApproximationSchemeConfiguration_inl.h.

Referenced by gum::ApproximationScheme::_stopScheme(), gum::ApproximationScheme::continueApproximationScheme(), and gum::credal::InferenceEngine< GUM_SCALAR >::getApproximationSchemeMsg().

                                                                          {
     std::stringstream s;
 
     switch (stateApproximationScheme()) {
       case ApproximationSchemeSTATE::Continue: s << "in progress"; break;
 
       case ApproximationSchemeSTATE::Epsilon:
         s << "stopped with epsilon=" << epsilon();
         break;
 
       case ApproximationSchemeSTATE::Rate:
         s << "stopped with rate=" << minEpsilonRate();
         break;
 
       case ApproximationSchemeSTATE::Limit:
         s << "stopped with max iteration=" << maxIter();
         break;
 
       case ApproximationSchemeSTATE::TimeLimit:
         s << "stopped with timeout=" << maxTime();
         break;
 
       case ApproximationSchemeSTATE::Stopped: s << "stopped on request"; break;
 
       case ApproximationSchemeSTATE::Undefined: s << "undefined state"; break;
     };
 
     return s.str();
   }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ minEpsilonRate()

INLINE double gum::ApproximationScheme::minEpsilonRate ( ) const

virtualinherited

Returns the value of the minimal epsilon rate.

Returns: Returns the value of the minimal epsilon rate.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 72 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_min_rate_eps.

Referenced by gum::learning::genericBNLearner::minEpsilonRate().

                                                           {
     return _min_rate_eps;
   }

Here is the caller graph for this function:

◆ nbrIterations()

INLINE Size gum::ApproximationScheme::nbrIterations ( ) const

virtualinherited

Returns the number of iterations.

Returns: Returns the number of iterations.

Exceptions

OperationNotAllowed Raised if the scheme did not perform.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 161 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_current_step, GUM_ERROR, gum::ApproximationScheme::stateApproximationScheme(), and gum::IApproximationSchemeConfiguration::Undefined.

Referenced by gum::GibbsBNdistance< GUM_SCALAR >::_computeKL(), and gum::learning::genericBNLearner::nbrIterations().

                                                        {
     if (stateApproximationScheme() == ApproximationSchemeSTATE::Undefined) {
       GUM_ERROR(OperationNotAllowed,
                 "state of the approximation scheme is undefined");
     }
 
     return _current_step;
   }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ operator=() [1/2]

LocalSearchWithTabuList& gum::learning::LocalSearchWithTabuList::operator= ( const LocalSearchWithTabuList & from )

copy operator

◆ operator=() [2/2]

LocalSearchWithTabuList& gum::learning::LocalSearchWithTabuList::operator= ( LocalSearchWithTabuList && from )

move operator

◆ periodSize()

INLINE Size gum::ApproximationScheme::periodSize ( ) const

virtualinherited

Returns the period size.

Returns: Returns the period size.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 147 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_period_size.

Referenced by gum::credal::CNMonteCarloSampling< GUM_SCALAR, BNInferenceEngine >::makeInference(), and gum::learning::genericBNLearner::periodSize().

147 { return _period_size; }

gum::ApproximationScheme::_period_size

Size _period_size

Checking criteria frequency.

Definition: approximationScheme.h:415

Here is the caller graph for this function:

◆ remainingBurnIn()

INLINE Size gum::ApproximationScheme::remainingBurnIn ( )

inherited

Returns the remaining burn in.

Returns: Returns the remaining burn in.

Definition at line 208 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_burn_in, and gum::ApproximationScheme::_current_step.

                                                    {
     if (_burn_in > _current_step) {
       return _burn_in - _current_step;
     } else {
       return 0;
     }
   }

◆ setEpsilon()

INLINE void gum::ApproximationScheme::setEpsilon ( double eps )

virtualinherited

Given that we approximate f(t), stopping criterion on |f(t+1)-f(t)|.

If the criterion was disabled it will be enabled.

Parameters

eps	The new epsilon value.

Exceptions

OutOfLowerBound Raised if eps < 0.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 41 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_eps, gum::ApproximationScheme::_eps, and GUM_ERROR.

Referenced by gum::credal::CNMonteCarloSampling< GUM_SCALAR, BNInferenceEngine >::__mcInitApproximationScheme(), gum::GibbsBNdistance< GUM_SCALAR >::GibbsBNdistance(), gum::GibbsSampling< GUM_SCALAR >::GibbsSampling(), gum::learning::GreedyHillClimbing::GreedyHillClimbing(), gum::SamplingInference< GUM_SCALAR >::SamplingInference(), and gum::learning::genericBNLearner::setEpsilon().

                                                         {
     if (eps < 0.) { GUM_ERROR(OutOfLowerBound, "eps should be >=0"); }
 
     _eps = eps;
     _enabled_eps = true;
   }

Here is the caller graph for this function:

◆ setMaxIter()

INLINE void gum::ApproximationScheme::setMaxIter ( Size max )

virtualinherited

Stopping criterion on number of iterations.

If the criterion was disabled it will be enabled.

Parameters

max	The maximum number of iterations.

Exceptions

OutOfLowerBound Raised if max <= 1.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 93 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_max_iter, gum::ApproximationScheme::_max_iter, and GUM_ERROR.

Referenced by gum::GibbsBNdistance< GUM_SCALAR >::GibbsBNdistance(), gum::SamplingInference< GUM_SCALAR >::SamplingInference(), and gum::learning::genericBNLearner::setMaxIter().

                                                       {
     if (max < 1) { GUM_ERROR(OutOfLowerBound, "max should be >=1"); }
     _max_iter = max;
     _enabled_max_iter = true;
   }

Here is the caller graph for this function:

◆ setMaxNbDecreasingChanges()

void gum::learning::LocalSearchWithTabuList::setMaxNbDecreasingChanges ( Size nb )

set the max number of changes decreasing the score that we allow to apply

Referenced by gum::learning::genericBNLearner::useLocalSearchWithTabuList().

Here is the caller graph for this function:

◆ setMaxTime()

INLINE void gum::ApproximationScheme::setMaxTime ( double timeout )

virtualinherited

Stopping criterion on timeout.

If the criterion was disabled it will be enabled.

Parameters

timeout The timeout value in seconds.

Exceptions

OutOfLowerBound Raised if timeout <= 0.0.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 116 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_max_time, gum::ApproximationScheme::_max_time, and GUM_ERROR.

Referenced by gum::credal::CNMonteCarloSampling< GUM_SCALAR, BNInferenceEngine >::CNMonteCarloSampling(), gum::GibbsBNdistance< GUM_SCALAR >::GibbsBNdistance(), gum::SamplingInference< GUM_SCALAR >::SamplingInference(), and gum::learning::genericBNLearner::setMaxTime().

                                                             {
     if (timeout <= 0.) { GUM_ERROR(OutOfLowerBound, "timeout should be >0."); }
     _max_time = timeout;
     _enabled_max_time = true;
   }

Here is the caller graph for this function:

◆ setMinEpsilonRate()

INLINE void gum::ApproximationScheme::setMinEpsilonRate ( double rate )

virtualinherited

Given that we approximate f(t), stopping criterion on d/dt(|f(t+1)-f(t)|).

If the criterion was disabled it will be enabled

Parameters

rate	The minimal epsilon rate.

Exceptions

OutOfLowerBound if rate<0

Implements gum::IApproximationSchemeConfiguration.

Definition at line 64 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_enabled_min_rate_eps, gum::ApproximationScheme::_min_rate_eps, and GUM_ERROR.

Referenced by gum::GibbsBNdistance< GUM_SCALAR >::GibbsBNdistance(), gum::GibbsSampling< GUM_SCALAR >::GibbsSampling(), gum::SamplingInference< GUM_SCALAR >::SamplingInference(), and gum::learning::genericBNLearner::setMinEpsilonRate().

                                                                 {
     if (rate < 0) { GUM_ERROR(OutOfLowerBound, "rate should be >=0"); }
 
     _min_rate_eps = rate;
     _enabled_min_rate_eps = true;
   }

Here is the caller graph for this function:

◆ setPeriodSize()

INLINE void gum::ApproximationScheme::setPeriodSize ( Size p )

virtualinherited

How many samples between two stopping is enable.

Parameters

p	The new period value.

Exceptions

OutOfLowerBound Raised if p < 1.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 141 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_period_size, and GUM_ERROR.

Referenced by gum::credal::CNMonteCarloSampling< GUM_SCALAR, BNInferenceEngine >::CNMonteCarloSampling(), gum::GibbsBNdistance< GUM_SCALAR >::GibbsBNdistance(), gum::SamplingInference< GUM_SCALAR >::SamplingInference(), and gum::learning::genericBNLearner::setPeriodSize().

                                                        {
     if (p < 1) { GUM_ERROR(OutOfLowerBound, "p should be >=1"); }
 
     _period_size = p;
   }

Here is the caller graph for this function:

◆ setVerbosity()

INLINE void gum::ApproximationScheme::setVerbosity ( bool v )

virtualinherited

Set the verbosity on (true) or off (false).

Parameters

v	If true, then verbosity is turned on.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 150 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_verbosity.

Referenced by gum::GibbsBNdistance< GUM_SCALAR >::GibbsBNdistance(), gum::SamplingInference< GUM_SCALAR >::SamplingInference(), and gum::learning::genericBNLearner::setVerbosity().

150 { _verbosity = v; }

gum::ApproximationScheme::_verbosity

bool _verbosity

If true, verbosity is enabled.

Definition: approximationScheme.h:418

Here is the caller graph for this function:

◆ startOfPeriod()

INLINE bool gum::ApproximationScheme::startOfPeriod ( )

inherited

Returns true if we are at the beginning of a period (compute error is mandatory).

Returns: Returns true if we are at the beginning of a period (compute error is mandatory).

Definition at line 195 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_burn_in, gum::ApproximationScheme::_current_step, and gum::ApproximationScheme::_period_size.

Referenced by gum::ApproximationScheme::continueApproximationScheme().

                                                  {
     if (_current_step < _burn_in) { return false; }
 
     if (_period_size == 1) { return true; }
 
     return ((_current_step - _burn_in) % _period_size == 0);
   }

Here is the caller graph for this function:

◆ stateApproximationScheme()

INLINE IApproximationSchemeConfiguration::ApproximationSchemeSTATE gum::ApproximationScheme::stateApproximationScheme ( ) const

virtualinherited

Returns the approximation scheme state.

Returns: Returns the approximation scheme state.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 156 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_current_state.

Referenced by gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::history(), gum::ApproximationScheme::nbrIterations(), and gum::learning::genericBNLearner::stateApproximationScheme().

                                                              {
     return _current_state;
   }

Here is the caller graph for this function:

◆ stopApproximationScheme()

INLINE void gum::ApproximationScheme::stopApproximationScheme ( )

inherited

Stop the approximation scheme.

Definition at line 217 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_current_state, gum::ApproximationScheme::_stopScheme(), gum::IApproximationSchemeConfiguration::Continue, and gum::IApproximationSchemeConfiguration::Stopped.

Referenced by gum::learning::DAG2BNLearner< ALLOC >::createBN(), gum::learning::GreedyHillClimbing::learnStructure(), and learnStructure().

                                                            {
     if (_current_state == ApproximationSchemeSTATE::Continue) {
       _stopScheme(ApproximationSchemeSTATE::Stopped);
     }
   }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateApproximationScheme()

INLINE void gum::ApproximationScheme::updateApproximationScheme ( unsigned int incr = 1 )

inherited

Update the scheme w.r.t the new error and increment steps.

Parameters

incr	The new increment steps.

Definition at line 204 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_current_step.

Referenced by gum::GibbsBNdistance< GUM_SCALAR >::_computeKL(), gum::SamplingInference< GUM_SCALAR >::_loopApproxInference(), gum::learning::DAG2BNLearner< ALLOC >::createBN(), gum::learning::GreedyHillClimbing::learnStructure(), learnStructure(), and gum::credal::CNMonteCarloSampling< GUM_SCALAR, BNInferenceEngine >::makeInference().

                                                                               {
     _current_step += incr;
   }

Here is the caller graph for this function:

◆ verbosity()

INLINE bool gum::ApproximationScheme::verbosity ( ) const

virtualinherited

Returns true if verbosity is enabled.

Returns: Returns true if verbosity is enabled.

Implements gum::IApproximationSchemeConfiguration.

Definition at line 152 of file approximationScheme_inl.h.

References gum::ApproximationScheme::_verbosity.

Referenced by gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::history(), and gum::learning::genericBNLearner::verbosity().

152 { return _verbosity; }

gum::ApproximationScheme::_verbosity

bool _verbosity

If true, verbosity is enabled.

Definition: approximationScheme.h:418

Here is the caller graph for this function:

Member Data Documentation

◆ __MaxNbDecreasing

Size gum::learning::LocalSearchWithTabuList::__MaxNbDecreasing {2}

private

the max number of changes decreasing the score that we allow to apply

Definition at line 126 of file localSearchWithTabuList.h.

Referenced by learnStructure().

◆ _burn_in

Size gum::ApproximationScheme::_burn_in

protectedinherited

Number of iterations before checking stopping criteria.

Definition at line 412 of file approximationScheme.h.

Referenced by gum::GibbsSampling< GUM_SCALAR >::burnIn(), gum::GibbsBNdistance< GUM_SCALAR >::burnIn(), gum::ApproximationScheme::remainingBurnIn(), gum::GibbsSampling< GUM_SCALAR >::setBurnIn(), gum::GibbsBNdistance< GUM_SCALAR >::setBurnIn(), and gum::ApproximationScheme::startOfPeriod().

◆ _current_epsilon

double gum::ApproximationScheme::_current_epsilon

protectedinherited

Current epsilon.

Definition at line 367 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::continueApproximationScheme(), and gum::ApproximationScheme::initApproximationScheme().

◆ _current_rate

double gum::ApproximationScheme::_current_rate

protectedinherited

Current rate.

Definition at line 373 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::continueApproximationScheme(), and gum::ApproximationScheme::initApproximationScheme().

◆ _current_state

ApproximationSchemeSTATE gum::ApproximationScheme::_current_state

protectedinherited

The current state.

Definition at line 382 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::_stopScheme(), gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::initApproximationScheme(), gum::ApproximationScheme::stateApproximationScheme(), and gum::ApproximationScheme::stopApproximationScheme().

◆ _current_step

Size gum::ApproximationScheme::_current_step

protectedinherited

The current step.

Definition at line 376 of file approximationScheme.h.

Referenced by gum::learning::Miic::_initiation(), gum::learning::Miic::_iteration(), gum::learning::Miic::_orientation_3off2(), gum::learning::Miic::_orientation_latents(), gum::learning::Miic::_orientation_miic(), gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::initApproximationScheme(), gum::learning::Miic::learnMixedStructure(), gum::ApproximationScheme::nbrIterations(), gum::ApproximationScheme::remainingBurnIn(), gum::ApproximationScheme::startOfPeriod(), and gum::ApproximationScheme::updateApproximationScheme().

◆ _enabled_eps

bool gum::ApproximationScheme::_enabled_eps

protectedinherited

If true, the threshold convergence is enabled.

Definition at line 391 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::disableEpsilon(), gum::ApproximationScheme::enableEpsilon(), gum::ApproximationScheme::isEnabledEpsilon(), and gum::ApproximationScheme::setEpsilon().

◆ _enabled_max_iter

bool gum::ApproximationScheme::_enabled_max_iter

protectedinherited

If true, the maximum iterations stopping criterion is enabled.

Definition at line 409 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::disableMaxIter(), gum::ApproximationScheme::enableMaxIter(), gum::ApproximationScheme::isEnabledMaxIter(), and gum::ApproximationScheme::setMaxIter().

◆ _enabled_max_time

bool gum::ApproximationScheme::_enabled_max_time

protectedinherited

If true, the timeout is enabled.

Definition at line 403 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::disableMaxTime(), gum::ApproximationScheme::enableMaxTime(), gum::ApproximationScheme::isEnabledMaxTime(), and gum::ApproximationScheme::setMaxTime().

◆ _enabled_min_rate_eps

bool gum::ApproximationScheme::_enabled_min_rate_eps

protectedinherited

If true, the minimal threshold for epsilon rate is enabled.

Definition at line 397 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::disableMinEpsilonRate(), gum::ApproximationScheme::enableMinEpsilonRate(), gum::ApproximationScheme::isEnabledMinEpsilonRate(), and gum::ApproximationScheme::setMinEpsilonRate().

◆ _eps

double gum::ApproximationScheme::_eps

protectedinherited

Threshold for convergence.

Definition at line 388 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::epsilon(), and gum::ApproximationScheme::setEpsilon().

◆ _history

std::vector< double > gum::ApproximationScheme::_history

protectedinherited

The scheme history, used only if verbosity == true.

Definition at line 385 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::history(), and gum::ApproximationScheme::initApproximationScheme().

◆ _last_epsilon

double gum::ApproximationScheme::_last_epsilon

protectedinherited

Last epsilon value.

Definition at line 370 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::continueApproximationScheme().

◆ _max_iter

Size gum::ApproximationScheme::_max_iter

protectedinherited

The maximum iterations.

Definition at line 406 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::maxIter(), and gum::ApproximationScheme::setMaxIter().

◆ _max_time

double gum::ApproximationScheme::_max_time

protectedinherited

The timeout.

Definition at line 400 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::maxTime(), and gum::ApproximationScheme::setMaxTime().

◆ _min_rate_eps

double gum::ApproximationScheme::_min_rate_eps

protectedinherited

Threshold for the epsilon rate.

Definition at line 394 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::minEpsilonRate(), and gum::ApproximationScheme::setMinEpsilonRate().

◆ _period_size

Size gum::ApproximationScheme::_period_size

protectedinherited

Checking criteria frequency.

Definition at line 415 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::periodSize(), gum::ApproximationScheme::setPeriodSize(), and gum::ApproximationScheme::startOfPeriod().

◆ _timer

Timer gum::ApproximationScheme::_timer

protectedinherited

The timer.

Definition at line 379 of file approximationScheme.h.

Referenced by gum::learning::Miic::_initiation(), gum::learning::Miic::_iteration(), gum::learning::Miic::_orientation_3off2(), gum::learning::Miic::_orientation_latents(), gum::learning::Miic::_orientation_miic(), gum::ApproximationScheme::_stopScheme(), gum::ApproximationScheme::continueApproximationScheme(), gum::ApproximationScheme::currentTime(), gum::ApproximationScheme::initApproximationScheme(), and gum::learning::Miic::learnMixedStructure().

◆ _verbosity

bool gum::ApproximationScheme::_verbosity

protectedinherited

If true, verbosity is enabled.

Definition at line 418 of file approximationScheme.h.

Referenced by gum::ApproximationScheme::setVerbosity(), and gum::ApproximationScheme::verbosity().

◆ onProgress

Signaler3< Size, double, double > gum::IApproximationSchemeConfiguration::onProgress

inherited

Progression, error and time.

Definition at line 57 of file IApproximationSchemeConfiguration.h.

Referenced by gum::learning::Miic::_initiation(), gum::learning::Miic::_iteration(), gum::learning::Miic::_orientation_3off2(), gum::learning::Miic::_orientation_latents(), gum::learning::Miic::_orientation_miic(), gum::ApproximationScheme::continueApproximationScheme(), and gum::learning::genericBNLearner::distributeProgress().

◆ onStop

Signaler1< std::string > gum::IApproximationSchemeConfiguration::onStop

inherited

Criteria messageApproximationScheme.

Definition at line 60 of file IApproximationSchemeConfiguration.h.

Referenced by gum::ApproximationScheme::_stopScheme(), and gum::learning::genericBNLearner::distributeStop().

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

agrum/learning/localSearchWithTabuList.h
agrum/learning/localSearchWithTabuList_tpl.h

Public Attributes

Public Member Functions

Public Types

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ ApproximationSchemeSTATE

Constructor & Destructor Documentation

◆ LocalSearchWithTabuList() [1/3]

◆ LocalSearchWithTabuList() [2/3]

◆ LocalSearchWithTabuList() [3/3]

◆ ~LocalSearchWithTabuList()

Member Function Documentation

◆ approximationScheme()

◆ continueApproximationScheme()

◆ currentTime()

◆ disableEpsilon()

◆ disableMaxIter()

◆ disableMaxTime()

◆ disableMinEpsilonRate()

◆ enableEpsilon()

◆ enableMaxIter()

◆ enableMaxTime()

◆ enableMinEpsilonRate()

◆ epsilon()

◆ history()

◆ initApproximationScheme()

◆ isEnabledEpsilon()

◆ isEnabledMaxIter()

◆ isEnabledMaxTime()

◆ isEnabledMinEpsilonRate()

◆ learnBN()

◆ learnStructure()

◆ maxIter()

◆ maxTime()

◆ messageApproximationScheme()

◆ minEpsilonRate()

◆ nbrIterations()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ periodSize()

◆ remainingBurnIn()

◆ setEpsilon()

◆ setMaxIter()

◆ setMaxNbDecreasingChanges()

◆ setMaxTime()

◆ setMinEpsilonRate()

◆ setPeriodSize()

◆ setVerbosity()

◆ startOfPeriod()

◆ stateApproximationScheme()

◆ stopApproximationScheme()

◆ updateApproximationScheme()

◆ verbosity()

Member Data Documentation

◆ __MaxNbDecreasing

◆ _burn_in

◆ _current_epsilon

◆ _current_rate

◆ _current_state

◆ _current_step

◆ _enabled_eps

◆ _enabled_max_iter

◆ _enabled_max_time

◆ _enabled_min_rate_eps

◆ _eps

◆ _history

◆ _last_epsilon

◆ _max_iter

◆ _max_time

◆ _min_rate_eps

◆ _period_size

◆ _timer

◆ _verbosity

◆ onProgress

◆ onStop