Skip to content

Commit

Permalink
Add explanation of spatial resolution
Browse files Browse the repository at this point in the history
  • Loading branch information
Simon Cox committed Feb 27, 2019
1 parent 3e25f11 commit 5e9fb1d
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 6 deletions.
20 changes: 14 additions & 6 deletions dcat/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -402,6 +402,13 @@ <h3>Basic Example</h3>
.
</pre>
-->
<p>Several 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. </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>. The spatial resolution, which describes the minimum spatial separation of items within the dataset, is given in <a href="#Property:dataset_spatialresolution"><code>dcat:spatialResolutionInMetres</code></a> using the standard datatype <code>xsd:decimal</code>. 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>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>
<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, and the temporal resolution using a standard datatype. 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>

Expand Down Expand Up @@ -698,7 +705,7 @@ <h3>Class: Catalog</h3>
<a href="#Property:dataset_distribution">distribution</a>,
<a href="#Property:dataset_frequency">frequency</a>,
<a href="#Property:dataset_spatial">spatial/geographic coverage</a>,
<a href="#Property:dataset_spatialresolutionm">spatial resolution</a>,
<a href="#Property:dataset_spatialresolution">spatial resolution</a>,
<a href="#Property:dataset_temporal">temporal coverage</a>,
<a href="#Property:dataset_wasgeneratedby">was generated by</a>
</p>
Expand Down Expand Up @@ -1462,7 +1469,7 @@ <h3>Class: Dataset</h3>
<a href="#Property:dataset_distribution">distribution</a>,
<a href="#Property:dataset_frequency">frequency</a>,
<a href="#Property:dataset_spatial">spatial/geographic coverage</a>,
<a href="#Property:dataset_spatialresolutionm">spatial resolution</a>,
<a href="#Property:dataset_spatialresolution">spatial resolution</a>,
<a href="#Property:dataset_temporal">temporal coverage</a>,
<a href="#Property:dataset_wasgeneratedby">was generated by</a>
</p>
Expand Down Expand Up @@ -1610,7 +1617,7 @@ <h4>Property: temporal coverage</h4>
</table>
</section>

<section id="Property:dataset_spatialresolutionm">
<section id="Property:dataset_spatialresolution">
<h4>Property: spatial resolution</h4>

<table class="definition">
Expand Down Expand Up @@ -1923,11 +1930,12 @@ <h4>Property: byteSize</h4>
<h4>Property: spatial resolution</h4>

<table class="definition">
<thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/dcat#spatialResolution">dct:spatialResolution</a></th></tr></thead>
<thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/dcat#spatialResolutionInMetres">dcat:spatialResolutionInMetres</a></th></tr></thead>
<tbody>
<tr><td class="prop">Definition:</td><td>minimum spatial separation resolvable in a dataset</td></tr>
<tr><td class="prop">Definition:</td><td>minimum spatial separation resolvable in a dataset distribution</td></tr>
<tr><td class="prop">Range:</td><td><a href="https://www.w3.org/TR/rdf-schema/#ch_resource"><code>rdfs:Resource</code></a></td></tr>
<tr><td class="prop">Usage note:</td><td>If the dataset is an image or grid this should correspond to the spacing of items. For other kinds of spatial dataset, this property will usually indicate the smallest distance between items in the dataset.</td></tr>
<tr><td class="prop">Usage note:</td><td>Alternative spatial resolutions might be provided as different dataset distributions</td></tr>
</tbody>
</table>

Expand Down Expand Up @@ -4177,7 +4185,7 @@ <h3>Changes since the W3C Recommendation of 16 January 2014</h3>

<ul>
<li>
A new property <a href="#Property:dataset_spatialresolutionm">dcat:spatialResolutionInMetres</a> added to support description of the spatial resolution of datasets and distributions. A new class <a href="#Class:measure">dcat:Measure</a> is provided for its value. See <a href="https://github.com/w3c/dxwg/issues/84">Issue #84</a>
A new property <a href="#Property:dataset_spatialresolution">dcat:spatialResolutionInMetres</a> added to support description of the spatial resolution of datasets and distributions. A new class <a href="#Class:measure">dcat:Measure</a> is provided for its value. See <a href="https://github.com/w3c/dxwg/issues/84">Issue #84</a>
</li>

<li>
Expand Down
1 change: 1 addition & 0 deletions dcat/rdf/dcat.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -853,6 +853,7 @@ dcat:spatialResolutionInMetres
skos:editorialNote "Status: 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 an image or grid this should correspond to the spacing of items. For other kinds of spatial dataset, this property will usually indicate the smallest distance between items in the dataset. " ;
skos:scopeNote "Alternative spatial resolutions might be provided as different dataset distributions" ;
.
dcat:theme
rdf:type rdf:Property ;
Expand Down

0 comments on commit 5e9fb1d

Please sign in to comment.