IS:underCrossing: Difference between revisions

From railML 3 Wiki
Jump to navigation Jump to search
[unchecked revision][checked revision]
(Created page with "{{subst:docBase |element=underCrossing |subschema=IS}}")
 
(added semantics from git)
Line 8: Line 8:
{{robot|subschema=IS|element=underCrossing|parent=}}
{{robot|subschema=IS|element=underCrossing|parent=}}
==={{semantics}}===
==={{semantics}}===
https://development.railml.org/railml/version3/-/issues/255
Some basic modelling rules:
- It is possible to refer to an arbitrary number of "crossed elements" from one xCrossing
- the constructional realization (bridge or tunnel) of the xCrossing is implemented as attribute and shall not be included in the name of the functional infrastructure element
- if "something" crosses under the railway track/line, it shall be named an underCrossing
- if "something" crosses over the railway track/line, it shall be named an overCrossing
- if "something" crosses the railway track/line at same level (usually only roads, streets and ways), it shall be named levelCrossing
{{importComment}}
{{importComment}}
=={{examples}}==
=={{examples}}==

Revision as of 09:15, 2 October 2023

Introduction

Documentation

Syntax

Autoexport from the XML-Schema for element IS:underCrossing of railML® version 3.2
Documentation An under crossing describes a crossing, where something crosses under the railway line. The most common constructional type of an under crossing is a bridge.
Subschema infrastructure
Parents* underCrossings
Children allowedWeightLimit (0..*), areaLocation (0..*), crossesElement (0..*), designator (0..*), external (0..*), gmlLocations (0..*), isValid (0..*), length (0..*), linearLocation (0..*), name (0..*), networkLocation (0..*), spotLocation (0..*), typeDesignator (0..*)
Attributes:
  • belongsToParent: reference to a parent under crossing

    - 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}}),

  • constructionType: construction type of under crossing: bridge or tunnel (obligatory; xs:string; patterns: other:w{2,})
Possible values:
  • bridge: a structure built to span a physical obstacle (such as a body of water, valley, road, or railway) without blocking the way underneath [wikipedia].
  • tunnel: underground passageway, dug through surrounding soil, earth or rock, and enclosed except for the entrance and exit, commonly at each end [wikipedia].
  • movableBridge: A special movable bridge (undercrossing) which is used for railway traffic passing a waterway underneath the railway line in normal position but allows for temporarily being moved out of the way of the vessels. It is then not passable by trains.
    The normal position is locked and supervised by interlocking system. The other control of the bridge is outside the interlocking system.,

  • verbalConstraint: verbal formulation for any kind of further constraint that applies for using the overCrossing or underCrossing (optional; xs:string),

  • 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:underCrossing of railML® version 3.1
Documentation An under crossing describes a crossing, where something crosses under the railway line. The most common constructional type of an under crossing is a bridge.
Subschema infrastructure
Parents* underCrossings
Children allowedWeightLimit (0..*), any (0..*), areaLocation (0..*), crossesElement (0..*), designator (0..*), external (0..*), gmlLocations (0..*), isValid (0..*), length (0..*), linearLocation (0..*), name (0..*), networkLocation (0..*), spotLocation (0..*)
Attributes:
  • constructionType: construction type of under crossing: bridge or tunnel (obligatory; xs:string; patterns: other:w{2,})
Possible values:
  • tunnel
  • bridge,

  • belongsToParent: reference to a parent under crossing (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}}),

  • verbalConstraint: verbal formulation for any kind of further constraint that applies for using the overCrossing or underCrossing (optional; xs:string),

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

The attributes have been changed.

Semantics

https://development.railml.org/railml/version3/-/issues/255

Some basic modelling rules:

- It is possible to refer to an arbitrary number of "crossed elements" from one xCrossing

- the constructional realization (bridge or tunnel) of the xCrossing is implemented as attribute and shall not be included in the name of the functional infrastructure element

- if "something" crosses under the railway track/line, it shall be named an underCrossing

- if "something" crosses over the railway track/line, it shall be named an overCrossing

- if "something" crosses the railway track/line at same level (usually only roads, streets and ways), it shall be named levelCrossing

Best Practice / Examples

Additional Information

Notes

Open Issues