update documentation

code/README.md

@@ -0,0 +1,3 @@
+De alignment die hier gemaakt is is een experiment; IMBOR en GWSW moeten deze nog formaliseren
+
+

code/alignment.ttl

@@ -0,0 +1,49 @@
+@prefix rdf:                <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix rdfs:               <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix owl:                <http://www.w3.org/2002/07/owl#> .
+@prefix sh:                 <http://www.w3.org/ns/shacl#> .
+@prefix xsd:                <http://www.w3.org/2001/XMLSchema#> .
+@prefix skos:               <http://www.w3.org/2004/02/skos/core#> .
+@prefix dct:                <http://purl.org/dc/terms/> .
+@prefix imbor:              <https://data.crow.nl/imbor/def/> .
+@prefix imbor-term:         <https://data.crow.nl/imbor/term/> .
+@prefix imbor-domeinwaarde: <https://data.crow.nl/imbor/id/domeinwaarden/> .
+@prefix gwsw:               <http://data.gwsw.nl/1.5/totaal/> .
+@prefix void:               <http://rdfs.org/ns/void#> .
+@prefix align:              <http://knowledgeweb.semanticweb.org/heterogeneity/alignment#> .
+@prefix edoal:              <http://ns.inria.org/edoal/1.0/> .
+
+gwsw:
+        a                void:Dataset ;
+        void:feature    <http://www.w3.org/ns/formats/Turtle> ;
+        .
+
+imbor:
+        a               void:Dataset ;
+        void:feature    <http://www.w3.org/ns/formats/Turtle> ;
+        align:location  "file:ex_ont_imbor.ttl" ;
+        .
+
+:imbor_gwsw
+        a               void:Linkset ;
+        void:feature    <http://www.w3.org/ns/formats/Turtle> ;
+        owl:versionInfo "0.1"@nl ;
+        dct:title       "IMBOR en GWSW ontologie mapping"@nl ;
+        dct:description "Handmatige voorbeeld mapping van de twee kernmodellen o.b.v. expert judgement"@nl ;
+        dct:publisher   "Stichting CROW"@nl ;
+        dct:date        "2023-10-11"^^xsd:date;
+        void:target     imbor: ;
+        void:target     gwsw: ;
+        .
+
+gwsw:Begindatum 
+    owl:equivalentProperty
+imbor:534f07b8-9243-4848-a3d0-6ebeb321784c .
+
+gwsw:uri
+    owl:equivalentProperty
+imbor:5f430c8d-7503-4a69-9e2f-f0b6e6c7f54e .
+
+
+
+

docs/architectuurframework/h/1-inleiding.md

@@ -74,6 +74,7 @@ In eerste instantie was een aanpak geformuleerd, waarbij met databeheerders zou
 * Relaties gelegd tussen de gebruikte informatiemodellen 
 * Laten zien dat je door deze relaties queries kan uitvoeren over meerdere datasets
 
+Daarmee wordt getoont hoe handig het is, als datasets in linked data staan en de onderliggende informatiemodellen met elkaar verbonden zijn. 
 
 
 ## Leeswijzer
@@ -84,4 +85,6 @@ Dit document beschrijft de volgende zaken:
 
 **4. Technische uitgangspunten** beschrijft de technische uitgangspunten en eisen aan de informatiemodellen en andere datastandaarden die gebruikt worden in de boven- en ondergrondse openbare ruimte.
 
+**5. Showcase** beschrijft de activiteiten die uitgevoerd zijn om te komen tot een showcase. 
+
 **5. Aanbevelingen** In Aanbevelingen wordt een roadmap voor ontwikkeling van de datastandaarden in samenhang gegeven en worden randvoorwaarden beschreven voor de manier waarop de oplossingsrichtingen worden uitgewerkt samen met beheerders van standaarden en in interactie met gebruikers. 

docs/architectuurframework/h/5-showcase

