TT:places: Difference between revisions

From railML 2 Wiki
Jump to navigation Jump to search
[checked revision][checked revision]
No edit summary
(Abgleich mit https://www.railml.org/forum/index.php?t=msg&th=562&start=0&)
(5 intermediate revisions by 2 users not shown)
Line 9: Line 9:
|parent = {{TT:Tag|passengerUsage}}
|parent = {{TT:Tag|passengerUsage}}
|childs=''None''
|childs=''None''
|minocc=0
|maxocc=∞
|inheritedAttributes=''None''
|inheritedAttributes=''None''
|ownAttributes =
|ownAttributes =
* {{Attr|category}}: The type of places specified within this element. {{AddAnn|| }} <br/> Possible values are:
* {{Attr|category}}: The type of places specified within this element. {{AddAnn|| }} <br/> Possible values are:
:* {{Enum|class1}} This is used for identifying the number of first class seats within the vehicle.
:* {{Enum|class1}} Seating capacity of the vehicle, class 1/comfort class.
:* {{Enum|class2}} This is used for identifying the number of standard class seats within the vehicle.
:* {{Enum|class2}} Seating capacity of the vehicle, class 2/standard.
:* {{Enum|class3}} This is used for identifying the number of third class seats within the vehicle.
:* {{Enum|class3}} Seating capacity of the vehicle, class 3.
:* {{Enum|standing}} This is used for identifying the number of standing places within the vehicle.
:* {{Enum|standing}} Standing place capacity of the vehicle.
:* {{Enum|wheelchair}} This is used for identifying the number of places available for wheelchairs within the vehicle.
:* {{Enum|standingArea}} {{intro|2.4}} Standing room capacity in square meters. Flip-up seats not in use.
:* {{Enum|bicycle}} This is used for identifying the number of places available for bicycles within the vehicle.
:* {{Enum|wheelchair}} Number of dedicated places for wheelchairs.
:* {{Enum|bicycle}} Number of dedicated places for bicyles.
:* {{Enum|couchette}} This is used for identifying the number of accommodation berths within the vehicle (couchette car).
:* {{Enum|couchette}} This is used for identifying the number of accommodation berths within the vehicle (couchette car).
:* {{Enum|bed}} This is used for identifying the number of bed places within the vehicle (sleeping car).
:* {{Enum|bed}} Number of beds. Not differentiated by class (typically in sleeping cars).
:* {{Enum|chair}} This is used for identifying the number of sleeping chairs within the vehicle.
:* {{Enum|chair}} Number of sleeping chairs (over all classes).
:* {{Enum|bistro}} {{intro|2.4}}
:* {{Enum|restaurant}} {{intro|2.4}} Seating capacity in the restaurant/dining car
:* {{Enum|foldingSeat}} {{intro|2.4}} Flip-up seats (folding and resting combined).{{note|Folding seats are seats with dedicated area for the seat when it is folded down. Resting seats are in dedicated standing area (like entry/exit area).}}
:* {{Enum|impairedToilet}} {{intro|2.4}}
:* {{Enum|toilet}} {{intro|2.4}}
:* {{Enum|business}} {{intro|2.4}}
:* {{Enum|businessCompartment}} {{intro|2.4}}
:* {{Enum|family}} {{intro|2.4}} Capacity of seats in the vehicle in family compartments with family services like playroom and baby wagon storage area/places. Services not defined.
:* {{Enum|familyCompartment}} {{intro|2.4}}
:* {{Enum|stroller}} {{intro|2.4}}
:* {{Enum|toddler}} {{intro|2.4}}
:* {{Enum|toddlerCompartment}} {{intro|2.4}}
:* {{Enum|sleepingCompartment}} {{intro|2.4}} Number of sleeping compartments. Not differentiated by class.
:* {{OtherEnum
:* {{OtherEnum
|notes_en = This is used for identifying the number of any other type of places within the vehicle.
|notes_en = This is used for identifying the number of any other type of places within the vehicle.
Line 27: Line 43:
*{{attr|tapTsiType9039Code}}: Code list for the facility type description based on the directory of passenger code lists for the ERA technical documents used in TAP TSI (B.4.9039)
*{{attr|tapTsiType9039Code}}: Code list for the facility type description based on the directory of passenger code lists for the ERA technical documents used in TAP TSI (B.4.9039)
* {{Attr|count}}: The number of places within the vehicle of the type given in the {{Attr|category}} attribute of the same element. {{AddAnn|| }}
* {{Attr|count}}: The number of places within the vehicle of the type given in the {{Attr|category}} attribute of the same element. {{AddAnn|| }}
* {{Attr|description}}: This allows an additional description or comment for the provided places. {{AddAnn|| }}
* {{Attr|description}}: This allows an additional description or comment for the provided places. {{AddAnn|| }}{{human}}
 
* {{attr|reservation}}: is needed to define a mandatory reservation for "places" in general and for bicycles in special
{{InheritAnyAttribute
{{InheritAnyAttribute
|comment={{intro|2.3}}
|comment={{intro|2.3}}
Line 34: Line 50:
|anyAttribute_de =
|anyAttribute_de =
}}
}}
|constraints =
|constraints =
* {{Attr|category}}: {{RailMLType|tPlaceCategory}}, mandatory
* {{Attr|category}}: {{RailMLType|tPlaceCategory}}, mandatory
Line 40: Line 55:
* {{Attr|count}}: {{RailMLType|tCounter}}, mandatory
* {{Attr|count}}: {{RailMLType|tCounter}}, mandatory
* {{Attr|description}}: {{RailMLType|tElementDescription}}, optional
* {{Attr|description}}: {{RailMLType|tElementDescription}}, optional
 
* {{attr|reservation}}: {{railMLType|tPlaceReservation}}
One {{TT:Tag|passengerUsage}} can have an unlimited number of {{TT:Tag|places}} elements. {{AddAnn|| }}
One {{TT:Tag|passengerUsage}} can have an unlimited number of {{TT:Tag|places}} elements. {{AddAnn|| }}


|example =
|example =
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<vehicle id='veh_DABpza785.2' name='DABpza785.2' numberNonDrivenAxles='4' track-Gauge='1.435' length='26.800' speed='160' bruttoWeight='55.000' net-toWeight='49.000'>
<trainPart id="...">
   <wagon>
   <formationTT formationRef="frm4711">
     <passenger>
     <passengerUsage>
       <places category='class1' count='5'/>
       <places category='class1' count='5'/>
       <places category='class2' count='89'/>
       <places category='class2' count='89'/>
     </passenger>
     </passengerUsage>
   </wagon>
   </formationTT>
</vehicle>
</trainPart>
</syntaxhighlight>
</syntaxhighlight>
}}
}}

Revision as of 11:12, 7 May 2021


places
 


Scheme description / Schemenbeschreibung

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

Multiplicity / Anzahl

[0..∞]

Semantics / Bedeutung

The element <places> contains the data related to particular passenger capacity with respect to the various categories of providing space for them.
(introduced with version 2.2)

Das Element <places> beinhaltet die Beschreibung zur Fahrgastkapazität des Fahrzeuges aufgeteilt nach den verschiedenen Kategorien der Unterbringung.
(introduced with version 2.2)

Attributes of places / Attribute von places

  • category: The type of places specified within this element.
    Possible values are:
  • class1 Seating capacity of the vehicle, class 1/comfort class.
  • class2 Seating capacity of the vehicle, class 2/standard.
  • class3 Seating capacity of the vehicle, class 3.
  • standing Standing place capacity of the vehicle.
  • standingArea (introduced with version 2.4) Standing room capacity in square meters. Flip-up seats not in use.
  • wheelchair Number of dedicated places for wheelchairs.
  • bicycle Number of dedicated places for bicyles.
  • couchette This is used for identifying the number of accommodation berths within the vehicle (couchette car).
  • bed Number of beds. Not differentiated by class (typically in sleeping cars).
  • chair Number of sleeping chairs (over all classes).
  • bistro (introduced with version 2.4)
  • restaurant (introduced with version 2.4) Seating capacity in the restaurant/dining car
  • foldingSeat (introduced with version 2.4) Flip-up seats (folding and resting combined).
🗒️ Folding seats are seats with dedicated area for the seat when it is folded down. Resting seats are in dedicated standing area (like entry/exit area).
  • impairedToilet (introduced with version 2.4)
  • toilet (introduced with version 2.4)
  • business (introduced with version 2.4)
  • businessCompartment (introduced with version 2.4)
  • family (introduced with version 2.4) Capacity of seats in the vehicle in family compartments with family services like playroom and baby wagon storage area/places. Services not defined.
  • familyCompartment (introduced with version 2.4)
  • stroller (introduced with version 2.4)
  • toddler (introduced with version 2.4)
  • toddlerCompartment (introduced with version 2.4)
  • sleepingCompartment (introduced with version 2.4) Number of sleeping compartments. Not differentiated by class.
  • 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.
    This is used for identifying the number of any other type of places within the vehicle.
  • tapTsiType9039Code: Code list for the facility type description based on the directory of passenger code lists for the ERA technical documents used in TAP TSI (B.4.9039)
  • count: The number of places within the vehicle of the type given in the category attribute of the same element.
  • description: This allows an additional description or comment for the provided places.
💡 Please take into account our references to human-intepretable data fields.

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

  • reservation: is needed to define a mandatory reservation for "places" in general and for bicycles in special
  • xs:anyAttribute(introduced with version 2.3) This provides an extension point for non-railML® attributes in a foreign namespace. How to use it?

Syntactic Constraints / Syntaktische Beschränkungen

  • category: 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, mandatory
  • tapTsiType9039Code: derived by tDigitString: xs:string; an arbitrary string consisting of digits from 0 to 9; not allowing white space, letters; no length restriction
  • count: xs:nonNegativeInteger, mandatory
  • description: xs:string, optional
  • reservation: 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

One <passengerUsage> can have an unlimited number of <places> elements.

Best practice & Examples / Empfohlene Anwendung & Beispiele

<trainPart id="...">
  <formationTT formationRef="frm4711">
    <passengerUsage>
      <places category='class1' count='5'/>
      <places category='class2' count='89'/>
    </passengerUsage>
  </formationTT>
</trainPart>

Notes / Anmerkungen

Not yet described. / Noch nicht beschrieben.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.