IS:mileageChange
mileageChange
Scheme description / Schemenbeschreibung
Position of mileageChange in the XML-Tree / Position von mileageChange im XML-Baum
- Parent: <mileageChanges>
- Children: <additionalName>, <any>, <geoCoord> (introduced with version 2.2)
Multiplicity / Anzahl
Semantics / Bedeutung
A <mileageChange> defines the position of a track where metering of mileage changes. To identify the initial mileage valid from the beginning of a track - before the first mileage change happens - the attributes @absPos and @absDir of the element <trackBegin> are used. Do not use a <mileageChange> at the beginning of a track, if you do not have any information about mileages before that track begins.
Ein <mileageChange>-Element gibt eine Stelle an, an der sich die absolute (außen sichtbare) Kilometrierung eines Streckengleises ändert, d. h. eine Unstetigkeitsstelle aufweist. Die ursprüngliche absolute Kilometrierung, die vom Anfang des Gleises bis zum ersten <mileageChange>-Element gilt, wird durch die Attribute @absPos und @absDir des Elements <trackBegin> definiert. Verwenden Sie kein <mileageChange> am Anfang eines Gleises, wenn Sie keine Informationen über die Kilometrierung vor Beginn dieses Gleises haben.
Please, be aware of the semantic constraint(s)!
Attributes of mileageChange / Attribute von mileageChange
- 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. - code (introduced with version 2.1): Machine-interpretable string (e.g. an abbreviation) used for identification of the object across exchange partners, usecase specific uniqueness constraints may apply. Please see our description of the differences between id, code and human-readable identifiers.
Maschineninterpretierbare Zeichenkette (z.B. Abkürzung), die zur Identifizierung des Objekts auch bei Austauschpartnern verwendet wird, wobei spezifische Eindeutigkeitsbeschränkungen gelten können. Bitte beachten Sie unsere Erläuterung zu den Unterschieden zwischen id, code and menschenlesbaren Kennzeichnungen. - name: Established, human-readable short string, giving the object a name. Not intended for machine interpretation, please see our notice on human interpretable data fields.
Etablierte, menschenlesbare kurze Zeichenkette, die das Objekt benennt. Nicht zur maschinellen Interpretation bestimmt, siehe Hinweise zu menschenlesbaren Datenfeldern. - description: Human-readable, more detailed description as addition to the name. It should give additional explanations or hints to the contents of this element. Not intended for machine interpretation, please see our notice on human interpretable data fields.
Menschenlesbare, detailliertere Beschreibung als Ergänzung zu name. Sie soll zusätzliche Erläuterungen oder Hinweise auf den Inhalt dieses Elements geben. Nicht zur maschinellen Interpretation bestimmt, siehe Hinweise zu menschenlesbaren Datenfeldern. - xml:lang (introduced with version 2.1): This is a unique identifier of language. It uses basically the language standard IETF BCP 47 (external link) which may be different to ISO 639-1 (external link) or ISO 639-2 (external link). For mapping hints see relation to other standards (external link).
This defines the language used for name and description. Use <additionalName> to provide a name and/or description in other languages. - 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.
|
- absPos: This is the position on a track as absolute mileage/chainage.
Official, often historical, mileage (written e.g. at mileposts (external link) or in drivers timetables) and used for most daily practical usage in railway operation.
Offizieller, oft historischer, Kilometer (z.B. an Hekto-/Kilometertafeln (external link) oder in Dienst-/Buchfahrplänen (external link)) und wird für die meisten praktischen Anwendungen im Bahnbetrieb verwendet.
|
- dir (deprecated with version 2.2): Specifies the counting direction of the new mileage valid from this mileageChange. The values up and down of this attribute relate to numerical interpretation (rising, falling = “to count up or down”).
Side note: Therefore, they could differ from the typical usage in British English where “up” relates on “direction to London” and “down” relates on “direction away from London”.
Gibt die ab diesem mileageChange-Element gültige Zählrichtung der neuen absoluten Kilometrierung an. Die Ausprägungen up und down dises Attributs sind numerisch zu interpretieren („hochzählen“, „runterzählen“).
Seitennotiz: Damit weichen diese Begriffe ggf. vom britischen Sprachgebrauch ab, wo „up“ = „in Richtung London“ und „down“ = „weg von London“ bedeuten können.
- absPosIn: This attribute specifies the "old" absolute mileage (which is valid up to this mileageChange).
Dieses Attribut gibt die „alte“ (bisherige) absolute Kilometrierung an einem mileageChange-Element an.
- absPosInOffset (deprecated with version 2.1)
- type: Refers to the typical historic reasons for mileage changes where there is either a shortening of the track (missing) or a lengthening (overlapping).
Hier wird die Art Kilometrierungssprungs angegeben werden. Dies bezieht sich terminologisch auf die in der Praxis unterschiedenen Begriffe „Fehlerstelle“ (missing) und „Überlänge“ (overlapping).
- absDir (introduced with version 2.2): Defines whether the new mileage valid from this mileageChange increases (raising) or decreases (falling) towards the <trackEnd>.
|
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 (_) - code: xs:string, optional
- name: xs:string, optional
- description: xs:string, optional
- xml:lang: xs:language, language identification, optional
- 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
- absPos: tLengthM (xs:decimal, 6 fraction digits, length value measured in meter); optional
- dir: tStrictDirection (xs:string, generic type for more constrained direction statements: enumeration up, down; derived from tLaxDirection); optional
- absPosIn: tLengthM (xs:decimal, 6 fraction digits, length value measured in meter); required
- absPosInOffset: tLengthM (xs:decimal, 6 fraction digits, length value measured in meter); optional (deprecated with version 2.1)
- type: tMileageChangeDescr (Restriction of xs:string (enumeration)); required
- absDir: tMileageDirection (xs:string, generic type for mileage direction statements; enumeration raising [Sic!], falling); optional: xs:string, generic type for mileage direction statements; enumeration raising [Sic!], falling
Semantic Constraints / Semantische Beschränkungen
|
Best practice & Examples / Empfohlene Anwendung & Beispiele
Missing part of track / Fehlerstelle
The following track starts at km 32.500. After a distance of 67 meters, there is a "missing" part of track: The mileage jumps forward from km 32.567 to km 32.600. There are 33 meters missing (=32600-32567). So, the total length of the track is not 35.160 km (which would be the difference of <trackEnd>.absPos minus <trackBegin>.absPos) but 35,127 km (which is the difference of <trackEnd>.Pos minus <trackBegin>.Pos).
Das folgende Gleis beginnt an km 32,500. Nach 67 Metern kommt eine Fehlerstelle: Die Kilometrierung springt von 32,567 auf 32,600; es fehlen 33 Meter (=32600-32567). Die Gesamtlänge des Gleises ist damit nicht 35,160 km (was die Differenz aus <trackEnd>.absPos und <trackBegin>.absPos wäre), sondern 35,127 km (was die Differenz aus <trackEnd>.Pos und <trackBegin>.Pos ist).
<track id='tr01'>
<trackTopology>
<trackBegin id='tb01' pos='0' absPos='32500' absDir='raising' />
<trackEnd id='te01' pos='35127' absPos='67660' />
<mileageChanges>
<mileageChange id='mc01' pos='67' absPosIn='32567' type='missing' absPos='32600' absDir='raising' />
</mileageChanges>
</trackTopology>
</track>
Overlength / Überlänge
The following track starts with km 207.900 and ends with 217.423. After a distance of 8746 meters, the mileage jumps back from km 216.646 to km 216.000. This means that the 646 meters before and after that place have the same absolute meters. The track is 646 meters longer than the difference of <trackEnd>.absPos minus <trackBegin>.absPos.
Das folgende Gleis beginnt an km 207,900 und endet bei 217,423. Nach 8.746 Metern springt die Kilometrierung zurück von km 216,646 auf km 216,000. Dadurch haben die 646 Meter vor und hinter diesem Punkt dieselbe Kilometrierung. Das Gleis ist 646 Meter länger als die Differenz aus <trackEnd>.absPos und <trackBegin>.absPos.
<track id='tr01'>
<trackTopology>
<trackBegin id='tb01' pos='0' absPos='207900' absDir='raising' />
<trackEnd id='te01' pos='10169' absPos='217423' />
<mileageChanges>
<mileageChange id='mc01' pos='8746' absPosIn='216646' type='overlapping' absPos='216000' absDir='raising' />
</mileageChanges>
</trackTopology>
</track>
A third example about the change of the mileage direction has been removed to the discussion page until the problem is solved.
Notes / Anmerkungen
Due to historical reasons, the mileage (or "metering") of the tracks of a line often is not continuous. It can have any points of discontinuity (jumping with missing parts or overlength of tracks) for instance by geographical corrections / repositioning of a line. In railML®, the practical, historical mileage (written e.g. at mileposts) is named "absolute mileage". On the contrary, there is the "relative mileage" (attribute @pos) which always has to be continuously rising, from zero to the length of the track (in meters). The relative mileage is normally virtual, i.e. not visible at stations or mileposts. It is referred to in railML® as relative mileage. To calculate distances, the relative mileage shall be used. Note: The term "mileage" here is used in a very general sense and in spite of its measurement unit is defined as meters in railML®.
Aus historischen Gründen ist die Kilometrierung einer Eisenbahnstrecke oft nicht ununterbrochen fortlaufend. Zum Beispiel durch Korrekturen der Streckenführung oder Eignerwechsel kann sie beliebige Unstetigkeitsstellen aufweisen (Springen mit Fehlkilometern oder Überlängen) .
In railML® wird die praktische, historische (z. B. an Hektometertafeln angeschriebene) Kilometrierung einer Strecke als absolute Kilometrierung bezeichnet. Zur genauen Bestimmung von Entfernungen ist aber auch eine ununterbrochene Kilometrierung notwendig. Diese ist i. d. R. virtuell, d. h. in der Praxis nicht direkt erkennbar. Sie wird in railML® als relative Kilometrierung bezeichnet. Die relative Kilometrierung eines Gleises (railML®: Attribut @pos) ist immer ununterbrochen fortlaufend steigend, und bei Null beginnend. Für die Berechnung der Entfernungen sollte die relative Kilometrierung verwendet werden. Anmerkung: Der Begriff "mileage" wird hier sehr allgemein verwendet und ist trotz seiner Maßeinheit in metern in railML® definiert.
Open issues / Offene Punkte/Pendenzen
For change of the mileage direction by <mileageChange> see Remarks and open issues on mileage changes.