From 4c35928b33ba7eb1058ccb86eabfed3da73b7dc8 Mon Sep 17 00:00:00 2001 From: shirly-stephen Date: Thu, 12 Sep 2024 09:20:39 -0700 Subject: [PATCH 1/2] page for s2 implementation --- _sidebar.md | 1 + s2-implementationmd.md | 3 +++ 2 files changed, 4 insertions(+) create mode 100644 s2-implementationmd.md diff --git a/_sidebar.md b/_sidebar.md index 1a49e37..810abf3 100644 --- a/_sidebar.md +++ b/_sidebar.md @@ -2,6 +2,7 @@ * [Home](./README.md) * [Data Schema/Ontology](ontology.md) +* [S2 Implementation](s2-implementation.md) * [Downloading Data](sparql-download.md) * [Walkthrough](./data-download-walkthrough.md) * [Downloading Bulk Data](./bulk-download.md) diff --git a/s2-implementationmd.md b/s2-implementationmd.md new file mode 100644 index 0000000..33d5621 --- /dev/null +++ b/s2-implementationmd.md @@ -0,0 +1,3 @@ +# S2 Implementation +Documentation for S2 Implementation in KWG + From 97d439e7b459c9ff87a941deb91762788dbabc99 Mon Sep 17 00:00:00 2001 From: ThomasThelen Date: Thu, 12 Sep 2024 09:31:05 -0700 Subject: [PATCH 2/2] Rename to integration and add background --- _sidebar.md | 2 +- s2-implementationmd.md | 3 --- s2-integration.md | 7 +++++++ 3 files changed, 8 insertions(+), 4 deletions(-) delete mode 100644 s2-implementationmd.md create mode 100644 s2-integration.md diff --git a/_sidebar.md b/_sidebar.md index 810abf3..60b577f 100644 --- a/_sidebar.md +++ b/_sidebar.md @@ -2,7 +2,7 @@ * [Home](./README.md) * [Data Schema/Ontology](ontology.md) -* [S2 Implementation](s2-implementation.md) +* [S2 Integration](s2-implementation.md) * [Downloading Data](sparql-download.md) * [Walkthrough](./data-download-walkthrough.md) * [Downloading Bulk Data](./bulk-download.md) diff --git a/s2-implementationmd.md b/s2-implementationmd.md deleted file mode 100644 index 33d5621..0000000 --- a/s2-implementationmd.md +++ /dev/null @@ -1,3 +0,0 @@ -# S2 Implementation -Documentation for S2 Implementation in KWG - diff --git a/s2-integration.md b/s2-integration.md new file mode 100644 index 0000000..fdaa9e2 --- /dev/null +++ b/s2-integration.md @@ -0,0 +1,7 @@ +# S2 Integration + +KnowWhereGraph uses the [S2 system](http://s2geometry.io/) for a global grid structure. This allows for a structure where [RCC](https://en.wikipedia.org/wiki/Region_connection_calculus) relations can be used to locate things within, between, overlapping, etc cells. The process of forming these relation with custom geometries is what we refer to as *integration*. + +## Integrating Your Data + +We provide a [tool](https://github.com/KnowWhereGraph/s2-coverings) for both generating s2 cell geometries and integrating custom geometries with them. It's generally un-necessary to generate your own S2 cells because they've been generated and exist within KnowWhereGraph - and the relations can be formed in relation to those.