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

This article explains basic concepts of track usage within the timetable subschema.

{{deu|Dieser Artikel erklärt Grundlagen der Gleisnutzung in Bahnhöfen innerhalb des Timetable Subschemas.}}
= Specifying of tracks and platformedges used by a train / {{Deu|Angabe der durch einen Zug benutzten Gleise und Bahnsteigkanten in einer Betriebsstelle}} = 

== General / {{Deu|Allgemeines}} ==

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

# referring to infrastructure elements (station tracks, platform edges), which can describe the elements in more detail, or
# using the attribute {{Attr|trackInfo}} of the element {{TT:Tag|ocpTT}} for track related information

In case the infrastructure part of a {{rml}} 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 {{rml}} file.  

{{Deu|Grundsätzlich bestehen zwei alternative Möglichkeiten zur Abbildung der Gleisnutzungs-Informationen innerhalb einer Betriebsstelle:}}
# {{Deu|Referenzierung von Elementen der Infrastruktur (Bahnhofsgleise, Bahnsteigkanten) aus dem Zuglauf, welche die eigentlichen Informationen tragen}}
# {{Deu|Nutzung des Attributs {{Attr|trackInfo}} des Elements {{TT:Tag|ocpTT}} für gleisbezogene Informationen}}

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

== Referring to station tracks and platform edges / {{Deu|Referenzierung von Bahnhofsgleisen und Bahnsteigkanten (platformEdge)}} ==

