Merge pull request #99 from rouault/CoordinateEpochGeoKey

Add CoordinateEpochGeoKey (fixes #78)
opengeospatial · Aug 31, 2021 · 833e1a8 · 833e1a8
2 parents 6c3561e + 5cccfc0
commit 833e1a8
Show file tree

Hide file tree

Showing 5 changed files with 42 additions and 0 deletions.
diff --git a/GeoTIFF_Standard/standard/abstract_tests/TIFF_Tests/TEST_Double_Param.adoc b/GeoTIFF_Standard/standard/abstract_tests/TIFF_Tests/TEST_Double_Param.adoc
@@ -21,6 +21,7 @@
 |http://www.opengis.net/spec/GeoTIFF/1.1/req/ProjLinearParameterGeoKey
 |http://www.opengis.net/spec/GeoTIFF/1.1/req/ProjScalarParameterGeoKey
 |http://www.opengis.net/spec/GeoTIFF/1.1/req/ProjAzimuthAngleGeoKey
+|http://www.opengis.net/spec/GeoTIFF/1.2/req/CoordinateEpochGeoKey
 |===
 
 *Purpose:* Verify Double parameters
@@ -98,6 +99,7 @@
 ^| 3093 <| ProjScalarParameters (Scale at Center)
 ^| 3094 <| ProjAzimuthAngleGeoKey
 ^| 3095 <| ProjAngularParameters (Straight Vertical Pole)
+^| 5120 <| CoordinateEpochGeoKey
 |===
 
 Double GeoKey Tests
diff --git a/GeoTIFF_Standard/standard/annex-e.adoc b/GeoTIFF_Standard/standard/annex-e.adoc
@@ -246,4 +246,10 @@ __Table E.1 - Summary of GeoKey IDs and names __
 <| VerticalUnitsGeoKey
 <|
 <| (as GeoTIFF v1.0)
+5+<| [underline]#Dynamic CRS Parameter Keys#
+^| 5120
+^| Double
+<| CoordinateEpochGeoKey
+<|
+<| (as GeoTIFF v1.2)
 |====
diff --git a/GeoTIFF_Standard/standard/clause_4_terms_and_definitions.adoc b/GeoTIFF_Standard/standard/clause_4_terms_and_definitions.adoc
@@ -27,6 +27,11 @@ One of a sequence of numbers designating the position of a point.
 
 Note: In a spatial coordinate reference system, the coordinate numbers are qualified by units.
 
+=== coordinate epoch
+Epoch to which coordinates in a dynamic coordinate reference system are referenced
+
+ [Source: ISO 19111:2019, 3.1.7]
+
 === coordinate reference system
 Coordinate system that is related to an object by a datum.
 
@@ -63,6 +68,10 @@ Coordinate space referencing scanner, printers and display devices.
 === double
 8-byte IEEE double precision floating point.
 
+=== dynamic CRS
+CRS into which coordinates of a point on the surface of the Earth may change with time.
+ [Source: ISO 19111:2019, B.4.3]
+
 === ellipsoid
 __reference ellipsoid__
 

diff --git a/GeoTIFF_Standard/standard/clause_7_requirements.adoc b/GeoTIFF_Standard/standard/clause_7_requirements.adoc
@@ -311,3 +311,12 @@ include::requirements/Projection_Definition_Keys/requirements_class_ProjAzimuthA
 include::requirements/Projection_Definition_Keys/requirements_class_ProjLinearParameters.adoc[]
 
 include::requirements/Projection_Definition_Keys/requirements_class_ProjScalarParameters.adoc[]
+
+=== Requirements for dynamic CRS
+
+In a dynamic CRS, coordinates of a point on the surface of the Earth may change with time. To be unambiguous the coordinates must always be qualified with the epoch at which they are valid.
+
+The date at which coordinates are referenced to a dynamic coordinate reference system is expressed as a decimal year in the Gregorian calendar, and stored in the _CoordinateEpochGeoKey_.
+Example: 2017-03-25 in the Gregorian calendar is epoch 2017.23.
+
+include::requirements/Dynamic_CRS_GeoKey/requirements_class_CoordinateEpochGeoKey.adoc[]
diff --git a/...d/requirements/Dynamic_CRS_GeoKey/requirements_class_CoordinateEpochGeoKey.adoc b/...d/requirements/Dynamic_CRS_GeoKey/requirements_class_CoordinateEpochGeoKey.adoc
@@ -0,0 +1,16 @@
+[cols="1,4",width="90%"]
+|===
+2+|*Requirements Class 32.0: CoordinateEpochGeoKey* {set:cellbgcolor:#CACCCE}
+2+|http://www.opengis.net/spec/GeoTIFF/1.2/req/CoordinateEpochGeoKey
+{set:cellbgcolor:#FFFFFF}
+
+|Requirement 32.1 {set:cellbgcolor:#CACCCE}
+|http://www.opengis.net/spec/GeoTIFF/1.2/req/CoordinateEpochGeoKey.ID +
+_The CoordinateEpochGeoKey SHALL have ID = 5120_
+{set:cellbgcolor:#FFFFFF}
+
+|Requirement 32.2 {set:cellbgcolor:#CACCCE}
+|http://www.opengis.net/spec/GeoTIFF/1.2/req/CoordinateEpochGeoKey.type +
+_The CoordinateEpochGeoKey SHALL have type = DOUBLE_
+{set:cellbgcolor:#FFFFFF}
+|===