IS:crossesElement: Difference between revisions

From railML 3 Wiki
Jump to navigation Jump to search
[checked revision][checked revision]
m (fixed attribution)
Line 103: Line 103:
|{{IS:Tag|underCrossing}}
|{{IS:Tag|underCrossing}}
|<gallery widths=700px heights=300px mode="packed-overlay">
|<gallery widths=700px heights=300px mode="packed-overlay">
File:Krzysztof-kotkowicz-d xw YAuRPU-unsplash.jpg|{{external|https://unsplash.com/photos/red-and-blue-train-in-the-city-d_xw_YAuRPU|Railway viaduct}} by {{external|https://unsplash.com/@lancaster83|Krzysztof Kotkowicz}} via {{external|https://unsplash.com|Unsplash}} Free to use under the {{external|https://unsplash.com/license|Unsplash License}}  
File:Krzysztof-kotkowicz-d xw YAuRPU-unsplash.jpg|{{unsplash|d_xw_YAuRPU|Krzysztof Kotkowicz|https://unsplash.com/@lancaster83}}
</gallery>
</gallery>
|because city is UNDER the railway  
|because city is UNDER the railway  

Revision as of 09:54, 13 May 2024

Introduction

Documentation

Syntax

Autoexport from the XML-Schema for element IS:crossesElement of railML® version 3.3
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. (optional; xs:IDREF),

  • 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: 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: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. (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

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 attributes have been changed.

Semantics

Best Practice / Examples

crossesElement/@type Valid parent Real world example Explanation Comment
railway <underCrossing>, <overCrossing>
river <underCrossing> because river is UNDER the railway BRIDGE
road <underCrossing> because road is UNDER the railway BRIDGE see also

1) Hampson Street Railway Bridge (external link) by David Dixon GeographBot (external link) via Wikimedia Commons CC BY-SA 2.0 (external link) 2) Kos93 (external link) Auto put železnički vijadukt.jpg (external link) by Srđan Popović via Wikimedia Commons CC BY-SA 4.0 (external link)

road <overCrossing> because road BRIDGE is OVER the railway see also CC BY-SA 4.0 (external link) Falk2 (external link) C1.23a Bf Lr, Stw 4.jpg (external link) via Wikimedia Commons
cycleway <underCrossing> because cycleway is UNDER the railway BRIDGE see also CC BY-SA 2.0 (external link) GeographBot (external link) Railway bridge at Thackley (external link) by Stephen Craven via Wikimedia Commons
road <overCrossing> because road is OVER the railway TUNNEL see also CC BY-SA 2.0 (external link) GeographBot (external link) The railway entering Ryde Tunnel (external link) by Steve Daniels via Wikimedia Commons
footway <overCrossing> because footway is OVER the railway TUNNEL see also CC BY-SA 2.0 (external link) GeographBot (external link) Ludlow railway station and tunnel (external link) by Gareth James via Wikimedia Commons
footway <overCrossing> because footway BRIDGE is OVER the railway
peak <overCrossing> because hill is OVER the railway
peak <underCrossing> because valley is UNDER the railway
city <underCrossing> because city is UNDER the railway


Additional Information

Notes

Open Issues