IS:trackEnd

trackEnd
 

Schema description / Schemenbeschreibung

Position of trackEnd in the XML-Tree / Position von trackEnd im XML-Baum

• Parent: <trackTopology>
• Children: (introduced with version 2.2) <geoCoord>, <bufferStop>, <connection>, <openEnd>, <macroscopicNode>

Multiplicity / Anzahl

[1..1]

Semantics / Bedeutung

The trackEnd defines the end of a track in the railML^® file. It could be seen as a "vertex" in a "graph" where the track is an "edge".
 
Please, be aware of the semantic constraint(s)!

Attributes of trackEnd / Attribute von trackEnd

• id: XML-file-wide unique, machine-interpretable identity, required for later referencing that element internally. For a detailed explanation see Dev:identities.
  XML-Datei-weit eindeutige, maschineninterpretierbare Identität, die für die spätere interne Referenzierung dieses Elements erforderlich ist. Für eine detaillierte Erklärung siehe Dev:identities.

• pos: This is the position on a track defined as distance from its start (trackBegin) regardless the "absolute mileage" in @absPos.
  Das ist die Position des Elements auf einem Track i.S. der realen Entfernung zum trackBegin. Sie ist damit unabhängig von der mit absPos modellierten Strecken-Kilometrierung.

🗒️ For an explanation of the differences between @pos and @absPos see <mileageChange>

• absPos: This is the position on a track as absolute mileage/chainage.
  Das ist die Position des Elements im Referenzsystem der Strecken-Kilometrierung.

🗒️ For an explanation of the differences between @pos and @absPos see <mileageChange>

• absPosOffset (deprecated with version 2.1): The semantics of this attribute aren't very clear. It seems to be redundant to the definitions with mileageChanges in "overlapping regions".
• absPosIn: the mileage of the (incoming) line in meters

Syntactic Constraints / Syntaktische Beschränkungen

• id: xs:ID, required
  a string, starting with a letter (a..zA..Z) or an underscore (_),
  followed by a non-colonized and non-spaced string consisting of letters, digits, points (.), dashes (-) or underscores (_)

• pos: tLengthM (xs:decimal, 6 fraction digits, length value measured in meter); required; must be greater than or equal to zero, less than or equal to the track's length
  The end of the track is defined by the "real" length of the track as distance from the trackBegin regardless the "absolute mileage" in absPos.
• absPos: tLengthM (xs:decimal, 6 fraction digits, length value measured in meter); optional
  If two tracks are connected, the absPos values of the connected <trackBegin> and <trackEnd> must be identical just in case both are provided and no mileageChange at this point is defined and both tracks belong to the same "mileage system" (typically the same line and same owner).
  If absPos is used in <trackEnd> then it should be used in <trackBegin> for unambiguity reasons, too.
• absPosOffset: xs:decimal, 6 fraction digits, length value measured in meter; optional
• absPosIn: tLengthM (xs:decimal, 6 fraction digits, length value measured in meter); optional

Semantic Constraints / Semantische Beschränkungen

Proposed Semantic Constraint "IS:002":   The value of @pos in <trackBegin> is always the lowest value of all specified <trackElements> and <ocsElements>. It is always lower than the value of @pos of <trackEnd>. The value of @pos in <trackEnd> is always the highest value of all specified <trackElements> and <ocsElements>. It is always higher than the value of @pos of <trackBegin>. Subtracting the value of @pos in <trackBegin> from the value of @pos in <trackEnd> will result in the length of the enclosing <track>. If two <track>s are connected, the @absPos values of the connected <trackBegin> and <trackEnd> must be identical if both are provided and no <mileageChange> is defined at this point and both <track>s belong to the same mileage system.   Proposed on June 17th 2019 FIXME: add Link to discussion! Please, recognize our guidelines on semantic constraints

Best practice & Examples / Empfohlene Anwendung & Beispiele

Consider the railML^® 2.3 example of Middle Rhine Railway by GPSinfradat

View/edit list on the separate source page.

TrackID	LineID	BeginElementType	EndElementType	OCP Start	OCP End
26301	2630	oE	mN	KKO	FBGK
35102	3510	oE	mN	FMZ	FBGK
35113	3511	mN	oE	FBGK	SBKNG

This code example defines a track end that is an open end.

<trackEnd id="tE35113" pos="16310" absPos="16200">
  <openEnd id="oEe35113"/>
</trackEnd>

This code example defines a track end that is a macroscopic node.

<trackEnd id="tE26301" pos="61366" absPos="152415">
  <macroscopicNode ocpRef="ocpFBGK"/>
</trackEnd>

Consider the railML^® 2.2 example of East Saxony railway network by FBS

This code example defines a track end that is a macroscopic node.

<trackEnd id='trn_DG_80.6212_1' pos='102100' absPos='0'>
  <macroscopicNode ocpRef='ocp_DG'/>
</trackEnd>

Notes / Anmerkungen

General information on positioning

Positive pos values describe the distance from the track's begin. The track length is derived from the pos value in <trackEnd>.

The absolute mileage refered to by absPos is usually found on technical drawings of the track layout or on mileage posts next to the track.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.