IS:mileageChange

From railML 2 Wiki
Revision as of 15:40, 25 March 2012 by Dirk Bräuer (talk | contribs) (Example link added and parts of the example's description included into the Wiki text)
Jump to navigation Jump to search


mileageChange
 


Scheme description / Schemenbeschreibung

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

Multiplicity / Anzahl

[1..1]

Semantics / Bedeutung

A <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 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 track (with the same relative position as 'trackBegin').

In the special case if there is no difference between the absolute and relative mileage of a track the whole structure 'mileageChanges' may be missing. In this case the absolute positions of all track elements are assumed to be identical to the relative positions.

Die Struktur mileageChanges definiert den Zusammenhang zwischen relativer (fortlaufender) und absoluter (außen sichtbarer) Kilometrierung jedes Streckengleises und damit jeder Strecke.

In dem Sonderfall, bei dem die absoluten Kilometrierung auf der gesamten Strecke identisch ist mit der relativen Kilometrierung, kann die gesamte mileageChanges-Struktur in der RailML-Datei fehlen. Es sind dann alle absoluten (außen sichtbaren) Kilometrierungen als identisch zur jeweiligen relativen Position anzusetzen.

Sofern die mileageChanges-Struktur vorhanden ist, ist immer mindestens ein mileageChange-Element am Anfang des Streckengleises (d. h. mit gleicher relativer pos wie trackBegin) vorhanden. Dieses Element definiert daher eigentlich keinen Wechsel (change), sondern die initiale Kilometrierung des Gleises vor dem ersten Wechsel.

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”. {{{1}}}
  • 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 changes. It is not to be specified at the very first mileage change at the beginning of a track. 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 den vorherigen mileageChange-Elementen berechnen. Beim ersten mileageChange-Element am Anfang eines Gleises ist es nicht angegeben.
  • 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). See examples. {{{1}}}

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

A mileage change happens e.g. when two tracks are joined at a crossing or due to historical reasons.

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.