Skip to content

Commit

Permalink
Merge pull request #776 from w3c/dcat-issue84-tres-simon
Browse files Browse the repository at this point in the history 
DCAT - temporal resolution - as per meeting minutes https://www.w3.org/2019/02/27-dxwgdcat-minutes#x12
  • Loading branch information
@davebrowning
davebrowning committed Feb 28, 2019
2 parents cacba46 + 77e54bb commit bd2c504
Show file tree
Hide file tree
Showing 2 changed files with 72 additions and 5 deletions.
66 changes: 61 additions & 5 deletions dcat/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -367,9 +367,10 @@ <h3>Basic Example</h3>
dcat:keyword "accountability","transparency" ,"payments"&nbsp;;
dct:creator&nbsp;:finance-employee-001&nbsp;;
dct:issued "2011-12-05"^^xsd:date&nbsp;;
dct:modified "2011-12-05"^^xsd:date&nbsp;;
dct:modified "2011-12-15"^^xsd:date&nbsp;;
dcat:contactPoint &lt;http://example.org/transparency-office/contact&gt; ;
dct:temporal &lt;http://reference.data.gov.uk/id/quarter/2006-Q1&gt; ;
dcat:temporalResolution "P1D"^^xsd:duration ;
dct:spatial &lt;http://www.geonames.org/6695072&gt; ;
dct:publisher&nbsp;:finance-ministry&nbsp;;
dct:language &lt;http://id.loc.gov/vocabulary/iso639-1/en&gt; &nbsp;;
Expand All @@ -378,11 +379,12 @@ <h3>Basic Example</h3>
.
</pre>

