Struct RuinMoveSelector 

pub struct RuinMoveSelector<S, V> { /* private fields */ }

A move selector that generates RuinMove instances for Large Neighborhood Search.

Selects random subsets of entities to “ruin” (unassign), enabling a construction heuristic to reassign them in potentially better configurations.

Type Parameters

• S - The planning solution type
• V - The variable value type

Zero-Erasure

All variable access uses fn pointers:

• getter: fn(&S, usize) -> Option<V> - gets current value
• setter: fn(&mut S, usize, Option<V>) - sets value
• entity_count: fn(&S) -> usize - counts entities

Implementations

impl<S, V> RuinMoveSelector<S, V>

pub fn new( min_ruin_count: usize, max_ruin_count: usize, entity_count: fn(&S) -> usize, getter: fn(&S, usize) -> Option<V>, setter: fn(&mut S, usize, Option<V>), variable_name: &'static str, descriptor_index: usize, ) -> Self

Creates a new ruin move selector with typed function pointers.

Arguments

• min_ruin_count - Minimum entities to ruin (at least 1)
• max_ruin_count - Maximum entities to ruin
• entity_count - Function to get total entity count
• getter - Function to get current value
• setter - Function to set value
• variable_name - Name of the planning variable
• descriptor_index - Entity descriptor index

Panics

Panics if min_ruin_count is 0 or max_ruin_count < min_ruin_count.

pub fn with_moves_per_step(self, count: usize) -> Self

Sets the number of ruin moves to generate per iteration.

Default is 10.

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

Sets the random seed for reproducible subset selection.

Trait Implementations

impl<S, V: Debug> Debug for RuinMoveSelector<S, V>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<S, V> MoveSelector<S, RuinMove<S, V>> for RuinMoveSelector<S, V>

where S: PlanningSolution, V: Clone + Send + Sync + Debug + 'static,

fn iter_moves<'a, D: ScoreDirector<S>>( &'a self, score_director: &'a D, ) -> Box<dyn Iterator<Item = RuinMove<S, V>> + 'a>

Returns an iterator over typed moves.

fn size<D: ScoreDirector<S>>(&self, score_director: &D) -> usize

Returns the approximate number of moves.

fn is_never_ending(&self) -> bool

Returns true if this selector may return the same move multiple times.