User:RailML Coord Documentation/IS:balise: Difference between revisions

From railML 3 Wiki
Jump to navigation Jump to search
Tag: New redirect
 
m (RailML Orga Admin Wiki3 moved page User:Documentation/IS:balise to User:RailML Coord Documentation/IS:balise: Automatically moved page while renaming the user "Documentation" to "RailML Coord Documentation")
 
(6 intermediate revisions by one other user not shown)
Line 1: Line 1:
#REDIRECT [[User:Documentation/IS:baliseGroup]]
==== Introduction ====
 
===== Relation between {{rml}} elements {{tag|is|baliseGroup}} and {{tag|is|balise}} =====
 
In balise based ATP systems, each {{tag|is|balise}} belongs to a {{tag|is|baliseGroup}}.
 
Consequently, for balise based ATP systems, there are two levels of description: the higher level ''balise group'', which is presented by the {{rml}} element {{tag|is|baliseGroup}} and the more detailed level ''balise'', presented by the {{rml}} element {{tag|is|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 {{tag|is|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 {{tag|is|baliseGroup}}.
 
Nevertheless, {{rml}} 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 {{rml}} {{tag|is|balise}} elements is optional.
 
But if {{rml}} {{tag|is|balise}} elements are used, then the {{rml}} {{tag|is|baliseGroup}} elements are mandatory. Each {{tag|is|balise}} element must reference a {{tag|is|baliseGroup}} element.
 
===== Concept of the {{rml}} element {{tag|is|balise}} =====
 
Correspondent to the concept of {{rml}} element {{tag|is|baliseGroup}}, also the {{rml}} element {{tag|is|balise}} is suitable for all balise based ATP systems. This means, a {{rml}} element {{tag|is|balise}} can be a '''K'''VB balise, an '''E'''bicab balise, a '''R'''SDD balise (together known as KER balises) or a Eurobalise.
 
The general information provided for all hardware types of balises is:
* the location of the balise (using sub-element {{tag|RTM|spotLocation}})
* to which balise group the balise belongs to (using {{@|belongsToBaliseGroup|IS:balise}})
* the distance to the predecessor balise within the group (using {{@|distanceToPredecessorBaliseWithinGroup|IS:balise}})
 
In case of Eurobalise, the optional sub-element {{tag|is|isEurobalise}} shall be used to specify the ETCS related information:
*the value of UNISIG variable N_PIG (provided in {{rml}} by {{@|positionInGroup|IS:isEurobalise}}), 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 {{rml}} by {{@|duplicate|IS:isEurobalise}}), 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 {{rml}} by {{@|mVersion|IS:isEurobaliseGroup}}), which is defined by UNISIG in SUBSET-026 (versions 2.3.0, 3.4.0 or 3.6.0), section 7.5.1.79
 
==== 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 [[IS:baliseGroup#Example_1_.E2.80.93_Balise_group_with_SMB_.28ETCS_Level_2.29|Example 1 of {{rml}} element <baliseGroup>]].
<div class="res-img">
[[file:image6.pdf]]
</div>''Example 1 – Balise group of 2 fix data balises''
 
;Corresponding {{rml}} description:
<syntaxhighlight lang=xml>
<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/>
</syntaxhighlight>
===== 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 [[IS:baliseGroup#Example_2_.E2.80.93_Balise_group_with_main_signal_.28ETCS_Level_1.29|Example 2 of {{rml}} element <baliseGroup>]].
<div class="res-img">
[[file:image7.pdf]]
</div>''Example 2 – Balise group of 1 fix data balise and 1 controlled balise''
 
;Corresponding {{rml}} description:
<syntaxhighlight lang=xml>
<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/>
</syntaxhighlight>
===== Example 3 – A Eurobalise belonging to an Eurobalise group consisting of 1 fix data balise =====
 
This example shows the balise elements belonging to the ETCS balise group presented in [[IS:baliseGroup#Example_4_.E2.80.93_Balise_group_for_odometry_purposes_.28ETCS_Level_1_and.2For_2.29|Example 4 of {{rml}} element <baliseGroup>]].
<div class="res-img">
[[file:image8.pdf]]
</div>''Example 3 – Balise group of 1 fix data balise''
 
;Corresponding {{rml}} description:
<syntaxhighlight lang=xml>
<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/>
</syntaxhighlight>
 
==== Additional Information ====
 
===== 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 – {{site|https://forum.railml.org}} – reporting the missing information to be modelled in {{rml}}. {{rml}}.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/<br />
balise/isEbicabBalise'' which includes the new requested information.

Latest revision as of 19:18, 4 January 2023

Introduction

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

In balise based ATP systems, each <balise> belongs to a <baliseGroup>.

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

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

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

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 Example 1 of railML® element <baliseGroup>.

Image6.pdf

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 Example 2 of railML® element <baliseGroup>.

Image7.pdf

Example 2 – Balise group of 1 fix data balise and 1 controlled balise

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 3 – A Eurobalise belonging to an Eurobalise group consisting of 1 fix data balise

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

Image8.pdf

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

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 – https://forum.railml.org (link to the railML® website) – 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.