IS:etcsArea

Introduction

The <etcsArea> element shall be used to mark parts of an infrastructure network that are equipped with technical components in which the operated ETCS system version is the same.

Das Element <etcsArea> ist zur Kennzeichnung von Teilen eines Infrastrukturnetzes zu verwenden, die mit technischen Komponenten ausgestattet sind, bei denen die betriebene ETCS-Systemversion gleich ist.

The attribute @mVersion of an <etcsArea> specifies a ‘global‘ ETCS version valid for all ETCS components included in the <etcsArea>, unless a different @mVersion is provided for a specific ETCS element (such as a balise group or an RBC within the <etcsArea>). In other words: a @mVersion given for a specific ETCS component within the <etcsArea> overwrites the ‘global‘ ETCS @mVersion provided for the <etcsArea>.

Das Attribut @mVersion einer <etcsArea> gibt eine "globale" ETCS-Version an, die für alle in der <etcsArea> enthaltenen ETCS-Komponenten gilt, es sei denn, für ein bestimmtes ETCS-Element (z. B. eine Balisengruppe oder ein RBC innerhalb der <etcsArea>) wird eine andere @mVersion angegeben. Mit anderen Worten: eine @mVersion, die für eine bestimmte ETCS-Komponente innerhalb der <etcsArea> angegeben wird, überschreibt die "globale" ETCS @mVersion, die für die <etcsArea> festgelegt wurde.

Documentation

Syntax

Autoexport from the XML-Schema for element IS:etcsArea of railML® version 3.2 UML-visualization of IS
Documentation	The element etcsArea can be used to aggregate part of the infrastructure network equipped with ETCS components based on a specific operated system version.
Subschema	infrastructure
Parents*	etcsAreas
Children	areaLocation (0..*), designator (0..*), external (0..*), gmlLocations (0..*), isValid (0..*), linearLocation (0..*), name (0..*), networkLocation (0..*), spotLocation (0..*), typeDesignator (0..*)
Attributes: mVersion: corresponds to ETCS variable M_VERSION; to be understood as operated system version (obligatory; xs:nonNegativeInteger), id: the identifier of the object; this can be either of type xs:ID or UUID (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 IS subschema. 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

The attribute mVersion corresponds to the installed ETCS system in the ETCS-Area and corresponds to ETCS variable M_VERSION. The definition of mVersion is defined in chapter 7.5.1.79 of SUBSET-026 (Versions 2.3.0, 3.4.0 or 3.6.0). Parts of the texts and parts of the table in this chapter is copied from chapter 7.5.1.79 in SUBSET-026 Version 3.6.0. The attribute mVersion is of type nonNegativeInteger and the variable’s length of seven bits is divided into two parts. The first three bits (MSB’s) distinguishes not compatible versions (major version), and the last four bits (LSB’s) indicates compatibility within a version (minor version).

Best Practice / Examples

<rail3:etcsAreas>
  <rail3:etcsArea id="etcsArea01" mVersion="33">
    <rail3:name description="ETCS area Border: M_VERSION 1.1 -> 2.1" language="EN" name="etcsArea_Border_BON"/>
    <rail3:areaLocation id="al01">
      ...
    </rail3:areaLocation>
    <rail3:linearLocation id="linLoc01">
      ...
    </rail3:linearLocation>
    <rail3:spotLocation id="spotLoc01" netElementRef="ne01">
      ...
    </rail3:spotLocation>
  </rail3:etcsArea>
</rail3:etcsAreas>

Simple example of an etcs area definition with M_VERSION 2.1