RTM:linearPositioningSystem

Introduction

See linear positioning system in the RailTopoModel^® Wiki.

Documentation

Syntax

3.33.23.1

Autoexport from the XML-Schema for element RTM:linearPositioningSystem of railML® version 3.3      UML-visualization of RTM
Description	Linear positioning systems work in one dimension. They are a typical way to specifiy the location of an entity on a railway. The one given coordinate for an entity in a linear positioning system positions the entity following the layout of the track.
Subschema	Rtm4railml
Parents*	linearPositioningSystems
Children**	name (0..*), isValid (1..*), anchor (0..*)
Attributes: endMeasure: last value in the direction on mileage of the line (at its end) associated with the enclosing linear positioning system (obligatory: xs:double : xs:double), linearReferencingMethod: specifies a way of how the coordinates were determined (obligatory: tLrsMethod : xs:string) Possible values: absolute: mileage i.e. distance from beginning of a line interpolation: determine location by interpolating between two known locations along a route. relative: relative to some point on a line, not a beginning of a line, startMeasure: first value in the direction on mileage of the line (at its beginning) associated with the enclosing linear positioning system (obligatory: xs:double : xs:double), units: use SI units (e.g. metres) whenever possible (obligatory: LinearPositioningSystemUnitExt : xs:string: patterns: other:\w{2,}; consider Use of tOtherEnumerationValue too.) Possible values: metres miles, id: the file-internal ID of the object (obligatory: tID : xs:ID): compare: Dev:Identities
*Notice: Elements may have different parent elements. As a consequence they may be used in different contexts. Please, consider this as well as a user of this Wiki as when developing this documentation further. Aspects that are only relevant with respect to one of several parents should be explained exclusively in the documentation of the respective parent element. **Notice: To learn, how to interpret multiplicity information like (0..*) go to Class diagram ()

Autoexport from the XML-Schema for element RTM:linearPositioningSystem of railML® version 3.2      UML-visualization of RTM
Description	Localization expressed in a linear reference system, generally a coordinate along a predefined axis.
Subschema	Rtm4railml
Parents*	linearPositioningSystems
Children**	name (0..*), isValid (1..*), anchor (0..*)
Attributes: endMeasure: last value in the direction on mileage of the line (at its end) associated with the enclosing linear positioning system (obligatory: xs:double : xs:double), linearReferencingMethod: specifies a way of how the coordinates were determined (obligatory: tLrsMethod : xs:string) Possible values: absolute: mileage i.e. distance from beginning of a line interpolation: determine location by interpolating between two known locations along a route. relative: relative to some point on a line, not a beginning of a line, startMeasure: first value in the direction on mileage of the line (at its beginning) associated with the enclosing linear positioning system (obligatory: xs:double : xs:double), units: use SI units (e.g. metres) whenever possible (obligatory: xs:string : xs:string), id: the identifier of the object; this can be either of type xs:ID or UUID (obligatory: tID : xs:string: patterns: (urn:uuid: )?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|\{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}\}): compare: Dev:Identities
*Notice: Elements may have different parent elements. As a consequence they may be used in different contexts. Please, consider this as well as a user of this Wiki as when developing this documentation further. Aspects that are only relevant with respect to one of several parents should be explained exclusively in the documentation of the respective parent element. **Notice: To learn, how to interpret multiplicity information like (0..*) go to Class diagram ()

Autoexport from the XML-Schema for element RTM:linearPositioningSystem of railML® version 3.1      UML-visualization of RTM
Description	This element is not documented in the schema!
Subschema	Rtm4railml
Parents*	linearPositioningSystems
Children**	name (0..*), isValid (1..*), anchor (0..*)
Attributes: linearReferencingMethod: This attribute is not documented in the schema! (obligatory: tLrsMethod : xs:string) Possible values: interpolation relative absolute, startMeasure: This attribute is not documented in the schema! (obligatory: xs:double : xs:double), endMeasure: This attribute is not documented in the schema! (obligatory: xs:double : xs:double), units: use SI units (e.g. metres) whenever possible (obligatory: xs:string : xs:string), id: the identifier of the object; this can be either of type xs:ID or UUID (obligatory: tID : xs:ID: patterns: (urn:uuid: )?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|\{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}\}): compare: Dev:Identities
*Notice: Elements may have different parent elements. As a consequence they may be used in different contexts. Please, consider this as well as a user of this Wiki as when developing this documentation further. Aspects that are only relevant with respect to one of several parents should be explained exclusively in the documentation of the respective parent element. **Notice: To learn, how to interpret multiplicity information like (0..*) go to Class diagram ()

Changes 3.1→3.2

There exists an overview of all changes between railML^® 3.1 and railML^® 3.2 on page Dev:Changes/3.2.

The element documentation has been changed.

The children have been changed.

The attributes have been changed.

Changes 3.2→3.3

There exists an overview of all changes between railML^® 3.2 and railML^® 3.3 on page Dev:Changes/3.3.

The element documentation has been changed.

The attributes have been changed.

Semantics

Semantic Constraint "IS:023":   <linearCoordinate>/@measure , <linearCoordinateBegin>/@measure , <linearCoordinateEnd>/@measure must be ≥ @startMeasure and ≤ @endMeasure of the corresponding <linearPositioningSystem>.   Proposed on 17 February 2025 Approved on 8 September 2025 Making consistent linearPositioningSystem and linear coordinates (link to the railML® website) Please, recognize our guidelines on semantic constraints

Proposed Semantic Constraint "IS:014":   @startMeasure and @endMeasure are start and end values of a railway <IS:line> associated with <RTM:linearPositioningSystem> not max and min values of a current file with e.g. line section   Proposed on 8 April 2024 Restricting IS:line and RTM:linearPositioningSystem (link to the railML® website)". Please, recognize our guidelines on semantic constraints

Best Practice / Examples

Please refer to <anchor> for an example.