Struct Line1D 

pub struct Line1D { /* private fields */ }

A one-dimensional line lattice.

Each cell has coordinate [i] where 0 <= i < len. Boundary handling is controlled by EdgeBehavior:

• Absorb: edge cells have fewer neighbors
• Clamp: edge cells self-loop
• Wrap: periodic boundary (equivalent to Ring1D)

Examples

use murk_space::{Line1D, EdgeBehavior, Space};

let line = Line1D::new(5, EdgeBehavior::Absorb).unwrap();
assert_eq!(line.len(), 5);
assert_eq!(line.cell_count(), 5);
assert_eq!(line.ndim(), 1);

// Interior cell has two neighbours.
let coord: murk_core::Coord = vec![2i32].into();
assert_eq!(line.neighbours(&coord).len(), 2);

// Edge cell (absorb) has only one neighbour.
let edge: murk_core::Coord = vec![0i32].into();
assert_eq!(line.neighbours(&edge).len(), 1);

Implementations

impl Line1D

pub const MAX_LEN: u32

Maximum length: coordinates use i32, so len must fit.

pub fn new(len: u32, edge: EdgeBehavior) -> Result<Self, SpaceError>

Create a new 1D line with len cells and the given edge behavior.

Returns Err(SpaceError::EmptySpace) if len == 0, or Err(SpaceError::DimensionTooLarge) if len > i32::MAX.

pub fn len(&self) -> u32

Number of cells.

pub fn is_empty(&self) -> bool

Always returns false — construction rejects len == 0.

pub fn edge_behavior(&self) -> EdgeBehavior

Edge behavior.

Trait Implementations

impl Clone for Line1D

fn clone(&self) -> Line1D

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Line1D

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

Formats the value using the given formatter.

impl Space for Line1D

fn ndim(&self) -> usize

Number of spatial dimensions.

fn cell_count(&self) -> usize

Total number of cells in the space.

fn neighbours(&self, coord: &Coord) -> SmallVec<[Coord; 8]>

Enumerate the neighbors of a cell.

fn max_neighbour_degree(&self) -> usize

Maximum neighbor-list length over all cells in this space.

fn distance(&self, a: &Coord, b: &Coord) -> f64

Graph-geodesic distance between two cells.

fn compile_region(&self, spec: &RegionSpec) -> Result<RegionPlan, SpaceError>

Compile a region specification into a plan for O(1) lookups.

fn canonical_ordering(&self) -> Vec<Coord>

All cells in deterministic canonical order.

fn canonical_rank(&self, coord: &Coord) -> Option<usize>

Position of a coordinate in the canonical ordering.

fn canonical_rank_slice(&self, coord: &[i32]) -> Option<usize>

Position of a coordinate slice in the canonical ordering.

fn instance_id(&self) -> SpaceInstanceId

Unique instance identifier for this space object.

fn topology_eq(&self, other: &dyn Space) -> bool

Returns true if self and other are topologically equivalent: same concrete type and identical behavioral parameters.

fn iter_region<'a>( &'a self, plan: &'a RegionPlan, ) -> Box<dyn Iterator<Item = Coord> + 'a>

Iterate over the cells in a compiled region.

fn map_coord_to_tensor_index( &self, coord: &Coord, plan: &RegionPlan, ) -> Option<usize>

Map a coordinate to its flat tensor index within a compiled region.