TT:trainPartSequence train: Difference between revisions

From railML 2 Wiki
Jump to navigation Jump to search
[checked revision][checked revision]
(Umbruch vor {{deu|...)
(railML→{{rml}})
 
(21 intermediate revisions by 4 users not shown)
Line 3: Line 3:


|semantics =
|semantics =
The element {{TT:Doc|trainPartSequence}} groups all elements {{TT:Doc|trainPart}} belonging to a train. The {{Attr|sequence}} herein is supposed to be used for successive parts along the train route. This is ''not'' to be mixed up with the sequence of rolling stock inside a train {{RS:Doc|formation}} or a chronological sequence during an operating period or during a day. Therefore all referenced elements {{TT:Doc|trainPart}} of a {{TT:Doc|trainPartSequence}} should have the same starting point and end point. Otherwise you should define smaller (shorter) {{TT:Doc|trainParts}}.
The element {{TT:Doc|trainPartSequence|train}} groups all elements {{TT:Doc|trainPart}} belonging to a train. The {{Attr|sequence}} herein is supposed to be used for successive parts along the train route. This is ''not'' to be mixed up with the sequence of rolling stock inside a train {{RS:Doc|formation}} or a chronological sequence during an operating period or during a day. Therefore all referenced elements {{TT:Doc|trainPart}} of a {{TT:Doc|trainPartSequence|train}} should have the same starting point and end point, while follow-up {{TT:Tag|trainPartSequence|train}} elements should begin where the {{TT:Doc|trainPart}}s referenced by the previous {{TT:Tag|trainPartSequence|train}} element ended. Otherwise you should define smaller (shorter) {{TT:Doc|trainParts}}.


{{deu|Das Element {{TT:Doc|trainPartSequence}} gruppiert alle zu einem Zug gehörigen Elemente {{TT:Doc|trainPart}}. Dabei ist die {{Attr|sequence}} im Sinne einer Abfolge der Betriebsstellen im Zuglauf zu verstehen. Dies darf ''nicht'' verwechselt werden mit der Abfolge der Zugteile innerhalb einer Zugkonfiguration und auch nicht mit der zeitlichen Abfolge von Betriebstagen innerhalb einer Verkehrsperiode. Die innerhalb einer {{TT:Doc|trainPartSequence}} referenzierten Zuglaufteile {{TT:Doc|trainPart}} müssen daher alle den gleichen Start- und Endpunkt aufweisen. Ansonsten müssen kleinere (kürzere) Zuglaufteile {{TT:Doc|trainPart}} als Bausteine definiert werden.}}
{{deu|Das Element {{TT:Doc|trainPartSequence|train}} gruppiert alle zu einem Zug gehörigen Elemente {{TT:Doc|trainPart}}. Dabei ist die {{Attr|sequence}} im Sinne einer Abfolge der Betriebsstellen im Zuglauf zu verstehen. Dies darf ''nicht'' verwechselt werden mit der Abfolge der Zugteile innerhalb einer Zugkonfiguration und auch nicht mit der zeitlichen Abfolge von Betriebstagen innerhalb einer Verkehrsperiode. Die innerhalb einer {{TT:Doc|trainPartSequence|train}} referenzierten Zuglaufteile {{TT:Doc|trainPart}} müssen daher alle den gleichen Start- und Endpunkt aufweisen und die {{TT:Doc|trainPart}}s eines Folge-{{TT:Tag|trainPartSequence|train}}-Elements müssen da beginnen, wo die {{TT:Doc|trainPart}}s des verausgegangenen {{TT:Tag|trainPartSequence|train}}-Elements geendet haben. Ansonsten müssen kleinere (kürzere) Zuglaufteile {{TT:Doc|trainPart}} als Bausteine definiert werden.}}


|parent = {{TT:Tag|train}}
|parent = {{TT:Tag|train}}


|childs = {{TT:Tag|trainPartRef}}, {{TT:Tag|equipmentUsage|trainPartSequence}}, {{TT:Tag|brakeUsage}}, {{TT:Tag|speedProfileRef}} {{intro|2.2}}, {{any}} {{intro|2.3}}
|childs = {{TT:Tag|trainPartRef}}, {{TT:Tag|speedProfileRef}} {{intro|2.2}}, {{TT:Tag|equipmentUsage|trainPartSequence}}, {{TT:Tag|brakeUsage}}, {{TT:Tag|topologyReference}} {{intro|2.4}}, {{any}} {{intro|2.3}}
|maxocc=∞
|maxocc=∞
|inheritedAttributes=''None''
|inheritedAttributes=''None''
Line 15: Line 15:
* {{Attr|sequence}}: This is the sequence of successive train parts along the train route ({{xsdType|integer}})
* {{Attr|sequence}}: This is the sequence of successive train parts along the train route ({{xsdType|integer}})


* {{Attr|pathStatus}}: This is the status of the train path. It is used if a {{TT:Doc|train}} is involved in a train paths allocation process and encodes information relevant for the ordering process only. Possible values are:
* {{Attr|pathStatus}}: This is the status of the {{TT:Doc|train}} times in a train paths allocation ''(called: slot)'' process and encodes information relevant for the slot ordering process between a railway undertaking (RU) and infrastructre manager (IM) only.</br></br>Currently possible values are:
:* {{Enum|planned}} The train is planned for ordering at the infrastructure manager (IM), but no order has yet been issued (initial state).<br>{{Deu|Der Zug wurde geplant und eine Trasse soll beim Imfrastrukturbetreiber (IM) bestellt werden, eine Bestellung ist aber noch nicht erfolgt (Initialzustand).}}
:* {{Enum|conceptual}} {{intro|2.5}} Train is only a preliminary consideration by the RU which has not been confirmed for planning yet. <br>{{Deu|Der Zug ist nur eine Vorüberlegung des EVU, die noch nicht für die Planung bestätigt wurde.}}
:* {{Enum|ordered}} The train has been ordered at the IM.<br>{{Deu|Die Trasse für den Zug wurde beim IM bestellt.}}
:* {{Enum|planned}} The train is planned by the RU for ordering at the IM, but no order has yet been sent by the RU (initial state). No action is taken by the IM.<br>{{Deu|Der Zug wurde durch das Eisenbahnverkehrsunternehmen (EVU) geplant und eine Trasse soll beim Infrastrukturbetreiber (EIU) bestellt werden, eine Bestellung ist aber noch nicht erfolgt (Initialzustand). Durch das EIU werden keine Aktivitäten durchgeführt.}}
:* {{Enum|confirmed}} The IM has submitted an offer for a train path to the railway undertaking (RU) and the RU has accepted this offer.<br>{{Deu|Der IM hat als Reaktion auf eine Trassenbestellung ein Angebot unterbreitet, das vom Eisenbahnverkehrsunternehmen angenommen wurde.}}
:* {{Enum|ordered}} The train has been ordered by the RU at the IM.<br>{{Deu|Die Trasse für den Zug wurde durch das EVU beim EIU bestellt.}}
:* {{Enum|detailsRefused}} The IM has received the order but cannot fulfill all requirements and changed some details in order to offer some train path related to the order.<br>{{Deu|Der Infrastrukturbetreiber hat eine Bestellung erhalten, konnte diese aber nicht in allen Aspekten berücksichtigen und hat daher einige Details der Bestellung geändert um ein Angebot machen zu können}}
:* {{Enum|offered}} {{intro|2.5}} The train path has been offered by the IM in response to an ordered train path request submitted by the RU<br>{{deu|Als Antwort auf eine Bestellung ([[#ordered]]) hat das EIU dem EVU ein Angebot unterbreitet.}}
:* {{Enum|cancelled}} The RU has cancelled the train at the IM.<br>{{Deu|Das Eisenbahnverkehrsunternehmen hat den Zug abgesagt.}}
:* {{Enum|confirmed}} The IM has submitted an offer for a train path to the RU and the RU has accepted this offer.<br>{{Deu|Das EIU hat dem EVU ein Trassenangebot unterbreitet, das vom EVU angenommen wurde.}}
:* {{Enum|notAvailable}} The IM has rejected the order of then train path.<br>{{Deu||Der Infrastrukturbetreiber hat die bestellte Trasse abgelehnt.}}
:* {{Enum|detailsRefused}} The IM has received the order from the RU, but cannot fulfill all requirements and changed some details in order to offer the RU some train path related to the order.<br>{{Deu|Das EIU hat eine Bestellung erhalten, konnte diese aber nicht in allen Aspekten berücksichtigen und hat daher einige Details der Bestellung geändert, um dem EVU ein Angebot machen zu können}}
:* {{Enum|cancelled}} The RU has rejected or cancelled the slot at the IM.<br>{{intro|2.3}} As of version 2.3 it is possible to differentiate between a cancelled slot and a cancelled service by using {{Attr|cancellation}} of {{TT:Tag|train}} or {{TT:Tag|trainPart}}.<br>{{Deu|Das EVU hat die Trasse beim EIU abgelehnt oder abgesagt. <br>{{intro|2.3}} Ab Version 2.3 ist es möglich zwischen einer abgesagten Trasse und einer ausgefallenen Fahrleistung zu unterscheiden. Dazu kann das Attribut {{Attr|cancellation}} an {{TT:Tag|train}} bzw. {{TT:Tag|trainPart}} genutzt werden.}}
:* {{Enum|notAvailable}} The IM has rejected or cancelled the slot at the RU.<br>{{Deu|Das EIU hat die Trasse beim EVU abgelehnt oder abgesagt.}}
:* {{OtherEnum
:* {{OtherEnum
|notes_en =
|notes_en =
Line 53: Line 55:


For more information, please read [[TT:trainCouplingAndSharing|Train coupling and Sharing]] - ''On trains and train parts in general''.
For more information, please read [[TT:trainCouplingAndSharing|Train coupling and Sharing]] - ''On trains and train parts in general''.
=== Attribute {{@|pathStatus}} and the slot ordering process ===
As of version 2.5 a slot ordering process may be described in {{rml}} using the {{@|pathStatus}} enum values. The intended process is visualized with the following diagram:
[[File:Bild 2022-09-29 152352322.png|border|1000px]]


|example =  
|example =  

Latest revision as of 20:04, 22 January 2024


trainPartSequence
 


Scheme description / Schemenbeschreibung

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

Multiplicity / Anzahl

[1..∞]

Semantics / Bedeutung

The element trainPartSequence groups all elements trainPart belonging to a train. The sequence herein is supposed to be used for successive parts along the train route. This is not to be mixed up with the sequence of rolling stock inside a train formation or a chronological sequence during an operating period or during a day. Therefore all referenced elements trainPart of a trainPartSequence should have the same starting point and end point, while follow-up <trainPartSequence> elements should begin where the trainParts referenced by the previous <trainPartSequence> element ended. Otherwise you should define smaller (shorter) trainParts.

Das Element trainPartSequence gruppiert alle zu einem Zug gehörigen Elemente trainPart. Dabei ist die sequence im Sinne einer Abfolge der Betriebsstellen im Zuglauf zu verstehen. Dies darf nicht verwechselt werden mit der Abfolge der Zugteile innerhalb einer Zugkonfiguration und auch nicht mit der zeitlichen Abfolge von Betriebstagen innerhalb einer Verkehrsperiode. Die innerhalb einer trainPartSequence referenzierten Zuglaufteile trainPart müssen daher alle den gleichen Start- und Endpunkt aufweisen und die trainParts eines Folge-<trainPartSequence>-Elements müssen da beginnen, wo die trainParts des verausgegangenen <trainPartSequence>-Elements geendet haben. Ansonsten müssen kleinere (kürzere) Zuglaufteile trainPart als Bausteine definiert werden.

Attributes of trainPartSequence / Attribute von trainPartSequence

  • sequence: This is the sequence of successive train parts along the train route (xs:integer)
  • pathStatus: This is the status of the train times in a train paths allocation (called: slot) process and encodes information relevant for the slot ordering process between a railway undertaking (RU) and infrastructre manager (IM) only.

    Currently possible values are:
  • conceptual (introduced with version 2.5) Train is only a preliminary consideration by the RU which has not been confirmed for planning yet.
    Der Zug ist nur eine Vorüberlegung des EVU, die noch nicht für die Planung bestätigt wurde.
  • planned The train is planned by the RU for ordering at the IM, but no order has yet been sent by the RU (initial state). No action is taken by the IM.
    Der Zug wurde durch das Eisenbahnverkehrsunternehmen (EVU) geplant und eine Trasse soll beim Infrastrukturbetreiber (EIU) bestellt werden, eine Bestellung ist aber noch nicht erfolgt (Initialzustand). Durch das EIU werden keine Aktivitäten durchgeführt.
  • ordered The train has been ordered by the RU at the IM.
    Die Trasse für den Zug wurde durch das EVU beim EIU bestellt.
  • offered (introduced with version 2.5) The train path has been offered by the IM in response to an ordered train path request submitted by the RU
    Als Antwort auf eine Bestellung (#ordered) hat das EIU dem EVU ein Angebot unterbreitet.
  • confirmed The IM has submitted an offer for a train path to the RU and the RU has accepted this offer.
    Das EIU hat dem EVU ein Trassenangebot unterbreitet, das vom EVU angenommen wurde.
  • detailsRefused The IM has received the order from the RU, but cannot fulfill all requirements and changed some details in order to offer the RU some train path related to the order.
    Das EIU hat eine Bestellung erhalten, konnte diese aber nicht in allen Aspekten berücksichtigen und hat daher einige Details der Bestellung geändert, um dem EVU ein Angebot machen zu können
  • cancelled The RU has rejected or cancelled the slot at the IM.
    (introduced with version 2.3) As of version 2.3 it is possible to differentiate between a cancelled slot and a cancelled service by using cancellation of <train> or <trainPart>.
    Das EVU hat die Trasse beim EIU abgelehnt oder abgesagt.
    (introduced with version 2.3) Ab Version 2.3 ist es möglich zwischen einer abgesagten Trasse und einer ausgefallenen Fahrleistung zu unterscheiden. Dazu kann das Attribut cancellation an <train> bzw. <trainPart> genutzt werden.
  • notAvailable The IM has rejected or cancelled the slot at the RU.
    Das EIU hat die Trasse beim EVU abgelehnt oder abgesagt.
  • other:anything: Any value that does not fit any value from the previous enumeration list, fulfilling the constraint: at minimum two characters, whitespace is not allowed. Please, apply Dev:usingAny accordingly.
  • xs:anyAttribute: This provides an extension point for non-railML® attributes in a foreign namespace. How to use it?

Syntactic Constraints / Syntaktische Beschränkungen

  • pathStatus: union of (restriction of xs:string, tOtherEnumerationValue); tOtherEnumerationValue is an arbitrary string starting with 'other:' followed by at minimum two characters, white space not allowed for extending railML® enumeration lists, optional

Best practice & Examples / Empfohlene Anwendung & Beispiele

Train City Night Line 242:

<train id="o242" type="operational" description="Berlin - Paris" trainNumber="242">
  <trainPartSequence sequence="1"> <!-- Berlin to Hannover -->
    <trainPartRef position="1" ref="CNL_242_1"/>
    <trainPartRef position="2" ref="CNL_1242_1"/>
  </trainPartSequence>
  <trainPartSequence sequence="2"> <!-- Hannover to Paris-Nord -->
    <trainPartRef ref="CNL_242_2"/>
  </trainPartSequence>
</train>

Notes / Anmerkungen

Each train names all its train parts in its element <trainPartRef> with the attributes ref and position. A train may consist of more than one train part either in one section or in subsequent sections of its route. There may be several elements <trainPartRef> with the same position if the corresponding train parts apply in different sections.

More than one train part in one section applies for instance with train coupling and sharing.
More than one train part in subsequent sections applies for instance if the operating days change at an intermediate station.

For more information, please read Train coupling and Sharing - On trains and train parts in general.

Attribute @pathStatus and the slot ordering process

As of version 2.5 a slot ordering process may be described in railML® using the @pathStatus enum values. The intended process is visualized with the following diagram:

Bild 2022-09-29 152352322.png

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.