Files
heuropt/src/operators/binary.rs
T
swaits e3f5d3eb7b chore: silence clippy warnings
- pareto/crowding.rs: rewrite the inner loop to iterate per-objective
  via index_axis-style indexing on `oriented` rather than naming an
  unused loop variable `k`.
- operators/{binary,permutation}.rs tests: pass parents via
  `std::slice::from_ref` instead of `&[parent.clone()]` to avoid the
  cloned_ref_to_slice_refs lint.

Pure cleanup — no behavior change, all 83 unit tests + 2 doctests still
pass.
2026-05-04 19:28:32 -06:00

71 lines
2.2 KiB
Rust

//! Operators for binary (`Vec<bool>`) decisions.
use rand::Rng as _;
use crate::core::rng::Rng;
use crate::traits::Variation;
/// Flip each bit of the first parent independently with probability `p`.
///
/// Always returns exactly one child (spec §11.3). Panics if `probability` is
/// outside `[0.0, 1.0]` or if no parents are provided.
#[derive(Debug, Clone)]
pub struct BitFlipMutation {
/// Per-bit flip probability. Must lie in `[0.0, 1.0]`.
pub probability: f64,
}
impl Variation<Vec<bool>> for BitFlipMutation {
fn vary(&mut self, parents: &[Vec<bool>], rng: &mut Rng) -> Vec<Vec<bool>> {
assert!(
(0.0..=1.0).contains(&self.probability),
"BitFlipMutation probability must be in [0.0, 1.0]",
);
assert!(
!parents.is_empty(),
"BitFlipMutation requires at least one parent",
);
let mut child = parents[0].clone();
for bit in child.iter_mut() {
if rng.random_bool(self.probability) {
*bit = !*bit;
}
}
vec![child]
}
}
#[cfg(test)]
mod tests {
use super::*;
use crate::core::rng::rng_from_seed;
#[test]
fn probability_zero_changes_nothing() {
let mut m = BitFlipMutation { probability: 0.0 };
let mut rng = rng_from_seed(0);
let parent = vec![false, true, false, true, true];
let children = m.vary(std::slice::from_ref(&parent), &mut rng);
assert_eq!(children.len(), 1);
assert_eq!(children[0], parent);
}
#[test]
fn probability_one_flips_everything() {
let mut m = BitFlipMutation { probability: 1.0 };
let mut rng = rng_from_seed(0);
let parent = vec![false, true, false, true, true];
let children = m.vary(std::slice::from_ref(&parent), &mut rng);
let expected: Vec<bool> = parent.iter().map(|b| !b).collect();
assert_eq!(children[0], expected);
}
#[test]
#[should_panic(expected = "must be in [0.0, 1.0]")]
fn probability_above_one_panics() {
let mut m = BitFlipMutation { probability: 1.5 };
let mut rng = rng_from_seed(0);
m.vary(&[vec![true]], &mut rng);
}
}