IS:balise: Difference between revisions

From railML 3 Wiki
Jump to navigation Jump to search
[unchecked revision][checked revision]
(→‎{{Open issues}}: Thanks to Karl Jerosch & Siemens)
(added photo)
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
<!--Element '''{{{element}}}'''-->
<!--Element '''{{{element}}}'''-->
[[File:1200px-ZBS-Balise der Berliner S-Bahn.jpg|thumb|500px|{{external|1=https://commons.wikimedia.org/wiki/File:ZBS-Balise_der_Berliner_S-Bahn.jpg|2=Balise}} by {{external|https://commons.wikimedia.org/wiki/User:Srittau|Sebastian Rittau}} via Wikimedia Commons
Free to use under the {{external|https://creativecommons.org/public-domain/cc0/|CC0}} ]]
=={{introduction}}==
=={{introduction}}==
=== Relation between {{rml}} elements {{tag|is|baliseGroup}} and {{tag|is|balise}} ===
=== Relation between {{rml}} elements {{tag|is|baliseGroup}} and {{tag|is|balise}} ===
Line 41: Line 45:


This example shows the balise elements belonging to the ETCS balise group presented in section 1.2.1 of {{rml}} element {{tag|is|baliseGroup}}.
This example shows the balise elements belonging to the ETCS balise group presented in section 1.2.1 of {{rml}} element {{tag|is|baliseGroup}}.
<span id="_Toc87894532" class="anchor"></span>Figure 6: Example 1 – Balise group of 2 fix data balises
 
<span class="underline">Corresponding {{rml}} description:</span>
[[file:balise_example6.svg]]<br>Figure 6: Example 1 – Balise group of 2 fix data balises
;Corresponding {{rml}} description
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<balises>
<balises>
<balise id="bg1_bal0" type="fixed" belongsToBaliseGroup="bg1" distanceToPredecessorBaliseWithinGroup="0.0">
<balise id="bg1_bal0" type="fixed" belongsToBaliseGroup="bg1" distanceToPredecessorBaliseWithinGroup="0.0">
<name name="127-00777-0" description="etcsName" language="EN"/>
<name name="127-00777-0" description="etcsName" language="EN"/>
<spotLocation id="bg1_bal0_sloc01" netElementRef="ne_101" applicationDirection="both" pos="45.0">
<spotLocation id="bg1_bal0_sloc01" netElementRef="ne_101" applicationDirection="both" pos="45.0">
<linearCoordinate positioningSystemRef="lps01" measure="100045.0"/>
<linearCoordinate positioningSystemRef="lps01" measure="100045.0"/>
</spotLocation>
</spotLocation>
<isEurobalise positionInGroup="0" duplicate="no" mVersion="32"/>
<isEurobalise positionInGroup="0" duplicate="no" mVersion="32"/>
</balise>
</balise>
<balise id="bg1_bal1" type="fixed" belongsToBaliseGroup="bg1" distanceToPredecessorBaliseWithinGroup="3.0">
<balise id="bg1_bal1" type="fixed" belongsToBaliseGroup="bg1" distanceToPredecessorBaliseWithinGroup="3.0">
<name name="127-00777-1" description="etcsName" language="EN"/>
<name name="127-00777-1" description="etcsName" language="EN"/>
<spotLocation id="bg1_bal1_sloc01" netElementRef="ne_101" applicationDirection="both" pos="48.0">
<spotLocation id="bg1_bal1_sloc01" netElementRef="ne_101" applicationDirection="both" pos="48.0">
<linearCoordinate positioningSystemRef="lps01" measure="100048.0"/>
<linearCoordinate positioningSystemRef="lps01" measure="100048.0"/>
</spotLocation>
</spotLocation>
<isEurobalise positionInGroup="1" duplicate="no" mVersion="32"/>
<isEurobalise positionInGroup="1" duplicate="no" mVersion="32"/>
</balise>
</balise>
<balises/>
</balises>
</syntaxhighlight>
</syntaxhighlight>


=== Example 2 – Eurobalises belonging to a Eurobalise group consisting of 1 fix data balise and 1 controlled balise ===
=== Example 2 – Eurobalises belonging to a Eurobalise group consisting of 1 fix data balise and 1 controlled balise ===
This example shows the balise elements belonging to the ETCS balise group presented in section 1.2.2 of {{rml}} element {{tag|is|baliseGroup}}.


This example shows the balise elements belonging to the ETCS balise group presented in section 1.2.2 of {{rml}} element {{tag|is|baliseGroup}}.
[[file:balise_example7.svg]]<br>Figure 7: Example 2 – Balise group of 1 fix data balise and 1 controlled balise
<span id="_Toc87894533" class="anchor"></span>Figure 7: Example 2 – Balise group of 1 fix data balise and 1 controlled balise
;Corresponding {{rml}} description
<span class="underline">Corresponding {{rml}} description:</span>
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<balises>
<balises>
<balise id="bg2_bal0" type="fixed" belongsToBaliseGroup="bg2" distanceToPredecessorBaliseWithinGroup="0.0">
<balise id="bg2_bal0" type="fixed" belongsToBaliseGroup="bg2" distanceToPredecessorBaliseWithinGroup="0.0">
<name name="127-00787-0" description="etcsName" language="EN"/>
<name name="127-00787-0" description="etcsName" language="EN"/>
<spotLocation id="bg2_bal0_sloc01" netElementRef="ne_102" applicationDirection="both" pos="985.0">
<spotLocation id="bg2_bal0_sloc01" netElementRef="ne_102" applicationDirection="both" pos="985.0">
<linearCoordinate positioningSystemRef="lps01" measure="101985.0"/>
<linearCoordinate positioningSystemRef="lps01" measure="101985.0"/>
</spotLocation>
</spotLocation>
<isEurobalise positionInGroup="0" duplicate="no" mVersion="16"/>
<isEurobalise positionInGroup="0" duplicate="no" mVersion="16"/>
</balise>
</balise>
<balise id="bg2_bal1" type="controlled" belongsToBaliseGroup="bg2" distanceToPredecessorBaliseWithinGroup="3.0">
<balise id="bg2_bal1" type="controlled" belongsToBaliseGroup="bg2" distanceToPredecessorBaliseWithinGroup="3.0">
<name name="127-00787-1" description="etcsName" language="EN"/>
<name name="127-00787-1" description="etcsName" language="EN"/>
<spotLocation id="bg2_bal1_sloc01" netElementRef="ne_102" applicationDirection="both" pos="982.0">
<spotLocation id="bg2_bal1_sloc01" netElementRef="ne_102" applicationDirection="both" pos="982.0">
<linearCoordinate positioningSystemRef="lps01" measure="101982.0"/>
<linearCoordinate positioningSystemRef="lps01" measure="101982.0"/>
</spotLocation>
</spotLocation>
<isEurobalise positionInGroup="1" duplicate="no" mVersion="16"/>
<isEurobalise positionInGroup="1" duplicate="no" mVersion="16"/>
</balise>
</balise>
<balises/>
</balises>
</syntaxhighlight>
</syntaxhighlight>


Line 89: Line 94:


This example shows the balise element belonging to the ETCS balise group presented in section 1.2.4 of {{rml}} element {{tag|is|baliseGroup}}.
This example shows the balise element belonging to the ETCS balise group presented in section 1.2.4 of {{rml}} element {{tag|is|baliseGroup}}.
<span id="_Toc87894534" class="anchor"></span>Figure 8: Example 3 – Balise group of 1 fix data balise
 
<span class="underline">Corresponding {{rml}} description:</span>
[[file:balise_example8.svg]]<br>Figure 8: Example 3 – Balise group of 1 fix data balise
;Corresponding {{rml}} description
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<balises>
<balises>
<balise id="bg4_bal0" type="fixed" belongsToBaliseGroup="bg4" distanceToPredecessorBaliseWithinGroup="0.0">
<balise id="bg4_bal0" type="fixed" belongsToBaliseGroup="bg4" distanceToPredecessorBaliseWithinGroup="0.0">
<name name="127-00727-0" description="etcsName" language="EN"/>
<name name="127-00727-0" description="etcsName" language="EN"/>
<spotLocation id="bg4_bal0_sloc01" netElementRef="ne_104" applicationDirection="both" pos="210.0">
<spotLocation id="bg4_bal0_sloc01" netElementRef="ne_104" applicationDirection="both" pos="210.0">
<linearCoordinate positioningSystemRef="lps01" measure="103210.0"/>
<linearCoordinate positioningSystemRef="lps01" measure="103210.0"/>
</spotLocation>
</spotLocation>
<isEurobalise positionInGroup="0" duplicate="no" mVersion="16"/>
<isEurobalise positionInGroup="0" duplicate="no" mVersion="16"/>
</balise>
</balise>
<balises/>
</balises>
</syntaxhighlight>
</syntaxhighlight>


Line 106: Line 112:
==={{Notes}}===
==={{Notes}}===
==={{Open issues}}===
==={{Open issues}}===
If the general information provided by the {{rml}} element {{tag|is|balise}} is not sufficient for a KER balise application, then please open a request in the {{rml}} forum reporting the missing information to be modelled in {{rml}}. railML.org will provide a suggestion for modelling the missing information in {{rml}}, for example added by a new optional sub-element “{{rml}}/infrastructure/functionalInfrastructure/balises/<br />
If the general information provided by the {{rml}} element {{tag|is|balise}} is not sufficient for a KER balise application, then please open a request in the {{rml}} forum reporting the missing information to be modelled in {{rml}}. railML.org will provide a suggestion for modelling the missing information in {{rml}}, for example added by a new optional sub-element “railML/infrastructure/functionalInfrastructure/balises/balise/isEbicabBalise“ which includes the new requested information.
balise/isEbicabBalise“ which includes the new requested information.

Latest revision as of 16:31, 11 April 2024


Balise (external link) by Sebastian Rittau (external link) via Wikimedia Commons Free to use under the CC0 (external link)

Introduction

Relation between railML® elements <baliseGroup> and <balise>

In balise based ATP systems, each <balise> belongs to a “balise group”.

Consequently, for balise based ATP systems, there are two levels of description: the higher level “balise group”, which is presented by the railML® element <baliseGroup> and the more detailed level <balise>, presented by the railML® element <balise>.

Usually, the definition of balise groups in the track layout is sufficient for the most purposes and it is not necessary additionally to give information about each balise of a balise group, because all relevant information for the ATP software engineering can be derived from the element <baliseGroup>. For example, all variables required for an ETCS balise telegram header according to SUBSET-026 (versions 2.3.0, 3.4.0 or 3.6.0), section 8.4.2.1, can be calculated from the information given by element <baliseGroup>.

Nevertheless, railML® provides the possibility to specify each balise of a balise group, which can make sense in cases where the exact location of each balise in a balise group is important, for example for special test purposes or for the mounting and installation of the balises.

Conclusion:

The use of railML® <balise> elements is optional.

But if railML® <balise> elements are used, then the railML® <baliseGroup> elements are mandatory. Each <balise> element must reference a <baliseGroup> element.

Concept of the railML® element <balise>

Correspondent to the concept of railML® element <baliseGroup>, also the railML® element <balise> is suitable for all balise based ATP systems. This means, a railML® element <balise> can be a KVB balise, an Ebicab balise, a RSDD balise (together known as KER balises) or an Eurobalise.

The general information provided for all hardware types of balises is:

  • the location of the balise (using sub-element spotLocation)
  • to which balise group the balise belongs to (using attibute belongsToBaliseGroup)
  • the distance to the predecessor balise within the group (using attribute distanceToPredecessorBaliseWithinGroup)

In case of Eurobalise, the optional sub-element “isEurobalise“ shall be used to specify the ETCS related information:

  • the value of UNISIG variable N_PIG (provided in railML® by attribute positionInGroup), which is defined by UNISIG in SUBSET-026 (versions 2.3.0, 3.4.0 or 3.6.0), section 7.5.1.81
  • the value of UNISIG variable M_DUP (provided in railML® by attribute duplicate), which is defined by UNISIG in SUBSET-026 (versions 2.3.0, 3.4.0 or 3.6.0), section 7.5.1.63 and
  • the value of UNISIG variable M_VERSION (provided in railML® by attribute mVersion), which is defined by UNISIG in SUBSET-026 (versions 2.3.0, 3.4.0 or 3.6.0), section 7.5.1.79

Documentation

Syntax

Autoexport from the XML-Schema for element IS:balise of railML® version 3.3
Documentation defines a single balise and its attributes. A balise is an electronic beacon or transponder placed between the rails of a railway as part of an Automatic Train Protection (ATP) system.
Subschema infrastructure
Parents* balises
Children areaLocation (0..*), designator (0..*), elementState (0..*), gmlLocation (0..*), isEurobalise (0..1), isValid (0..*), linearLocation (0..*), name (0..*), networkLocation (0..*), spotLocation (0..*), typeDesignator (0..*)
Attributes:
  • basedOnTemplate: reference to a generic balise (optional; xs:IDREF),

  • belongsToBaliseGroup: reference to the balise group that this balise belongs to (obligatory; xs:IDREF),

  • distanceToPredecessorBaliseWithinGroup: distance to predecessor balise in balise group in meters (optional; xs:decimal),

  • type: type of balise: fixed or controlled (optional; xs:string)
Possible values:
  • controlled: describes a controlled data balise
  • fixed: describes a fixed data balise,

  • id: the identifier of the object; this can be either of type xs:ID or UUID (obligatory; xs:ID); 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.


 

Autoexport from the XML-Schema for element IS:balise of railML® version 3.2
Documentation defines a single balise and its attributes. A balise is an electronic beacon or transponder placed between the rails of a railway as part of an Automatic Train Protection (ATP) system.
Subschema infrastructure
Parents* balises
Children areaLocation (0..*), designator (0..*), external (0..*), gmlLocations (0..*), isEurobalise (0..1), isValid (0..*), linearLocation (0..*), name (0..*), networkLocation (0..*), spotLocation (0..*), typeDesignator (0..*)
Attributes:
  • baliseGroupType: DEPRECATED with railML 3.2;
    type of balise group: fixed, transparent or infill (optional; xs:string; patterns: other:w{2,})
Possible values:
  • fixed
  • infill
  • signal,

  • basedOnTemplate: reference to a generic balise (optional; 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}}),

  • belongsToBaliseGroup: reference to the balise group that this balise belongs to (optional; 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}}),

  • belongsToParent: DEPRECATED with railML 3.2;
    reference to the (one and only) parent balise


    - if some information exists in parent and child, then information in child overwrites it in child

    - if some information exists only in parent, then child inherits this information from parent (optional; 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}}),

  • distanceToPredecessorBaliseWithinGroup: distance to predecessor balise in balise group in meters (optional; xs:decimal),

  • isBaliseGroup: DEPRECATED with railML 3.2, use BaliseGroup instead;
    indicate whether the <balise> represents a balise group (optional; xs:boolean),

  • type: type of balise: fixed or controlled (optional; xs:string)
