Struct Flock 

pub struct Flock {
    pub boids: Vec<Boid>,
    pub config: FlockConfig,
    pub obstacles: Vec<Obstacle>,
    pub leader: Option<Vec3>,
    pub predators: Vec<Vec3>,
}

The complete flock — owns and ticks all boids each frame.

Fields

boids: Vec<Boid>

config: FlockConfig

obstacles: Vec<Obstacle>

leader: Option<Vec3>

predators: Vec<Vec3>

Implementations

impl Flock

pub fn new(config: FlockConfig) -> Self

pub fn spawn_circle(&mut self, n: usize, center: Vec3, radius: f32)

Spawn N boids in a circle at the given center with random velocities.

pub fn spawn_scatter(&mut self, n: usize, center: Vec3, radius: f32, seed: u64)

Spawn N boids in a random scatter within radius.

pub fn tick(&mut self, dt: f32)

Tick all boids by dt seconds. Computes neighbor lists and integrates.

pub fn add_obstacle(&mut self, center: Vec3, radius: f32)

Add a spherical obstacle to avoid.

pub fn set_leader(&mut self, pos: Option<Vec3>)

Set the leader position (boids will follow).

pub fn set_predators(&mut self, predators: Vec<Vec3>)

Set predator positions (boids will flee).

pub fn len(&self) -> usize

Number of boids.

pub fn is_empty(&self) -> bool

pub fn centroid(&self) -> Vec3

Average position (flock centroid).

pub fn avg_speed(&self) -> f32

Average speed.

pub fn cohesion_metric(&self) -> f32

Cohesion metric: 1.0 = tight flock, 0.0 = completely scattered. Measured as 1 / (1 + average distance from centroid).

pub fn polarization(&self) -> f32

Polarization: how aligned the flock velocity is (1.0 = all same direction).

pub fn remove_if(&mut self, predicate: impl Fn(&Boid) -> bool)

Kill and remove boids with a predicate.