Struct SamplingPlane 

pub struct SamplingPlane { /* private fields */ }

A finite rectangular sampling plane embedded in three-dimensional space.

origin is the corner before the first cell. Columns advance along u and rows advance along v. A cell at (row, column) is sampled at its centre:

origin + (column + 1/2) * extent_u / columns * u + (row + 1/2) * extent_v / rows * v.

Construction validates the orthonormal frame, dimensions, derived cell sizes, and rows * columns before any caller needs to allocate grid storage.

Implementations

impl SamplingPlane

pub fn new( origin: Point3M, u_axis: UnitVector3, v_axis: UnitVector3, extent_u: PositiveMetres, extent_v: PositiveMetres, rows: usize, columns: usize, ) -> Result<Self, InterferenceError>

Constructs a checked finite sampling plane.

pub fn origin(self) -> Point3M

Returns the corner before the first cell.

pub fn u_axis(self) -> UnitVector3

Returns the direction in which columns advance.

pub fn v_axis(self) -> UnitVector3

Returns the direction in which rows advance.

pub fn normal(self) -> UnitVector3

Returns the right-handed unit normal u cross v.

pub fn extent_u(self) -> PositiveMetres

Returns the physical u extent.

pub fn extent_v(self) -> PositiveMetres

Returns the physical v extent.

pub fn rows(self) -> usize

Returns the number of rows along v.

pub fn columns(self) -> usize

Returns the number of columns along u.

pub fn cell_count(self) -> usize

Returns the checked product rows * columns.

pub fn cell_size_u_m(self) -> f64

Returns the centre-to-centre spacing along u in metres.

pub fn cell_size_v_m(self) -> f64

Returns the centre-to-centre spacing along v in metres.

pub fn point_at( self, row: usize, column: usize, ) -> Result<Point3M, InterferenceError>

Returns the exact centre defined for one sampling cell.

Trait Implementations

impl Clone for SamplingPlane

fn clone(&self) -> SamplingPlane

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SamplingPlane

impl Debug for SamplingPlane

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

Formats the value using the given formatter.

impl PartialEq for SamplingPlane

fn eq(&self, other: &SamplingPlane) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SamplingPlane