Detailed Description

Usual limit based on wall_time, number of explored branches and number of failures in the search tree.

Definition at line 4324 of file constraint_solver.h.

Public Member Functions
	RegularLimit (Solver *const s, absl::Duration time, int64_t branches, int64_t failures, int64_t solutions, bool smart_time_check, bool cumulative)

	~RegularLimit () override

void	Copy (const SearchLimit *const limit) override
	Copy a limit. More...

SearchLimit *	MakeClone () const override
	Allocates a clone of the limit. More...

RegularLimit *	MakeIdenticalClone () const

bool	Check () override
	This method is called to check the status of the limit. More...

void	Init () override
	This method is called when the search limit is initialized. More...

void	ExitSearch () override
	End of the search. More...

void	UpdateLimits (absl::Duration time, int64_t branches, int64_t failures, int64_t solutions)

absl::Duration	duration_limit () const

int64_t	wall_time () const

int64_t	branches () const

int64_t	failures () const

int64_t	solutions () const

bool	IsUncheckedSolutionLimitReached () override
	Returns true if the limit of solutions has been reached including unchecked solutions. More...

int	ProgressPercent () override
	Returns a percentage representing the propress of the search before reaching limits. More...

std::string	DebugString () const override

absl::Time	AbsoluteSolverDeadline () const

void	Accept (ModelVisitor *const visitor) const override
	Accepts the given model visitor. More...

bool	crossed () const
	Returns true if the limit has been crossed. More...

void	EnterSearch () override
	Internal methods. More...

void	BeginNextDecision (DecisionBuilder *const b) override
	Before calling DecisionBuilder::Next. More...

void	PeriodicCheck () override
	Periodic call to check limits in long running methods. More...

void	RefuteDecision (Decision *const d) override
	Before refuting the decision. More...

virtual void	RestartSearch ()
	Restart the search. More...

virtual void	EndNextDecision (DecisionBuilder const b, Decision const d)
	After calling DecisionBuilder::Next, along with the returned decision. More...

virtual void	ApplyDecision (Decision *const d)
	Before applying the decision. More...

virtual void	AfterDecision (Decision *const d, bool apply)
	Just after refuting or applying the decision, apply is true after Apply. More...

virtual void	BeginFail ()
	Just when the failure occurs. More...

virtual void	EndFail ()
	After completing the backtrack. More...

virtual void	BeginInitialPropagation ()
	Before the initial propagation. More...

virtual void	EndInitialPropagation ()
	After the initial propagation. More...

virtual bool	AcceptSolution ()
	This method is called when a solution is found. More...

virtual bool	AtSolution ()
	This method is called when a valid solution is found. More...

virtual void	NoMoreSolutions ()
	When the search tree is finished. More...

virtual bool	LocalOptimum ()
	When a local optimum is reached. More...

virtual bool	AcceptDelta (Assignment delta, Assignment deltadelta)

virtual void	AcceptNeighbor ()
	After accepting a neighbor during local search. More...

virtual void	AcceptUncheckedNeighbor ()
	After accepting an unchecked neighbor during local search. More...

Solver *	solver () const

virtual void	Install ()
	Registers itself on the solver such that it gets notified of the search and propagation events. More...

Static Public Attributes
static constexpr int	kNoProgress = -1

Constructor & Destructor Documentation

◆ RegularLimit()

RegularLimit	(	Solver *const	s,
		absl::Duration	time,
		int64_t	branches,
		int64_t	failures,
		int64_t	solutions,
		bool	smart_time_check,
		bool	cumulative
	)

Definition at line 4031 of file search.cc.

◆ ~RegularLimit()

~RegularLimit ( )

override

Definition at line 4050 of file search.cc.

Member Function Documentation

◆ AbsoluteSolverDeadline()

absl::Time AbsoluteSolverDeadline ( ) const

inline

Definition at line 4351 of file constraint_solver.h.

◆ Accept()

void Accept ( ModelVisitor *const visitor ) const

overridevirtual

Accepts the given model visitor.

Reimplemented from SearchMonitor.

Definition at line 4136 of file search.cc.

◆ AcceptDelta()

bool AcceptDelta	(	Assignment *	delta,
		Assignment *	deltadelta
	)

virtualinherited

Reimplemented in OptimizeVar.

Definition at line 2894 of file constraint_solver.cc.

◆ AcceptNeighbor()

void AcceptNeighbor ( )

