IS:switchToLevel

From railML 3 Wiki
Jump to navigation Jump to search

Introduction

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

Documentation

Syntax

Autoexport from the XML-Schema for element IS:switchToLevel of railML® version 3.2
Documentation destination of ETCS level switching in order of priority
Subschema infrastructure
Parents* etcsLevelTransition
Children None
Attributes:
  • lengthOfAcknowledgement: length of acknowledgement area in meters (optional; xs:decimal),

  • levelType: specifies whether interlocking type is interoperable (obligatory; xs:string; patterns: other:w{2,})
Possible values:
  • ETCS
  • NTC: national train control system,

  • levelValue: characterizes level of ETCS (obligatory; 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; 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. It is available only in railML® 3.2. Do not hesitate to contact railML.org for further questions.


Changes 3.1→3.2

Introduced with version 3.2

Semantics

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>

Additional Information

Notes

Open Issues