Struct AbcState 

pub struct AbcState<B: Backend> { /* private fields */ }

Generation state for ArtificialBeeColony.

Fields are private so the per-bee caches cannot fall out of sync with the colony size from outside this module; construct one with try_new and read it through the accessors.

Implementations

impl<B: Backend> AbcState<B>

pub fn try_new( colony: Tensor<B, 2>, fitness: Vec<f32>, trial: Vec<usize>, target_of_candidate: Vec<usize>, best_genome: Option<Tensor<B, 2>>, best_fitness: f32, generation: usize, ) -> Result<Self, ConfigError>

Assembles a colony state, checking the per-bee caches match the colony.

Errors

Returns a ConfigError if the colony has zero rows, if fitness or trial is non-empty with a length other than pop_size, or if target_of_candidate is non-empty with a length other than 2 · pop_size.

pub fn colony(&self) -> &Tensor<B, 2>

Current colony, shape (pop_size, D).

pub fn fitness(&self) -> &[f32]

Host-side fitness cache (empty at bootstrap, else pop_size long).

pub fn trial(&self) -> &[usize]

Per-bee trial counters, pop_size long.

pub fn target_of_candidate(&self) -> &[usize]

Candidate-to-bee mapping recorded by ask (2 · pop_size long, or empty at bootstrap).

pub fn best_genome(&self) -> Option<&Tensor<B, 2>>

Best-so-far genome, or None before the first tell.

pub fn best_fitness(&self) -> f32

Best-so-far (canonical, maximise) fitness.

pub fn generation(&self) -> usize

Generation counter.

Trait Implementations

impl<B: Clone + Backend> Clone for AbcState<B>

fn clone(&self) -> AbcState<B>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<B: Debug + Backend> Debug for AbcState<B>

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

Formats the value using the given formatter.