virtualinherited

After accepting a neighbor during local search.

Definition at line 2897 of file constraint_solver.cc.

◆ AcceptSolution()

bool AcceptSolution ( )

virtualinherited

This method is called when a solution is found.

It asserts whether the solution is valid. A value of false indicates that the solution should be discarded.

Reimplemented in OptimizeVar.

Definition at line 2890 of file constraint_solver.cc.

◆ AcceptUncheckedNeighbor()

void AcceptUncheckedNeighbor ( )

virtualinherited

After accepting an unchecked neighbor during local search.

Reimplemented in SearchLog.

Definition at line 2898 of file constraint_solver.cc.

◆ AfterDecision()

void AfterDecision	(	Decision *const	d,
		bool	apply
	)

virtualinherited

Just after refuting or applying the decision, apply is true after Apply.

This is called only if the Apply() or Refute() methods have not failed.

Definition at line 2885 of file constraint_solver.cc.

◆ ApplyDecision()

void ApplyDecision ( Decision *const d )

virtualinherited

Before applying the decision.

Reimplemented in SearchLog.

Definition at line 2883 of file constraint_solver.cc.

◆ AtSolution()

bool AtSolution ( )

virtualinherited

This method is called when a valid solution is found.

If the return value is true, then search will resume after. If the result is false, then search will stop there.

Reimplemented in OptimizeVar, ImprovementSearchLimit, and SearchLog.

Definition at line 2891 of file constraint_solver.cc.

◆ BeginFail()

void BeginFail ( )

virtualinherited

Just when the failure occurs.

Reimplemented in SearchLog, and DemonProfiler.

Definition at line 2886 of file constraint_solver.cc.

◆ BeginInitialPropagation()

void BeginInitialPropagation ( )

virtualinherited

Before the initial propagation.

Reimplemented in SearchLog.

Definition at line 2888 of file constraint_solver.cc.

◆ BeginNextDecision()

void BeginNextDecision ( DecisionBuilder *const b )

overridevirtualinherited

Before calling DecisionBuilder::Next.

Reimplemented from SearchMonitor.

Definition at line 4006 of file search.cc.

◆ branches()

int64_t branches ( ) const

inline

Definition at line 4344 of file constraint_solver.h.

◆ Check()

bool Check ( )

overridevirtual

This method is called to check the status of the limit.

A return value of true indicates that we have indeed crossed the limit. In that case, this method will not be called again and the remaining search will be discarded.

Implements SearchLimit.

Definition at line 4071 of file search.cc.

◆ Copy()

void Copy ( const SearchLimit *const limit )

overridevirtual

Copy a limit.

Warning: leads to a direct (no check) downcasting of 'limit' so one needs to be sure both SearchLimits are of the same type.

Implements SearchLimit.

Definition at line 4052 of file search.cc.

◆ crossed()

bool crossed ( ) const

inlineinherited

Returns true if the limit has been crossed.

Definition at line 4288 of file constraint_solver.h.

◆ DebugString()

std::string DebugString ( ) const

overridevirtual

Reimplemented from SearchLimit.

Definition at line 4128 of file search.cc.

◆ duration_limit()

absl::Duration duration_limit ( ) const

inline

Definition at line 4338 of file constraint_solver.h.

◆ EndFail()

void EndFail ( )

virtualinherited

After completing the backtrack.

Definition at line 2887 of file constraint_solver.cc.

◆ EndInitialPropagation()

void EndInitialPropagation ( )

virtualinherited

After the initial propagation.

Reimplemented in SearchLog.

Definition at line 2889 of file constraint_solver.cc.

◆ EndNextDecision()

void EndNextDecision	(	DecisionBuilder *const	b,
		Decision *const	d
	)

virtualinherited

After calling DecisionBuilder::Next, along with the returned decision.

Reimplemented in SymmetryManager.

Definition at line 2881 of file constraint_solver.cc.

◆ EnterSearch()

void EnterSearch ( )

overridevirtualinherited

Internal methods.

Reimplemented from SearchMonitor.

Definition at line 4001 of file search.cc.

◆ ExitSearch()

void ExitSearch ( )

overridevirtual

End of the search.

Reimplemented from SearchMonitor.

Definition at line 4103 of file search.cc.

◆ failures()

int64_t failures ( ) const

inline

Definition at line 4345 of file constraint_solver.h.

◆ Init()

void Init ( )

overridevirtual

