Difference between revisions of "TT:ocpTT"

From wiki.railML.org
Jump to: navigation, search
[checked revision][checked revision]
(updated semantic constraints after discussion in tt dev group)
Line 70: Line 70:
 
* {{Attr|offset}}: {{RailMLType|tLengthM}}, optional
 
* {{Attr|offset}}: {{RailMLType|tLengthM}}, optional
 
* {{Attr|shuntingTime}}: {{XsdType|duration}}, optional
 
* {{Attr|shuntingTime}}: {{XsdType|duration}}, optional
|semcon=
+
|semcon={{Deu|Kein {{attr|ocpRef}} darf mehrmals im selben {{TT:Tag|trainPart}} verwendet werden!}}|proposed=2018-10-25|status=proposed}}
 
{{semconApproved|The attribute sequence is shall be increasing according to the train path.<br/> {{Deu|Das Attribut sequence muss ansteigend entsprechend dem Zuglauf sein.}}|2018-10-25|2019-06-20}}
 
{{semconApproved|The attribute sequence is shall be increasing according to the train path.<br/> {{Deu|Das Attribut sequence muss ansteigend entsprechend dem Zuglauf sein.}}|2018-10-25|2019-06-20}}
  
  
{{Deu|Kein {{attr|ocpRef}} darf mehrmals im selben {{TT:Tag|trainPart}} verwendet werden!}}|proposed=2018-10-25|status=proposed}}
+
 
 
|bestpractice =  
 
|bestpractice =  
 
In most cases, the {{TT:Doc|ocpTT}} references a ''macroscopic'' node ({{IS:Doc|ocp}}) within the infrastructure. Therefore the {{Attr|trackRef}} should reference to a ''macroscopic'' {{IS:Doc|track}} which could be described as track with type="''stationTrack''" being inside a node, connecting from and to the same macroscopic node.
 
In most cases, the {{TT:Doc|ocpTT}} references a ''macroscopic'' node ({{IS:Doc|ocp}}) within the infrastructure. Therefore the {{Attr|trackRef}} should reference to a ''macroscopic'' {{IS:Doc|track}} which could be described as track with type="''stationTrack''" being inside a node, connecting from and to the same macroscopic node.

Revision as of 15:40, 3 July 2019

ocpTT
 


Scheme description / Schemenbeschreibung / Description du schéma

Position of ocpTT in the XML-Tree / Position von ocpTT im XML-Baum / position de ocpTT dans l’aborescence XML

Multiplicity / Anzahl / Multiplicité

[1..∞]

Semantics / Bedeutung / Sémantique

The element ocpTT describes a single point along the train path. Normally, an ocpTT belongs to a station with an arrivial and departure time. But an ocpTT could also be a blocking signal with or without passing time, or some control point on the train path. It is always referencing a certain ocp defined in the infrastructure part, providing some timetable related information for it. In the British railway timetabling system the ocpTT is called TIPLOC by Network Rail, which is a contraction of TIming Point LOCation.

Das Element ocpTT beschreibt den einzelnen Punkt im Zuglauf. Der ocpTT entspricht einem Fahrzeitmesspunkt. Ein Fahrzeitmesspunkt kann, muss aber keine Betriebsstelle sein. Meist ist ein ocpTT gleichzusetzen mit einen Bahnhof und der dortigen Ankunfts- und Abfahrtszeit. Es kann aber genauso gut ein Blocksignal mit oder ohne Durchfahrtszeit oder auch ein beliebiger Messpunkt auf der Strecke sein. Der jeweilige ocpTT verweist immer auf einen in der Infrastruktur definierten ocp und beschreibt dessen Verwendung im Fahrplan. Als Regel darf jeder ocpTT nur einmal innerhalb eines trainParts auftauchen.

Please, be aware of the semantic constraint(s)!
 
Please, be aware of the semantic constraint(s)!

Attributes of ocpTT / Attribute von ocpTT / Attributs de ocpTT

  • ocpRef: This refers to the id attribute of the associated ocp element.
  • trackRef: This refers to the id attribute of the associated track element.
  • sequence: (introduced with version 2.2) This number defines the order of the ocpTT elements inside a trainPart which is supposed to be chronological.
  • trackInfo: Textual description of station track for information purposes. The real track and platform information can and should be identified via the trackRef attribute.
  • ocpType: This is a mixture of two informations describing the action of the train at this ocpTT. Possible values are:
  • stop The train is stopping at this ocpTT.
  • pass The train is not stopping at this ocpTT.
  • begin (deprecated with version 2.2) If the trainPart begins at this ocpTT and is not part of a longer train path, this value is used. The start of a train path should be detected by parsing the trains.
  • end (deprecated with version 2.2) If the trainPart ends at this ocpTT and is not part of a longer train path, this value is used. The end of a train path should be detected by parsing the trains.
  • remarks: This is a free attribute for further descriptions.
Birne.png Please take into account our references to human-intepretable data fields.

Bitte berücksichtigen Sie unsere Hinweise zu menschen-intepretierbaren Datenfeldern.

Veuillez tenir compte de nos références aux champs de données à valeur humaine.


  • trainReverse: This is true if the train changes its direction of travel at this station which is often shown by a '<->' sign in printouts. For indicating that the formation starts in reversed order, you will have to set the attribute orientationReversed in the formationTT. If the train reverses at an intermediate station and restarts in reversed order, you will have to build a new trainPart with
    • trainReverse set at the last ocpTT of the previous trainPart and
    • trainReverse set at the first ocpTT and the attribute orientationReversed set in the formationTT of the new trainPart.
