TT:statisticAnalyses: Difference between revisions

From railML 2 Wiki
Jump to navigation Jump to search
[checked revision][checked revision]
(any-Attribut ergänzt)
(added documentation regarding enum values taken from xsd)
 
(6 intermediate revisions by 2 users not shown)
Line 2: Line 2:
|elementName = statisticAnalyses
|elementName = statisticAnalyses
|parent =  {{TT:Tag|statistic}}
|parent =  {{TT:Tag|statistic}}
|childs  
|childs=''None''
|minocc=0
|maxocc=∞
|inheritedAttributes=''None''
|semantics =
|semantics =
The element {{TT:Tag|statisticAnalyses}} provides a formalized output for the result of an analysed statistic figures.
The element {{TT:Tag|statisticAnalyses}} provides a formalized output for the result of an analysed statistic figure.
 
|ownAttributes =
|ownAttributes =
* {{Attr|description}}: description of the analysis figure
* {{Attr|description}}: description of the analysis figure{{human}}
* {{Attr|percentage}}: percentage involved in the analysis figure
* {{Attr|percentage}}: percentage involved in the analysis figure
* {{Attr|value}}: value involved in the analysis figure
* {{Attr|value}}: value involved in the analysis figure
Line 16: Line 18:
|anyAttribute_de =
|anyAttribute_de =
}}
}}
|constraints =
|constraints =
* {{Attr|description}} {{XsdType|string}}, optional
* {{Attr|description}}: {{XsdType|string}}, optional
* {{Attr|percentage}} {{XsdType|decimal}}, optional
* {{Attr|percentage}}: {{XsdType|decimal}}, optional
* {{Attr|value}} {{XsdType|duration}}, optional
* {{Attr|value}}: {{XsdType|duration}}, optional
* {{Attr|figure}} optional, possible values are:
* {{Attr|figure}}: {{railMLType|tStatisticFigure}}, optional, possible values are:
:* {{Enum|maxDelayArrival}}
:* {{Enum|maxDelayArrival}} The enclosing element encodes information about the maximum delay of this train's arrivals.
:* {{Enum|maxDelayDeparture}}
:* {{Enum|maxDelayDeparture}} The enclosing element encodes information about the maximum delay of this train's departures.
:* {{Enum|meanDelayArrival}}
:* {{Enum|meanDelayArrival}} The enclosing element encodes information about the mean delay of this train's arrivals.
:* {{Enum|meanDelayDeparture}}
:* {{Enum|meanDelayDeparture}} The enclosing element encodes information about the mean delay of this train's departures.
:* {{Enum|medianDelayArrival}}
:* {{Enum|medianDelayArrival}} The enclosing element encodes information about the median delay of this train's arrivals.
:* {{Enum|medianDelayDeparture}}
:* {{Enum|medianDelayDeparture}} The enclosing element encodes information about the median delay of this train's departures.
:* {{OtherEnum
:* {{OtherEnum
|notes_en =
|notes_en =
|notes_de =
|notes_de =
}}
}}
|notes =  The result of an analysis could be: "''This train has at this ocp in more than 95% of all cases less than 4 minutes arrival delay''"
|notes =  The result of an analysis could be: "''This train has at this ocp in more than 95% of all cases less than 4 minutes arrival delay''"
|example =  <statisticAnalyses description="95% less than 4min delay" percentage="95" value="PT4M" figure="maxDelayArrival" />
|example =  <syntaxhighlight lang=xml><statisticAnalyses description="95% less than 4min delay" percentage="95" value="PT4M" figure="maxDelayArrival" /></syntaxhighlight>
 
|backHome = TT:elements
|backHome = TT:elements
}}
}}

Latest revision as of 09:58, 19 September 2022


statisticAnalyses
 


Scheme description / Schemenbeschreibung

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

Multiplicity / Anzahl

[0..∞]

Semantics / Bedeutung

The element <statisticAnalyses> provides a formalized output for the result of an analysed statistic figure.

Attributes of statisticAnalyses / Attribute von statisticAnalyses

  • description: description of the analysis figure
💡 Please take into account our references to human-intepretable data fields.

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

  • percentage: percentage involved in the analysis figure
  • value: value involved in the analysis figure
  • figure: type of the analysis figure
  • 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

  • description: xs:string, optional
  • percentage: xs:decimal, optional
  • value: xs:duration, optional
  • figure: 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, possible values are:
  • maxDelayArrival The enclosing element encodes information about the maximum delay of this train's arrivals.
  • maxDelayDeparture The enclosing element encodes information about the maximum delay of this train's departures.
  • meanDelayArrival The enclosing element encodes information about the mean delay of this train's arrivals.
  • meanDelayDeparture The enclosing element encodes information about the mean delay of this train's departures.
  • medianDelayArrival The enclosing element encodes information about the median delay of this train's arrivals.
  • medianDelayDeparture The enclosing element encodes information about the median delay of this train's departures.
  • 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.

Best practice & Examples / Empfohlene Anwendung & Beispiele

<statisticAnalyses description="95% less than 4min delay" percentage="95" value="PT4M" figure="maxDelayArrival" />

Notes / Anmerkungen

The result of an analysis could be: "This train has at this ocp in more than 95% of all cases less than 4 minutes arrival delay"

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.