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).

railML value	bit value	description
NA	000 XXXX	Previous versions according to, e.g. EEIG SRS, UIC A200 SRS
16	001 0000	Version 1.0, introduced in SRS 1.2.0
17	001 0001	Version 1.1, introduced in SRS 3.3.0
Not valid	001 0010	Not valid
...	...
Not valid	001 1111	Not valid
32	010 0000	Version 2.0, introduced in SRS 3.3.0
33	010 0001	Version 2.1, introduced in SRS 3.5.0
34	010 0010	Reserved for future use (this is a valid value)
...	...
127	111 1111	Reserved for future use (this is a valid value)

Best Practice / Examples

The <etcsArea> element shall be used to specify a part of the infrastructure network that is equipped with technical components in which the operated ETCS system version is the same. The railML^® variable @mVersion provided by railML^® element <etcsArea> specifies a global ETCS version valid for all ETCS components included in the <etcsArea>, except a different @mVersion is provided to a specific ETCS element (like a specific <baliseGroup> or a Radio Block Centre within the etcsArea). In other words: a value mVersion valid for a specific ETCS component within the <etcsArea> overwrites the global ETCS @mVersion provided for the <etcsArea>.

The <etcsArea> element is a project-defined aggregated part of the infrastructure network equipped with ETCS components based on a specific operating system version. An <etcsArea> can be applied to a whole railway network. But an <etcsArea> can also be used to determine the area affected by one construction stage/lot only. A railway network can include various etcsAreas. An infrastructure part is only allowed to be part of exactly one <etcsArea>. In other words: Overlapped etcsAreas are forbidden to avoid inconsistencies concerning the validity of @mVersion provided by the <etcsArea> element.

The attribute mVersion

The definition of @mVersion is conform to 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 are copied from chapter 7.5.1.79 in SUBSET-026 Version 3.6.0.

Code Example

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

A simple example of an ETCS area definition with M_VERSION 2.1