Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DatasetSeries: adding dcat:inSeries and its inverse, updating the dataset examples. #1328

Merged
merged 7 commits into from
Mar 16, 2021
Merged

DatasetSeries: adding dcat:inSeries and its inverse, updating the dataset examples. #1328

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
8c7463e
replaced dcterms:hasPart with dcat:hasSeriesMember, adding superprope…
riccardoAlbertoni Mar 14, 2021
0680fee
added dcat:inSeries and replacing dcterms:isPartOf in the dataset ser…
riccardoAlbertoni Mar 14, 2021
d3af3e1
added dcat:inSeries in list of properties of dcat:Dataset
riccardoAlbertoni Mar 15, 2021
f7eb308
note saying dcat:hasSeriesMember has added in the context of dcat 3
riccardoAlbertoni Mar 15, 2021
a337a62
adding catalog to example 35
riccardoAlbertoni Mar 15, 2021
e30e8be
adjusting internal link
riccardoAlbertoni Mar 15, 2021
b7f8d0a
adding dataset series in change History
riccardoAlbertoni Mar 15, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
87 changes: 63 additions & 24 deletions dcat/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2222,6 +2222,7 @@ <h3>Class: Dataset</h3>
<p>The following properties are specific to this class:
<a href="#Property:dataset_distribution">distribution</a>,
<a href="#Property:dataset_frequency">frequency</a>,
<a href="#Property:dataset_in_series">in series</a>
<a href="#Property:dataset_spatial">spatial/geographic coverage</a>,
<a href="#Property:dataset_spatial_resolution">spatial resolution</a>,
<a href="#Property:dataset_temporal">temporal coverage</a>,
Expand Down Expand Up @@ -2323,7 +2324,31 @@ <h4>Property: frequency</h4>
Examples showing how <code>dcterms:accrualPeriodicity</code> and <a href="#Property:dataset_temporal_resolution"><code>dcat:temporalResolution</code></a> may be combined are given in <a href="#temporal-properties"></a>.
</p>
</section>

<section id="Property:dataset_in_series">
<h4>Property: in series</h4>
<aside class="note">
<p>Property added in DCAT 3.</p>
</aside>
<table class="definition">
<thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/dcat#inSeries">dcat:inSeries</a></th></tr></thead>
<tbody>
<tr><td class="prop">Definition:</td><td>A dataset series of which the dataset is part.</td></tr>

<!-- <tr><td class="prop">Domain:</td><td><a href="#Class:Dataset_Series"><code>dcat:DatasetSeries</code></a></td></tr> -->
<tr><td class="prop">Range:</td><td><a href="#Class:Dataset_Series"><code>dcat:DatasetSeries</code></a></td></tr>

<tr><td class="prop">Sub-property of:</td>
<td><a href="http://purl.org/dc/terms/isPartOf"><code>dcterms:isPartOf</code></a></td>
</tr>
<tr><td class="prop">Inverse property of:</td>
<td><a href="#Property:dataset_series_has_series_member"><code>dcat:hasSeriesMember</code></a></td>
</tr>
<tr><td class="prop">Usage note:</td><td> Normally, child datasets in dataset series are represented as <code>dcat:Dataset</code>. The use of <code>dcat:Distribution</code> for typing child datasets is however recognized as a possible alternative, whenever it addresses more effectively the requirements of a given application scenario.</td></tr>
<!--tr><td class="prop">See also:</td><td>Sub-properties of <code>dcterms:hasPart</code> in particular <a href="#Property:catalog_dataset"><code>dcat:dataset</code></a>, <a href="#Property:catalog_catalog"><code>dcat:catalog</code></a>, <a href="#Property:catalog_service"><code>dcat:service</code></a>. </td></tr-->
</tbody>
</table>
</section>
<section id="Property:dataset_spatial">
<h4>Property: spatial/geographical coverage</h4>

Expand Down Expand Up @@ -2468,7 +2493,7 @@ <h3>Class: Dataset Series</h3>
</aside>

<p>The following property is specific to this class:
<a href="#Property:dataset_series_has_part">hasPart</a>.
<a href="http://www.w3.org/ns/dcat#DatasetSeries">dcat:hasSeriesMember</a>.

