Struct SolverScope 

pub struct SolverScope<'t, S: PlanningSolution, D: ScoreDirector<S>> { /* private fields */ }

Top-level scope for the entire solving process.

Holds the working solution, score director, and tracks the best solution found.

Type Parameters

• 't - Lifetime of the termination flag reference
• S - The planning solution type
• D - The score director type

Implementations

impl<'t, S: PlanningSolution, D: ScoreDirector<S>> SolverScope<'t, S, D>

pub fn new(score_director: D) -> Self

Creates a new solver scope with the given score director.

pub fn with_terminate( score_director: D, terminate: Option<&'t AtomicBool>, ) -> Self

Creates a solver scope with a termination flag.

pub fn with_seed(score_director: D, seed: u64) -> Self

Creates a solver scope with a specific random seed.

pub fn start_solving(&mut self)

Marks the start of solving.

pub fn elapsed(&self) -> Option<Duration>

Returns the elapsed time since solving started.

pub fn score_director(&self) -> &D

Returns a reference to the score director.

pub fn score_director_mut(&mut self) -> &mut D

Returns a mutable reference to the score director.

pub fn working_solution(&self) -> &S

Returns a reference to the working solution.

pub fn working_solution_mut(&mut self) -> &mut S

Returns a mutable reference to the working solution.

pub fn calculate_score(&mut self) -> S::Score

Calculates and returns the current score.

pub fn best_solution(&self) -> Option<&S>

Returns the best solution found so far.

pub fn best_score(&self) -> Option<&S::Score>

Returns the best score found so far.

pub fn update_best_solution(&mut self)

Updates the best solution if the current solution is better.

pub fn set_best_solution(&mut self, solution: S, score: S::Score)

Forces an update of the best solution regardless of score comparison.

pub fn rng(&mut self) -> &mut StdRng

Returns a reference to the RNG.

pub fn increment_step_count(&mut self) -> u64

Increments and returns the total step count.

pub fn total_step_count(&self) -> u64

Returns the total step count.

pub fn take_best_solution(self) -> Option<S>

Extracts the best solution, consuming this scope.

pub fn take_best_or_working_solution(self) -> S

Returns the best solution or the current working solution if no best was set.

pub fn is_terminate_early(&self) -> bool

Checks if early termination was requested (external flag only).

pub fn set_time_limit(&mut self, limit: Duration)

Sets the time limit for solving.

pub fn should_terminate(&self) -> bool

Checks if solving should terminate (external flag OR time limit).

pub fn stats(&self) -> &SolverStats

Returns a reference to the solver statistics.

pub fn stats_mut(&mut self) -> &mut SolverStats

Returns a mutable reference to the solver statistics.