For more information, see Reversing trains and formations.
  • alignment: This describes the alignment of the arriving train in relation to the place on a track referenced by ocpRef. Possible values are:
  • head - The head of the train (front of first vehicle) is located at the <ocp> referenced by ocpRef, possibly shifted by offset metres.
  • center - The centre of the train (mid point concerning the train length) is located at the <ocp> referenced by ocpRef, possibly shifted by offset metres.
  • rear - The end of the train (back of last vehicle) is located at the <ocp> referenced by ocpRef, possibly shifted by offset metres.
The default value for alignment is center if the attribute is not specified.
  • offset: This describes the offset of the stopping point in relation to the place on a track referenced by ocpRef in metres. The default value is zero (no offset).
  • shuntingTime: This is the shunting time used inside a station in case the train is shunted there.
  • xs:anyAttribute: This provides an extension point for non-railML attributes in a foreign namespace. How to use it?

Syntactic Constraints / Syntaktische Beschränkungen / Contraintes syntactiques

Please, be aware of the semantic constraint(s)!

  • sequence: xs:positiveInteger, mandatory
  • ocpRef: xs:IDREF, mandatory
  • trackRef: xs:IDREF, optional
  • trackInfo: xs:string, optional
  • ocpType: restriction of xs:sting; stop, pass, begin (deprecated with version 2.2), end (deprecated with version 2.2)
    Optional
  • remarks: xs:string, optional
  • trainReverse: xs:boolean, optional
  • alignment: restriction of xs:string; generic type for the alignment of a train relative to some objective in the used context (head, center, rear), optional
  • offset: xs:decimal, 6 fraction digits, length value measured in meter, optional
  • shuntingTime: xs:duration, optional

Semantic Constraints / Semantische Beschränkungen / Contraintes semantiques

Kein ocpRef darf mehrmals im selben <trainPart> verwendet werden!

Best practice & Examples / Empfohlene Anwendung & Beispiele / Bonnes pratiques & exemples

Not yet described. / Noch nicht beschrieben. / Pas encore décrit.

Notes / Anmerkungen / Notes

Not yet described. / Noch nicht beschrieben. / Pas encore décrit.

Open issues / Offene Punkte/Pedenzen / Questions ouvertes

Not yet described. / Noch nicht beschrieben. / Pas encore décrit.


Private-cloud-icon.png Semantic Constraint:
 
The attribute sequence is shall be increasing according to the train path.
Das Attribut sequence muss ansteigend entsprechend dem Zuglauf sein.
 
Proposed on 2018-10-25
Approved on 2019-06-20
Please, recognize our guidelines on semantic constraints


|bestpractice = In most cases, the ocpTT references a macroscopic node (ocp) within the infrastructure. Therefore the trackRef should reference to a macroscopic track which could be described as track with type="stationTrack" being inside a node, connecting from and to the same macroscopic node.

Meistens referenziert der ocpTT einen makroskopischen Knoten ocp innerhalb der Infrastruktur. Daher sollte das Attribut trackRef ebenfalls ein makroskopisches Bahnhofsgleis referenzieren. Dieses kann man als einen track vom Typ stationTrack beschreiben, welcher innerhalb eines Bahnhofs, d.h. von und zu demselben makroskopischen Knoten verläuft.


The train is stopping in Zurich (referenced ocp) on track 12 (no reference here). It is stopping with its head 10 meters before actually reaching the cross section of this ocp, which is assumed to be located at the buffer stop in the main hall of this station. Then the train is changing direction and leaving. In this example the train path is split into two subsequent trainParts because the position of the train (attributes alignment and offset) is different for arrival and departure.

See How to define track usage of a train in stations for further information about the indication of station track usage.

  <trainPart id="...">
    <ocpsTT>
      ...
      <ocpTT sequence="35" ocpRef="_85ZUE" ocpType="stop" trackInfo="12" alignment="head" offset="-10">
        <times scope="scheduled" arrival="10:56:00.0"/>
      </ocpTT>
    </ocpsTT>
  </trainPart>
  <trainPart id="...">
    <ocpsTT>
      <ocpTT sequence="1" ocpRef="_85ZUE" ocpType="stop" trackInfo="12" alignment="rear" trainReverse="true" offset="10">
        <times scope="scheduled" departure="11:04:00.0"/>
      </ocpTT>
      ...
    <ocpsTT>
  </trainPart>

Train(part)s with one <ocpTT> only

Normally, each <train> has at least one <trainPart> with at least two <ocpTT>s. However, it is allowed that a <trainPart> has only one <ocpTT>. In this special case, what is mentioned at TT:times‎ concerning arrival at first and departure at last <ocpTT> applies at the same time: The train arrives from outside and immediately departs to outside the railML file. In very rare cases, this is used, for instance, to express only an occupation of a station track by a train which is not considered further. You can imagine a whole railML file which only expresses the station timetable of one station: All trains arrive from and depart to "nowhere". You should keep that special case in mind if you handle railML files on import.

Reversing trains and formations

On the difference between ocpTT/@trainReverse and formationTT/@orientationReversed, see Reversing trains and formations.
See also:

}}