Dev:How to define track usage of a train in stations

Specifying of tracks and platformedges used by a train / Angabe der durch einen Zug benutzten Gleise und Bahnsteigkanten in einer Betriebsstelle

General / Allgemeines

In general there is two ways of describing what station tracks are used by a train:

1. referring to infrastructure elements (station tracks, platform edges), which can describe the elements in more detail, or
2. using the attribute trackInfo of the element <ocpTT> for track related information

In case the infrastructure part of a railML^® file already includes information about station tracks, the first option should be used. The train schedule should refer to the infrastructure data. The two ways of describing station track usage should not be mixed within the same railML^® file.

Grundsätzlich bestehen zwei alternative Möglichkeiten zur Abbildung der Gleisnutzungs-Informationen innerhalb einer Betriebsstelle:

1. Nutzung des Attributs trackInfo des Elements <ocpTT> für gleisbezogene Informationen
2. Referenzierung von Elementen der Infrastruktur (Bahnhofsgleise, Bahnsteigkanten) aus dem Zuglauf, welche die eigentlichen Informationen tragen

Sind in der Infrastruktur einer railML^®-Datei ohnehin die Gleise einer Betriebsstelle definiert, so sollten diese auch durch den Fahrplan des Zuges referenziert werden. Innerhalb einer railML^®-Datei sollte die Abbildung der Gleisnutzung einheitlich in einer der beiden Varianten erfolgen.

Referring to station tracks and platform edges / Referenzierung von Bahnhofsgleisen und Bahnsteigkanten (platformEdge)

Using this way of modeling the operation designator of a station track is not provided within a <trainPart>. Instead the infrastructure description is extended by corresponding <track> and <platformEdge> elements. These infrastructure elements are referenced by the <ocpTT>s of a <trainPart>. The infrastructure elements allow among other things to specify a code (e.g an ID from an infrastructure database) and a name (display name/public name). The code can be provided using the attribute code. The name is specified using name.

Bei dieser Abbildungsvariante wird die Bahnsteig- bzw. Gleisbezeichnung nicht innerhalb des <trainPart>s angegeben, stattdessen werden in der Infrastruktur entsprechende Elemente <track> bzw. <platformEdge> angelegt, die von der jeweiligen <ocpTT> des <trainPart>s referenziert werden. Die eigentlichen Bezeichnungen werden dann an den Elementen der Infrastruktur abgebildet. Hierfür können die Attribute code bzw. name verwendet werden, wobei code für einen externen Schlüssel (bspw. in einer Infrastruktur-Datenbank) vorgesehen ist, während name für die Angabe eines durch Menschen lesbaren Namens benutzt werden sollte.

A station track is characterized by the fact that its <trackBegin> and <trackEnd> elements refer to the same <ocp> with their ocpRef. Referring to the station track from an <ocpTT> is done using the attribute trackRef.

Ein <track> innerhalb einer <ocp> ist dadurch gekennzeichnet, dass seine jeweiligen <trackBegin>- / <trackEnd>-Elemente über das Attribut ocpRef die gleiche <ocp> referenzieren. Die Referenzierung von der <ocpTT> erfolgt über das Attribut trackRef.

Specifying a <platformEdge> is optional. That means specifying can be omitted in general or, in case including station track information is wanted, if the <track> does not have a platform edge. It is modeled as a sub element of <track> which implies that for each <platformEdge> a corresponding <track> needs to be provided. When referring to a platform edge the attribute ref of the <platformEdgeRef> element is used. Since <platformEdgeRef> is a sub element of <stopDescription>, platform edges can only be specified for <ocpTT>s which are scheduled stops of a train. Specifying the attribute pos of a <platformEdge> is not necessary for all use cases. However in the railML schema it is declared mandatory. In case it is not needed it should be specified as "0".

