Struct ContinuousSpace3D 

pub struct ContinuousSpace3D { /* private fields */ }

3D continuous space with uniform-grid spatial hashing for fast neighbor queries.

The space spans [0, extent_x) x [0, extent_y) x [0, extent_z). An internal grid of cells (side length = spacing) accelerates nearby_ids_euclidean to O(k) where k is the number of agents in the neighborhood, rather than O(n).

Implementations

impl ContinuousSpace3D

pub fn new( extent_x: f64, extent_y: f64, extent_z: f64, periodic: bool, spacing: f64, ) -> Result<Self, ContinuousSpace3DConfigError>

Create a new 3D continuous space.

Arguments

• extent_x, extent_y, extent_z - space dimensions.
• periodic - whether boundaries wrap.
• spacing - cell side length for the spatial hash grid.

pub fn extent(&self) -> (f64, f64, f64)

Space dimensions as (extent_x, extent_y, extent_z).

pub fn periodic(&self) -> bool

Whether the space wraps around (toroidal boundaries).

pub fn spacing(&self) -> f64

Cell side length for the spatial hash grid.

pub fn agent_position(&self, id: AgentId) -> Option<&ContinuousPos3D>

Look up the current position of an agent.

pub fn move_agent_pos( &mut self, id: AgentId, new_pos: ContinuousPos3D, ) -> Result<ContinuousPos3D, ContinuousSpace3DError>

Move an agent to a new position, updating the spatial hash.

Returns the (possibly normalized) final position, or an error if the position is out of bounds in a non-periodic space.

pub fn nearby_ids_euclidean( &self, pos: &ContinuousPos3D, radius: f64, ) -> Vec<AgentId>

Find all agent IDs within Euclidean distance radius of pos.

Respects periodic boundaries when enabled.

Trait Implementations

impl Clone for ContinuousSpace3D

fn clone(&self) -> ContinuousSpace3D

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContinuousSpace3D

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

Formats the value using the given formatter.

impl<A> SpaceInteraction<A> for ContinuousSpace3D

where A: PositionedAgent<Position = ContinuousPos3D>,

type Error = ContinuousSpace3DError

Error type for space operations.

fn random_position<R: RngCore>(&self, rng: &mut R) -> A::Position

Generate a random valid position within this space.

fn add_agent(&mut self, agent: &A) -> Result<(), Self::Error>

Register an agent with the space at its current position.

fn remove_agent(&mut self, agent: &A) -> Result<(), Self::Error>

Deregister an agent from the space.

fn nearby_ids(&self, position: &A::Position, radius: usize) -> Vec<AgentId>

Return all agent IDs within radius of position.

impl Space for ContinuousSpace3D