IS:switchToLevel

Introduction

The <switchToLevel> element contains information about to which ETCS level the vehicle shall transition and the length of the acknowledgement area.

🗒️ 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

3.33.23.1

Autoexport from the XML-Schema for element IS:switchToLevel of railML® version 3.3      UML-visualization of IS
Description	destination of ETCS level switching in order of priority
Subschema	infrastructure
Parents*	etcsLevelTransition
Children	None
Attributes: lengthOfAcknowledgement: length of acknowledgement area in meters (optional: tLengthM : xs:decimal), levelType: specifies whether interlocking type is interoperable (obligatory: EtcsLevelTypeExt : xs:string: patterns: other:\w{2,}; consider Use of tOtherEnumerationValue too.) Possible values: ETCS: European Train Control System NTC: national train control system, levelValue: characterizes level of ETCS (obligatory: xs:unsignedLong : xs:unsignedLong), priority: priority of all supported level from the highest to the lowest one as defined in chapter 5.10.2 of the Subset 26 specification. Lower numbers mean higher priority (the highest possible priority is 0). (optional: tPriority : xs:unsignedLong)
*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 IS:switchToLevel of railML® version 3.2      UML-visualization of IS
Description	destination of ETCS level switching in order of priority
Subschema	infrastructure
Parents*	etcsLevelTransition
Children	None
Attributes: lengthOfAcknowledgement: length of acknowledgement area in meters (optional: tLengthM : xs:decimal), levelType: specifies whether interlocking type is interoperable (obligatory: EtcsLevelTypeExt : xs:string: patterns: other:\w{2,}; consider Use of tOtherEnumerationValue too.) Possible values: ETCS: European Train Control System NTC: national train control system, levelValue: characterizes level of ETCS (obligatory: xs:positiveInteger : xs:positiveInteger), priority: priority of all supported level from the highest to the lowest one as defined in chapter 5.10.2 of the Subset 26 specification. Lower numbers mean higher priority (the highest possible priority is 0). (optional: tPriority : xs:nonNegativeInteger)
*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 IS subschema. It is available only in railML^® 3.2, 3.3. Do not hesitate to contact railML.org e.V. 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 attributes have been changed.

Best Practice / Examples

The <switchToLevel> element contains information about to which ETCS level the vehicle shall transition and the length of the acknowledgement area.

@levelType & @levelValue

If @levelType="ETCS", then only the following values are accepted:

levelValue="0"
levelValue="1"
levelValue="2"
levelValue="3"

If @levelType="NTC", then the value shall be conform to the NID_NTC-values specified in the ERA document “Assignment of values to ETCS variables”, ERA_ERTMS_040001,

@priority

@priority defines the priority from highest priority (value “1”) to the lowest priority (the highest number in use).

@lengthOfAcknowledgement

@lengthOfAcknowledgement corresponds to ETCS variable L_ACKLEVELTR defined by UNISIG SUBSET-026 (versions 2.3.0, 3.4.0 and 3.6.0), section 7.5.1.39.

Code example

<rail3:etcsLevelTransitions>
  <rail3:etcsLevelTransition id="8c37ad44-990c-4130-8e16-ebe685f63db5">
    <rail3:name description="ETCS Level Transition: L1LS -> L2" language="EN" name="etcsLevelTransition_BON"/>
    <rail3:spotLocation …>
    </rail3:spotLocation>
    <rail3:switchToLevel levelType="ETCS" levelValue="2" priority="1" lengthOfAcknowledgement="50"/>
    <rail3:switchToLevel levelTye="NTC" level_value="22" priority="2" lengthOfAcknowledgement="50"/>
    <rail3:switchToLevel req_level="ETCS" level_value="0" priority="3" lengthOfAcknowledgement="50"/>
  </rail3:etcsLevelTransition>
</rail3:etcsLevelTransition>