Struct Grid2D 

pub struct Grid2D { /* private fields */ }

Multi-occupancy 2D grid space.

Each cell can hold an arbitrary number of agents. Backed by a flat Vec<Vec<AgentId>> of size width x height.

Boundary modes

• periodic = true - toroidal wrapping (positions are taken modulo grid size).
• periodic = false - bounded (out-of-bounds positions return an error).

Implementations

impl Grid2D

pub fn new(width: usize, height: usize, periodic: bool) -> Self

Create a new multi-occupancy grid.

Panics

Panics if width or height is zero.

pub fn dimensions(&self) -> (usize, usize)

Grid dimensions as (width, height).

pub fn periodic(&self) -> bool

Whether the grid wraps around (toroidal boundaries).

pub fn is_in_bounds(&self, pos: GridPos2) -> bool

Check whether a position is within the grid bounds.

pub fn is_empty(&self, pos: GridPos2) -> bool

Check whether a cell has no agents.

pub fn ids_in_position(&self, pos: GridPos2) -> Option<&[AgentId]>

Return the agent IDs at a given position, or None if out of bounds.

pub fn add_agent(&mut self, pos: GridPos2, id: AgentId) -> Result<(), GridError>

Register an agent at a position.

pub fn remove_agent( &mut self, pos: GridPos2, id: AgentId, ) -> Result<bool, GridError>

Deregister an agent from a position. Returns Ok(true) if found and removed.

Trait Implementations

impl Clone for Grid2D

fn clone(&self) -> Grid2D

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Grid2D

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

Formats the value using the given formatter.

impl<A> SpaceInteraction<A> for Grid2D

where A: PositionedAgent<Position = GridPos2>,

type Error = GridError

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 Grid2D