Struct PenaltyMap 

pub struct PenaltyMap { /* private fields */ }

Penalty-map metric – base distance plus per-cell penalty difference.

Cost = base_metric.delta_cost(from, to) + |penalty[from] - penalty[to]|.

The penalty map is a 2D array (row-major, height x width) of integer penalties. This is useful for modeling terrain height, road quality, etc.

Mirrors Agents.jl PenaltyMap.

Example

use rustsim_pathfinding::metrics::{PenaltyMap, DirectDistance};

// 5x5 grid with a hill in the center
let mut penalties = vec![0i32; 25];
penalties[2 * 5 + 2] = 100; // cell (2,2) is expensive

let metric = PenaltyMap::new(penalties, 5, 5, DirectDistance::new()).unwrap();

Implementations

impl PenaltyMap

pub fn new( penalties: Vec<i32>, width: usize, height: usize, base: impl CostMetric + 'static, ) -> Result<Self, PenaltyMapError>

Create a penalty map metric.

pub fn penalties(&self) -> &[i32]

Read-only access to the penalty values.

pub fn penalties_mut(&mut self) -> &mut [i32]

Mutable access to the penalty values (e.g. for dynamic terrain).

pub fn penalty_at(&self, x: usize, y: usize) -> i32

Get the penalty at a grid cell.

Trait Implementations

impl CostMetric for PenaltyMap

fn delta_cost( &self, from: (usize, usize), to: (usize, usize), periodic: bool, width: usize, height: usize, diagonal: bool, ) -> f64

Estimate the cost of traveling from from to to.

impl Debug for PenaltyMap

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

Formats the value using the given formatter.