IS:mileageChange: Difference between revisions

From railML 2 Wiki
Jump to navigation Jump to search
[unchecked revision][unchecked revision]
No edit summary
(Misunderstanding corrected: The initial mileage change is missing in railML 2.x, <trackBegin> is to be interpreted. English description for the already existing German text added.)
Line 17: Line 17:
* {{Attr|dir}} Specifies the new counting direction of the new mileage valid from this {{IS:Doc|mileageChange}}. The values {{Attr|up}} and {{Attr|down}} of this attribute relate to numerical interpretation (raising, falling = “to count up or down”). Therefore, they differ from the typical usage in British English where “up” relates on “direction to London” and “down” relates on “direction away from London”. <br> {{Deu|Gibt die ab diesem {{IS:Doc|mileageChange}}-Element gültige Zählrichtung der neuen absoluten Kilometrierung an. Die Ausprägungen {{Attr|up}} und {{Attr|down}} des Attributs {{Attr|dir}} sind numerisch zu interpretieren <nowiki>(„hochzählen“, „runterzählen“)</nowiki> und weichen damit vom britischen Sprachgebrauch ab, wo {{Attr|up}} <nowiki>= „in Richtung London“</nowiki> und {{Attr|down}} <nowiki>= „weg von London“</nowiki> bedeuten.}}
* {{Attr|dir}} Specifies the new counting direction of the new mileage valid from this {{IS:Doc|mileageChange}}. The values {{Attr|up}} and {{Attr|down}} of this attribute relate to numerical interpretation (raising, falling = “to count up or down”). Therefore, they differ from the typical usage in British English where “up” relates on “direction to London” and “down” relates on “direction away from London”. <br> {{Deu|Gibt die ab diesem {{IS:Doc|mileageChange}}-Element gültige Zählrichtung der neuen absoluten Kilometrierung an. Die Ausprägungen {{Attr|up}} und {{Attr|down}} des Attributs {{Attr|dir}} sind numerisch zu interpretieren <nowiki>(„hochzählen“, „runterzählen“)</nowiki> und weichen damit vom britischen Sprachgebrauch ab, wo {{Attr|up}} <nowiki>= „in Richtung London“</nowiki> und {{Attr|down}} <nowiki>= „weg von London“</nowiki> bedeuten.}}


* {{Attr|absPosIn}} This attribute specifies the "old" absolute mileage (which is valid up to this {{IS:Doc|mileageChange}}). This value is redundant so far as it could also be calculated from the previous mileage changes. It is not to be specified at the very first mileage change at the beginning of a {{IS:Doc|track}}. <br> {{Deu|Das Attribut {{Attr|absPosIn}} gibt auf redundante Art die „alte“ (bisherige) absolute Kilometrierung an einem {{IS:Doc|mileageChange}}-Element an. Dieser Wert ließe sich immer auch aus den vorherigen {{IS:Doc|mileageChange}}-Elementen berechnen. Beim ersten {{IS:Doc|mileageChange}}-Element am Anfang eines Gleises ist es nicht angegeben.}}
* {{Attr|absPosIn}} This attribute specifies the "old" absolute mileage (which is valid up to this {{IS:Doc|mileageChange}}). This value is redundant so far as it could also be calculated from the previous mileage change. <br> {{Deu|Das Attribut {{Attr|absPosIn}} gibt auf redundante Art die „alte“ (bisherige) absolute Kilometrierung an einem {{IS:Doc|mileageChange}}-Element an. Dieser Wert ließe sich immer auch aus dem vorherigen {{IS:Doc|mileageChange}}-Element berechnen.}}


* {{Attr|absPosInOffset}}
* {{Attr|absPosInOffset}}
Line 24: Line 24:


|semantics =
|semantics =
A {{IS:Tag|mileageChange}} defines the position of a track where metering of mileage changes. It is also used to define the initial mileage which is valid from the beginning of a {{IS:Doc|track}} (before the first real mileage change happens). Therefore, there has to be always at least one mileage change at the very beginning of the {{IS:Doc|track}} (with the same relative position as {{IS:Doc|trackBegin}}). <br> In the special case if there is no difference between the absolute and relative mileage of a {{IS:Doc|track}} the whole structure {{IS:Tag|mileageChanges}} may be missing. In this case the absolute positions of all {{IS:Tag|track}} elements are assumed to be identical to the relative positions. <br> {{Deu|Die Struktur {{IS:Doc|mileageChanges}} definiert den Zusammenhang zwischen relativer (fortlaufender) und absoluter (außen sichtbarer) Kilometrierung jedes Streckengleises und damit jeder Strecke. <br> In dem Sonderfall, bei dem die absoluten Kilometrierung auf der gesamten Strecke identisch ist mit der relativen Kilometrierung, kann die gesamte {{IS:Doc|mileageChanges}}-Struktur in der RailML-Datei fehlen. Es sind dann alle absoluten (außen sichtbaren) Kilometrierungen als identisch zur jeweiligen relativen Position anzusetzen. <br> Sofern die {{IS:Doc|mileageChanges}}-Struktur vorhanden ist, ist immer mindestens ein {{IS:Tag|mileageChange}}-Element am Anfang des Streckengleises (d. h. mit gleicher relativer {{Attr|pos}} wie {{IS:Doc|trackBegin}}) vorhanden. Dieses Element definiert daher eigentlich keinen Wechsel (change), sondern die initiale Kilometrierung des Gleises vor dem ersten Wechsel.}}
A {{IS:Tag|mileageChange}} defines the position of a track where metering of mileage changes. To identify the initial mileage valid from the beginning of a {{IS:Doc|track}} - before the first mileage change happens - the attributes {{Attr|pos}} and {{Attr|absPos}} of the element {{IS:Tag|trackTopology}}.{{IS:Tag|trackBegin}} are used.
 
