IS:operationalPoints: Difference between revisions

From railML 3 Wiki
Jump to navigation Jump to search
[unchecked revision][checked revision]
(→‎{{examples}}: +Tutorial Pahud)
(→‎{{examples}}: References to tutorial removed)
 
Line 14: Line 14:
[[File:ISoperationalPoints.pdf]]
[[File:ISoperationalPoints.pdf]]
</div>
</div>
In order to locate the {{tag|IS|operationalPoint}} elements within the topology network ({{tag|IS|netElement}} “a11” and {{tag|IS|netElement}} “b11”) the child element {{tag|RTM|spotLocation}} is being used. Considering the mesoscopic topology network described in section 3.1.2.2 station “Bf Arnau” is located on the {{tag|IS|netElement}} “a11” and station “Bf Cstadt” is located on the {{tag|IS|netElement}} “b11”. Since both referenced {{tag|IS|netElement}} objects are non-linear objects, their intrinsic position equals “0”. The {{tag|RTM|spotLocation}} element further implements the linking between the (topologic) intrinsic location and the railway line coordinates mentioned above.
In order to locate the {{tag|IS|operationalPoint}} elements within the topology network ({{tag|IS|netElement}} “a11” and {{tag|IS|netElement}} “b11”) the child element {{tag|RTM|spotLocation}} is being used. Considering the mesoscopic topology network station “Bf Arnau” is located on the {{tag|IS|netElement}} “a11” and station “Bf Cstadt” is located on the {{tag|IS|netElement}} “b11”. Since both referenced {{tag|IS|netElement}} objects are non-linear objects, their intrinsic position equals “0”. The {{tag|RTM|spotLocation}} element further implements the linking between the (topologic) intrinsic location and the railway line coordinates mentioned above.


Please note: An {{tag|IS|operationalPoint}} is modelled as part of the {{tag|IS|functionalInfrastructure}}. Thus, it is independent of the underlying topology that it references.
Please note: An {{tag|IS|operationalPoint}} is modelled as part of the {{tag|IS|functionalInfrastructure}}. Thus, it is independent of the underlying topology that it references.


Both operational points also have designators, which act like external identifiers in a given register. In particular, "Bf Arnau" has the code "OAR" in the register named "RL100" and "Bf Cstadt" is designated with the RL100 code "OCS". The specification of the operational aspects of the operational points is given in the child element {{tag|IS|opOperations}}. With the child element {{tag|CO|name}}, the operation point (e.g. in different languages) can be defined with different names. The child element {{tag|IS|opEquipment}} can be used to explicitly list infrastructure elements that belong to this operational point, e.g. platform edges or signals. The {{tag|IS|platform}} model is described in detail in section 3.1.8. The resulting railML code snippet looks like this:
Both operational points also have designators, which act like external identifiers in a given register. In particular, "Bf Arnau" has the code "OAR" in the register named "RL100" and "Bf Cstadt" is designated with the RL100 code "OCS". The specification of the operational aspects of the operational points is given in the child element {{tag|IS|opOperations}}. With the child element {{tag|CO|name}}, the operation point (e.g. in different languages) can be defined with different names. The child element {{tag|IS|opEquipment}} can be used to explicitly list infrastructure elements that belong to this operational point, e.g. {{tag|IS|platform}} edges or signals. The resulting railML code snippet looks like this:
<syntaxhighlight lang=xml>
<syntaxhighlight lang=xml>
<infrastructure id="is_01">
<infrastructure id="is_01">

Latest revision as of 16:53, 20 September 2021

Introduction

Documentation

Syntax

Autoexport from the XML-Schema for element IS:operationalPoints of railML® version 3.2
Documentation container element for all operationalPoint elements
Subschema infrastructure
Parents* functionalInfrastructure
Children operationalPoint (1..*)
Attributes:
None
*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:operationalPoints of railML® version 3.1
Documentation container element for all operationalPoint elements
Subschema infrastructure
Parents* functionalInfrastructure
Children operationalPoint (1..*)
Attributes:
None
*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.

Semantics

Best Practice / Examples

The Simple Example contains two operational control points in the form of stations. Their names are "Bf Arnau" and "Bf Cstadt" and they are located at the beginning and the end of the railway line. The center of "Bf Arnau" is located at kilometer 0.300, and the center of "Bf Cstadt" is located at kilometer 4.700, as shown in the following figure.

ISoperationalPoints.pdf

In order to locate the <operationalPoint> elements within the topology network (<netElement> “a11” and <netElement> “b11”) the child element <spotLocation> is being used. Considering the mesoscopic topology network station “Bf Arnau” is located on the <netElement> “a11” and station “Bf Cstadt” is located on the <netElement> “b11”. Since both referenced <netElement> objects are non-linear objects, their intrinsic position equals “0”. The <spotLocation> element further implements the linking between the (topologic) intrinsic location and the railway line coordinates mentioned above.

Please note: An <operationalPoint> is modelled as part of the <functionalInfrastructure>. Thus, it is independent of the underlying topology that it references.

Both operational points also have designators, which act like external identifiers in a given register. In particular, "Bf Arnau" has the code "OAR" in the register named "RL100" and "Bf Cstadt" is designated with the RL100 code "OCS". The specification of the operational aspects of the operational points is given in the child element <opOperations>. With the child element <name>, the operation point (e.g. in different languages) can be defined with different names. The child element <opEquipment> can be used to explicitly list infrastructure elements that belong to this operational point, e.g. <platform> edges or signals. The resulting railML code snippet looks like this:

<infrastructure id="is_01">
    ...
    <functionalInfrastructure>  
      <operationalPoints>
        <operationalPoint id="opp01">
          <name name="Bf Arnau" language="de"/>
          <name name="Adamov" language="cz"/>
          <spotLocation id="opp01_sloc01" netElementRef="ne_a11" applicationDirection="both">
            <linearCoordinate positioningSystemRef="lps01" measure="300.0"/>
          </spotLocation>
          <designator register="RL100" entry="OAR"/>
          <opEquipment>
            <ownsPlatform ref="plf01"/>
          </opEquipment>
          <opOperations>
            <opOperation operationalType="station" trafficType="passenger"/>
          </opOperations> 
        </operationalPoint>
        <operationalPoint id="opp02">
          <name name="Bf Cstadt" language="de"/>
          <name name="Bouzov" language="cz"/>
          <spotLocation id="opp02_sloc01" netElementRef="ne_b11" applicationDirection="both">
            <linearCoordinate positioningSystemRef="lps01" measure="4700.0"/>
          </spotLocation>
          <designator register="RL100" entry="OCS"/>
          <opEquipment>
            <ownsPlatform ref="plf02"/>
            <ownsPlatform ref="plf03"/>
          </opEquipment>
          <opOperations>
            <opOperation operationalType="station" trafficType="passenger"/>
          </opOperations> 
        </operationalPoint>
      </operationalPoints>
    </functionalInfrastructure>
  </infrastructure>

Additional Information

Notes

Open Issues