</p>
<p>The following properties of the super-classes <a href="#Class:Resource"><code>dcat:Resource</code></a> and <a href="#Class:Dataset"><code>dcat:Dataset</code></a> are also available for use:
Expand Down Expand Up @@ -2513,19 +2538,28 @@ <h3>Class: Dataset Series</h3>
</tbody>
</table>

<section id="Property:dataset_series_has_part">
<h4>Property: has part</h4>
<section id="Property:dataset_series_has_series_member">
<h4>Property: has series member</h4>
<!--
<div class="issue" data-number="1307"> </div>
-->
<aside class="note">
<p>Property added in DCAT 3.</p>
</aside>
<table class="definition">
<thead><tr><th>RDF Property:</th><th><a href="http://purl.org/dc/terms/hasPart">dcterms:hasPart</a></th></tr></thead>
<thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/dcat#DatasetSeries">dcat:hasSeriesMember</a></th></tr></thead>
<tbody>
<tr><td class="prop">Definition:</td><td>A child dataset that is part of the dataset series.</td></tr>
<!--
<tr><td class="prop">Domain:</td><td><a href="#Class:Catalog"><code>dcat:Catalog</code></a></td></tr>
<tr><td class="prop">Range:</td><td><a href="#Class:Resource"><code>dcat:Resource</code></a></td></tr>

<tr><td class="prop">Domain:</td><td><a href="#Class:Dataset_Series"><code>dcat:DatasetSeries</code></a></td></tr>
<!-- <tr><td class="prop">Range:</td><td><a href="#Class:Dataset"><code>dcat:Dataset</code></a></td></tr>
-->
<tr><td class="prop">Sub-property of:</td>
<td><a href="http://purl.org/dc/terms/hasPart"><code>dcterms:hasPart</code></a></td>
</tr>
<tr><td class="prop">Inverse property of:</td>
<td><a href="#Property:dataset_in_series"><code>dcat:inSeries</code></a></td>
</tr>
<tr><td class="prop">Usage note:</td><td> Normally, child datasets in dataset series are represented as <code>dcat:Dataset</code>. The use of <code>dcat:Distribution</code> for typing child datasets is however recognized as a possible alternative, whenever it addresses more effectively the requirements of a given application scenario.</td></tr>
<!--tr><td class="prop">See also:</td><td>Sub-properties of <code>dcterms:hasPart</code> in particular <a href="#Property:catalog_dataset"><code>dcat:dataset</code></a>, <a href="#Property:catalog_catalog"><code>dcat:catalog</code></a>, <a href="#Property:catalog_service"><code>dcat:service</code></a>. </td></tr-->
</tbody>
Expand Down Expand Up @@ -4398,32 +4432,36 @@ <h2>Dataset series</h2>

<h2>How to specify dataset series</h2>

<p>DCAT makes dataset series first class citizens of data catalogs by minting a new class <a href="#Class:Dataset_Series"><code>dcat:DatasetSeries</code></a>, defined as subclass of <a href="#Class:Dataset"><code>dcat:Dataset</code></a>. The dataset series and the child datasets are linked by using the [[DCTERMS]] property <a href="#Property:dataset_series_has_part"><code>dcterms:hasPart</code></a> and/or its inverse <a href="#Property:dataset_series_is_part_of"><code>dcterms:isPartOf</code></a>. Note that a dataset series can also be the child of another dataset series.</p>
<p>DCAT makes dataset series first class citizens of data catalogs by minting a new class <a href="#Class:Dataset_Series"><code>dcat:DatasetSeries</code></a>, defined as subclass of <a href="#Class:Dataset"><code>dcat:Dataset</code></a>. The dataset series and the child datasets are linked by using the [[DCTERMS]] property <a href="#Property:dataset_series_has_series_member"><code>dcat:hasSeriesMember</code></a> and/or its inverse <a href="#Property:dataset_in_series"><code>dcat:inSeries</code></a>. Note that a dataset series can also be the child of another dataset series.</p>
<div class="issue" data-number="1307"> </div>

