Struct ProjectedPosition 

pub struct ProjectedPosition {
    pub original: GnssPosition,
    pub projected_coords: Point<f64>,
    pub netelement_id: String,
    pub measure_meters: f64,
    pub projection_distance_meters: f64,
    pub crs: String,
    pub intrinsic: Option<f64>,
}

Represents a GNSS position projected onto a railway netelement

A ProjectedPosition is the result of projecting a GNSS measurement onto the nearest railway track segment. It preserves the original GNSS data and adds:

• Projected coordinates on the track centerline
• Measure (distance along track from netelement start)
• Projection distance (perpendicular distance from original to projected point)
• Netelement assignment

Use Cases

• Calculate train progress along tracks
• Analyze position accuracy and quality
• Detect track deviations or sensor errors
• Generate linear referencing for asset management

Examples

use tp_lib_core::{parse_gnss_csv, parse_network_geojson, RailwayNetwork};
use tp_lib_core::{project_gnss, ProjectionConfig};

// Load and project data
let (netelements, _netrelations) = parse_network_geojson("network.geojson")?;
let network = RailwayNetwork::new(netelements)?;
let positions = parse_gnss_csv("gnss.csv", "EPSG:4326", "latitude", "longitude", "timestamp")?;

let config = ProjectionConfig::default();
let projected = project_gnss(&positions, &network, &config)?;

// Analyze results
for pos in projected {
    println!("Track position: {}m on {}", pos.measure_meters, pos.netelement_id);
    println!("Projection accuracy: {:.2}m", pos.projection_distance_meters);
}

Fields

original: GnssPosition

Original GNSS measurement (preserved)

projected_coords: Point<f64>

Projected coordinates on the track axis

netelement_id: String

ID of the netelement this position was projected onto

measure_meters: f64

Distance along the netelement from start (in meters)

projection_distance_meters: f64

Distance between original GNSS position and projected position (in meters)

crs: String

Coordinate Reference System of the projected coordinates

intrinsic: Option<f64>

Intrinsic coordinate (0-1 range) relative to netelement start Only populated when projecting onto a calculated train path (US2)

Implementations

impl ProjectedPosition

pub fn new( original: GnssPosition, projected_coords: Point<f64>, netelement_id: String, measure_meters: f64, projection_distance_meters: f64, crs: String, ) -> Self

Create a new projected position

pub fn with_intrinsic( original: GnssPosition, projected_coords: Point<f64>, netelement_id: String, measure_meters: f64, projection_distance_meters: f64, crs: String, intrinsic: f64, ) -> Self

Create a new projected position with intrinsic coordinate (for path projection)

Trait Implementations

impl Clone for ProjectedPosition

fn clone(&self) -> ProjectedPosition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProjectedPosition

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProjectedPosition

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ProjectedPosition

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

where __S: Serializer,

Serialize this value into the given Serde serializer.