IS:levelCrossingIS

From railML 3 Wiki
Revision as of 12:36, 17 November 2023 by RailML Orga Ontology (talk | contribs) (removed comment of Adam because it belongs to under/overcrossing)
Jump to navigation Jump to search

Introduction

Documentation

Syntax

Autoexport from the XML-Schema for element IS:levelCrossingIS of railML® version 3.3
Documentation Allows specifying intersections where a railway line crosses a road or a path at the same level
Subschema infrastructure
Parents* levelCrossingsIS
Children areaLocation (0..*), crossesElement (0..*), designator (0..*), elementState (0..*), etcsLevelCrossing (0..1), gmlLocation (0..*), isValid (0..*), linearLocation (0..*), linkedSpeedSection (0..*), name (0..*), networkLocation (0..*), protection (0..1), spotLocation (0..*), typeDesignator (0..*)
Attributes:
  • activation: describes how the level crossing is being activated;
    missing attribute means that the information is not known (optional; xs:string)
Possible values:
  • infrastructureAutomatic: level crossing is activated automatically from infrastructure side (e.g. via activating rail detector)
  • infrastructureManual: level crossing is activated manually from infrastructure side (e.g. by a dispatcher)
  • none: there is no activation of the level crossing protection
  • trainAutomatic: level crossing is activated automatically from train side
  • trainManual: level crossing is activated manually from train side (action of train driver required),

  • basedOnTemplate: reference to a template level crossing (optional; xs:IDREF),

  • belongsToParent: reference to the (one and only) parent level 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:IDREF),

  • lengthOfStoppingAreaBeforeLevelCrossing: distance between the stopping point in front of a level crossing and the level crossing itself, in meters (optional; xs:decimal),

  • obstacleDetection: obstacle detection: automatic (technical system, e.g. radar) or manual (e.g. by operator);
    missing attribute means that the information is not known (optional; xs:string)
Possible values:
  • automatic: obstacle detection in level crossing danger area is done automatically (e.g. via radar)
  • manual: obstacle detection in level crossing danger area is done manually (e.g. via dispatcher looking)
  • none: there is no obstacle detection taking place in the level crossing danger area,

  • opensOnDemand: set TRUE if the level crossing is closed for road users by default and gates are only opened on demand;
    missing attribute means that the information is not known (optional; xs:boolean),

  • supervision: describes how the state of the level crossing is being supervised;
    missing attribute means that the information is not known (optional; xs:string)
Possible values:
  • infrastructureAutomatic: level crossing is supervised automatically from infrastructure side (e.g. via camera)
  • infrastructureManual: level crossing is supervised manually from infrastructure side (e.g. by dispatcher looking)
  • none: the level crossing is not supervised
  • trainManual: level crossing is supervised manually from train side (by train driver),

  • 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:levelCrossingIS of railML® version 3.2
Documentation Allows specifying intersections where a railway line crosses a road or a path at the same level
Subschema infrastructure
Parents* levelCrossingsIS
Children areaLocation (0..*), crossesElement (0..*), designator (0..*), etcsLevelCrossing (0..1), external (0..*), gmlLocations (0..*), isValid (0..*), linearLocation (0..*), linkedSpeedSection (0..*), name (0..*), networkLocation (0..*), protection (0..1), spotLocation (0..*), typeDesignator (0..*)
Attributes:
  • activation: describes how the level crossing is being activated;
    missing attribute means that the information is not known (optional; xs:string)
Possible values:
  • infrastructureAutomatic: level crossing is activated automatically from infrastructure side (e.g. via activating rail detector)
  • infrastructureManual: level crossing is activated manually from infrastructure side (e.g. by a dispatcher)
  • none: there is no activation of the level crossing protection
  • trainAutomatic: level crossing is activated automatically from train side
  • trainManual: level crossing is activated manually from train side (action of train driver required),

  • basedOnTemplate: reference to a template level crossing (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: reference to the (one and only) parent level 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}}),

  • lengthOfStoppingAreaBeforeLevelCrossing: distance between the stopping point in front of a level crossing and the level crossing itself, in meters (optional; xs:decimal),

  • obstacleDetection: obstacle detection: automatic (technical system, e.g. radar) or manual (e.g. by operator);
    missing attribute means that the information is not known (optional; xs:string)