<aside class="example" id="ex-dataset-series-containment" title="Yearly budget datasets grouped into a series">
<p>In the following example, yearly budget data are grouped into a series. The series is typed as <code>dcat:DatasetSeries</code>, the child datasets are typed as <code>dcat:Dataset</code>. The series and the datasets are linked by using both <code>dcterms:hasPart</code> and <code>dcterms:isPartOf</code>.</p>
<p>In the following example, yearly budget data are grouped into a series. The series is typed as <code>dcat:DatasetSeries</code>, the child datasets are typed as <code>dcat:Dataset</code>. The series and the datasets are linked by using both <code>dcat:hasSeriesMember</code> and <code>dcat:inSeries</code>.</p>
<pre>
ex:EUCatalogue a dcat:Catalog ;
dcterms:title "European Data Catalogue"@en ;
dcat:dataset ex:budget , ex:employment , ex:finance ;
.

ex:budget a dcat:DatasetSeries ;
dcterms:title "Budget data"@en ;
dcterms:hasPart ex:budget-2018 ,
dcat:hasSeriesMember ex:budget-2018 ,
ex:budget-2019 , ex:budget-2020 ;
.

ex:budget-2018 a dcat:Dataset ;
dcterms:title "Budget data for year 2018"@en ;
dcterms:isPartOf ex:budget ;
dcat:inSeries ex:budget ;
.

ex:budget-2019 a dcat:Dataset ;
dcterms:title "Budget data for year 2019"@en ;
dcterms:isPartOf ex:budget ;
dcat:inSeries ex:budget ;
.

ex:budget-2020 a dcat:Dataset ;
dcterms:title "Budget data for year 2020"@en ;
dcterms:isPartOf ex:budget ;
dcat:inSeries ex:budget ;
.
</pre>
</aside>
Expand All @@ -4437,28 +4475,28 @@ <h2>How to specify dataset series</h2>

ex:budget a dcat:DatasetSeries ;
dcterms:title "Budget data"@en ;
dcterms:hasPart ex:budget-2018 ,
dcat:hasSeriesMember ex:budget-2018 ,
ex:budget-2019 , ex:budget-2020 ;
.

ex:budget-2018 a dcat:Dataset ;
dcterms:title "Budget data for year 2018"@en ;
dcterms:isPartOf ex:budget ;
dcat:inSeries ex:budget ;
dcterms:issued "2019-01-01"^^xsd:date ;
adms:next ex:budget-2019 ;
.

ex:budget-2019 a dcat:Dataset ;
dcterms:title "Budget data for year 2019"@en ;
dcterms:isPartOf ex:budget ;
dcat:inSeries ex:budget ;
dcterms:issued "2020-01-01"^^xsd:date ;
adms:prev ex:budget-2018 ;
adms:next ex:budget-2020 ;
.

ex:budget-2020 a dcat:Dataset ;
dcterms:title "Budget data for year 2020"@en ;
dcterms:isPartOf ex:budget ;
dcat:inSeries ex:budget ;
dcterms:issued "2021-01-01"^^xsd:date ;
adms:prev ex:budget-2019 ;
.
Expand Down Expand Up @@ -4513,7 +4551,7 @@ <h2>Dataset series metadata</h2>
<pre>
ex:budget a dcat:DatasetSeries ;
dcterms:title "Budget data"@en ;
dcterms:hasPart ex:budget-2018-be , ex:budget-2019-be , ex:budget-2020-be ,
dcat:hasSeriesMember ex:budget-2018-be , ex:budget-2019-be , ex:budget-2020-be ,
ex:budget-2018-fr , ex:budget-2019-fr , ex:budget-2020-fr ,
ex:budget-2018-it , ex:budget-2019-it , ex:budget-2020-it ,
... ;
Expand All @@ -4533,7 +4571,7 @@ <h2>Dataset series metadata</h2>

ex:budget-2018-be a dcat:Dataset ;
dcterms:title "Belgium budget data for year 2018"@en ;
dcterms:isPartOf ex:budget ;
dcat:inSeries ex:budget ;
dcterms:issued "2019-01-01"^^xsd:date ;
adms:next ex:budget-2019-be ;
dcterms:accrualPeriodicity &lt;http://purl.org/cld/freq/annual&gt; ;
Expand All @@ -4549,7 +4587,7 @@ <h2>Dataset series metadata</h2>

