Skip to content

Commit

Permalink
added dcat:inSeries and replacing dcterms:isPartOf in the dataset ser…
Browse files Browse the repository at this point in the history 
…ies examples
  • Loading branch information
@riccardoAlbertoni
riccardoAlbertoni committed Mar 14, 2021
1 parent 8c7463e commit 0680fee
Showing 1 changed file with 35 additions and 14 deletions.
49 changes: 35 additions & 14 deletions dcat/index.html
View file
Expand Up @@ -2323,7 +2323,28 @@ <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>
<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 title="http://www.w3.org/dcat#inSeries">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 +2489,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 @@ -2523,7 +2544,7 @@ <h4>Property: has series member</h4>
<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:DatasetSeries"><code>dcat:DatasetSeries</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>
Expand Down Expand Up @@ -4404,11 +4425,11 @@ <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="http://www.w3.org/ns/dcat#DatasetSeries">dcat:hasSeriesMember</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="http://www.w3.org/ns/dcat#DatasetSeries">dcat:hasSeriesMember</a> and/or its inverse <a href="#Property:dataset_in_series"><code title="http://www.w3.org/dcat#inSeries">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>dcat:hasSeriesMember</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:budget a dcat:DatasetSeries ;
Expand All @@ -4419,17 +4440,17 @@ <h2>How to specify dataset series</h2>

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 @@ -4449,22 +4470,22 @@ <h2>How to specify dataset series</h2>

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 @@ -4539,7 +4560,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 @@ -4555,7 +4576,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 @@ -4571,7 +4592,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 @@ -4601,7 +4622,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

0 comments on commit 0680fee

Please sign in to comment.