IS:geoCoord: Difference between revisions

From railML 2 Wiki
Jump to navigation Jump to search
[unchecked revision][checked revision]
(GeoCoord, coordinates)
 
(railML→{{rml}})
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{ElementDocu|
elementName = geoCoord


== GeoCoord ==
|parent = {{IS:Tag|axleWeightChange}}, {{IS:Tag|balise}}, {{IS:Tag|border}}, {{IS:Tag|brigde}}, {{IS:Tag|clearanceGaugeChange}}, {{IS:Tag|crossing}}, {{IS:Tag|crossSection}}, {{IS:Tag|derailer}}, {{IS:Tag|electrificationChange}}, {{IS:Tag|from}}, {{IS:Tag|gaugeChange}}, {{IS:Tag|geoMapping}}, {{IS:Tag|gradientChange}}, {{IS:Tag|levelCrossing|levelCrossings}}, {{IS:Tag|lock}}, {{IS:Tag|mileageChange}}, {{IS:Tag|ocp}}, {{IS:Tag|operationModeChange}}, {{IS:Tag|ownerChange}}, {{IS:Tag|platformEdge}}, {{IS:Tag|powerTransmissionChange}}, {{IS:Tag|radiusChange}}, {{IS:Tag|serviceSection}}, {{IS:Tag|signal}}, {{IS:Tag|speedChange}}, {{IS:Tag|stopPost}}, {{IS:Tag|switch}}, {{IS:Tag|to}}, {{IS:Tag|trackBegin}}, {{IS:Tag|trackCircuitBorder}}, {{IS:Tag|trackCondition}}, {{IS:Tag|trackEnd}}, {{IS:Tag|trainDetector}}, {{IS:Tag|trainProtectionChange}}, {{IS:Tag|trainProtectionElement}}, {{IS:Tag|trainRadioChange}}, {{IS:Tag|tunnel}}
|childs={{#if:|{{{childs}}}|''None''}}
|minocc=0
|semantics =
{{IS:Tag|geoCoord}} provides the definition of a geographical position (e. g. longitude, latitude, altitude). It can be used in case that element positions should not only be specified by relative or absolute mileage along the track but via geographical reference as well. Thus, {{IS:Tag|geoCoord}} defines exactly one point on earth given by either two or three dimensional coordinates.


A GeoCoord element is a container for specifiying geographical coordinates for a railway infrastructure object. Thus, a GeoCoord element defines exactly one point on earth given by either two or three dimensional coordinates.
The coordinate system is specified by its {{external|https://en.wikipedia.org/wiki/EPSG|EPSG-Code}}. It can either be provided as optional value for each coordinate element or as a default value assigned in {{IS:Tag|infraAttributes}}. By default, the coordinates shall be given in the reference system WGS84, because it is valid worldwide — see {{external|https://spatialreference.org/ref/epsg/wgs-84}}.


By default, the coordinates shall be given in the reference system WGS84, because it is valid worldwide.
The semantics for the list contents of the {{Attr|coord}} attribute are implicitly defined by their bounded {{external|https://en.wikipedia.org/wiki/EPSG|EPSG-Code}}. {{AddAnn|| }}
WGS84: see [http://spatialreference.org/ref/epsg/wgs-84/]
<!--|inheritedAttributes={{#if:{{{inheritedAttributes|}}}|{{{inheritedAttributes}}}|''None''}}--><!--Hinfällig nach Zusammenlegung der Abschnitte „Inherited Atrributes“ und „Own Atrributes“-->
|ownAttributes =
* {{Attr|coord}}: This is a list of values representing the coordinates. {{AddAnn|| }}


== Implementation in railML ==
* {{Attr|extraHeight}}: This is a separate value for the altitude/height. It is used<br>
** if altitudes are stored in an own reference system (i. e. {{Attr|epsgCode}} refers to a GeodeticCRS rather than a CompoundCRS),<br>
** if there are no long/lat coords given or known but a height (see notes below).<br>{{AddAnn|| }}


[...]
{{InheritEpsg
|codeAttribute = epsgCode
|heightCodeAttribute = heightEpsgCode
|epsgCode =
|epsgCode_de =
|heightEpsgCode =
|heightEpsgCode_de =
}}


== Discussion ==
|constraints =  
* {{Attr|coord}} "whitespace" separated list of {{XsdType|double}} values, at minimum two values, at maximum three values, mandatory ''(for arrangement see below)''


There are some aspects about geographical coordinates and the current implementation in railML, which are not yet solved and require further discussion. These aspects are listed below:
* {{Attr|extraHeight}} {{XsdType|double}}, optional
 
{{InheritEpsgConstraints
|codeAttribute = epsgCode
|heightCodeAttribute = heightEpsgCode
}}
 
For 2-dimensional reference, there are two values in the {{Attr|coord}} attribute, {{Attr|extraHeight}} attribute is absent.
 
For 3-dimensional references, there are ''either'' three values in the {{Attr|coord}} attribute and {{Attr|extraHeight}} is absent ''or'' two values in the {{Attr|coord}} list together with the {{Attr|extraHeight}} attribute. The third value in {{Attr|coord}} and the attribute {{Attr|extraHeight}} shall not be used in conjunction (the third value may be set to zero if there is an attribute {{Attr|extraHeight}}).
 
The usage of geographical coordinates in {{IS:Tag|geoCoord}} is an optional supplement to the mandatory relative positioning of elements along the track using {{Attr|pos}} and the optional absolute positioning along the track using {{Attr|absPos}}. {{AddAnn|| }}
 
{{Attr|epsgCode}} is highly recommended (mandatory for a future release) if there are coordinates given in the attribute {{Attr|coord}} (i. e. if both long and lat coords are not zero).<br>
{{Attr|epsgCode}} has to refer to a GeodeticCRS (incl. projected geodetic CRS) or CompoundCRS (such as 4258, 4326, 4314).
 
{{Attr|heightEpsgCode}} is highly recommended (mandatory for a future release)<br>
- if there is a height given in the attribute {{Attr|coord}} and {{Attr|epsgCode}} does not refer to a CompoundCRS,<br>
or<br>
- if the attribute {{Attr|extraHeight}} is used.<br>
{{Attr|heightEpsgCode}} has to refer to a VerticalCRS (such as 5621, 5730, 5783, 5785) but not to a VerticalDatum (such as 6258, 5183, 5181).
|bestpractice=There are some aspects about geographical coordinates and the implementation in {{rml|2.1}} to {{rml|2.5}}, which are not yet solved and require further discussion. These aspects are listed below:


* At the moment, only ''one <geoCoord> per element'' can be defined. It is not possible, to give one point multiple geographical coordinates, e.g. for locating a point in different reference systems.
* At the moment, only ''one <geoCoord> per element'' can be defined. It is not possible, to give one point multiple geographical coordinates, e.g. for locating a point in different reference systems.


* At the moment, height coordinates cannot exist without horizontal coordinates. From the timetable's perspective this is difficult since often coordinates are not know and only the vertical height/gradient profile could be modelled. Therefore, the height coordinates should be defined independent from the horizontal coordinates. Until then, please use the parameter '''extraHeight''' in combination with zero horizontal coordinates:
* At the moment, height coordinates cannot exist without horizontal coordinates. From the timetable's perspective this is difficult since often coordinates are not know and only the vertical height/gradient profile could be modelled. Therefore, the height coordinates should be defined independent from the horizontal coordinates. Until then, please use the parameter '''extraHeight''' in combination with zero horizontal coordinates (example for German DHHN92):
 
<syntaxhighlight lang="xml">
  <geoCoord coord="0 0 0" extraHeight="123.4" epsgCode="urn:ogc:def:crs:EPSG::5783" />
</syntaxhighlight>
 
* The height coordinates may differ in various countries referencing different national peils (Amsterdam's Peil, Kronstadt Peil, ...). The peil systems are categorized in the EPSG code too. You may find the EPSG codes at the {{external|https://www.epsg-registry.org|website of EPSG Geodetic Parameter Dataset}}.
===Examples===
<syntaxhighlight lang="xml">
  <geoCoord coord="52.2449 10.5466" epsgCode="urn:ogc:def:crs:EPSG::4326"/>
</syntaxhighlight>
 
 
This code example defines the position of ''Oslo Sentralstasjon'' in WGS84 coordinates:
<syntaxhighlight lang="xml">
  <geoCoord coord="59.911 10.754" epsgCode="urn:ogc:def:crs:EPSG::4326" />
</syntaxhighlight>
 
 
This code example defines the position of ''Oslo Sentralstasjon'' in ETRS89 / ETRS-TM32:
<syntaxhighlight lang="xml">
  <geoCoord coord="598059.6081 6642972.5966" epsgCode="urn:ogc:def:crs:EPSG::3044" />
</syntaxhighlight>
 
 
The following code example defines a height without long/lat coordinates:
<syntaxhighlight lang="xml">
  <geoCoord coord='0 0' extraHeight='250.03' heightEpsgCode='5783'/>
</syntaxhighlight>
(In {{rml|2.0}} and {{rml|2.1}}, for syntactical reasons, there has to be a third 0 in {{Attr|coord}}:)
<syntaxhighlight lang="xml">
  <geoCoord coord='0 0 0' extraHeight='250.03' heightEpsgCode='5783'/>
</syntaxhighlight>
 
 
The following code example of ''Görlitz'' defines a height in a different reference system than the long/lat coordinates:
<syntaxhighlight lang="xml">
  <geoCoord coord='51.1473 14.9783' epsgCode='4326' extraHeight='209.42' heightEpsgCode='5783'/>
</syntaxhighlight>
which is equivalent to
<syntaxhighlight lang="xml">
  <geoCoord coord='51.1473 14.9783 209.42' epsgCode='4326' heightEpsgCode='5783'/>
</syntaxhighlight>
 
 
The following code example of ''Görlitz'' defines a height in the same compound reference system as the long/lat coordinates:
<syntaxhighlight lang="xml">
  <geoCoord coord='51.1473 14.9783 209.38' epsgCode='6893' />
</syntaxhighlight>
 
 
|notes =
A database of {{external|https://en.wikipedia.org/wiki/EPSG EPSG-Codes}} is available from the {{external|https://www.epsg-registry.org|EPSG-Registry}}. {{AddAnn|| }}
 
The full urn reference part of the attributes {{Attr|epsgCode}} and {{Attr|heightEpsgCode}} - that is "urn:ogc:def:crs:EPSG::" - is treated to be constant. (Between the last two colons :: is the place for a version number of the EPSG code if there would be any.) Since it is clear that the attributes are only allowed to contain EPSG numbers, and if there would be no version number, you can omit the constant part, just reducing the value to the actual EPSG code number: <code>epsgCode="urn:ogc:def:crs:EPSG::4326"</code> is the same as <code>epsgCode="4326"</code>.
=== Unit for height coordinates ===
The unit for the height coordinate is given by the used EPSG code. For
example, the "Deutsches Haupthoehennetz 1992" with EPSG code 5783
defines the height in meters — see {{external|https://www.spatialreference.org/ref/epsg/5783/prettywkt}}.
=== Sequence of coordinates / {{Deu|Reihenfolge der Koordinaten}} ===
 
The order of the coordinates is specified by the spatial reference system (SRS), which has to be given, e.g. in form of the EPSG code. The EPSG code is a standard for identifying all the different coordinate reference systems that exist and the {{external|https://www.epsg-registry.org|EPSG register}} contains them all. The most common basis is the World Geodetic System 84 (WGS 84) with the EPSG code 4326. WGS 84 is a geodetic coordinate reference system, which includes an ellipsoidal coordinate system (EPSG::6422) defining the axes geodetic latitude (1, north) and geodetic longitude (2, east). Therefore, the correct order of coordinates is: latitude, longitude. The complete schema definition can be found in the {{external|https://opengis.net/def/crs/EPSG/0/4326|OpenGIS register}}.


  <geoCoord coord="0.0000 0.0000" extraHeight="123.4" />
{{Deu|Prinzipiell richtet sich die Reihenfolge der Koordinaten nach der Definition im zugehörigen SRS (Spatial Reference System), welches in Form des EPSG-Codes angegeben ist. Mit Hilfe des EPSG-Codes lassen sich alle verschiedenen Koordinatensysteme angeben. Einen Überblick über diese Koordinatensysteme liefert das {{external|https://schemas.opengis.net/gml/3.2.1/geometryBasic0d1d.xsd|OpenGIS schema|inlang=de}}. Das meistgenutzte System ist das "World Geodetic System 84 (WGS 84)" mit dem {{external|https://www.epsg-registry.org|EPSG-Code|inlang=de}} 4326. WGS 84 ist ein geodätisches Koordinaten-Referenzsystem, welches einen Referenzellipsoiden (EPSG::6422) besitzt, dessen Koordinatenachsen "Geodetic Latitude" (1, Nord) und "Geodetic Longitude" (2, Ost) aufspannen. Daher ist die korrekte Reihenfolge der Koordinaten: Latitude, Longitude.}}


* The height coordinates may differ in various countries referencing different national peils (Amsterdam's Peil, Kronstadt Peil, ...). In contrast to the EPSG code, the peil systems are not categorized. It is suggested to introduce such a categorization. Until then, the usage of the relevant national height reference system will be anticipated.
|openissues =
There are some aspects about geographical coordinates and the implementation in {{rml|2.1}} to {{rml|2.5}}, which are not yet solved and require further discussion. These aspects are listed below:


== Examples ==
* At the moment, only ''one {{IS:Tag|geoCoord}} per element'' can be defined. It is not possible, to give one point multiple geographical coordinates, e.g. for locating a point in different reference systems.


This code example defines the position of Oslo Sentralstasjon in WGS84 coordinates:
* At the moment, height coordinates cannot exist without horizontal coordinates. From the timetable's perspective this is difficult since often coordinates are not know and only the vertical height/gradient profile could be modeled. Therefore, the height coordinates should be defined independently from the horizontal coordinates. Until then, please use the parameter '''extraHeight''' in combination with zero horizontal coordinates (example for German DHHN92):


   <geoCoord coord="10.754 59.911" epsgCode="4326" />
<syntaxhighlight lang="xml">
   <geoCoord coord="0 0 0" extraHeight="123.4" heightEpsgCode="urn:ogc:def:crs:EPSG::5783" />
</syntaxhighlight>


This code example defines the position of Oslo Sentralstasjon in ETRS89 / ETRS-TM32:
* The height coordinates may differ in various countries referencing different national peils (Amsterdam's Peil, Kronstadt Peil, ...). The peil systems are categorized in the EPSG code too. You may find the EPSG codes at the {{external|https://www.epsg-registry.org|website of EPSG Geodetic Parameter Dataset}}.


  <geoCoord coord="598059.6081 6642972.5966" epsgCode="3044" />
* The definition of EPSG codes for every geoCoord element provides redundancy and enlarges the {{rml}} files. Therefore, it is suggested to define an attribute for a global EPSG code being valid for all coordinates of the {{rml}} file. See {{ticket|265}} for more details and follow up.
}}

Revision as of 18:28, 22 January 2024


geoCoord
 


Schema description / Schemenbeschreibung

Position of geoCoord in the XML-Tree / Position von geoCoord im XML-Baum

Multiplicity / Anzahl

[0..1]

Semantics / Bedeutung

<geoCoord> provides the definition of a geographical position (e. g. longitude, latitude, altitude). It can be used in case that element positions should not only be specified by relative or absolute mileage along the track but via geographical reference as well. Thus, <geoCoord> defines exactly one point on earth given by either two or three dimensional coordinates.

The coordinate system is specified by its EPSG-Code (external link). It can either be provided as optional value for each coordinate element or as a default value assigned in <infraAttributes>. By default, the coordinates shall be given in the reference system WGS84, because it is valid worldwide — see https://spatialreference.org/ref/epsg/wgs-84 (external link).

The semantics for the list contents of the coord attribute are implicitly defined by their bounded EPSG-Code (external link).

Attributes of geoCoord / Attribute von geoCoord

  • coord: This is a list of values representing the coordinates.
  • extraHeight: This is a separate value for the altitude/height. It is used
    • if altitudes are stored in an own reference system (i. e. epsgCode refers to a GeodeticCRS rather than a CompoundCRS),
    • if there are no long/lat coords given or known but a height (see notes below).


  • epsgCode: This is an URI pointing to the EPSG-Code (external link) as reference system for the coordinates in coord.
  • heightEpsgCode: This is an URI pointing to the EPSG-Code (external link) for the separate altitude reference system.

Syntactic Constraints / Syntaktische Beschränkungen

  • coord "whitespace" separated list of xs:double values, at minimum two values, at maximum three values, mandatory (for arrangement see below)

For 2-dimensional reference, there are two values in the coord attribute, extraHeight attribute is absent.

For 3-dimensional references, there are either three values in the coord attribute and extraHeight is absent or two values in the coord list together with the extraHeight attribute. The third value in coord and the attribute extraHeight shall not be used in conjunction (the third value may be set to zero if there is an attribute extraHeight).

The usage of geographical coordinates in <geoCoord> is an optional supplement to the mandatory relative positioning of elements along the track using pos and the optional absolute positioning along the track using absPos.

epsgCode is highly recommended (mandatory for a future release) if there are coordinates given in the attribute coord (i. e. if both long and lat coords are not zero).
epsgCode has to refer to a GeodeticCRS (incl. projected geodetic CRS) or CompoundCRS (such as 4258, 4326, 4314).

heightEpsgCode is highly recommended (mandatory for a future release)
- if there is a height given in the attribute coord and epsgCode does not refer to a CompoundCRS,
or
- if the attribute extraHeight is used.
heightEpsgCode has to refer to a VerticalCRS (such as 5621, 5730, 5783, 5785) but not to a VerticalDatum (such as 6258, 5183, 5181).

Best practice & Examples / Empfohlene Anwendung & Beispiele

There are some aspects about geographical coordinates and the implementation in railML® 2.1 to railML® 2.5, which are not yet solved and require further discussion. These aspects are listed below:

  • At the moment, only one <geoCoord> per element can be defined. It is not possible, to give one point multiple geographical coordinates, e.g. for locating a point in different reference systems.
  • At the moment, height coordinates cannot exist without horizontal coordinates. From the timetable's perspective this is difficult since often coordinates are not know and only the vertical height/gradient profile could be modelled. Therefore, the height coordinates should be defined independent from the horizontal coordinates. Until then, please use the parameter extraHeight in combination with zero horizontal coordinates (example for German DHHN92):
  <geoCoord coord="0 0 0" extraHeight="123.4" epsgCode="urn:ogc:def:crs:EPSG::5783" />
  • The height coordinates may differ in various countries referencing different national peils (Amsterdam's Peil, Kronstadt Peil, ...). The peil systems are categorized in the EPSG code too. You may find the EPSG codes at the website of EPSG Geodetic Parameter Dataset (external link).

Examples

  <geoCoord coord="52.2449 10.5466" epsgCode="urn:ogc:def:crs:EPSG::4326"/>


This code example defines the position of Oslo Sentralstasjon in WGS84 coordinates: 

  <geoCoord coord="59.911 10.754" epsgCode="urn:ogc:def:crs:EPSG::4326" />


This code example defines the position of Oslo Sentralstasjon in ETRS89 / ETRS-TM32: 

  <geoCoord coord="598059.6081 6642972.5966" epsgCode="urn:ogc:def:crs:EPSG::3044" />


The following code example defines a height without long/lat coordinates: 

  <geoCoord coord='0 0' extraHeight='250.03' heightEpsgCode='5783'/>

(In railML® 2.0 and railML® 2.1, for syntactical reasons, there has to be a third 0 in coord:) 

  <geoCoord coord='0 0 0' extraHeight='250.03' heightEpsgCode='5783'/>


The following code example of Görlitz defines a height in a different reference system than the long/lat coordinates: 

  <geoCoord coord='51.1473 14.9783' epsgCode='4326' extraHeight='209.42' heightEpsgCode='5783'/>

which is equivalent to 

  <geoCoord coord='51.1473 14.9783 209.42' epsgCode='4326' heightEpsgCode='5783'/>


The following code example of Görlitz defines a height in the same compound reference system as the long/lat coordinates: 

  <geoCoord coord='51.1473 14.9783 209.38' epsgCode='6893' />

Notes / Anmerkungen

A database of EPSG-Codes https://en.wikipedia.org/wiki/EPSG EPSG-Codes (external link) is available from the EPSG-Registry (external link).

The full urn reference part of the attributes epsgCode and heightEpsgCode - that is "urn:ogc:def:crs:EPSG::" - is treated to be constant. (Between the last two colons :: is the place for a version number of the EPSG code if there would be any.) Since it is clear that the attributes are only allowed to contain EPSG numbers, and if there would be no version number, you can omit the constant part, just reducing the value to the actual EPSG code number: epsgCode="urn:ogc:def:crs:EPSG::4326" is the same as epsgCode="4326".

Unit for height coordinates

The unit for the height coordinate is given by the used EPSG code. For example, the "Deutsches Haupthoehennetz 1992" with EPSG code 5783 defines the height in meters — see https://www.spatialreference.org/ref/epsg/5783/prettywkt (external link).

Sequence of coordinates / Reihenfolge der Koordinaten

The order of the coordinates is specified by the spatial reference system (SRS), which has to be given, e.g. in form of the EPSG code. The EPSG code is a standard for identifying all the different coordinate reference systems that exist and the EPSG register (external link) contains them all. The most common basis is the World Geodetic System 84 (WGS 84) with the EPSG code 4326. WGS 84 is a geodetic coordinate reference system, which includes an ellipsoidal coordinate system (EPSG::6422) defining the axes geodetic latitude (1, north) and geodetic longitude (2, east). Therefore, the correct order of coordinates is: latitude, longitude. The complete schema definition can be found in the OpenGIS register (external link).

Prinzipiell richtet sich die Reihenfolge der Koordinaten nach der Definition im zugehörigen SRS (Spatial Reference System), welches in Form des EPSG-Codes angegeben ist. Mit Hilfe des EPSG-Codes lassen sich alle verschiedenen Koordinatensysteme angeben. Einen Überblick über diese Koordinatensysteme liefert das OpenGIS schema (externer Link). Das meistgenutzte System ist das "World Geodetic System 84 (WGS 84)" mit dem EPSG-Code (externer Link) 4326. WGS 84 ist ein geodätisches Koordinaten-Referenzsystem, welches einen Referenzellipsoiden (EPSG::6422) besitzt, dessen Koordinatenachsen "Geodetic Latitude" (1, Nord) und "Geodetic Longitude" (2, Ost) aufspannen. Daher ist die korrekte Reihenfolge der Koordinaten: Latitude, Longitude.

Open issues / Offene Punkte/Pendenzen

There are some aspects about geographical coordinates and the implementation in railML® 2.1 to railML® 2.5, which are not yet solved and require further discussion. These aspects are listed below:

  • At the moment, only one <geoCoord> per element can be defined. It is not possible, to give one point multiple geographical coordinates, e.g. for locating a point in different reference systems.
  • At the moment, height coordinates cannot exist without horizontal coordinates. From the timetable's perspective this is difficult since often coordinates are not know and only the vertical height/gradient profile could be modeled. Therefore, the height coordinates should be defined independently from the horizontal coordinates. Until then, please use the parameter extraHeight in combination with zero horizontal coordinates (example for German DHHN92):
  <geoCoord coord="0 0 0" extraHeight="123.4" heightEpsgCode="urn:ogc:def:crs:EPSG::5783" />
  • The height coordinates may differ in various countries referencing different national peils (Amsterdam's Peil, Kronstadt Peil, ...). The peil systems are categorized in the EPSG code too. You may find the EPSG codes at the website of EPSG Geodetic Parameter Dataset (external link).
  • The definition of EPSG codes for every geoCoord element provides redundancy and enlarges the railML® files. Therefore, it is suggested to define an attribute for a global EPSG code being valid for all coordinates of the railML® file. See #265 for more details and follow up.
Retrieved from "https://wiki2.railml.org/index.php?title=IS:geoCoord&oldid=15278"