stichting-crow/demo-beheerpakket-linked-data

Voorbeeldimplementatie van software die werkt op basis van NEN 2660-2:2022, zoals IMBOR

Demo Beheerpakket Linked Data

Voorbeeldimplementatie van software die werkt op basis van NEN 2660-2:2022.

Introductie

CROW is de initiator van dit project. De insteek was:

"Maak een Proof of Concept dat aantoont dat het gemakkelijk is om een beheerpakket te maken voor het beheren van op NEN2660-2 gebaseerde ontologieen.

Oftewel:

• Een (areaal)beheerpakket
• Voor het beheren van objecten + attributen
• Gebruik van NEN2660-2 LinkedData ontologie
• Eenvoudige uitwerking: Proof of Concept

Over IMBOR

CROW beheert het IMBOR.

Het IMBOR uniformeert begrippen voor het vakgebied 'beheer openbare ruimte'.

Over NEN2660-2

De NEN2660-2 standaardiseert het maken van ontologieën: informatie rondom de gebouwde omgeving kan hiermee worden vastgelegd en gedeeld.

Voordelen gebruik NEN2660-2

Nu: elk softwarepakket maakt een systeem voor het vastleggen van een 'Boom' of 'Afvalbak'.

Toekomst: softwarepakket legt geen 'Boom' meer vast, maar enkel nog klassen uit de NEN2660-2.

Voordelen:

• Automatisch de actuele lijst van objecten en attributen:
  softwarepakket wordt gevuld met de IMBOR-ontologie
• Minder werk, minder opslag nodig
• Software minder vaak aanpassen

Demo

» Bekijk de demo

Screenshots

Kaart met alle objecten:

Voeg een nieuw objecttype toe:

Vul de attributen in:

De applicatie gebruiken als ontwikkelaar

Deze sectie geeft informatie over het op je computer starten van de applicatie. Als je de applicatie wilt zien en testen kun je ook gebruik maken van de online versie op docs.crow.nl/demo-beheerpakket-linked-data.

Benodigdheden

Clone de repository:

git clone https://github.com/Stichting-CROW/demo-beheerpakket-linked-data.git
cd demo-beheerpakket-linked-data

Stel de API token in:

• Dupliceer .env.example en geef dit duplicaat de bestandsnaam .env
• Configureer de REACT_APP_IMBOR_TOKEN variabele

Beschikbare scripts

npm install

Installeert alle afhankelijkheden. Dit is verplicht voordat je de applicatie voor de eerste keer start.

npm start

Start de app in ontwikkelingsmodus.

Als je naar http://localhost:3000 gaat zie je de webapplicatie in je browser.

De site herlaadt automatisch als je wijzigingen in de code aanbrengt.

npm run deploy

Plaatst een nieuwe versie online.

De applicatie zal worden gebouwd en geupload naar GitHub Pages. De online geplaatste applicatie verschijnt op docs.crow.nl/demo-beheerpakket-linked-data.

Meer leren?

Dit project is gemaakt met Create React App.

• Create React App documentatie.
• React documentatie.

Voor het bevragen van de triple store gebruiken we SPARQL.

• SPARQL By Example

Voor het bevragen van IMBOR kunnen we de volgende bronnen gebruiken:

• https://hub.laces.tech/crow/imbor/2022/p/vocabulaire
• https://hub.laces.tech/crow/imbor/2022/p/kern
• https://hub.laces.tech/crow/imbor/2022/p/domeinwaarden
• https://hub.laces.tech/crow/imbor/2022/p/informatief
• https://hub.laces.tech/crow/imbor/2022/p/aanvullend-metamodel

Documentatie over hoe te authenticeren op de Laces Hub:

• Laces Hub authentication

De IMBOR ontologie verkennen:

• IMBOR Onto Verkenner

Note to self

GitHub Pages: y is not defined

