IS:balise: Difference between revisions

From railML 3 Wiki
Jump to navigation Jump to search
[unchecked revision][unchecked revision]
(Erweiterung)
(Replaced content with "<!--Element '''{{{element}}}'''--> =={{introduction}}== <!--{{#ifeq:{{{comment}}}||{{missing information|topic=the semantics|user=<br>This template was inserted Automatica...")
Tag: Replaced
Line 1: Line 1:
<!--Element '''{{{element}}}'''-->
<!--Element '''{{{element}}}'''-->
=={{introduction}}==
=={{introduction}}==
===== Relation between {{rml}} elements {{tag|is|baliseGroup}} and {{tag|is|balise}} =====
<!--{{#ifeq:{{{comment}}}||{{missing information|topic=the semantics|user=<br>This template was inserted Automatically on import by [[user:Roboter]]}}|{{{comment}}}}}-->
 
{{ImportComment}}
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
 
=={{documentation}}==
=={{documentation}}==
==={{syntax}}===
==={{syntax}}===
Line 38: Line 10:
{{importComment}}
{{importComment}}
=={{examples}}==
=={{examples}}==
===== Example 1 – Eurobalises belonging to a Eurobalise group consisting of 2 fix data balises =====
{{importComment}}
 
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}}==
=={{Additional Information}}==
==={{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 – {{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.

Revision as of 18:05, 20 December 2021

Introduction

Documentation

Syntax

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

The element documentation has been changed.

The children have changed.

The attributes have been changed.

Semantics

Best Practice / Examples

Additional Information

Notes

Open Issues