@@ -0,0 +1,51 @@
+# Showcase
+
+
+## Inleiding
+CROW heeft een showcase gemaakt voor het verbinden van datastandaarden in de ondergrond met datasets van gemeente Amsterdam en samenwerkpartners. Uitgevoerde activiteiten:
+
+* Datasets vanuit GIS transformeren naar linked data
+* Relaties leggen tussen de gebruikte informatiemodellen 
+* Laten zien dat je door deze relaties queries kan uitvoeren over meerdere datasets.
+
+Daarmee wordt aangetoond hoe handig het is, als datasets in linked data staan en de onderliggende informatiemodellen met elkaar verbonden zijn. 
+
+## Samenstellen representatieve dataset
+
+Als eerste zijn de aangeleverde bronbestanden omgezet naar een representatieve dataset:
+
+* Hiervoor zijn alle aangeleverde bronsets in één Geopackage gezet
+* Daarvan is doormiddel van een uitsnede een representatieve dataset gemaakt.
+
+Deze datasets zijn niet open beschikbaar. Wel is er een screenshot gemaakt om een idee te geven.
+
+<figure>
+<img src="./h/media/Screenshot 2023-10-13 155615.png" alt="Een screenshot van eenb GIS kaart met de representatieve dataset (het gebied en de lagen)">
+<figcaption>Een screenshot van de representatieve dataset (het gebied en de lagen)</caption>
+</figure> 
+
+## Geopackage naar rdf
+Met behulp van [deze open source software](https://github.com/redmer/rdf-geopackage) zijn de Geopackages op een standaard manier omgezet naar RDF waar je vervolgens in kan zoeken met behulp van SPARQL-queries. 
+
+
+Met deze tool kan vanuit een GeoPackage zeer platte (generieke) linked data worden gegenereerd. Rijen uit featuretabellen worden geo:Features met arbitraire relaties en een geo:Geometry. Rijen uit niet-feature-tabellen worden geïnstantieerd met arbitraire eigenschappen.
+
+## Cureren van de dataset
+Op de RDF zijn SPARQL-queries geschreven die de set omzet naar een ‘gecureerde’ graaf. Ofwel het handmatig verrijken van features en properites:
+*	Met IMBOR en GWSW classificaties 
+*	Met NEN2660-2 als ontologie 
+
+
+## Alignment tussen standaarden
+
+Vervolgens is ten behoeve van dit project een [proef-'alignment’]() gemaakt tussen de standaarden
+* Door dit extra model worden bijvoorbeeld de relaties tussen GWSW en IMBOR klassen geformaliseerd, maar ook tussen GWSW en IMBOR eigenschappen
+* Deze alignment is een eerste opzet, die wordt vanuit het IMBOR en GWSW project geformaliseerd.
+
+
+
+## Resultaat
+Bovenstaande hebben we allemaal werkend, maar het moet nog ‘geschaald’ worden. Ofwel we hebben het nu voor een paar objecttypen en eigenschappen gedaan om te zien of het werk, maar we willen dit nog voor de hele representatie dataset doen. Dat is daarmee ook de volgende stap. 
+Na die stap kunnen we dus federatieve vragen stellen als: ‘geef me alles in dit gebied met een aanlegjaar na 1950’. We creeren dus volledig overzicht over de ‘silo's’ heen.
+
+

docs/architectuurframework/index.html

@@ -15,10 +15,10 @@
   <section id="abstract"       data-include-format="markdown" data-include="h/0-samenvatting.md"></section>
   <section id="sotd"></section>
   <section class="informative" data-include-format="markdown" data-include="h/1-inleiding.md"></section>
-  <section                     data-include-format="markdown" data-include="h/3-usecases.md"></section>
-  <section                     data-include-format="markdown" data-include="h/3-usecases-archive.md"></section>
-  <section                     data-include-format="markdown" data-include="h/4-technische-uitgangspunten.md"></section>
-  <section                     data-include-format="markdown" data-include="h/7-aanbevelingen.md"></section>  
+  <section class="informative"  data-include-format="markdown" data-include="h/3-usecases.md"></section>
+  <section class="informative"  data-include-format="markdown" data-include="h/4-technische-uitgangspunten.md"></section>
+  <section id="conformance"  data-include-format="markdown" data-include="h/5-showcase.md"></section> 
+  <section class="informative"  data-include-format="markdown" data-include="h/7-aanbevelingen.md"></section>  
   <section id="conformance"></section>
   <section id="index"></section>
 </body>