TT:operatingDayDeviance: Difference between revisions

From railML 2 Wiki
Jump to navigation Jump to search
[unchecked revision][checked revision]
mNo edit summary
(multiplicity)
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{elementDocu|
{{ElementDocu|
elementName = operatingDayDeviance
elementName = operatingDayDeviance
|semantics =
|semantics =
The Element {{TT:Doc|operatingDayDeviance}} describes the operation modifications of the standard week described in {{TT:Doc|operatingDay}}. This description is also week based but also related to public holidays. Each element {{TT:Doc|operatingDayDeviance}} characterizes a set of days (e.g. Mondays and Tuesdays on a days before a public Holiday).
The Element {{TT:Doc|operatingDayDeviance}} describes the operation modifications of the standard week described in {{TT:Doc|operatingDay}}. This description is also week based but also related to public holidays. Each element {{TT:Doc|operatingDayDeviance}} characterizes a set of days (e.g. Mondays and Tuesdays on a days before a public Holiday).


{{deu|Das Element {{TT:Doc|operatingDayDeviance}} beschreibt die Abweichungen gegenüber der in {{TT:Doc|operatingDay}} beschriebenen Standardwoche. Dies erfolgt ebenfalls wochentagsbezogen, aber auch im Hinblick auf zeitlich benachbarte Feiertage. Jedes Element {{TT:Doc|operatingDayDeviance}} charakterisiert dabei eine Menge von Tagen (z.B. alle Montage und Dienstage, die gleichzeitig Vor-Feiertage sind).}}
{{Deu|Das Element {{TT:Doc|operatingDayDeviance}} beschreibt die Abweichungen gegenüber der in {{TT:Doc|operatingDay}} beschriebenen Standardwoche. Dies erfolgt ebenfalls wochentagsbezogen, aber auch im Hinblick auf zeitlich benachbarte Feiertage. Jedes Element {{TT:Doc|operatingDayDeviance}} charakterisiert dabei eine Menge von Tagen (z.B. alle Montage und Dienstage, die gleichzeitig Vor-Feiertage sind).}}
 
|parent = {{TT:Tag|operatingDay}}
|childs=''None''
|minocc=0
|maxocc=∞
|inheritedAttributes=''None''
|ownAttributes =
* {{Attr|operatingCode}}: This is a 7-digit week bit mask, describing for Monday to Sunday if a train is driving or not (1/0) on this day of the week.
 
* {{Attr|onRequest}} {{Intro|2.1}}: This is needed for "runs Monday to Friday and additionally Sunday on request".


|parent = {{TT:Doc|operatingDay}}
* {{Attr|holidayOffset}}: This is the type of a day in relation to surrounding public holidays.


|inheritedAttributes
* {{Attr|ranking}}: This gives a detailed characterization of the specific subset of days, the modification is made for.


|ownAttributes =
{{InheritAnyAttribute
*{{attr|operatingCode}}: a 7-digit week bit mask, describing for Monday to Sunday if a train is driving or not (1/0) on this day of the week ({{xsdType|string}}, required)
|comment={{intro|2.3}}
*{{attr|holidayOffset}}: the type of a day in relation to surrounding publich holidays ({{xsdType|integer}}, required).
|anyAttribute =
*{{attr|ranking}}: gives a detailed characterization of the specific subset of days, the modification is made for ({{xsdType|positiveInteger}}, optional).
|anyAttribute_de =
Two or more conditions described by elements {{TT:Tag|operatingDayDeviance}} with the same or no {{attr|ranking}} have to be fullfilled at the same time. For days wich happen to be in two sets with different {{attr|ranking}}, the one with the lower rank is the right one.
}}
 
|constraints =
* {{Attr|operatingCode}} mandatory
 
* {{Attr|onRequest}} {{XsdType|boolean}}, optional
 
* {{Attr|holidayOffset}} {{XsdType|integer}}, mandatory
 
* {{Attr|ranking}} {{RailMLType|tPositiveCounter}}, optional
 
Two or more conditions described by elements {{TT:Tag|operatingDayDeviance}} with the same or no {{Attr|ranking}} have to be fullfilled at the same time. For days which happen to be in two sets with different {{Attr|ranking}}, the one with the lower rank is the right one.


|example =  
|example =  
Line 20: Line 42:
  <operatingPeriod id="op1" name="S">
  <operatingPeriod id="op1" name="S">
   <operatingDay operatingCode="0000001"/>
   <operatingDay operatingCode="0000001"/>
   <operatingDayD operatingCode="1111111" holidayOffset="0"/>
   <operatingDayDeviance operatingCode="1111111" holidayOffset="0"/>
   </operatingDay>
   </operatingDay>
  </operatingPeriod>
  </operatingPeriod>
Line 35: Line 57:
   </operatingDay>
   </operatingDay>
  </operatingPeriod>
  </operatingPeriod>
see also
* {{external|http://www.irfp.de/download/railml_beispiel_verkehrstage.pdf|Weitere Informationen und {{rml}}-Beispiel zu Verkehrstagen|type=PDF|comment=by Dirk Bräuer, iRFP Dresden|visited=2018-03-27|lang=de|dat=2012-05-23}}


|backHome = TT:elements
|backHome = TT:elements
}}
}}

Revision as of 21:28, 25 November 2018


operatingDayDeviance
 


Scheme description / Schemenbeschreibung

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

Multiplicity / Anzahl

[0..∞]

Semantics / Bedeutung

The Element operatingDayDeviance describes the operation modifications of the standard week described in operatingDay. This description is also week based but also related to public holidays. Each element operatingDayDeviance characterizes a set of days (e.g. Mondays and Tuesdays on a days before a public Holiday).

Das Element operatingDayDeviance beschreibt die Abweichungen gegenüber der in operatingDay beschriebenen Standardwoche. Dies erfolgt ebenfalls wochentagsbezogen, aber auch im Hinblick auf zeitlich benachbarte Feiertage. Jedes Element operatingDayDeviance charakterisiert dabei eine Menge von Tagen (z.B. alle Montage und Dienstage, die gleichzeitig Vor-Feiertage sind).

Attributes of operatingDayDeviance / Attribute von operatingDayDeviance

  • operatingCode: This is a 7-digit week bit mask, describing for Monday to Sunday if a train is driving or not (1/0) on this day of the week.
  • onRequest (introduced with version 2.1): This is needed for "runs Monday to Friday and additionally Sunday on request".
  • holidayOffset: This is the type of a day in relation to surrounding public holidays.
  • ranking: This gives a detailed characterization of the specific subset of days, the modification is made for.
  • 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

  • operatingCode mandatory

Two or more conditions described by elements <operatingDayDeviance> with the same or no ranking have to be fullfilled at the same time. For days which happen to be in two sets with different ranking, the one with the lower rank is the right one.

Best practice & Examples / Empfohlene Anwendung & Beispiele

On Sundays and on public holidays

<operatingPeriod id="op1" name="S">
 <operatingDay operatingCode="0000001"/>
  <operatingDayDeviance operatingCode="1111111" holidayOffset="0"/>
 </operatingDay>
</operatingPeriod>

On Saturdays which are no public holidays and on public holidays before other public holidays

<operatingPeriod id="op2" name="Sa[S] + FvF">
 <operatingDay operatingCode="0000010">
  <operatingDayDeviance operatingCode="0000000" holidayOffset="0" />
 </operatingDay>
 <operatingDay operatingCode="0000000">
  <operatingDayDeviance operatingCode="1111111" holidayOffset="0" ranking="1" />
  <operatingDayDeviance operatingCode="1111111" holidayOffset="-1" ranking="1" />
 </operatingDay>
</operatingPeriod>

see also

Notes / Anmerkungen

Not yet described. / Noch nicht beschrieben.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.