<p>In order to express the frequency of update in the example above, we chose to use an instance from the <a href="http://www.w3.org/TR/vocab-data-cube/#dsd-cog">Content-Oriented Guidelines</a> developed as part
of the <abbr title="World Wide Web Consortium">W3C</abbr> Data Cube Vocabulary [[?VOCAB-DATA-CUBE]] efforts. Additionally, we chose to describe the spatial and temporal coverage of the example dataset using URIs from <a href="http://www.geonames.org/">Geonames</a> and the Interval dataset (originally available from http://reference.data.gov.uk/id/interval) from data.gov.uk, respectively. A contact point is also provided where comments and feedback about the dataset can be sent. Further details about the contact point, such as email address or telephone number, can be provided using vCard [[?VCARD-RDF]].</p>
<p>Five distinct temporal descriptors are shown for this dataset. The dataset publication and revision dates are shown in <a href="#Property:resource_release_date"><code>dct:issued</code></a> and <a href="#Property:resource_update_date"><code>dct:modified</code></a>. For the frequency of update of the dataset in <a href="#Property:dataset_frequency"><code>dct:accrualPeriodicity</code></a>, we use an instance from the <a href="http://www.w3.org/TR/vocab-data-cube/#dsd-cog">Content-Oriented Guidelines</a> developed as part
of the <abbr title="World Wide Web Consortium">W3C</abbr> Data Cube Vocabulary [[?VOCAB-DATA-CUBE]] efforts. The temporal coverage or extent is given in <a href="#Property:dataset_temporal"><code>dct:temporal</code></a> using an item from the Interval dataset (originally available from http://reference.data.gov.uk/id/interval) from data.gov.uk. The temporal resolution, which describes the minimum spacing of items within the dataset, is given in <a href="#Property:dataset_temporalresolution"><code>dcat:temporalResolution</code></a> using the standard datatype <code>xsd:duration</code>. </p>
<p>Additionally, the spatial coverage or extent is given <a href="#Property:dataset_spatial"><code>dct:spatial</code></a> using a URI from <a href="http://www.geonames.org/">Geonames</a>. A contact point is provided where comments and feedback about the dataset can be sent. Further details about the contact point, such as email address or telephone number, can be provided using vCard [[?VCARD-RDF]].</p>

<p>The dataset distribution <code>:dataset-001-csv</code> can be downloaded as a 5Kb CSV file. This information is
represented via an RDF resource of type <code>dcat:Distribution</code>.
<p>One representation of the dataset <code>:dataset-001-csv</code> can be downloaded as a 5Kb CSV file. This is
represented as an RDF resource of type <code>dcat:Distribution</code>.
</p>
<pre id="ex-distribution" class="example nohighlight turtle" aria-busy="false" aria-live="polite">
:dataset-001-csv
Expand Down Expand Up @@ -675,6 +677,7 @@ <h3>Class: Catalog</h3>
<a href="#Property:dataset_frequency">frequency</a>,
<a href="#Property:dataset_spatial">spatial/geographic coverage</a>,
<a href="#Property:dataset_temporal">temporal coverage</a>,
<a href="#Property:dataset_temporalresolution">temporal resolution</a>,
<a href="#Property:dataset_wasgeneratedby">was generated by</a>
</p>
<p>The following properties are inherited from the super-class <a href="#Class:Resource"><code>dcat:Resource</code></a>:
Expand Down Expand Up @@ -1438,6 +1441,7 @@ <h3>Class: Dataset</h3>
<a href="#Property:dataset_frequency">frequency</a>,
<a href="#Property:dataset_spatial">spatial/geographic coverage</a>,
<a href="#Property:dataset_temporal">temporal coverage</a>,
<a href="#Property:dataset_temporalresolution">temporal resolution</a>,
<a href="#Property:dataset_wasgeneratedby">was generated by</a>
</p>
<p>The following properties are inherited from the super-class <a href="#Class:Resource"><code>dcat:Resource</code></a>:
Expand Down Expand Up @@ -1584,6 +1588,28 @@ <h4>Property: temporal coverage</h4>
</table>
</section>

<section id="Property:dataset_temporalresolution">
<h4>Property: temporal resolution</h4>

<table class="definition">
<thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/dcat#temporalResolution">dcat:temporalResolution</a></th></tr></thead>
<tbody>
<tr><td class="prop">Definition:</td><td>minimum time period resolvable in the dataset</td></tr>
<tr><td class="prop">Range:</td><td><a href="http://www.w3.org/TR/xmlschema-2/#duration"><code>xsd:duration</code></a></td></tr>
<tr><td class="prop">Usage note:</td><td>If the dataset is a time-series this should correspond to the spacing of items. For other kinds of dataset, this property will usually indicate the smallest time difference between items in the dataset. </td></tr>
</tbody>
</table>


<p>This is intended to provide a summary indication of the temporal resolution of the data distribution as a single value.
More complex descriptions of various aspects of temporal precision, accuracy, resolution and other statistics can be provided using the Data Quality Vocabulary [[VOCAB-DQV]]. </p>

<p class="note">
New property in this context in this revision of DCAT.
</p>

</section>

<section id="Property:dataset_wasgeneratedby">
<h4>Property: was generated by</h4>

Expand Down Expand Up @@ -1635,6 +1661,7 @@ <h3>Class: Distribution</h3>
<a href="#Property:distribution_packaging_format">packaging format</a>,
<a href="#Property:distribution_release_date">release date</a>,
<a href="#Property:distribution_rights">rights</a>,
<a href="#Property:distribution_temporalresolution">temporal resolution</a>,
<a href="#Property:distribution_title">title</a>,
<a href="#Property:distribution_update_date">update/modification date</a>,
</p>
Expand Down Expand Up @@ -1872,6 +1899,30 @@ <h4>Property: byteSize</h4>
</table>
</section>

<section id="Property:distribution_temporalresolution">
<h4>Property: temporal resolution</h4>

<table class="definition">
<thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/dcat#temporalResolution">dcat:temporalResolution</a></th></tr></thead>
<tbody>
<tr><td class="prop">Definition:</td><td>minimum time period resolvable in the dataset distribution</td></tr>
<tr><td class="prop">Range:</td><td><a href="http://www.w3.org/TR/xmlschema-2/#duration"><code>xsd:duration</code></a></td></tr>
<tr><td class="prop">Usage note:</td><td>If the dataset is a time-series this should correspond to the spacing of items. For other kinds of dataset, this property will usually indicate the smallest time difference between items in the dataset. </td></tr>
<tr><td class="prop">Usage note:</td><td>Alternative temporal resolutions might be provided in different dataset distributions</td></tr>
</tbody>
</table>

<p class="note">
New property in this context in this revision of DCAT.
</p>
</tbody>
</table>

<p>This is intended to provide a summary indication of the temporal resolution of the data distribution as a single value.
More complex descriptions of various aspects of temporal precision, accuracy, resolution and other statistics can be provided using the Data Quality Vocabulary [[VOCAB-DQV]]. </p>

</section>

<section id="Property:distribution_conformsto">
<h4>Property: conforms to</h4>

Expand Down Expand Up @@ -4061,6 +4112,11 @@ <h3>Changes since the W3C Recommendation of 16 January 2014</h3>
<p>The document has undergone the following changes since the W3C Recommendation of 16 January 2014 [[?VOCAB-DCAT-20140116]]:</p>

<ul>
<li>
A new property <a href="#Property:dataset_temporalresolution">dcat:temporalResolution</a> added to support description of the temporal resolution of datasets and distributions. See <a href="https://github.com/w3c/dxwg/issues/84">Issue #84</a>
</li>

<li>
<li>
Two new properties were added to specify packaged and compressed distributions: <a href="#Property:distribution_packaging_format">dcat:packageFormat</a> and <a href="#Property:distribution_compression_format">dcat:compressFormat</a>. See <a href="https://github.com/w3c/dxwg/issues/54">Issue #54</a>
</li>
Expand Down
11 changes: 11 additions & 0 deletions dcat/rdf/dcat.ttl
View file
Original file line number Diff line number Diff line change
Expand Up @@ -829,6 +829,17 @@ dcat:service
skos:changeNote "New property in this revision of DCAT" ;
skos:editorialNote "Status: Property accepted by DCAT revision team, but details of definition and constraints not yet resolved." ;
.
dcat:temporalResolution
rdf:type owl:DatatypeProperty ;
rdfs:comment "minimum time period resolvable in a dataset" ;
rdfs:label "temporal resolution" ;
rdfs:range xsd:duration ;
skos:changeNote "New property in this revision of DCAT" ;
skos:editorialNote "Status: Property accepted by DCAT revision team, but details of definition and constraints not yet resolved." ;
skos:editorialNote "Might appear in the description of a Dataset or a Distribution, so no domain is specified" ;
skos:scopeNote "If the dataset is a time-series this should correspond to the spacing of items. For other kinds of dataset, this property will usually indicate the smallest time difference between items in the dataset. " ;
skos:scopeNote "Alternative temporal resolutions might be provided as different dataset distributions" ;
.
dcat:theme
rdf:type rdf:Property ;
rdf:type owl:ObjectProperty ;
Expand Down

0 comments on commit bd2c504

Please sign in to comment.