Die Angabe einer <platformEdge> ist optional, d.h. sie muss nur definiert werden, wenn in der railML^®-Datei Angaben zu Bahnsteigkanten enthalten sein sollen und der jeweilige <track> über eine Bahnsteigkante verfügt. Sie wird als Unterelement eines <track> abgebildet, d.h. für jede <platformEdge> muss auch ein entsprechender <track> in der Infrastruktur angelegt werden. Die Referenzierung der <platformEdge> von der <ocpTT> erfolgt über das Attribut ref des <platformEdgeRef>-Elements. Da die <platformEdgeRef> ein Child-Element einer <stopDescription> ist, können Bahnsteigkanten nur für diejenigen <ocpTT> angegeben werden, an denen der Zug hält. Die Angabe des Attributs pos der <platformEdge> ist nicht in allen Anwendungsfällen (bspw. Fahrgastinformation) fachlich relevant, wird aber durch das railML-Schema erfordert. In diesen Fällen kann dieses Attribut auf den Wert 0 gesetzt werden. Die Bezeichnungen (Attribut name) von <track> und zugehöriger <platformEdge> können identisch sein, müssen jedoch nicht.

  <track id="_tr" name="12">
    <trackTopology>
      <trackBegin id="_tb" pos="0">
        <macroscopicNode ocpRef="_85ZUE" />
      </trackBegin>
      <trackEnd id="_te" pos="0">
        <macroscopicNode ocpRef="_85ZUE" />
      </trackEnd>
    </trackTopology>

    <trackElements>
      <platformEdges>
        <platformEdge id="_pe" name="1A" pos="0" />
      </platformEdges>
    </trackElements>
  </track>
  ...
  <ocp id="_85ZUE" code="85ZUE" name="Zürich HB" />
  ...
  <ocpTT ocpRef="_85ZUE" trackRef="_tr">
    <times scope="scheduled" arrival="10:59:00" departure="11:04:00"/>
    <stopDescription>
      <platformEdgeRef ref="_pe" />
    </stopDescription>
  </ocpTT>

The above (incomplete) example describes a train, which is scheduled to stop at the station track with the operational designation "12" using the platform edge with the name "1A".

Das (unvollständige) Beispiel zeigt einen Zug, der in der Betriebsstelle "Zürich HB" das Gleis mit der Bezeichnung "12" und die Bahnsteigkante mit der Bezeichnung "1A" nutzt..

Recommended for the following usecases: Timetable information, Passenger information at stations, Passenger information inside the train

Empfohlen für die folgenden Usecases: Fahrplanauskunft, Fahrgastinformation am Bahnhof, Fahrgastinformation im Zug

Using the attribute trackInfo of the element <ocpTT> for track related information / Nutzung des Attributs trackInfo des Elements <ocpTT> für gleisbezogene Informationen

Specifying station tracks in <ocpTT> directly allows for omitting of <track> elements for each track of an <ocp>. The station tracks name is simply specified as trackInfo of an <ocpTT>. In this case it's not possible to specify the public platform name (as published to the passenger).

Im Attribut trackInfo des Elements <ocpTT> können allgemeine für den Fahrgast bestimmte Informationen über das durch den <train> genutzte Gleis einer <ocp> angegeben werden. Dies kann beispielsweise eine Gleis- oder Bahnsteigbezeichnung für die Fahrgastinformation sein. Es wird nicht empfohlen, das Attribut als externen Schlüssel auf ein Gleis oder eine Bahnsteigkante einer Betriebsstelle zu verwenden.

  <ocp id="_85ZUE" code="85ZUE" name="Zürich HB" />
  ...
  <ocpTT ocpRef="_85ZUE" trackInfo="12">
    <times scope="scheduled" arrival="10:59:00" departure="11:04:00"/>
  </ocpTT>

The above (inclomplete) example describes a train, which is scheduled to use the station track known as "12" (operational designation) at the station "Zürich HB".

Das (unvollständige) Beispiel beschreibt einen Zug, für den in der Betriebsstelle "Zürich HB" die Fahrgastinformation "12" definiert ist.

Recommended for the following usecases: A timetable for a competition (call for proposals), Slot ordering, TAF/TAP TSI requirements

Empfohlen für die folgenden Usescases: Ausschreibungsfahrplan, Trassenbestellung, TAF/TAP TSI Anforderungen

Further Information / Weitere Informationen

• How To Reference Infrastructure