Using this way of modeling the operation designator of a station track is not provided within a {{TT:Tag|trainPart}}. Instead the infrastructure description is extended by corresponding {{IS:Tag|track}} and {{IS:Tag|platformEdge}} elements. These infrastructure elements are referenced by the {{TT:Tag|ocpTT}}s of a {{TT:Tag|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 {{Attr|code}}. The name is specified using {{Attr|name}}.

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

A station track is characterized by the fact that its {{IS:Tag|trackBegin}} and {{IS:Tag|trackEnd}} elements refer to the same {{IS:Tag|ocp}} with their {{Attr|ocpRef}}. Referring to the station track from an {{TT:Tag|ocpTT}} is done using the attribute {{Attr|trackRef}}.

{{Deu|Ein {{IS:Tag|track}} innerhalb einer {{IS:Tag|ocp}} ist dadurch gekennzeichnet, dass seine jeweiligen {{IS:Tag|trackBegin}}- / {{IS:Tag|trackEnd}}-Elemente über das Attribut {{Attr|ocpRef}} die gleiche {{IS:Tag|ocp}} referenzieren. Die Referenzierung von der {{TT:Tag|ocpTT}} erfolgt über das Attribut {{Attr|trackRef}}.}}

Specifying a {{IS:Tag|platformEdge}} is optional. That means specifying can be omitted in general or, in case including station track information is wanted, if the {{IS:Tag|track}} does not have a platform edge. It is modeled as a sub element of {{IS:Tag|track}} which implies that for each {{IS:Tag|platformEdge}} a corresponding {{IS:Tag|track}} needs to be provided.
When referring to a platform edge the attribute {{Attr|ref}} of the {{TT:Tag|platformEdgeRef}} element is used. Since {{TT:Tag|platformEdgeRef}} is a sub element of {{TT:Tag|stopDescription}}, platform edges can only be specified for {{TT:Tag|ocpTT}}s which are scheduled stops of a train.
Specifying the attribute {{Attr|pos}} of a {{IS:Tag|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".

The descriptive texts (attribute {{Attr|name}} of {{IS:Tag|track}} and associated {{IS:Tag|platformEdge}} may be identical. They do not have to, though.

{{Deu|Die Angabe einer {{IS:Tag|platformEdge}} ist optional, d.h. sie muss nur definiert werden, wenn in der {{rml}}-Datei Angaben zu Bahnsteigkanten enthalten sein sollen und der jeweilige {{IS:Tag|track}} über eine Bahnsteigkante verfügt. Sie wird als Unterelement eines {{IS:Tag|track}} abgebildet, d.h. für jede {{IS:Tag|platformEdge}} muss auch ein entsprechender {{IS:Tag|track}} in der Infrastruktur angelegt werden. Die Referenzierung der {{IS:Tag|platformEdge}} von der {{TT:Tag|ocpTT}} erfolgt über das Attribut {{Attr|ref}} des {{TT:Tag|platformEdgeRef}}-Elements. Da die {{TT:Tag|platformEdgeRef}} ein Child-Element einer {{TT:Tag|stopDescription}} ist, können Bahnsteigkanten nur für diejenigen {{TT:Tag|ocpTT}} angegeben werden, an denen der Zug hält.}}
{{Deu|Die Angabe des Attributs {{Attr|pos}} der {{IS:Tag|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.}} 
{{Deu|Die Bezeichnungen (Attribut {{Attr|name}}) von {{IS:Tag|track}} und zugehöriger {{IS:Tag|platformEdge}} können identisch sein, müssen jedoch nicht.}}

[[file:railML_SimpleExample_v08_180122.png]]

<syntaxhighlight lang=xml>
  <track id="_tr" name="1">
    <trackTopology>
      <trackBegin id="_tb" pos="0">
        <macroscopicNode ocpRef="_OAR" />
      </trackBegin>
      <trackEnd id="_te" pos="0">
        <macroscopicNode ocpRef="_OAR" />
      </trackEnd>
    </trackTopology>

    <trackElements>
      <platformEdges>
        <platformEdge id="_pe" name="2" pos="0" />
      </platformEdges>
    </trackElements>
  </track>
  ...
  <ocp id="_OAR" code="OAR" name="Bf Arnau" />
  ...
  <ocpTT ocpRef="_OAR" trackRef="_tr">
    <times scope="scheduled" arrival="10:59:00" departure="11:04:00"/>
    <stopDescription>
      <platformEdgeRef ref="_pe" />
    </stopDescription>
  </ocpTT>
</syntaxhighlight>

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

{{Deu|Das (unvollständige) Beispiel zeigt einen Zug, der in der Betriebsstelle "Bf Arnau" das Gleis mit der Bezeichnung "1" und die Bahnsteigkante mit der Bezeichnung "2" nutzt.}}


'''Recommended for the following usecases:''' [[TT:UC:TimetableInformation|Timetable information]], [[TT:UC:PassengerInformationAtStations|Passenger information at stations]], [[TT:UC:FGIInTrain|Passenger information inside the train]]

{{Deu|'''Empfohlen für die folgenden Usecases:''' [[TT:UC:TimetableInformation|Fahrplanauskunft]], [[TT:UC:PassengerInformationAtStations|Fahrgastinformation am Bahnhof]], [[TT:UC:FGIInTrain|Fahrgastinformation im Zug]]}}

== Using the attribute {{Attr|trackInfo}} of the element {{TT:Tag|ocpTT}} for track related information / {{Deu|Nutzung des Attributs {{Attr|trackInfo}} des Elements {{TT:Tag|ocpTT}} für gleisbezogene Informationen}} ==

The attribute {{Attr|trackInfo}} of {{TT:Tag|ocpTT}} can be used for general information related to the station track used by the {{TT:Tag|train}}. This may be for example a name of a {{IS:Tag|track}} or a {{IS:Tag|platformEdge}} for passenger information. It is not recommended to use this attribute as external key for a {{IS:Tag|track}} or  {{IS:Tag|platformEdge}}.

{{Deu|Im Attribut {{Attr|trackInfo}} des Elements {{TT:Tag|ocpTT}} können allgemeine Informationen über das durch den {{TT:Tag|train}} genutzte Gleis einer {{IS:Tag|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.}}

<syntaxhighlight lang=xml>
  <ocp id="_OAR" code="OAR" name="Bf Arnau" />
  ...
  <ocpTT ocpRef="_OAR" trackInfo="1">
    <times scope="scheduled" arrival="10:59:00" departure="11:04:00"/>
  </ocpTT>
</syntaxhighlight>

The above (inclomplete) example describes a train, which has a stop at station "Bf Arnau". For this stop the track related passenger information "1" is provided, which implies that the train will be stopping at track 1 of that station.

{{Deu|Das (unvollständige) Beispiel beschreibt einen Zug, für den in der Betriebsstelle "Bf Arnau" die Fahrgastinformation "1" definiert ist, was impliziert, dass der Zug an dieser Betriebsstelle an Gleis "1" halten wird.}}


'''Recommended for the following usecases:''' [[TT:UC:ATimetableForACompetition|A timetable for a competition (call for proposals)]], [[TT:UC:SlotOrdering|Slot ordering]], [[TT:UC:TAF/TAP TSI|TAF/TAP TSI requirements]]

{{Deu|'''Empfohlen für die folgenden Usescases:''' [[TT:UC:ATimetableForACompetition|Ausschreibungsfahrplan]], [[TT:UC:SlotOrdering|Trassenbestellung]], [[TT:UC:TAF/TAP TSI|TAF/TAP TSI Anforderungen]]}}

== Further Information / {{Deu|Weitere Informationen}} ==
* [[TT:How_To_Reference_Infrastructure|How To Reference Infrastructure]]

[[category:Timetable Concept]] [[category:Infrastructure Concept]]