Possible values:
  • controlled: describes a controlled data balise
  • fixed: describes a fixed data balise
  • transparent: DEPRECATED with railML 3.2, use value 'controlled' instead,

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


 

Autoexport from the XML-Schema for element IS:balise of railML® version 3.1
Documentation This element is not documented in the schema!
Subschema infrastructure
Parents* balises
Children any (0..*), areaLocation (0..*), designator (0..*), external (0..*), gmlLocations (0..*), isValid (0..*), linearLocation (0..*), name (0..*), networkLocation (0..*), spotLocation (0..*)
Attributes:
  • type: type of balise: fixed or transparent (optional; xs:string)
Possible values:
  • transparent
  • fixed,

  • belongsToParent: reference to the (one and only) parent balise (group) (optional; xs:IDREF; 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}}),

  • basedOnTemplate: reference to a generic balise (group) (optional; xs:IDREF; 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}}),

  • isBaliseGroup: indicate whether the <balise> represents a balise group (optional; xs:boolean),

  • baliseGroupType: type of balise group: fixed, transparent or infill (optional; xs:string; patterns: other:w{2,})
Possible values:
  • signal
  • infill
  • fixed,

  • id: the identifier of the object; this can be either of type xs:ID or UUID (obligatory; xs:ID; 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.


 


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.

The element documentation has been changed.

The children have been changed.

The attributes have been changed.

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 children have been changed.

The attributes have been changed.

Semantics

Best Practice / Examples

Example 1 – Eurobalises belonging to a Eurobalise group consisting of 2 fix data balises

This example shows the balise elements belonging to the ETCS balise group presented in section 1.2.1 of railML® element <baliseGroup>.

Balise example6.svg
Figure 6: Example 1 – Balise group of 2 fix data balises

Corresponding railML® description
<balises>
	<balise id="bg1_bal0" type="fixed" belongsToBaliseGroup="bg1" distanceToPredecessorBaliseWithinGroup="0.0">
		<name name="127-00777-0" description="etcsName" language="EN"/>
		<spotLocation id="bg1_bal0_sloc01" netElementRef="ne_101" applicationDirection="both" pos="45.0">
			<linearCoordinate positioningSystemRef="lps01" measure="100045.0"/>
		</spotLocation>
		<isEurobalise positionInGroup="0" duplicate="no" mVersion="32"/>
	</balise>
	<balise id="bg1_bal1" type="fixed" belongsToBaliseGroup="bg1" distanceToPredecessorBaliseWithinGroup="3.0">
		<name name="127-00777-1" description="etcsName" language="EN"/>
		<spotLocation id="bg1_bal1_sloc01" netElementRef="ne_101" applicationDirection="both" pos="48.0">
			<linearCoordinate positioningSystemRef="lps01" measure="100048.0"/>
		</spotLocation>
		<isEurobalise positionInGroup="1" duplicate="no" mVersion="32"/>
	</balise>
</balises>

Example 2 – Eurobalises belonging to a Eurobalise group consisting of 1 fix data balise and 1 controlled balise

This example shows the balise elements belonging to the ETCS balise group presented in section 1.2.2 of railML® element <baliseGroup>.

Balise example7.svg
Figure 7: Example 2 – Balise group of 1 fix data balise and 1 controlled balise

Corresponding railML® description
<balises>
	<balise id="bg2_bal0" type="fixed" belongsToBaliseGroup="bg2" distanceToPredecessorBaliseWithinGroup="0.0">
		<name name="127-00787-0" description="etcsName" language="EN"/>
		<spotLocation id="bg2_bal0_sloc01" netElementRef="ne_102" applicationDirection="both" pos="985.0">
			<linearCoordinate positioningSystemRef="lps01" measure="101985.0"/>
		</spotLocation>
		<isEurobalise positionInGroup="0" duplicate="no" mVersion="16"/>
	</balise>
	<balise id="bg2_bal1" type="controlled" belongsToBaliseGroup="bg2" distanceToPredecessorBaliseWithinGroup="3.0">
		<name name="127-00787-1" description="etcsName" language="EN"/>
		<spotLocation id="bg2_bal1_sloc01" netElementRef="ne_102" applicationDirection="both" pos="982.0">
			<linearCoordinate positioningSystemRef="lps01" measure="101982.0"/>
		</spotLocation>
		<isEurobalise positionInGroup="1" duplicate="no" mVersion="16"/>
	</balise>
</balises>

Example 3 – A Eurobalise belonging to an Eurobalise group consisting of 1 fix data balise

This example shows the balise element belonging to the ETCS balise group presented in section 1.2.4 of railML® element <baliseGroup>.

Balise example8.svg
Figure 8: Example 3 – Balise group of 1 fix data balise

Corresponding railML® description
<balises>
	<balise id="bg4_bal0" type="fixed" belongsToBaliseGroup="bg4" distanceToPredecessorBaliseWithinGroup="0.0">
		<name name="127-00727-0" description="etcsName" language="EN"/>
		<spotLocation id="bg4_bal0_sloc01" netElementRef="ne_104" applicationDirection="both" pos="210.0">
			<linearCoordinate positioningSystemRef="lps01" measure="103210.0"/>
		</spotLocation>
		<isEurobalise positionInGroup="0" duplicate="no" mVersion="16"/>
	</balise>
</balises>

Additional Information

Notes

Open Issues

If the general information provided by the railML® element <balise> is not sufficient for a KER balise application, then please open a request in the railML® forum reporting the missing information to be modelled in railML®. railML.org will provide a suggestion for modelling the missing information in railML®, for example added by a new optional sub-element “railML/infrastructure/functionalInfrastructure/balises/balise/isEbicabBalise“ which includes the new requested information.