Struct TrainPath 

pub struct TrainPath {
    pub segments: Vec<AssociatedNetElement>,
    pub overall_probability: f64,
    pub calculated_at: Option<DateTime<Utc>>,
    pub metadata: Option<PathMetadata>,
}

Represents a continuous train path through the rail network

A TrainPath is an ordered sequence of netelements (track segments) that the train traversed, calculated from GNSS coordinates and network topology.

Examples

use tp_lib_core::{TrainPath, AssociatedNetElement};
use chrono::Utc;

let segments = vec![
    AssociatedNetElement::new(
        "NE_A".to_string(), 0.87, 0.0, 1.0, 0, 10
    )?,
    AssociatedNetElement::new(
        "NE_B".to_string(), 0.92, 0.0, 1.0, 11, 18
    )?,
];

let path = TrainPath::new(
    segments,
    0.89,
    Some(Utc::now()),
    None,
)?;

assert_eq!(path.segments.len(), 2);
assert_eq!(path.overall_probability, 0.89);

Fields

segments: Vec<AssociatedNetElement>

Ordered sequence of netelements in the path Order represents the direction of travel from first to last GNSS position

overall_probability: f64

Overall probability score for this path (0.0 to 1.0) Calculated as length-weighted average of segment probabilities, averaged between forward and backward path calculations

calculated_at: Option<DateTime<Utc>>

Timestamp when this path was calculated

metadata: Option<PathMetadata>

Algorithm configuration metadata

Implementations

impl TrainPath

pub fn new( segments: Vec<AssociatedNetElement>, overall_probability: f64, calculated_at: Option<DateTime<Utc>>, metadata: Option<PathMetadata>, ) -> Result<Self, ProjectionError>

Create a new train path with validation

pub fn diagnostics(&self) -> PathDiagnosticInfo

Build diagnostic info from the current segments (order, intrinsics, probabilities)

pub fn with_metadata(self, metadata: PathMetadata) -> Self

Attach metadata, auto-populating diagnostic info if not provided

pub fn total_fractional_length(&self) -> f64

Calculate total path length (sum of fractional lengths)

pub fn netelement_ids(&self) -> Vec<&str>

Get netelement IDs in traversal order

pub fn total_gnss_positions(&self) -> usize

Total number of GNSS positions in path

Trait Implementations

impl Clone for TrainPath

fn clone(&self) -> TrainPath

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TrainPath

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TrainPath

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TrainPath

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.