Possible values:
  • automatic: obstacle detection in level crossing danger area is done automatically (e.g. via radar)
  • manual: obstacle detection in level crossing danger area is done manually (e.g. via dispatcher looking)
  • none: there is no obstacle detection taking place in the level crossing danger area,

  • opensOnDemand: set TRUE if the level crossing is closed for road users by default and gates are only opened on demand;
    missing attribute means that the information is not known (optional; xs:boolean),

  • supervision: describes how the state of the level crossing is being supervised;
    missing attribute means that the information is not known (optional; xs:string)
Possible values:
  • infrastructureAutomatic: level crossing is supervised automatically from infrastructure side (e.g. via camera)
  • infrastructureManual: level crossing is supervised manually from infrastructure side (e.g. by dispatcher looking)
  • none: the level crossing is not supervised
  • trainManual: level crossing is supervised manually from train side (by train driver),

  • 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:levelCrossingIS of railML® version 3.1
Documentation This element is not documented in the schema!
Subschema infrastructure
Parents* levelCrossingsIS
Children any (0..*), areaLocation (0..*), crossesElement (0..*), designator (0..*), external (0..*), gmlLocations (0..*), isValid (0..*), linearLocation (0..*), name (0..*), networkLocation (0..*), protection (0..1), spotLocation (0..*)
Attributes:
  • obstacleDetection: obstacle detection: automatic (technical system, e.g. radar) or manual (e.g. by operator);

missing attribute means that the information is not known (optional; xs:string)

Possible values:
  • none: there is no obstacle detection taking place in the level crossing danger area
  • manual: obstacle detection in level crossing danger area is done manually (e.g. via dispatcher looking)
  • automatic: obstacle detection in level crossing danger area is done automatically (e.g. via radar),

  • opensOnDemand: set TRUE if the level crossing is closed for road users by default and gates are only opened on demand;

missing attribute means that the information is not known (optional; xs:boolean),

  • activation: describes how the level crossing is being activated;

missing attribute means that the information is not known (optional; xs:string)

Possible values:
  • trainAutomatic: level crossing is activated automatically from train side
  • trainManual: level crossing is activated manually from train side (action of train driver required)
  • infrastructureAutomatic: level crossing is activated automatically from infrastructure side (e.g. via activating rail detector)
  • infrastructureManual: level crossing is activated manually from infrastructure side (e.g. by a dispatcher)
  • none: there is no activation of the level crossing protection,

  • supervision: describes how the state of the level crossing is being supervised;

missing attribute means that the information is not known (optional; xs:string)

Possible values:
  • trainManual: level crossing is supervised manually from train side (by train driver)
  • infrastructureManual: level crossing is supervised manually from infrastructure side (e.g. by dispatcher looking)
  • infrastructureAutomatic: level crossing is supervised automatically from infrastructure side (e.g. via camera)
  • none: the level crossing is not supervised,

  • belongsToParent: reference to the (one and only) parent level 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}}),

  • basedOnTemplate: reference to a template level 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}}),

  • 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

Private-cloud-icon.png Proposed Semantic Constraint "IS:XXX":
 
<levelCrossingIS> should not have a <crossesElement> child of type railway. This case should be represented either by a <crossing> in case of a simple crossing, or by a <switchIS> of type doubleSwitchCrossing or singleSwitchCrossing.



 
Proposed on October 23rd 2023
FIXME: add Link to discussion!
Please, recognize our guidelines on semantic constraints



Best Practice / Examples

Additional Information

Notes

Open Issues