Struct ContinuousSpace2D 

pub struct ContinuousSpace2D { /* private fields */ }

2D continuous space with spatial hashing.

Agents are tracked by position and indexed into a uniform grid for fast neighbor queries. The grid cell size (spacing) determines the tradeoff between query accuracy and move_agent_pos overhead.

Boundary modes

• periodic = true - toroidal wrapping.
• periodic = false - bounded; out-of-bounds positions return ContinuousSpaceError::OutOfBounds.

Implementations

impl ContinuousSpace2D

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

Create a new 2D continuous space.

Arguments

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

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

Space dimensions as (extent_x, extent_y).

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<&ContinuousPos>

Look up the current position of an agent.

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

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: &ContinuousPos, radius: f64, ) -> Vec<AgentId>

Find all agent IDs within Euclidean distance radius of pos.

Respects periodic boundaries when enabled.

Trait Implementations

impl Clone for ContinuousSpace2D

fn clone(&self) -> ContinuousSpace2D

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContinuousSpace2D

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

Formats the value using the given formatter.

impl<A> SpaceInteraction<A> for ContinuousSpace2D

where A: PositionedAgent<Position = ContinuousPos>,

type Error = ContinuousSpaceError

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 ContinuousSpace2D