IS:stopPost

stopPost
 

Schema description / Schemabeschreibung

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

• Parent: <stopPosts> (introduced with version 2.2)
• Children: <additionalName>, <any>, <geoCoord>, <states>, <validForMovements> (introduced with version 2.2), <signalRef>

Multiplicity / Anzahl

[0..∞]

Semantics / Bedeutung

The element <stopPost> is used to mark a position on a track, where a train, which fulfills certain criteria, needs to stop in order to change passengers or because of other operational rules.

Attributes of stopPost / Attribute von stopPost

• 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.

🗒️ 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".
• dir: This defines the validity of <stopPost> along the track. Possible values are:

• none: <stopPost> has no direction restriction.
• up: This denotes the direction from the <trackBegin> to the <trackEnd> (increasing relative position values).
• down: This goes opposite to up (decreasing relative position values).
• both: <stopPost> is valid in both directions.
• unknown: <stopPost> is restricted to a certain direction, but this direction is not known.

• ruleCode: Code for this element in the rule book, combination of letters and numbers and space allowed (e.g. DE:ESO:Ne5, GA, SFRS/E)
• trainRelation: Reference to the part of the train from where on the stop post is valid. Normally, a stop post relates to the head of the train. However, if the attribute is not given, it means that the information is unknown.

• platformEdgeRef: This refers to the id attribute of the associated <platformEdge> element.

• trainLength: Set this value if the stop post is only valid for trains with less than or equal train length. If the stop post is valid for trains with all lengths, don't use this attribute.
  Dieser Wert muss definiert sein, wenn der Halteplatz nur für Züge mit geringerer oder gleicher Länge des Zuges gültig ist. Wenn der Halteplatz für Züge aller Längen gültig sein soll, darf dieses Attribut nicht verwendet werden.

• axleCount: Set this value if the stop post is only valid for trains with less than or equal number of axles.. If the stop post is valid for trains with all lengths, don't use this attribute.
  Dieser Wert muss definiert sein, wenn der Halteplatz nur für Züge mit geringerer oder gleicher Anzahl der Achsen gültig ist. Wenn der Halteplatz für Züge aller Längen gültig sein soll, darf dieses Attribut nicht verwendet werden.

• wagonCount: Set this value if the stop post is only valid for trains with less than or equal number of wagons.. If the stop post is valid for trains with all lengths, don't use this attribute.
  Dieser Wert muss definiert sein, wenn der Halteplatz nur für Züge mit geringerer oder gleicher Anzahl der Wagen gültig ist. Wenn der Halteplatz für Züge aller Längen gültig sein soll, darf dieses Attribut nicht verwendet werden.

• verbalConstraints: Set this value if the stop post is only valid for trains fulfilling a certain verbal constraint (e.g. long train / short train). If the stop post is valid for trains with all lengths, don't use this attribute. Should contain only those constraints that cannot be represented by any of the other attributes present, including the "kind" attribute of the validForMovements child.
  Dieser Wert muss definiert sein, wenn der Halteplatz nur für Züge, auf die eine bestimmte textuelle Beschreibung passt (z.B. Kurzzug, Vollzug, Langzug) gültig ist. Wenn der Halteplatz für Züge aller Längen gültig sein soll, darf dieses Attribut nicht verwendet werden.

• virtual: Marks a stop post being virtual if there is no physical representation along the track.

• ocpRef: This refers to the id attribute of the associated <ocp> element.

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
  
• absPosOffset: xs:decimal, 6 fraction digits, length value measured in meter; optional
• dir: xs:string, generic type for direction statements: enumeration up, down, unknown, none, both; optional
• ruleCode: tElementDescription (xs:string); optional
• trainRelation: tTrainRelation (union of (restriction of xs:string, tOtherEnumerationValue)); optional; enumeration: "headOfTrain" / "midOfTrain" / "endOfTrain"
• trainLength: tLengthM (xs:decimal, 6 fraction digits, length value measured in meter); optional
• axleCount: tPositiveCounter (xs:positiveInteger); optional
• wagonCount: tPositiveCounter (xs:positiveInteger); optional
• verbalConstraints: xs:string; optional
• platformEdgeRef: tGenericRef (xs:IDREF); optional
• virtual: xs:boolean; optional
• ocpRef: tGenericRef (xs:IDREF); optional

Best practice & Examples / Empfohlene Anwendung & Beispiele

Not yet described. / Noch nicht beschrieben.

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.

In order to find out which <stopPost> elements belong to one specific <ocp>, you need to check the ocpRef attribute of all <stopPost> elements. A reversed way of referencing from <ocp> to <stopPost> has been discussed in the forum. Since there was no urgent need, it was decided that the current solution is sufficient and the concept of referencing will be revised with railML^® version 3.1.

verbalConstraints attribute can be used for:

- stop posts used by "S-Bahn Berlin" and

- interpretation issues of attributes such as trainLength, e.g. min or max railML^® forum discussion

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.