Template:InheritValueTable

valueTable
 

Schema description / Schemenbeschreibung

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

• Parent: FIX ME
• Children: <columnHeader>, <valueLine>

Multiplicity / Anzahl

[1..1]

Semantics / Bedeutung

The element <valueTable> provides a flexible mechanism for description of arbitrary curves in RailML. According the descriptive data in the related attributes the particular curves can be mapped by selected pairs of variates (points) in a three-dimensional coordinate system. All intermediate values have to be interpolated accordingly. The table consist of the informative details of name and unit of each coordinate within the related attributes of the element <valueTable>. In case of several curves versus the x-coordinate there is the child element <columnHeader>, which takes the values of the z-coordinate as parameter for the array of curves. The final pair of variates are located in the particular child elements of <valueLine>, providing the attributes for the values of x- and y-coordinate. This can be depicted as the lines of the table. Within each line there has to be one corresponding element of <values> for each defined value of the z-coordinate. This can be depicted as the columns of the table. The order of <values> elements as values of the y-coordinate has to conform to the order of z-coordinate in <columnHeader>. According the normal conventions 'x' means the independent variable. 'y' is direct dependent on 'x' and conforms to y = f(x). 'z' is the additional parameter extending the dependency to y = f(x,z).

Das Element <valueTable> (Wertetabelle) stellt ein mächtiges Instrument zur Hinterlegung beliebiger Verläufe in RailML zur Verfügung. Entsprechend der Beschreibung in den zugehörigen Attributen können die zu betrachtenden Verläufe durch ausgewählte Punkte in einem drei-dimensionalen Koordinatensystem abgebildet werden. Alle Zwischenwerte müssen entsprechend interpoliert werden. Die Tabelle besteht aus der informativen Angabe von Name und Einheit der jeweiligen Koordinate in den Attributen dieses Elements <valueTable>. Wenn mehr als eine Kurve bezogen auf eine x-Koordinate beschrieben werden soll, gibt es das Unterelement <columnHeader>, welches die Einzelwerte der z-Koordinate als Parameter aufnimmt. Die eigentlichen Wertepaare befinden sich in den einzelnen Unterelementen <valueLine>, die die jeweiligen Werte für die x- und y-Koordinate enthalten. Für jeden möglichen Wert der z-Koordinate muss ein Element <values> mit dem zugehörigen Wert der y-Koordinate auftreten. Die Werte der y-Koordinate müssen dabei in der gleichen Reihenfolge aufgelistet werden wie die zugehörigen zValue in der Kopfzeile <columnHeader>. Gemäß der üblichen Konventionen stellt 'x' die unabhängige Variable dar. 'y' ist der direkt von 'x' abhängige Wert, sodass gilt y = f(x). 'z' ist ein zusätzlicher Parameter für die Abhängigkeit von 'y', sodass gilt y = f(x,z).

Attributes of valueTable / Attribute von valueTable

• xValueName: This is the descriptive name for the x-coordinate in the <valueTable>.

• xValueUnit: This is the unit used for the values of the x-coordinate in the <valueTable>. For scalars the value '1' shall be given. Possible values of physical units are:

• m/s - speed
• km/h - speed
• A - current
• N - force/effort
• Hz - frequney
• % - percentage
• V - voltage
• W - effective power
• VA - apparent power
• Vs - magnetic flux
• 1 - scalar
• 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.

• yValueName: This is the descriptive name for the y-coordinate in the <valueTable>.

• yValueUnit: This is the unit used for the values of the y-coordinate in the <valueTable>. For scalars the value '1' shall be given. Possible values of physical units are:

• m/s - speed
• km/h - speed
• A - current
• N - force/effort
• Hz - frequney
• % - percentage
• V - voltage
• W - effective power
• VA - apparent power
• Vs - magnetic flux
• 1 - scalar
• 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.

• zValueName: This is the descriptive name for the z-coordinate in the <valueTable>.

• zValueUnit: This is the unit used for the values of the z-coordinate in the <valueTable>. For scalars the value '1' shall be given. Possible values of physical units are:

• m/s - speed
• km/h - speed
• A - current
• N - force/effort
• Hz - frequney
• % - percentage
• V - voltage
• W - effective power
• VA - apparent power
• Vs - magnetic flux
• 1 - scalar
• 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.

Syntactic Constraints / Syntaktische Beschränkungen

• xValueName xs:string, mandatory

• xValueUnit mandatory

• yValueName xs:string, mandatory

• yValueUnit mandatory

• zValueName xs:string, optional

• zValueUnit optional

The element <valueTable> is optional as alternative to mml:math in order to describe any curve.

Best practice & Examples / Empfohlene Anwendung & Beispiele

Not yet described. / Noch nicht beschrieben.

Notes / Anmerkungen

Not yet described. / Noch nicht beschrieben.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.