Er was het probleem dat GitHub Pages een foutmelding gaf: y is not defined. Dit is opgelost met deze oplossing.

demo-beheerpakket-linked-data's Issues

Interne representatie van een `nen2660:RealObject`/`nen2660:SpatialRegion`

Met een snelle blik op NEN 2660-2 (check @RiX012), lijkt me dit een OOP weergave in je localStorage/in-mem van wat een instantie van een nen2660:PhysicalObject zou zijn,

Het is in TypeScript vanwege de generics, zou je ook in de broncode zelf met JSDoc Type Annotations kunnen doen. Of met een .d.ts bestand.

// Voorbeelddefinities
type URL = string;
type Geometry = string;
type Literal = string | boolean | number | any;

class AttributeRelationValue<T extends Literal | URL> {
  /** Verwijst naar IMBOR (of andere ontologie), wel stabiel */
  type: URL; //
  /** Bij relaties een URL, bij attributen een Literal */
  value: T; //
  /** Misschien niet nodig? t.b.v. datums die als strings worden geserialiseerd */
  jsType?: string; //
}

class Individual {
  /** PK van het individuele object, hoeft niet een URL te zijn. */
  id: any;
  /** Verwijst naar IMBOR (of andere ontologie), wel stabiel in IMBOR, zoals "Boom". */
  type: URL; //
  // label: string; description: string; // label van type komt uit IMBOR (niet stabiel), eigen naam bij this.annotations
  /** Opslag van geometrie, maar kan ook in this.attributes */
  geometry: Geometry; //
  /** Lijst van attributen, zoals "snoeifrequentie" */
  attributes?: AttributeRelationValue<Literal>[]; //
  /** Lijst van relaties, zoals nen2660:hasPart. */
  relations?: AttributeRelationValue<URL>[]; //
  /** Lijst van annotaties, voor bijvoorbeeld skos:prefLabel en skos:description. */
  annotations?: AttributeRelationValue<Literal>[];
}

Vreemde optimalisatie in queries naar SPARQL-endpoint

Wanneer deze query uitgevoerd wordt is de response tijd bijna 20 seconden:

PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
PREFIX dash: <http://datashapes.org/dash#>
PREFIX sh: <http://www.w3.org/ns/shacl#>
PREFIX nen2660: <https://w3id.org/nen2660/def#>

SELECT ?attributeURI ?attributeLabel ?attributeDefinition
WHERE {
    <https://data.crow.nl/imbor/def/fdcbc153-9b5c-4109-a947-774885056cd5> rdfs:subClassOf* ?superClass .
   ?superClass sh:property/sh:path ?attributeURI .
    OPTIONAL { ?attributeURI skos:prefLabel ?attributeLabel . }
    OPTIONAL { ?attributeURI skos:definition ?attributeDefinition . }
    OPTIONAL{ ?attribuut nen2660:hasQuantityKind/skos:prefLabel ?attributQuantityKind . }

}

Wanneer de eerste triple helemaal naar achter geschoven wordt is de response tijd minder dan 2 seconden.

PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
PREFIX dash: <http://datashapes.org/dash#>
PREFIX sh: <http://www.w3.org/ns/shacl#>
PREFIX nen2660: <https://w3id.org/nen2660/def#>

SELECT ?attributeURI ?attributeLabel ?attributeDefinition
WHERE {
   ?superClass sh:property/sh:path ?attributeURI .
    OPTIONAL { ?attributeURI skos:prefLabel ?attributeLabel . }
    OPTIONAL { ?attributeURI skos:definition ?attributeDefinition . }
    OPTIONAL{ ?attribuut nen2660:hasQuantityKind/skos:prefLabel ?attributQuantityKind . }
    <https://data.crow.nl/imbor/def/fdcbc153-9b5c-4109-a947-774885056cd5> rdfs:subClassOf* ?superClass .
}

@bartwr De oorzaak weten we nog niet, maar dit kun je gebruiken in je GUI queries.