RS:vehicle

From wiki.railML.org
Jump to: navigation, search

vehicle
 


Scheme description / Schemenbeschreibung / Description du schéma

Position of vehicle in the XML-Tree / Position von vehicle im XML-Baum / position de vehicle dans l’aborescence XML

Multiplicity / Anzahl / Multiplicité

[1..∞]

Semantics / Bedeutung / Sémantique

The element <vehicle> contains all data, which are related to a single vehicle or a vehicle family. The item is referenced via its attribute id. In case of a vehicle family all data can be stored, which are common for all vehicles of this family. The data set of a single vehicle can refer to the common values and define more or deviating characteristics valid only for this particular vehicle.

In dem Element <vehicle> werden alle Fahrzeug bezogenen Daten aufgenommen, um individuelle Fahrzeuge oder ganze Fahrzeugfamilien in informatorischer, organisatorischer, betrieblicher und technischer Hinsicht zu beschreiben. Die einzelnen Datensätze können über das Attribut id referenziert werden. Für eine Fahrzeugfamilie können die Daten einmal aufgeführt werden, die für alle Mitglieder der Familie gleich sind. Die Daten für ein Einzelfahrzeug können dann auf diesen Stand referenzieren. Die Applikation muss sicherstellen, dass bei abweichenden Daten diejenigen des Einzelfahrzeuges zur Anwendung kommen.

Attributes of vehicle / Attribute von vehicle / Attributs de vehicle

  • id: XML-file-wide unique, machine-interpretable identity, required for later referencing that element internally. For a detailed explanation see Dev:identities.
    XML-Datei-weit eindeutige, maschineninterpretierbare Identität, die für die spätere interne Referenzierung dieses Elements erforderlich ist. Für eine detaillierte Erklärung siehe Dev:identities.
  • code (introduced with version 2.1): Machine-interpretable string (e.g. an abbreviation) used for identification of the object across exchange partners, usecase specific uniqueness constraints may apply.
    Maschineninterpretierbare Zeichenkette (z.B. Abkürzung), die zur Identifizierung des Objekts auch bei Austauschpartnern verwendet wird, wobei spezifische Eindeutigkeitsbeschränkungen gelten können.
  • name: Established, human-readable short string, giving the object a name. Usually not intended for machine interpretation.
    Etablierte, menschenlesbare kurze Zeichenkette, die das Objekt benennt. In der Regel nicht zur maschinellen Interpretation bestimmt.
  • description: Human-readable, more detailed description as addition to the name. It should give additional explanations or hints to the contents of this data set. Usually not intended for machine interpretation.
    Menschenlesbare, detailliertere Beschreibung als Ergänzung zu name. Sie soll zusätzliche Erläuterungen oder Hinweise auf den Inhalt dieses Datensatzes geben. In der Regel nicht zur maschinellen Interpretation bestimmt.
Birne.png Please be aware that this attribute is only intended to forward simple remarks/explanations from one end-user to another end-user. It is not to be used to contain computer-processable data, nor shall it be parsed by programmes in any way. In case of semantical overlaps or discrepancies to machine processable file contents, any machine processable contents have priority over possible human interpretable contents. However, the attribute may be used to transmit complementary details to machine processable parameters.