ex:budget-2018-fr a dcat:Dataset ;
dcterms:title "France budget data for year 2018"@en ;
dcterms:isPartOf ex:budget ;
dcat:inSeries ex:budget ;
dcterms:issued "2019-01-01"^^xsd:date ;
adms:next ex:budget-2019-fr ;
dcterms:accrualPeriodicity &lt;http://purl.org/cld/freq/annual&gt; ;
Expand All @@ -4565,7 +4603,7 @@ <h2>Dataset series metadata</h2>

ex:budget-2018-it a dcat:Dataset ;
dcterms:title "Italy budget data for year 2018"@en ;
dcterms:isPartOf ex:budget ;
dcat:inSeries ex:budget ;
dcterms:issued "2019-01-01"^^xsd:date ;
adms:next ex:budget-2019-it ;
dcterms:accrualPeriodicity &lt;http://purl.org/cld/freq/annual&gt; ;
Expand Down Expand Up @@ -4595,7 +4633,7 @@ <h2>Dataset series in existing DCAT implementations</h2>

<ol>
<li>The dataset series is typed as a <code>dcat:Dataset</code>, whereas its child datasets are typed as <code>dcat:Distribution</code>'s.</li>
<li>Both the dataset series and its child datasets are typed as a <code>dcat:Dataset</code>'s, and the two are usually linked by using the [[DCTERMS]] properties <code>dcterms:hasPart</code> / <code>dcterms:isPartOf</code>.</li>
<li>Both the dataset series and its child datasets are typed as a <code>dcat:Dataset</code>'s, and the two are usually linked by using the [[DCTERMS]] properties <code>dcat:hasSeriesMember</code> / <code>dcat:inSeries</code>.</li>
</ol>

<p>In both cases, the dataset series is sometimes soft-typed by using the [[DCTERMS]] property <code>dcterms:type</code> (e.g., this is the approach used in [[GeoDCAT-AP]], and adopted in [[DCAT-AP-IT]] and [[GeoDCAT-AP-IT]]).</p>
Expand Down Expand Up @@ -5893,8 +5931,9 @@ <h2>Changes since the first public working draft of 17 December 2020</h2>
<p>The other sections include only editorial changes.</p>
</li>
<li><a href="#Class:Resource"></a> has been updated to include the definition of the properties illustrated in <a href="#dataset-versions"></a>.</li>
<li><p><a href="#dataset-series"></a> has been revised making dataset series first class citizens of data catalogs and introducing new properties for linking dataset series and datasets (see issues <a href="https://github.com/w3c/dxwg/issues/1272">1272</a> and <a href="https://github.com/w3c/dxwg/issues/1307">1307</a>). In particular, the class <code>dcat:DatasetSeries</code> and property <code>dcat:hasSeriesMember</code> have been minted (see <a href="#Class:Dataset_Series"></a>), the property <code>dcat:inSeries</code> has been added to <a href="#Class:Dataset"></a>.</p>
</li>
</ul>

</section>

<section id="changes-since-20200204">
Expand All @@ -5907,7 +5946,7 @@ <h3>Changes since the W3C Recommendation of 4 February 2020</h3>
<li>
Section <a href="#dataset-versions"></a> was extended with draft guidelines to deal with version delta (<a href="https://github.com/w3c/dxwg/issues/#89">Issue #89</a>), version release date (<a href="https://github.com/w3c/dxwg/issues/#91">Issue #91</a>), version identifier (<a href="https://github.com/w3c/dxwg/issues/#92">Issue #92</a>), version compatibility (<a href="https://github.com/w3c/dxwg/issues/#1258">Issue #1258</a>) and resource status (<a href="https://github.com/w3c/dxwg/issues/#1238">Issue #1238</a>).
</li>
<li> A new class <a href="#Class:Dataset_Series"><code>dcat:DatasetSeries</code></a> was added (<a href="https://github.com/w3c/dxwg/issues/#1272">Issue #1272</a>). Section <a href="#dataset-series"></a> drafts guidelines on dataset series (<a href="https://github.com/w3c/dxwg/issues/#868">Issue #868</a>) and to show related examples (<a href="https://github.com/w3c/dxwg/issues/#806">Issue #806</a>).
<li> A new section <a href="#dataset-series"></a> was added to draft guidelines on dataset series (<a href="https://github.com/w3c/dxwg/issues/#868">Issue #868</a>) and to show related examples (<a href="https://github.com/w3c/dxwg/issues/#806">Issue #806</a>).
</li>
</ul>

Expand Down