IS:etcsArea

From railML 3 Wiki
Jump to navigation Jump to search

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

Additional Information

Notes

Open Issues