IS:crossesElement: Difference between revisions

From railML 3 Wiki
Jump to navigation Jump to search
[checked revision][checked revision]
(added photo)
m (typo)
Line 30: Line 30:
|
|
<gallery widths=700px heights=300px>
<gallery widths=700px heights=300px>
File:1200px-Kehra railway bridge.jpg|Zmobbie, CC0, via Wikimedia Commons https://commons.wikimedia.org/wiki/File:Kehra_railway_bridge.jpg https://commons.wikimedia.org/wiki/User:Zmobbie
File:1200px-Kehra railway bridge.jpg|Zmobbie https://commons.wikimedia.org/wiki/User:Zmobbie, CC0, via Wikimedia Commons https://commons.wikimedia.org/wiki/File:Kehra_railway_bridge.jpg
</gallery>
</gallery>
|because river is UNDER the railway BRIDGE
|because river is UNDER the railway BRIDGE

Revision as of 14:59, 14 March 2024

Introduction

Documentation

Syntax

Autoexport from the XML-Schema for element IS:crossesElement of railML® version 3.2
Documentation describes a single element each that is crossed by a bridge, level crossing or tunnel
Subschema infrastructure
Parents* levelCrossingIS,

overCrossing, underCrossing

Children name (0..*)
Attributes:
  • ref: reference to the ID of an element that is also part of the railway infrastructure. Use this attribute e.g. when your railway line is crossing itself (not on same level!). (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}}),

  • type: type of the element that is crossed by the over/under/level crossing (obligatory; xs:string; patterns: other:w{2,})
Possible values:
  • area: generic value for describing an areal location within the network
  • city: a human settlement of a notable size [The Penguin Dictionary of Human Geography].
  • cycleway: path, track or lane restricted to bicycles
  • footway: path, track or sidewalk restricted to pedestrian traffic
  • lake: naturally occurring, relatively large body of water localized in a basin surrounded by dry land [Encyclopaedia Britannica].
  • motorway: national road with restricted access, divided traffic and grade separated junctions
  • peak: of a hill or mountain - is immaterial and maps the highest point of a natural or renaturalised physical feature [openStreetMap].
  • permissiveRoad: private road with public access
  • primaryRoad: national road linking large towns; no motorway
  • privateRoad: private road with no public access
  • ridge: a hill or mountain landform with a continuous elevated crest. The sides of the ridge slope away on either side of the crest. The line along the crest formed by the highest points is called the ridgeline [openStreetMap].
  • river: linear flow of larger natural waterways, in flow direction. Note that the linear ways should form a complete routable description of the watercourse [openStreetMap].
  • road: unknown road type
  • secondaryRoad: county road linking towns
  • tertiaryRoad: municipal road within towns and in the countryside
  • valley: an elongated natural depression flanked by ridges or ranges of mountains or hills, and at least partially formed by fluvial degration [openStreetMap].
  • railway: A track, consisting of parallel rails, over which wheeled vehicles such as trains may travel [wiktionary].,

  • id: unique identifier (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:crossesElement of railML® version 3.1
Documentation This element is not documented in the schema!
Subschema infrastructure
Parents* levelCrossingIS,

overCrossing, underCrossing

Children name (0..*)
Attributes:
  • type: type of the element that is crossed by the over/under/level crossing (obligatory; xs:string; patterns: other:w{2,})
Possible values:
  • lake
  • river
  • valley
  • ridge
  • peak
  • road
  • motorway
  • footway
  • city
  • area
  • cycleway
  • railway,

  • ref: reference to the ID of an element that is also part of the railway infrastructure. Use this attribute e.g. when your railway line is crossing itself (not on same level!). (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: unique identifier (optional; 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

crossesElement/@type valid parent real world example comment
railway <underCrossing>, <overCrossing>
river <underCrossing> because river is UNDER the railway BRIDGE
road <underCrossing> Srđan Popović, CC BY-SA 4.0 <https://creativecommons.org/licenses/by-sa/4.0>, via Wikimedia Commons - https://commons.wikimedia.org/wiki/File:Auto_put_%C5%BEelezni%C4%8Dki_vijadukt.jpg

Hampson Street Railway Bridge by David Dixon, CC BY-SA 2.0 <https://creativecommons.org/licenses/by-sa/2.0>, via Wikimedia Commons - https://commons.wikimedia.org/wiki/File:Hampson_Street_Railway_Bridge_-_geograph.org.uk_-_5294877.jpg

because road is UNDER the railway BRIDGE
road <overCrossing>

Falk2, CC BY-SA 4.0 <https://creativecommons.org/licenses/by-sa/4.0>, via Wikimedia Commons - https://commons.wikimedia.org/wiki/File:C1.23a_Bf_Lr,_Stw_4.jpg

because road BRIDGE is OVER the railway
cycleway <underCrossing> Railway bridge at Thackley by Stephen Craven, CC BY-SA 2.0 <https://creativecommons.org/licenses/by-sa/2.0>, via Wikimedia Commons - https://commons.wikimedia.org/wiki/File:Railway_bridge_at_Thackley_-_geograph.org.uk_-_5429648.jpg because cycleway is UNDER the railway BRIDGE
road <overCrossing> The railway entering Ryde Tunnel by Steve Daniels, CC BY-SA 2.0 <https://creativecommons.org/licenses/by-sa/2.0>, via Wikimedia Commons - https://commons.wikimedia.org/wiki/File:The_railway_entering_Ryde_Tunnel_-_geograph.org.uk_-_5822454.jpg because road is OVER the railway TUNNEL
footway <overCrossing> Ludlow railway station and tunnel by Gareth James, CC BY-SA 2.0 <https://creativecommons.org/licenses/by-sa/2.0>, via Wikimedia Commons - https://commons.wikimedia.org/wiki/File:Ludlow_railway_station_and_tunnel_-_geograph.org.uk_-_4088041.jpg because footway is OVER the railway TUNNEL
footway <overCrossing> Severn Tunnel Junction railway station footbridge by Jaggery, CC BY-SA 2.0 <https://creativecommons.org/licenses/by-sa/2.0>, via Wikimedia Commons - https://commons.wikimedia.org/wiki/File:Severn_Tunnel_Junction_railway_station_footbridge_-_geograph.org.uk_-_3757583.jpg because footway BRIDGE is OVER the railway


Additional Information

Notes

Open Issues