This method is called when the search limit is initialized.

Implements SearchLimit.

Definition at line 4092 of file search.cc.

◆ Install()

void Install ( )

virtualinherited

Registers itself on the solver such that it gets notified of the search and propagation events.

Reimplemented in Trace, LocalSearchMonitorMaster, PropagationMonitor, LocalSearchMonitor, DemonProfiler, and LocalSearchProfiler.

Definition at line 2902 of file constraint_solver.cc.

◆ IsUncheckedSolutionLimitReached()

bool IsUncheckedSolutionLimitReached ( )

overridevirtual

Returns true if the limit of solutions has been reached including unchecked solutions.

Reimplemented from SearchMonitor.

Definition at line 4122 of file search.cc.

◆ LocalOptimum()

bool LocalOptimum ( )

virtualinherited

When a local optimum is reached.

If 'true' is returned, the last solution is discarded and the search proceeds with the next one.

Definition at line 2893 of file constraint_solver.cc.

◆ MakeClone()

SearchLimit * MakeClone ( ) const

overridevirtual

Allocates a clone of the limit.

Implements SearchLimit.

Definition at line 4063 of file search.cc.

◆ MakeIdenticalClone()

RegularLimit * MakeIdenticalClone ( ) const

Definition at line 4065 of file search.cc.

◆ NoMoreSolutions()

void NoMoreSolutions ( )

virtualinherited

When the search tree is finished.

Reimplemented in SearchLog.

Definition at line 2892 of file constraint_solver.cc.

◆ PeriodicCheck()

void PeriodicCheck ( )

overridevirtualinherited

Periodic call to check limits in long running methods.

Reimplemented from SearchMonitor.

Definition at line 4016 of file search.cc.

◆ ProgressPercent()

int ProgressPercent ( )

overridevirtual

Returns a percentage representing the propress of the search before reaching limits.

Reimplemented from SearchMonitor.

Definition at line 4079 of file search.cc.

◆ RefuteDecision()

void RefuteDecision ( Decision *const d )

overridevirtualinherited

Before refuting the decision.

Reimplemented from SearchMonitor.

Definition at line 4011 of file search.cc.

◆ RestartSearch()

void RestartSearch ( )

virtualinherited

Restart the search.

Reimplemented in DemonProfiler, and LocalSearchProfiler.

Definition at line 2878 of file constraint_solver.cc.

◆ solutions()

int64_t solutions ( ) const

inline

Definition at line 4346 of file constraint_solver.h.

◆ solver()

Solver * solver ( ) const

inlineinherited

Definition at line 3750 of file constraint_solver.h.

◆ UpdateLimits()

void UpdateLimits	(	absl::Duration	time,
		int64_t	branches,
		int64_t	failures,
		int64_t	solutions
	)

Definition at line 4114 of file search.cc.

◆ wall_time()

int64_t wall_time ( ) const

inline

Definition at line 4339 of file constraint_solver.h.

Member Data Documentation

◆ kNoProgress

constexpr int kNoProgress = -1

staticconstexprinherited

Definition at line 3679 of file constraint_solver.h.

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

Detailed Description

Public Member Functions

Static Public Attributes

Constructor & Destructor Documentation

◆ RegularLimit()

◆ ~RegularLimit()

Member Function Documentation

◆ AbsoluteSolverDeadline()

◆ Accept()

◆ AcceptDelta()

◆ AcceptNeighbor()

◆ AcceptSolution()

◆ AcceptUncheckedNeighbor()

◆ AfterDecision()

◆ ApplyDecision()

◆ AtSolution()

◆ BeginFail()

◆ BeginInitialPropagation()

◆ BeginNextDecision()

◆ branches()

◆ Check()

◆ Copy()

◆ crossed()

◆ DebugString()

◆ duration_limit()

◆ EndFail()

◆ EndInitialPropagation()

◆ EndNextDecision()

◆ EnterSearch()

◆ ExitSearch()

◆ failures()

◆ Init()

◆ Install()

◆ IsUncheckedSolutionLimitReached()

◆ LocalOptimum()

◆ MakeClone()

◆ MakeIdenticalClone()

◆ NoMoreSolutions()

◆ PeriodicCheck()

◆ ProgressPercent()

◆ RefuteDecision()

◆ RestartSearch()

◆ solutions()

◆ solver()

◆ UpdateLimits()

◆ wall_time()

Member Data Documentation

◆ kNoProgress