Skip to content

Commit

Permalink
fixing rml spec reference
Browse files Browse the repository at this point in the history
  • Loading branch information
@anaigmo
anaigmo committed Sep 12, 2023
1 parent 8c19a9b commit afe04f6
Show file tree
Hide file tree
Showing 2 changed files with 25 additions and 25 deletions.
16 changes: 8 additions & 8 deletions spec/dev.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -91,11 +91,11 @@
date: "17 December 2021",
},
"RML": {
title: "RDF Mapping Language",
href: "https://rml.io/specs/rml/",
status: "Unofficial draft",
publisher: "https://rml.io",
date: "06 October 2020",
title: "RDF Mapping Language - Core",
href: "https://w3id.org/rml/core/spec",
status: "Draft Community Group Report",
publisher: "https://w3id.org/rml/core/spec",
date: "30 June 2023",
},
"R2RML": {
title: "R2RML: RDB to RDF Mapping Language",
Expand Down Expand Up @@ -207,9 +207,9 @@
// !!!! IMPORTANT !!!! MAKE THE ABOVE BLINK IN YOUR HEAD
};
</script>



</head>
<body>
<section id='abstract' data-include="section/abstract.md" data-include-format="markdown"></section>
Expand Down
34 changes: 17 additions & 17 deletions spec/docs/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -209,11 +209,11 @@
"id": "rdf-star"
},
"RML": {
"title": "RDF Mapping Language",
"href": "https://rml.io/specs/rml/",
"status": "Unofficial draft",
"publisher": "https://rml.io",
"date": "06 October 2020",
"title": "RDF Mapping Language - Core",
"href": "https://w3id.org/core/spec/",
"status": "Draft Community Group Report",
"publisher": "https://www.w3.org/community/kg-construct/",
"date": "30 June 2023",
"id": "rml"
},
"R2RML": {
Expand Down Expand Up @@ -431,9 +431,9 @@ <h2>

<pre class="ex-output" aria-busy="false"><code class="hljs"># This box contains the example output</code></pre></section></section>

<section id="the-rml-star-vocabulary"><div class="header-wrapper"><h2 id="vocabulary"><bdi class="secno">3. </bdi>The RML-star vocabulary</h2><a class="self-link" href="#vocabulary" aria-label="Permalink for Section 3."></a></div><p>An <dfn data-lt="rml-star-mapping|RML-star mapping" data-plurals="rml-star mappings" id="dfn-rml-star-mapping" tabindex="0" aria-haspopup="dialog" data-dfn-type="dfn">RML-star mapping</dfn> defines a mapping from any data in a structured source format to RDF-star. It consists of one or more <a href="https://rml.io/specs/rml/#triples-map">Triples Maps</a> that can in turn contain Triples Maps within the subject or object. A Triples Map can be Asserted or Non Asserted, depending on whether the triples that they generate should be included in the output graph.</p>
<section id="the-rml-star-vocabulary"><div class="header-wrapper"><h2 id="vocabulary"><bdi class="secno">3. </bdi>The RML-star vocabulary</h2><a class="self-link" href="#vocabulary" aria-label="Permalink for Section 3."></a></div><p>An <dfn data-lt="rml-star-mapping|RML-star mapping" data-plurals="rml-star mappings" id="dfn-rml-star-mapping" tabindex="0" aria-haspopup="dialog" data-dfn-type="dfn">RML-star mapping</dfn> defines a mapping from any data in a structured source format to RDF-star. It consists of one or more <a href="https://w3id.org/core/spec/#triples-map">Triples Maps</a> that can in turn contain Triples Maps within the subject or object. A Triples Map can be Asserted or Non Asserted, depending on whether the triples that they generate should be included in the output graph.</p>
<p>The input to an RML-star mapping is called input data source. The output of an RML-star mapping is called output dataset.</p>
<p>The output dataset of an RML-star mapping is an RDF-star dataset that contains the generated <a href="https://www.w3.org/2021/12/rdf-star.html#dfn-triple">RDF-star triples</a> for each of the <a href="https://rml.io/specs/rml/#triples-map">Triples Maps</a> in the RML-star mapping. An <a data-link-type="dfn|abstract-op" href="#dfn-rml-star-processors" class="internalDFN" id="ref-for-dfn-rml-star-processors-1">RML-star processor</a> may provide additional triples or graphs.</p>
<p>The output dataset of an RML-star mapping is an RDF-star dataset that contains the generated <a href="https://www.w3.org/2021/12/rdf-star.html#dfn-triple">RDF-star triples</a> for each of the <a href="https://w3id.org/core/spec/#triples-map">Triples Maps</a> in the RML-star mapping. An <a data-link-type="dfn|abstract-op" href="#dfn-rml-star-processors" class="internalDFN" id="ref-for-dfn-rml-star-processors-1">RML-star processor</a> may provide additional triples or graphs.</p>
<p>As in RML, conforming <dfn data-lt="rml-star-processors|RML-star processors" data-plurals="rml-star processor" id="dfn-rml-star-processors" tabindex="0" aria-haspopup="dialog" data-dfn-type="dfn">RML-star processors</dfn> may rename blank nodes when providing access to the output dataset.</p>
<p>An <a data-link-type="dfn|abstract-op" href="#dfn-rml-star-processors" class="internalDFN" id="ref-for-dfn-rml-star-processors-2">RML-star processor</a> has access to one of the followings:</p>
<ul>
Expand Down Expand Up @@ -507,11 +507,11 @@ <h2>
<figcaption><a class="self-link" href="#fig-to-enable-the-generation-of-rdf-star-graphs-rml-star-adds-three-classes-and-one-object-property-to-the-rml-ontology">Figure <bdi class="figno">1</bdi></a> <span class="fig-title">To enable the generation of RDF-star graphs, RML-star adds three classes and one object property to the RML ontology.</span></figcaption>
</figure></section></section>

<section id="generating-quoted-triples-with-rml-star"><div class="header-wrapper"><h2 id="quoted"><bdi class="secno">4. </bdi>Generating quoted triples with RML-star</h2><a class="self-link" href="#quoted" aria-label="Permalink for Section 4."></a></div><p>A <dfn data-plurals="star maps" id="dfn-star-map" tabindex="0" aria-haspopup="dialog" data-dfn-type="dfn">Star Map</dfn> (<code>rml:StarMap</code>) is similar to a <a href="https://rml.io/specs/rml/#term-map">term map</a> that generates <a href="https://www.w3.org/2021/12/rdf-star.html#dfn-quoted">quoted triples</a>.
<section id="generating-quoted-triples-with-rml-star"><div class="header-wrapper"><h2 id="quoted"><bdi class="secno">4. </bdi>Generating quoted triples with RML-star</h2><a class="self-link" href="#quoted" aria-label="Permalink for Section 4."></a></div><p>A <dfn data-plurals="star maps" id="dfn-star-map" tabindex="0" aria-haspopup="dialog" data-dfn-type="dfn">Star Map</dfn> (<code>rml:StarMap</code>) is similar to a <a href="https://w3id.org/core/spec/#term-map">term map</a> that generates <a href="https://www.w3.org/2021/12/rdf-star.html#dfn-quoted">quoted triples</a>.
It can be used within Subject or Object Maps.
A Star Map is linked to a <a href="https://rml.io/specs/rml/#triples-map">Triples Map</a> by the <dfn id="dfn-quoted-triples-map" tabindex="0" aria-haspopup="dialog" data-dfn-type="dfn">quoted Triples Map</dfn> property (<code>rml:quotedTriplesMap</code>).
A Star Map is linked to a <a href="https://w3id.org/core/spec/#triples-map">Triples Map</a> by the <dfn id="dfn-quoted-triples-map" tabindex="0" aria-haspopup="dialog" data-dfn-type="dfn">quoted Triples Map</dfn> property (<code>rml:quotedTriplesMap</code>).
The <a href="https://www.w3.org/2021/12/rdf-star.html#dfn-quoted">quoted triples</a> generated by a <a data-link-type="dfn|abstract-op" href="#dfn-star-map" class="internalDFN" id="ref-for-dfn-star-map-1">Star Map</a> are exactly those triples generated by its <a data-link-type="dfn|abstract-op" href="#dfn-quoted-triples-map" class="internalDFN" id="ref-for-dfn-quoted-triples-map-1">quoted Triples Map</a>.
If a Star Map has the same <a href="https://rml.io/specs/rml/#logical-source">logical source</a> as its <a data-link-type="dfn|abstract-op" href="#dfn-quoted-triples-map" class="internalDFN" id="ref-for-dfn-quoted-triples-map-2">quoted Triples Map</a>, then for each <a href="https://rml.io/specs/rml/#iterator">logical iteration</a>, the <a href="https://www.w3.org/2021/12/rdf-star.html#dfn-quoted">quoted triples</a> generated by a Star Map are those triples generated by its <a data-link-type="dfn|abstract-op" href="#dfn-quoted-triples-map" class="internalDFN" id="ref-for-dfn-quoted-triples-map-3">quoted Triples Map</a> <em>for the same logical iteration</em>.
If a Star Map has the same <a href="https://w3id.org/core/spec/#logical-source">logical source</a> as its <a data-link-type="dfn|abstract-op" href="#dfn-quoted-triples-map" class="internalDFN" id="ref-for-dfn-quoted-triples-map-2">quoted Triples Map</a>, then for each <a href="https://w3id.org/core/spec/#iterator">logical iteration</a>, the <a href="https://www.w3.org/2021/12/rdf-star.html#dfn-quoted">quoted triples</a> generated by a Star Map are those triples generated by its <a data-link-type="dfn|abstract-op" href="#dfn-quoted-triples-map" class="internalDFN" id="ref-for-dfn-quoted-triples-map-3">quoted Triples Map</a> <em>for the same logical iteration</em>.
If a Star Map has a different logical source than its quoted Triples Map then a join is used, as described in <a href="#join">the next section</a>.</p>
<p>In the following example, for each logical iteration (i.e., each CSV row) a "type" triple is generated by <code>&lt;#innerTriplesMap&gt;</code> that occurs
in the resulting graph both as an asserted and as a quoted triple:</p>
Expand Down Expand Up @@ -655,11 +655,11 @@ <h2>
<p>It should be noted that Non Asserted Triples Maps that are not quoted do not generate any triple. For this reason, the use of <code>rml:NonAssertedTriplesMap</code> <strong>without</strong> <code>rml:StarMap</code> <strong>is not allowed</strong>. <code>rml:NonAssertedTriplesMap</code> must always be called with <code>rml:quotedTriplesMap</code>.</p>
</section>

<section id="generating-quoted-triples-from-multiple-sources"><div class="header-wrapper"><h2 id="join"><bdi class="secno">5. </bdi>Generating quoted triples from multiple sources</h2><a class="self-link" href="#join" aria-label="Permalink for Section 5."></a></div><p>RML-star can create RDF-star triples from multiple <a href="https://rml.io/specs/rml/#logical-source">logical sources</a>.
When creating RDF-star triples from multiple <a href="https://rml.io/specs/rml/#logical-source">logical sources</a>, <a href="https://rml.io/specs/rml/#join-condition">join conditions</a> are used, just like when using <a href="https://rml.io/specs/rml/#referencing-object-map">referencing object maps</a> in RML.</p>
<p>If a <a data-link-type="dfn|abstract-op" href="#dfn-star-map" class="internalDFN" id="ref-for-dfn-star-map-5">star map</a> has a <a href="https://rml.io/specs/rml/#join-condition">join condition</a>, it generates <a href="https://www.w3.org/2021/12/rdf-star.html#dfn-quoted">quoted triples</a> as follows. Each combination of iterations, i.e., the <a href="https://en.wikipedia.org/wiki/Cartesian_product">Cartesian product</a>, from the <em>child source</em> and the <em>parent source</em> is looked at. Here, we consider as child source the <a href="https://rml.io/specs/rml/#logical-source">logical source</a> of the <a href="https://rml.io/specs/rml/#triples-map">Triples Map</a> in which the star map occurs, and as parent source the logical source of the star map's <a data-link-type="dfn|abstract-op" href="#dfn-quoted-triples-map" class="internalDFN" id="ref-for-dfn-quoted-triples-map-4">Quoted Triples Map</a>. A star map only generates quoted triples for combinations in which the join condition holds true. As is the case when <a href="https://rml.io/specs/rml/#logical-join">join conditions are used in in referencing object maps</a>, a join condition checks for equality of the <a href="https://rml.io/specs/rml/#reference-value">reference values</a> of the <a href="https://rml.io/specs/rml/#child-reference">child</a>/<a href="https://rml.io/specs/rml/#parent-reference">parent reference</a> between iterations of the child/parent source.</p>
<section id="generating-quoted-triples-from-multiple-sources"><div class="header-wrapper"><h2 id="join"><bdi class="secno">5. </bdi>Generating quoted triples from multiple sources</h2><a class="self-link" href="#join" aria-label="Permalink for Section 5."></a></div><p>RML-star can create RDF-star triples from multiple <a href="https://w3id.org/core/spec/#logical-source">logical sources</a>.
When creating RDF-star triples from multiple <a href="https://w3id.org/core/spec/#logical-source">logical sources</a>, <a href="https://w3id.org/core/spec/#join-condition">join conditions</a> are used, just like when using <a href="https://w3id.org/core/spec/#referencing-object-map">referencing object maps</a> in RML.</p>
<p>If a <a data-link-type="dfn|abstract-op" href="#dfn-star-map" class="internalDFN" id="ref-for-dfn-star-map-5">star map</a> has a <a href="https://w3id.org/core/spec/#join-condition">join condition</a>, it generates <a href="https://www.w3.org/2021/12/rdf-star.html#dfn-quoted">quoted triples</a> as follows. Each combination of iterations, i.e., the <a href="https://en.wikipedia.org/wiki/Cartesian_product">Cartesian product</a>, from the <em>child source</em> and the <em>parent source</em> is looked at. Here, we consider as child source the <a href="https://w3id.org/core/spec/#logical-source">logical source</a> of the <a href="https://w3id.org/core/spec/#triples-map">Triples Map</a> in which the star map occurs, and as parent source the logical source of the star map's <a data-link-type="dfn|abstract-op" href="#dfn-quoted-triples-map" class="internalDFN" id="ref-for-dfn-quoted-triples-map-4">Quoted Triples Map</a>. A star map only generates quoted triples for combinations in which the join condition holds true. As is the case when <a href="https://w3id.org/core/spec/#logical-join">join conditions are used in in referencing object maps</a>, a join condition checks for equality of the <a href="https://w3id.org/core/spec/#reference-value">reference values</a> of the <a href="https://w3id.org/core/spec/#child-reference">child</a>/<a href="https://w3id.org/core/spec/#parent-reference">parent reference</a> between iterations of the child/parent source.</p>

<p>If the <a href="https://rml.io/specs/rml/#logical-source">logical source</a> of Triples Map in which a <a data-link-type="dfn|abstract-op" href="#dfn-star-map" class="internalDFN" id="ref-for-dfn-star-map-6">star map</a> occurs and the logical source of star map's <a data-link-type="dfn|abstract-op" href="#dfn-quoted-triples-map" class="internalDFN" id="ref-for-dfn-quoted-triples-map-5">Quoted Triples Map</a> are not identical, then the star map must have at least one <a href="https://rml.io/specs/rml/#join-condition">join condition</a>.</p>
<p>If the <a href="https://w3id.org/core/spec/#logical-source">logical source</a> of Triples Map in which a <a data-link-type="dfn|abstract-op" href="#dfn-star-map" class="internalDFN" id="ref-for-dfn-star-map-6">star map</a> occurs and the logical source of star map's <a data-link-type="dfn|abstract-op" href="#dfn-quoted-triples-map" class="internalDFN" id="ref-for-dfn-quoted-triples-map-5">Quoted Triples Map</a> are not identical, then the star map must have at least one <a href="https://w3id.org/core/spec/#join-condition">join condition</a>.</p>
<pre class="ex-input" aria-busy="false"><code class="hljs"># Contents of logical source ex:ClassesSource
entity , class
Alice , Person
Expand Down Expand Up @@ -703,8 +703,8 @@ <h2>

<section id="using-star-map-together-with-referencing-object-maps"><div class="header-wrapper"><h3 id="x5-1-using-star-map-together-with-referencing-object-maps"><bdi class="secno">5.1 </bdi>Using star map together with referencing object maps</h3><a class="self-link" href="#using-star-map-together-with-referencing-object-maps" aria-label="Permalink for Section 5.1"></a></div>
<p>It is also possible to generate <a href="https://www.w3.org/2021/12/rdf-star.html#dfn-quoted">quoted triples</a> which themselves are built from multiple sources.
This is done by using a <a data-link-type="dfn|abstract-op" href="#dfn-quoted-triples-map" class="internalDFN" id="ref-for-dfn-quoted-triples-map-6">Quoted Triples Map</a> which contains a <a href="https://rml.io/specs/rml/#referencing-object-map">referencing object map</a>.</p>
<p>Note: this process for generating <a href="https://www.w3.org/2021/12/rdf-star.html#dfn-quoted">quoted triples</a> with a <a href="https://rml.io/specs/rml/#referencing-object-map">referencing object map</a> is not different from the general process to create quoted triples <a href="#quoted">described earlier</a>, but we include this section for clarity.</p>
This is done by using a <a data-link-type="dfn|abstract-op" href="#dfn-quoted-triples-map" class="internalDFN" id="ref-for-dfn-quoted-triples-map-6">Quoted Triples Map</a> which contains a <a href="https://w3id.org/core/spec/#referencing-object-map">referencing object map</a>.</p>
<p>Note: this process for generating <a href="https://www.w3.org/2021/12/rdf-star.html#dfn-quoted">quoted triples</a> with a <a href="https://w3id.org/core/spec/#referencing-object-map">referencing object map</a> is not different from the general process to create quoted triples <a href="#quoted">described earlier</a>, but we include this section for clarity.</p>
<pre class="ex-input" aria-busy="false"><code class="hljs"># Contents of logical source ex:ClassesSource
entity , class
Alice , Person
Expand Down Expand Up @@ -819,7 +819,7 @@ <h2>
</dd><dt id="bib-rdf11-concepts">[RDF11-Concepts]</dt><dd>
<a href="https://www.w3.org/TR/rdf11-concepts/"><cite>RDF 1.1 Concepts and Abstract Syntax</cite></a>. W3C. 25 February 2014. W3C Recommendation. URL: <a href="https://www.w3.org/TR/rdf11-concepts/">https://www.w3.org/TR/rdf11-concepts/</a>
</dd><dt id="bib-rml">[RML]</dt><dd>
<a href="https://rml.io/specs/rml/"><cite>RDF Mapping Language</cite></a>. https://rml.io. 06 October 2020. Unofficial draft. URL: <a href="https://rml.io/specs/rml/">https://rml.io/specs/rml/</a>
<a href="https://w3id.org/core/spec/"><cite>RDF Mapping Language - Core</cite></a>. https://www.w3.org/community/kg-construct/. 30 June 2023. Draft Community Group Report. URL: <a href="https://w3id.org/core/spec/">https://w3id.org/core/spec/</a>
</dd><dt id="bib-turtle">[Turtle]</dt><dd>
<a href="https://www.w3.org/TR/turtle/"><cite>RDF 1.1 Turtle</cite></a>. W3C. 25 February 2014. W3C Recommendation. URL: <a href="https://www.w3.org/TR/turtle/">https://www.w3.org/TR/turtle/</a>
</dd></dl>
Expand Down

0 comments on commit afe04f6

Please sign in to comment.