Struct CantLayout 

#[non_exhaustive]
pub struct CantLayout {
    pub entity: EntityId,
    pub rail_head_distance: f64,
    /* private fields */
}

One resolved, ordered, continuity-checked cant profile.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

entity: EntityId

The IfcAlignmentCant entity this layout was resolved from.

rail_head_distance: f64

RailHeadDistance: track gauge used to convert cant to superelevation angle, in metres.

Implementations

impl CantLayout

pub fn frame_at_distance( &self, distance_along: f64, ) -> AlignmentResult<CantFrame>

The cant cross-section at an absolute distance along.

Errors

Refuses a distance outside the profile’s span, a segment whose cant cannot be evaluated exactly, and a cant exceeding the RailHeadDistance (|D| > b, no real bank angle).

impl CantLayout

pub fn resolve( model: &Model, entity: EntityId, units: AlignmentUnits, ) -> AlignmentResult<Self>

Resolve IfcAlignmentCant#entity’s nested IfcAlignmentSegment chain into an ordered, continuity-checked cant profile.

The zero-length segment IFC4.3 requires at the end of a layout is kept in Self::segments; its station and start cant are checked against the previous segment’s end like any seam. A zero-length segment anywhere else, or as the only segment, is refused (AlignmentError::SemanticViolation).

pub fn for_alignment( model: &Model, alignment: EntityId, units: AlignmentUnits, ) -> AlignmentResult<Self>

The cant layout of IfcAlignment#alignment.

Unlike the gradient-curve composition, where a road without cant is ordinary, this is the call for work that NEEDS cant (the section frames, the IfcSegmentedReferenceCurve role), so its absence is a refusal rather than None.

Errors

Refuses a model that is not IFC4X3, an entity that is not an IfcAlignment, an alignment nesting no IfcAlignmentCant or several of them (SemanticViolation: picking one would silently choose a track), and everything Self::resolve refuses.

pub fn segments(&self) -> &[CantSegment]

Segments in authored (distance-along) order.

pub fn length(&self) -> f64

Total distance-along span covered by this profile.

pub fn cant_at_distance( &self, distance_along: f64, ) -> AlignmentResult<CantAtStation>

Cant at an absolute distance-along value within this profile’s span.

Trait Implementations

impl Clone for CantLayout

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CantLayout

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

Formats the value using the given formatter.

impl PartialEq for CantLayout

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CantLayout