Bitte, berücksichtigen Sie, dass dieses Attribut nur für einfache Kommentare/Erklärungen von Endbenutzer zu Endbenutzer bestimmt ist. Es ist nicht für maschineninterpretierbare Daten gedacht und wird nicht geparst werden. Im Falle semantischer Überschneidungen oder Widersprüche zu maschinenlesbaren Inhalten wird diesen der Vorzug gegenüber durch Menschen lesbaren gegeben. Allerdings können durch Menschen lesbare Felder für Ergänzungen zu maschinenlesbaren verwendet werden.

  • xml:lang (introduced with version 2.1): This is a unique identifier of language. It uses basically the language standard IETF BCP 47 (external link) which may be different to ISO 639-1 (external link) or ISO 639-2 (external link). For mapping hints see relation to other standards (external link).
    This is used for defining name and description.
  • vehicleFamilyRef: This refers to the id attribute of the associated <vehicle> element.
    The referenced vehicle data are used as definition of common features for several vehicles.
    The application has to ensure that the data of the current vehicle are formed from the referred family first. The content of the vehicle data set shall than overwrite any features with the values from the own data set. Thus the particular can have a subset of characteristics deviating from the common one of the vehicle family. In the data set of the single vehicle all values taken from the family definition can be omitted here.
  • vehicleCategory (introduced with version 2.2): This is a basic categorisation of vehicle type for easy use in train formation planning. The user must ensure that the value is consistent with the vehicle data. The following values should be selected:
  • coach non-driven coach for passenger use
  • motorCoach passenger coach with motors for traction
  • controlCabCoach coach with controlling cab at one end (might be with motors)
  • motorVehicles vehicle with traction engine, not for passenger use
  • freightWagon non-driven wagon used for transport of any goods
  • 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.
  • axleSequence: This is the description of the vehicles axle sequence. As there a several semantics for the axle sequence in use this can be only an informative string. There is no restriction with regard to particular patterns.
  • numberDrivenAxles: This is just the number of axles of the vehicle used to apply the tractive effort onto the running rails.
  • numberNonDrivenAxles: This is just the number of axles of the vehicle not used for propulsion purpose.
  • trackGauge: This represents the track gauge the vehicle is designed for. This optional value shall be given as decimal in metres.
    At the moment not more than two values can be given per vehicle. In case of vehicles with interchangeable track gauge the value for the gauge mainly used shall be given. Additional information may be inserted in description.
  • trackGaugeAlternative: This represents the alternative track gauge in case the vehicle is designed with interchangeable wheelsets. This optional value shall be given as decimal in metres.
  • adjustableWheelSet: This is a flag, whether the vehicle comprises adjustable wheelsets. If 'true' the value for trackGauge and trackGaugeAlternative shall be given.
  • length: This represents the length of the vehicle over couplers. This optional value shall be given as decimal in metres.
    The vehicle length will be used to calculate the entire length of a formation consisting of several vehicles in order to get the needed length of tracks or platforms for this formation. The total length is also required for simulation when modelling the train as band of masses.
  • speed: This is the maximum speed in kilometres per hour the vehicle is permitted to run in normal operation.
  • towingSpeed: This is the maximum speed in kilometres per hour the vehicle is permitted to be towed. This applies to motored vehicles when towed by other vehicles.
  • bruttoWeight: This comprises the total weight of vehicle with full payload in metric tons.
  • nettoWeight: This comprises the total weight of the vehicle payload in metric tons.
  • tareWeight: This comprises the total weight of the empty vehicle in metric tons.
  • bruttoAdhesionWeight: This comprises the portion of total vehicle weight with full payload resting on the motored axles in metric tons. This so-called adhesion weight is used to calculate the possible tractive effort which can be transmitted onto the running rails for a fully loaded vehicle and a particular adhesion factor.
  • nettoAdhesionWeight (deprecated with version 2.1): This comprises the portion of total weight of the vehicle payload resting on the motored axles in metric tons. This so-called adhesion weight is used to calculate the possible tractive effort which can be transmitted onto the running rails for a vehicle and a particular adhesion factor.
  • tareAdhesionWeight: This comprises the portion of total weight of an empty vehicle resting on the motored axles in metric tons. This so-called adhesion weight is used to calculate the possible tractive effort which can be transmitted onto the running rails for an empty vehicle and a particular adhesion factor.
  • axleLoad: This is the load per axle in metric tons.
  • resistanceFactor: This simple value represents the running resistance of vehicle in N/kN, which may be used in conjungtion with the <trainResistance> element.
    It is just a rather simple estimation for the complex physics of any vehicle's running resistance. As there are dependencies of speed which becomes dominating at higher speeds, say above 100 km/h, this values shall only be used for slow vehicles like shunting units or so. In all other cases the more detailed possibilities of the <trainResistance> element shall be used, which is defined per train as a composition of vehicles.
  • onTrainHead: This is a flag, whether the vehicle may run at the train head in normal operation.
  • onTrainTailOnly: This is a flag, whether the vehicle shall only run at the end of any train.

Syntactic Constraints / Syntaktische Beschränkungen / Contraintes syntactiques

  • id: xs:ID, required
    a string, starting with a letter (a..zA..Z) or an underscore (_),
    followed by a non-colonized and non-spaced string consisting of letters, digits, points (.), dashes (-) or underscores (_)
  • trackGauge xs:decimal, 6 fraction digits, length value measured in meter, optional
  • trackGaugeAlternative xs:decimal, 6 fraction digits, length value measured in meter, optional
  • length xs:decimal, 6 fraction digits, length value measured in meter, optional
  • speed xs:decimal, 5 digits and 1 fraction digit with minimum value 0, speed value measured in km/h, optional
  • towingSpeed xs:decimal, 5 digits and 1 fraction digit with minimum value 0, speed value measured in km/h, optional

Best practice & Examples / Empfohlene Anwendung & Beispiele / Bonnes pratiques & exemples

Not yet described. / Noch nicht beschrieben. / Pas encore décrit.

Notes / Anmerkungen / Notes

Not yet described. / Noch nicht beschrieben. / Pas encore décrit.

Open issues / Offene Punkte/Pedenzen / Questions ouvertes

Not yet described. / Noch nicht beschrieben. / Pas encore décrit.