Struct DensityGrid 

pub struct DensityGrid { /* private fields */ }

Spatial density grid for computing agents-per-square-meter.

Implementations

impl DensityGrid

pub fn new( extent_x: f64, extent_y: f64, cell_size: f64, ) -> Result<Self, DensityGridError>

Create a new density grid.

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

Grid dimensions as (width_cells, height_cells).

pub fn cell_size(&self) -> f64

Cell side length in meters.

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

Space extent as (extent_x, extent_y).

pub fn add_position(&mut self, x: f64, y: f64)

Register an agent’s position.

Positions outside the extent are clamped to the nearest edge cell.

pub fn add_positions(&mut self, positions: impl IntoIterator<Item = (f64, f64)>)

Register multiple agent positions from an iterator of (x, y) pairs.

pub fn count_at(&self, x: f64, y: f64) -> u32

Agent count in the cell containing (x, y).

pub fn density_at(&self, x: f64, y: f64) -> f64

Density (agents per cell area) in the cell containing (x, y).

pub fn los_at(&self, x: f64, y: f64, criteria: &dyn LosCriteria) -> LosGrade

LoS grade for the cell containing (x, y) using the given criteria.

pub fn density_at_cell(&self, cx: usize, cy: usize) -> f64

Density for a specific cell index (cx, cy).

pub fn count_at_cell(&self, cx: usize, cy: usize) -> u32

Agent count for a specific cell index (cx, cy).

pub fn max_density(&self) -> f64

Maximum density across all cells.

pub fn mean_density_occupied(&self) -> f64

Mean density across occupied cells only.

Returns 0.0 if no cells are occupied.

pub fn mean_density_all(&self) -> f64

Mean density across all cells.

pub fn statistics(&self, criteria: &dyn LosCriteria) -> DensityStatistics

Compute full statistics using the given LoS criteria.

pub fn counts(&self) -> &[u32]

Raw counts slice (row-major: counts[cy * grid_w + cx]).

pub fn total_agents(&self) -> usize

Total number of agents registered.

pub fn clear(&mut self)

Clear all counts for the next time step.

Trait Implementations

impl Clone for DensityGrid

fn clone(&self) -> DensityGrid

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DensityGrid

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

Formats the value using the given formatter.