{{Deu|Ein {{IS:Tag|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 {{IS:Tag|mileageChange}}-Element gilt, wird durch die Attribute {{Attr|pos}} und {{Attr|absPos}} des Elements {{IS:Tag|trackTopology}}.{{IS:Tag|trackBegin}} definiert.}}


|notes =
|notes =
A mileage change happens e.g. when two tracks are joined at a crossing or due to historical reasons. <br> {{Deu|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“) und/oder die Zählrichtung wechseln („fallen“). <br> 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 {{Attr|pos}}) ist immer ununterbrochen fortlaufend steigend, jedoch nicht unbedingt bei 0 beginnend.}}
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 ("jump" and/or change of counting direction between raising and falling) 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 {{Attr|pos}}) which always has to be continuously raising (but not necessarily starting with zero). The relative mileage normally is virtual, i.e. not visible at stations or mileposts. To calculate distances, the relative mileage is used. ''Note: The term "mileage" here is used in a very general sense and in spite of its measurement unit is defined at kilometers in railML.''
 
{{Deu|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“) und/oder die Zählrichtung wechseln („fallen“). <br> 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 {{Attr|pos}}) ist immer ununterbrochen fortlaufend steigend, jedoch nicht unbedingt bei 0 beginnend.}}


|constraints =
|constraints =

Revision as of 23:32, 8 December 2014


mileageChange
 


Scheme description / Schemenbeschreibung

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

  • Parent: <mileageChanges>
  • Children: <geoCoord> (deprecated with version 2.0), but re-(introduced with version 2.2)

Multiplicity / Anzahl

[1..1]

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 pos and absPos of the element <trackTopology>.<trackBegin> are used.

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 pos und absPos des Elements <trackTopology>.<trackBegin> definiert.

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.
  • dir Specifies the new counting direction of the new mileage valid from this mileageChange. The values up and down of this attribute relate to numerical interpretation (raising, falling = “to count up or down”). Therefore, they 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 des Attributs dir sind numerisch zu interpretieren („hochzählen“, „runterzählen“) und weichen damit vom britischen Sprachgebrauch ab, wo up = „in Richtung London“ und down = „weg von London“ bedeuten.
  • absPosIn This attribute specifies the "old" absolute mileage (which is valid up to this mileageChange). This value is redundant so far as it could also be calculated from the previous mileage change.
    Das Attribut absPosIn gibt auf redundante Art die „alte“ (bisherige) absolute Kilometrierung an einem mileageChange-Element an. Dieser Wert ließe sich immer auch aus dem vorherigen mileageChange-Element berechnen.
  • absPosInOffset
  • type Refers to the typical historic reasons for mileage changes where there is either a "missing" part of the track (type = "missing") or a "prolonged" line (type = "overlapping").
    Mit dem optionalen Attribut type kann die Art Kilometrierungssprungs angegeben werden (sofern es sich nicht um einen Kilometrierungsrichtungswechsel handelt). Dies bezieht sich terminologisch auf die in der Praxis unterschiedenen Begriffe „Fehlerstelle“ (type = "missing") und „Überlänge“ (type = "overlapping").

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
  • dir optional
  • absPosIn required
  • absPosInOffset optional
  • type optional

Best practice & Examples / Empfohlene Anwendung & Beispiele

see RailML-Beispiel Kilometrierung, PDF, 155 kByte

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 ("jump" and/or change of counting direction between raising and falling) 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 raising (but not necessarily starting with zero). The relative mileage normally is virtual, i.e. not visible at stations or mileposts. To calculate distances, the relative mileage is used. Note: The term "mileage" here is used in a very general sense and in spite of its measurement unit is defined at kilometers 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“) und/oder die Zählrichtung wechseln („fallen“).
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, jedoch nicht unbedingt bei 0 beginnend.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.

Retrieved from "https://wiki2.railml.org/index.php?title=IS:mileageChange&oldid=3890"