From 8315cb92f1776d7f67de9b22f37d4cd273cedc70 Mon Sep 17 00:00:00 2001 From: Chris Holmes Date: Sun, 16 Jun 2024 18:03:39 -0700 Subject: [PATCH 1/4] added filemetadata requirements --- format-specs/requirements/requirement-fm.adoc | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 format-specs/requirements/requirement-fm.adoc diff --git a/format-specs/requirements/requirement-fm.adoc b/format-specs/requirements/requirement-fm.adoc new file mode 100644 index 0000000..b320089 --- /dev/null +++ b/format-specs/requirements/requirement-fm.adoc @@ -0,0 +1,7 @@ +[requirement] +==== +[%metadata] +identifier:: /req/core/filemetadata +part:: A GeoParquet file SHALL contain an appropriate value in the "version" key in the file metadata to indicate its version. +part:: The "primary_column" key SHALL be present in the file metadata, and its value MUST be a string that matches one of the column metadata keys. +==== \ No newline at end of file From 79ae5fca045f3f894d0efec79c0864517dc2c85a Mon Sep 17 00:00:00 2001 From: Chris Holmes Date: Sun, 16 Jun 2024 18:19:32 -0700 Subject: [PATCH 2/4] more on req 1, added column metadata requirement --- format-specs/requirements/requirement-cm.adoc | 6 ++++++ format-specs/requirements/requirement001.adoc | 2 ++ 2 files changed, 8 insertions(+) create mode 100644 format-specs/requirements/requirement-cm.adoc diff --git a/format-specs/requirements/requirement-cm.adoc b/format-specs/requirements/requirement-cm.adoc new file mode 100644 index 0000000..f47e1d6 --- /dev/null +++ b/format-specs/requirements/requirement-cm.adoc @@ -0,0 +1,6 @@ +[requirement] +==== +[%metadata] +identifier:: /req/core/columnmetadata +part:: Each geometry column in the dataset SHALL have an entry in the "columns" object, and the key of the object MUST have the same name as the geometry column in the dataset. +==== \ No newline at end of file diff --git a/format-specs/requirements/requirement001.adoc b/format-specs/requirements/requirement001.adoc index 4efd1a8..eba6a8a 100644 --- a/format-specs/requirements/requirement001.adoc +++ b/format-specs/requirements/requirement001.adoc @@ -2,6 +2,8 @@ ==== [%metadata] identifier:: /req/core/geometry-columns +part:: Each column metadata object MUST include a valid "encoding" string. +part:: For this version of the GeoParquet specification the value of the encoding string MUST be "WKB". part:: Geometry columns SHALL be stored using the BYTE_ARRAY parquet type. part:: Geometries SHALL be encoded as https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary[Well Known Binary (WKB)]. ==== From fdbd01c77b7f2df0df47d4743005fb1e859d6714 Mon Sep 17 00:00:00 2001 From: Chris Holmes Date: Sun, 16 Jun 2024 18:22:53 -0700 Subject: [PATCH 3/4] more clarifications on wkb --- format-specs/requirements/requirement001.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/format-specs/requirements/requirement001.adoc b/format-specs/requirements/requirement001.adoc index eba6a8a..ceaa4fc 100644 --- a/format-specs/requirements/requirement001.adoc +++ b/format-specs/requirements/requirement001.adoc @@ -4,6 +4,6 @@ identifier:: /req/core/geometry-columns part:: Each column metadata object MUST include a valid "encoding" string. part:: For this version of the GeoParquet specification the value of the encoding string MUST be "WKB". -part:: Geometry columns SHALL be stored using the BYTE_ARRAY parquet type. -part:: Geometries SHALL be encoded as https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary[Well Known Binary (WKB)]. +part:: Geometry columns with "WKB" as the encoding SHALL be stored using the BYTE_ARRAY parquet type. +part:: Geometries in geometry columns with "WKB" as the encoding SHALL be encoded as https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary[Well Known Binary (WKB)]. ==== From fe68d2288104044f0935d59ec2c0d2399526f1e3 Mon Sep 17 00:00:00 2001 From: Chris Holmes Date: Mon, 17 Jun 2024 19:37:00 -0700 Subject: [PATCH 4/4] added geometry types requirements --- format-specs/requirements/requirements009.adoc | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 format-specs/requirements/requirements009.adoc diff --git a/format-specs/requirements/requirements009.adoc b/format-specs/requirements/requirements009.adoc new file mode 100644 index 0000000..f5395a1 --- /dev/null +++ b/format-specs/requirements/requirements009.adoc @@ -0,0 +1,8 @@ +[requirement] +==== +[%metadata] +identifier:: /req/core/geoemtrytypes +part:: Every geometry column metadata object must include a "geometry_types" list. +part:: All geometry types that are present in the file MUST be included in the "geometry_types" metadata, if the geometry_types list is not empty. +part:: If the geometry types are not known then the geometry_types list MUST be empty. +====