rapid_solve 0.1.7

This library provides a metaheuristic framework for solving combinatorial optimization problems.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

//! This module contains several [`TabuImprover`] implementation, which define the strategy to
//! explore the neighborhood of a solution in each iteration of the
//! [`TabuSearchSolver`][super::TabuSearchSolver].
pub mod tabu_minimizer;

use crate::objective::EvaluatedSolution;
use std::collections::VecDeque;
pub use tabu_minimizer::TabuMinimizer;

/// Determines for a given solution (as [`EvaluatedSolution`]) and a tabu list the best neighbor,
/// that are not tabu, together with new tabus to add to the tabu list.
/// * A solver is equipped with only one [`TabuImprover`].
/// * The [`TabuImprover`] is invoked in each iteration of the tabu search.
/// * Only returns `None` if there are no neighbors.
pub trait TabuImprover<S, T>: Send + Sync {
    /// Determines for a given [`EvaluatedSolution`] and a tabu list the best neighbor, that are
    /// not tabu, together with new tabus to add to the tabu list.
    /// Returns `None` if there are no neighbors.
    /// This method is called in each iteration of the
    /// [`TabuSearchSolver`][super::TabuSearchSolver].
    fn improve(
        &self,
        solution: &EvaluatedSolution<S>,
        tabu_list: &VecDeque<T>,
    ) -> Option<(EvaluatedSolution<S>, Vec<T>)>;
}