Putting rml:Strategy and rml:strategy back in the ontology #149 (#155)

* Removed Excel tmp file * Update rml-core.owl * Updated documentation * Create README.md to add documentation about Widoco
kg-construct · Jan 29, 2025 · 980ca11 · 980ca11
1 parent 88fe796
commit 980ca11
Show file tree

Hide file tree

Showing 14 changed files with 1,886 additions and 1,561 deletions.
diff --git a/ontology/README.md b/ontology/README.md
@@ -0,0 +1,5 @@
+# How to generate the documentation
+* Download and install [WIDOCO](https://github.com/dgarijo/Widoco/releases) in this folder. Make sure you do not commit the jar file.
+* Run the following command: `java -jar widoco.jar -ontFile rml-core.owl -outFolder tmp -crossRef`
+
+The only things that are generated are the overview and the cross reference sections. These are generated in the folder `./tmp/doc`. The `tmp` folder is ignored. If the generation was successful, move the contents of `./tmp/doc` to `./documentation`. 
diff --git a/ontology/documentation/ontology.jsonld b/ontology/documentation/ontology.jsonld
@@ -319,6 +319,19 @@
   "http://www.w3.org/2000/01/rdf-schema#label" : [ {
     "@value" : "Reference Formulation"
   } ]
+}, {
+  "@id" : "http://w3id.org/rml/Strategy",
+  "@type" : [ "http://www.w3.org/2002/07/owl#Class" ],
+  "http://www.w3.org/2000/01/rdf-schema#comment" : [ {
+    "@language" : "en",
+    "@value" : "Denotes a strategy to perform a action (e.g. gather for collections and containers, joins)."
+  } ],
+  "http://www.w3.org/2000/01/rdf-schema#isDefinedBy" : [ {
+    "@id" : "http://w3id.org/rml/core/"
+  } ],
+  "http://www.w3.org/2000/01/rdf-schema#label" : [ {
+    "@value" : "Strategy"
+  } ]
 }, {
   "@id" : "http://w3id.org/rml/SubjectMap",
   "@type" : [ "http://www.w3.org/2002/07/owl#Class" ],
@@ -892,6 +905,22 @@
   "http://www.w3.org/2000/01/rdf-schema#range" : [ {
     "@id" : "http://w3id.org/rml/ReferenceFormulation"
   } ]
+}, {
+  "@id" : "http://w3id.org/rml/strategy",
+  "@type" : [ "http://www.w3.org/2002/07/owl#ObjectProperty" ],
+  "http://www.w3.org/2000/01/rdf-schema#comment" : [ {
+    "@language" : "en",
+    "@value" : "A Strategy element to indicate how to perform an action (e.g. gather for collections and containers, join)."
+  } ],
+  "http://www.w3.org/2000/01/rdf-schema#isDefinedBy" : [ {
+    "@id" : "http://w3id.org/rml/core/"
+  } ],
+  "http://www.w3.org/2000/01/rdf-schema#label" : [ {
+    "@value" : "strategy"
+  } ],
+  "http://www.w3.org/2000/01/rdf-schema#range" : [ {
+    "@id" : "http://w3id.org/rml/Strategy"
+  } ]
 }, {
   "@id" : "http://w3id.org/rml/subject",
   "@type" : [ "http://www.w3.org/2002/07/owl#ObjectProperty" ],

diff --git a/ontology/documentation/ontology.nt b/ontology/documentation/ontology.nt
@@ -243,6 +243,13 @@ _:genid4 <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://www.w3.org/20
 <http://w3id.org/rml/referenceFormulation> <http://www.w3.org/2000/01/rdf-schema#isDefinedBy> <http://w3id.org/rml/core/> .
 <http://w3id.org/rml/referenceFormulation> <http://www.w3.org/2000/01/rdf-schema#label> "reference formulation" .
 # 
+# http://w3id.org/rml/strategy
+<http://w3id.org/rml/strategy> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://www.w3.org/2002/07/owl#ObjectProperty> .
+<http://w3id.org/rml/strategy> <http://www.w3.org/2000/01/rdf-schema#range> <http://w3id.org/rml/Strategy> .
+<http://w3id.org/rml/strategy> <http://www.w3.org/2000/01/rdf-schema#comment> "A Strategy element to indicate how to perform an action (e.g. gather for collections and containers, join)."@en .
+<http://w3id.org/rml/strategy> <http://www.w3.org/2000/01/rdf-schema#isDefinedBy> <http://w3id.org/rml/core/> .
+<http://w3id.org/rml/strategy> <http://www.w3.org/2000/01/rdf-schema#label> "strategy" .
+# 
 # http://w3id.org/rml/subject
 <http://w3id.org/rml/subject> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://www.w3.org/2002/07/owl#ObjectProperty> .
 <http://w3id.org/rml/subject> <http://www.w3.org/2000/01/rdf-schema#domain> <http://w3id.org/rml/TriplesMap> .
@@ -462,6 +469,12 @@ _:genid7 <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://www.w3.org/20
 <http://w3id.org/rml/ReferenceFormulation> <http://www.w3.org/2000/01/rdf-schema#isDefinedBy> <http://w3id.org/rml/core/> .
 <http://w3id.org/rml/ReferenceFormulation> <http://www.w3.org/2000/01/rdf-schema#label> "Reference Formulation" .
 # 
+# http://w3id.org/rml/Strategy
+<http://w3id.org/rml/Strategy> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://www.w3.org/2002/07/owl#Class> .
+<http://w3id.org/rml/Strategy> <http://www.w3.org/2000/01/rdf-schema#comment> "Denotes a strategy to perform a action (e.g. gather for collections and containers, joins)."@en .
+<http://w3id.org/rml/Strategy> <http://www.w3.org/2000/01/rdf-schema#isDefinedBy> <http://w3id.org/rml/core/> .
+<http://w3id.org/rml/Strategy> <http://www.w3.org/2000/01/rdf-schema#label> "Strategy" .
+# 
 # http://w3id.org/rml/SubjectMap
 <http://w3id.org/rml/SubjectMap> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://www.w3.org/2002/07/owl#Class> .
 <http://w3id.org/rml/SubjectMap> <http://www.w3.org/2000/01/rdf-schema#subClassOf> <http://w3id.org/rml/TermMap> .

diff --git a/ontology/documentation/ontology.rdf b/ontology/documentation/ontology.rdf
@@ -311,40 +311,19 @@
 
     <owl:ObjectProperty rdf:about="http://w3id.org/rml/logicalSource">
         <rdfs:domain rdf:resource="http://w3id.org/rml/TriplesMap"/>
-        <rdfs:range rdf:resource="http://w3id.org/rml/LogicalSource"/>
+        <rdfs:range rdf:resource="http://w3id.org/rml/AbstractLogicalSource"/>
         <rdfs:comment xml:lang="en">Represents the logical source to be mapped.</rdfs:comment>
         <rdfs:isDefinedBy rdf:resource="http://w3id.org/rml/core/"/>
         <rdfs:label>logical source</rdfs:label>
     </owl:ObjectProperty>
 
 
 
-    <!-- http://w3id.org/rml/logicalTarget -->
-
-
-    <owl:ObjectProperty rdf:about="http://w3id.org/rml/logicalTarget">
-        <rdfs:domain>
-            <owl:Class>
-                <owl:unionOf rdf:parseType="Collection">
-                    <rdf:Description rdf:about="http://w3id.org/rml/LanguageMap"/>
-                    <rdf:Description rdf:about="http://w3id.org/rml/TermMap"/>
-                </owl:unionOf>
-            </owl:Class>
-        </rdfs:domain>
-        <rdfs:range rdf:resource="http://w3id.org/rml/LogicalTarget"/>
-        <rdfs:comment>Represents the logical target to where triples are exported to.</rdfs:comment>
-        <rdfs:isDefinedBy rdf:resource="http://w3id.org/rml/core/"/>
-        <rdfs:label>logical target</rdfs:label>
-    </owl:ObjectProperty>
-
-
-
     <!-- http://w3id.org/rml/object -->
 
 
     <owl:ObjectProperty rdf:about="http://w3id.org/rml/object">
         <rdfs:domain rdf:resource="http://w3id.org/rml/PredicateObjectMap"/>
-        <rdfs:range rdf:resource="http://www.w3.org/2000/01/rdf-schema#Resource"/>
         <rdfs:comment xml:lang="en">Specifies the object for the generated triple from the logical source record.</rdfs:comment>
         <rdfs:isDefinedBy rdf:resource="http://w3id.org/rml/core/"/>
         <rdfs:label>object</rdfs:label>
@@ -428,6 +407,31 @@
 
 
 
+    <!-- http://w3id.org/rml/referenceFormulation -->
+
+
+    <owl:ObjectProperty rdf:about="http://w3id.org/rml/referenceFormulation">
+        <rdfs:domain rdf:resource="http://w3id.org/rml/Iterable"/>
+        <rdfs:range rdf:resource="http://w3id.org/rml/ReferenceFormulation"/>
+        <rdfs:comment xml:lang="en">The reference formulation used to refer to extracts of the source data. </rdfs:comment>
+        <rdfs:isDefinedBy rdf:resource="http://w3id.org/rml/core/"/>
+        <rdfs:label>reference formulation</rdfs:label>
+    </owl:ObjectProperty>
+
+
+
+    <!-- http://w3id.org/rml/strategy -->
+
+
+    <owl:ObjectProperty rdf:about="http://w3id.org/rml/strategy">
+        <rdfs:range rdf:resource="http://w3id.org/rml/Strategy"/>
+        <rdfs:comment xml:lang="en">A Strategy element to indicate how to perform an action (e.g. gather for collections and containers, join).</rdfs:comment>
+        <rdfs:isDefinedBy rdf:resource="http://w3id.org/rml/core/"/>
+        <rdfs:label>strategy</rdfs:label>
+    </owl:ObjectProperty>
+
+
+
     <!-- http://w3id.org/rml/subject -->
 
 
@@ -502,6 +506,19 @@
 
 
 
+    <!-- http://w3id.org/rml/iterator -->
+
+
+    <owl:DatatypeProperty rdf:about="http://w3id.org/rml/iterator">
+        <rdfs:domain rdf:resource="http://w3id.org/rml/Iterable"/>
+        <rdfs:range rdf:resource="http://www.w3.org/2001/XMLSchema#string"/>
+        <rdfs:comment xml:lang="en">An expression qualified according to the reference formulation that defines a sequence of logical iterations on the data source.</rdfs:comment>
+        <rdfs:isDefinedBy rdf:resource="http://w3id.org/rml/core/"/>
+        <rdfs:label>iterator</rdfs:label>
+    </owl:DatatypeProperty>
+
+
+
     <!-- http://w3id.org/rml/language -->
 
 
@@ -566,6 +583,18 @@
 
 
 
+    <!-- http://w3id.org/rml/AbstractLogicalSource -->
+
+
+    <owl:Class rdf:about="http://w3id.org/rml/AbstractLogicalSource">
+        <rdfs:subClassOf rdf:resource="http://w3id.org/rml/Iterable"/>
+        <rdfs:comment xml:lang="en">An iterable that can be associated with a triples map such that a data source can be mapped to RDF triples.</rdfs:comment>
+        <rdfs:isDefinedBy rdf:resource="http://w3id.org/rml/core/"/>
+        <rdfs:label>Abstract Logical Source</rdfs:label>
+    </owl:Class>
+
+
+
     <!-- http://w3id.org/rml/BlankNode -->
 
 
@@ -635,6 +664,17 @@
 
 
 
+    <!-- http://w3id.org/rml/Iterable -->
+
+
+    <owl:Class rdf:about="http://w3id.org/rml/Iterable">
+        <rdfs:comment xml:lang="en">An abstract construct to describe data access and iteration for a data source.</rdfs:comment>
+        <rdfs:isDefinedBy rdf:resource="http://w3id.org/rml/core/"/>
+        <rdfs:label>Iterable</rdfs:label>
+    </owl:Class>
+
+
+
     <!-- http://w3id.org/rml/Join -->
 
 
@@ -669,20 +709,6 @@
 
 
 
-    <!-- http://w3id.org/rml/LogicalSource -->
-
-
-    <owl:Class rdf:about="http://w3id.org/rml/LogicalSource"/>
-
-
-
-    <!-- http://w3id.org/rml/LogicalTarget -->
-
-
-    <owl:Class rdf:about="http://w3id.org/rml/LogicalTarget"/>
-
-
-
     <!-- http://w3id.org/rml/ObjectMap -->
 
 
@@ -741,6 +767,28 @@
 
 
 
+    <!-- http://w3id.org/rml/ReferenceFormulation -->
+
+
+    <owl:Class rdf:about="http://w3id.org/rml/ReferenceFormulation">
+        <rdfs:comment xml:lang="en">Denotes a Reference Formulation.</rdfs:comment>
+        <rdfs:isDefinedBy rdf:resource="http://w3id.org/rml/core/"/>
+        <rdfs:label>Reference Formulation</rdfs:label>
+    </owl:Class>
+
+
+
+    <!-- http://w3id.org/rml/Strategy -->
+
+
+    <owl:Class rdf:about="http://w3id.org/rml/Strategy">
+        <rdfs:comment xml:lang="en">Denotes a strategy to perform a action (e.g. gather for collections and containers, joins).</rdfs:comment>
+        <rdfs:isDefinedBy rdf:resource="http://w3id.org/rml/core/"/>
+        <rdfs:label>Strategy</rdfs:label>
+    </owl:Class>
+
+
+
     <!-- http://w3id.org/rml/SubjectMap -->
 
 
@@ -813,13 +861,6 @@
 
 
     <owl:Class rdf:about="http://www.w3.org/2000/01/rdf-schema#Class"/>
-
-
-
-    <!-- http://www.w3.org/2000/01/rdf-schema#Resource -->
-
-
-    <owl:Class rdf:about="http://www.w3.org/2000/01/rdf-schema#Resource"/>
 </rdf:RDF>
 
 

diff --git a/ontology/documentation/ontology.ttl b/ontology/documentation/ontology.ttl
@@ -267,6 +267,14 @@
                                            rdfs:label "reference formulation" .
 
 
+###  http://w3id.org/rml/strategy
+<http://w3id.org/rml/strategy> rdf:type owl:ObjectProperty ;
+                               rdfs:range <http://w3id.org/rml/Strategy> ;
+                               rdfs:comment "A Strategy element to indicate how to perform an action (e.g. gather for collections and containers, join)."@en ;
+                               rdfs:isDefinedBy <http://w3id.org/rml/core/> ;
+                               rdfs:label "strategy" .
+
+
 ###  http://w3id.org/rml/subject
 <http://w3id.org/rml/subject> rdf:type owl:ObjectProperty ;
                               rdfs:domain <http://w3id.org/rml/TriplesMap> ;
@@ -490,6 +498,13 @@
                                            rdfs:label "Reference Formulation" .
 
 
+###  http://w3id.org/rml/Strategy
+<http://w3id.org/rml/Strategy> rdf:type owl:Class ;
+                               rdfs:comment "Denotes a strategy to perform a action (e.g. gather for collections and containers, joins)."@en ;
+                               rdfs:isDefinedBy <http://w3id.org/rml/core/> ;
+                               rdfs:label "Strategy" .
+
+
 ###  http://w3id.org/rml/SubjectMap
 <http://w3id.org/rml/SubjectMap> rdf:type owl:Class ;
                                  rdfs:subClassOf <http://w3id.org/rml/TermMap> ;