Introduction
| 🗒️
|
This article uses the unit label meter.
As the reference for this Wiki is British English, the correct label is metre.
Wherever the label meter occurs, it is meant equivalently to metre.
|
|
|
Documentation
Syntax
Autoexport from the XML-Schema for element RS:vehicle of railML ® version 3.3 |
| Documentation
|
A vehicle is a set consisting of at least one vehiclePart which is used in operation as a unit and will not be split under normal circumstances during operation, i.e. splitting might be possible in the workshop only.
The element can be used to define the common data of a complete vehicle class or the detailed data of an individual vehicle.
|
| Subschema
|
rollingstock
|
| Parents*
|
vehicles
|
| Children
|
administrativeData (0..1), brakes (0..*), designator (0..*), drivingResistance (0..1), elementState (0..*), engine (0..*), speedProfileRef (0..*), supportedTrackGauge (0..*), vehiclePart (0..*)
|
Attributes:
- adhesionWeight: The weight of the entire vehicle in tonnes usable for traction. Also referred to as tare adhesion weight.
To be used to estimate the adhesion limit during run time calculation (train movement simulation) by using the minimum possible mass when multiplying with adhesion coefficient, leading to a lower adhesion limit by tendency “on the safe side”.
adhesionWeight = tareWeight;
adhesionWeight = 0 if numberDrivenAxles=0;
tareAdhesionWeight = tareWeight if numberOfNonDrivenAxles=0 (optional; xs:decimal),
- basedOnTemplate: In case of describing an individual vehicle this is the reference to the common data of the vehicle class, which is also a <vehicle> element. The data of an individual vehicle shall supplement (not existing in template) or override (existing in both) the common data of the vehicle class. (optional;
xs:IDREF),
- bruttoWeight: Mass of vehicle, ready to run, incl. operating fluids,
for passenger vehicles: all seats taken with a usual (mean) passenger pass e. g. 75 kg,
for freight vehicles: with full payload,
in tonnes;
to be used to calculate run time in a physical sense within the general formula “a = F / m” as vehicle mass when vehicle is used in formations (regular trains)
tareWeight <= bruttoWeight <= nettoWeight (optional; xs:decimal),
- effectiveAxleDistance: Used to calculate the increase of the rolling resistance in curves (also known as "curve resistance"): Rigid wheelbase to be used to calculate the curve resistance in combination with <vehicle>.trackGauge and the curve radius from <infrastructure>. Note that this is not the mean axle distance over the whole vehicle length. Rather, for a vehicle with two bogies, it is usually roughly the axle distance within one boogie - the distance between the bogie pivots has a rather small impact. It may be a virtual value (not directly shown in a scaled drawing of the vehicle) to express the effective value to be used for curve resistances as a combination of rigid and non-rigid axles or possible forces of resetting springs for steering axles. It can theoretically be 0 for vehicles which have no rigid wheelbase (all axles are non-rigid steering axles) to express that the vehicle has no raised rolling resistance in curves at all. (optional;
xs:decimal),
- length: Overall length of the vehicle over buffers or couplings in meters; used to calculate train length (optional;
xs:decimal),
- maximumAxleLoad: The maximum axle load in tonnes for any axle of the vehicle.
Used to determine the permitted speed profile in cases where speed profiles depend on axle loads. (optional; xs:decimal),
- maximumWeight: Maximum weight of vehicle (maximum permitted mass) in respect of braking (bremstechnische Höchstmasse); theoretical upper limit of mass used for brake calculations; the maximum permitted mass is to be used as denominator in the formula
“brake percentage = brake mass / maximum mass”.
Used to estimate the braking power or braking deceleration curve of formations containing this vehicle
tareWeight <= bruttoWeight <= maximumWeight (optional; xs:decimal),
- nettoWeight: The maximum payload of the entire vehicle in tonnes. (optional;
xs:decimal),
- numberOfDrivenAxles: Number of driven axles of self-driven vehicles.
optional, must be set to >0 for all self-driven engines, i. e. all <vehicle> elements which have an <engine> sub-element.
If not specified indicates that the information is unknown (optional; xs:nonNegativeInteger),
- numberOfNonDrivenAxles: Number of non-driven axles of non-driven as well as of self-driven vehicles.
optional
If not specified indicates that the information is unknown (optional; xs:nonNegativeInteger),
- rotatingMassFactor: Factor by which the (static) mass of the vehicle is to be increased in calculations for longitudinal movements to take into account the additional energy needed to accelerate and decelerate rotating masses (Factor, typically 1.05..1.25) (optional;
xs:decimal),
- speed: The maximum permissible speed for the vehicle in km/h. (optional;
xs:decimal),
- tareWeight: Mass of vehicle, ready to run, incl. operating fluids, no passengers, no payload, in tonnes;
to be used to calculate run time in a physical sense within the general formula “a = F / m” as vehicle mass when vehicle is used in formations (empty trains)
tareWeight <= bruttoWeight <= maximumWeight (optional; xs:decimal),
- timetableWeight: Mass of the train to be used for timetable runtime calculation. Usually a value between bruttoWeight and nettoWeight is specified here. (optional;
xs:decimal),
- towingSpeed: Maximum permitted speed of a self-drivable vehicle driven by a different engine within a formation.
(not to be used for general permitted speed of non-driven vehicles – this is to be given as //vehicle/@speed) (optional; xs:decimal),
- id: the identifier of the object; this can be either of type xs:ID or UUID (obligatory;
xs:ID); compare: Dev:Identities
|
*Notice:
Elements may have different parent elements. As a consequence they may be used in different contexts.
Please, consider this as well as a user of this Wiki as when developing this documentation further.
Aspects that are only relevant with respect to one of several parents should be explained exclusively in the documentation of the respective parent element.
|
Autoexport from the XML-Schema for element RS:vehicle of railML ® version 3.2 |
| Documentation
|
A vehicle is a set consisting of at least one vehiclePart which is used in operation as a unit and will not be split under normal circumstances during operation, i.e. splitting might be possible in the workshop only.
The element can be used to define the common data of a complete vehicle class or the detailed data of an individual vehicle.
|
| Subschema
|
rollingstock
|
| Parents*
|
vehicles
|
| Children
|
administrativeData (0..1), brakes (0..*), designator (1..*), engine (0..*), vehiclePart (0..*)
|
Attributes:
- adhesionWeight: The weight of the entire vehicle in metric tons usable for traction. (optional;
xs:decimal),
- belongsToParent: In case of describing an individual vehicle this is the reference to the common data of the vehicle class, which is also a <vehicle> element. The data of an individual vehicle shall supplement or override the common data of the vehicle class. (optional;
xs:string; patterns: (urn:uuid:)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}),
- bruttoWeight: The total weight of the entire vehicle in metric tons. (optional;
xs:decimal),
- length: The overall length of the vehicle in metres. (optional;
xs:decimal),
- maximumAxleLoad: The maximum axle load in metric tons for any axle of the vehicle. (optional;
xs:decimal),
- nettoWeight: The payload of the entire vehicle in metric tons. (optional;
xs:decimal),
- numberOfAxles: The total number of axles of this vehicle. (optional;
xs:positiveInteger),
- speed: The maximum permissible speed for the vehicle in km/h. (optional;
xs:decimal),
- tareWeight: The tare weight of the entire vehicle in metric tons. The weight of an empty standard vehicle with all of its fluids (for example, oils and coolants) and if needed fuel in the tank. (optional;
xs:decimal),
- id: unique identifier (obligatory;
xs:string; patterns: (urn:uuid:)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}); compare: Dev:Identities
|
*Notice:
Elements may have different parent elements. As a consequence they may be used in different contexts.
Please, consider this as well as a user of this Wiki as when developing this documentation further.
Aspects that are only relevant with respect to one of several parents should be explained exclusively in the documentation of the respective parent element.
|
This element does not appear in railML® 3.1 within the RS subschema. It is available only in railML® 3.2, 3.3. Do not hesitate to contact railML.org for further questions.
Changes 3.1→3.2
There exists an overview of all changes between railML® 3.1 and railML® 3.2 on page Dev:Changes/3.2.
Introduced with version 3.2.
Changes 3.2→3.3
There exists an overview of all changes between railML® 3.2 and railML® 3.3 on page Dev:Changes/3.3.
The parents have been changed.
The children have been changed.
The attributes have been changed.
Semantics
Best Practice / Examples
Additional Information
Notes
Open Issues