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.

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

Clarify that the activity that generated a dataset might be on-going #338

Merged
merged 4 commits into from
Sep 12, 2018
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
19 changes: 13 additions & 6 deletions dcat/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -457,17 +457,18 @@ <h3>Dataset provenance</h3>

dap:P366
rdf:type prov:Activity ;
dcterms:type "Observation" ;
rdfs:comment "Parkes multibeam high-latitude pulsar survey" ;
rdfs:label "P366 - Parkes multibeam high-latitude pulsar survey" ;
dct:type "Observation" ;
prov:startedAtTime "2000-11-01"^^xsd:date ;
prov:used dap:Parkes-radio-telescope ;
prov:wasAssociatedWith dap:Marta_Burgay ;
prov:wasInformedBy dap:ATNF ;
rdfs:label "P366 - Parkes multibeam high-latitude pulsar survey" ;
rdfs:seeAlso &lt;https://doi.org/10.1111/j.1365-2966.2006.10100.x&gt; ;
.
</pre>
<p>
Several properties capture provenance information, including within the citation and title, but the primary link to a formal description of the project is through <a href="#Property:dataset_wasgeneratedby">prov:wasGeneratedBy</a>.
A terse description of the project is shown as a <a href="http://www.w3.org/ns/prov#Activity">prov:Activity</a>, though this would not necessarily be part of the same catalog.
Note that as the project is ongoing, the activity has no end date.
</p>
<p>
Further provenance information might be provided using the other <i>starting point properties</i> from PROV, in particular <a href="http://www.w3.org/TR/prov-o/#wasAttributedTo">prov:wasAttributedTo</a> (to link to an agent associated with the dataset production) and <a href="http://www.w3.org/TR/prov-o/#Property:wasDerivedFrom">prov:wasDerivedFrom</a> (to link to a predecessor dataset). Both of these complement Dublin Core properties already used in DCAT, as follows:
Expand Down Expand Up @@ -1552,7 +1553,7 @@ <h4>Property: was generated by</h4>
<tr><td class="prop">Definition:</td><td>An activity that generated, or provides the business context for, the creation of the dataset.</td></tr>
<tr><td class="prop">Domain:</td><td><a href="http://www.w3.org/ns/prov#Entity">prov:Entity</a></td></tr>
<tr><td class="prop">Range:</td><td><a href="http://www.w3.org/ns/prov#Activity">prov:Activity</a> An activity is something that occurs over a period of time and acts upon or with entities; it may include consuming, processing, transforming, modifying, relocating, using, or generating entities.</td></tr>
<tr><td class="prop">Usage note:</td><td>The activity associated with generation of a dataset will typically be an initiative, project, mission, survey etc. Multiple prov:wasGeneratedBy properties can be used to indicate the dataset production context at various levels of granularity. </td></tr>
<tr><td class="prop">Usage note:</td><td>The activity associated with generation of a dataset will typically be an initiative, project, mission, survey, on-going activity ("business as usual") etc. Multiple prov:wasGeneratedBy properties can be used to indicate the dataset production context at various levels of granularity. </td></tr>
<tr><td class="prop">Usage note:</td><td>Use <a href="http://www.w3.org/ns/prov#qualifiedGeneration">prov:qualifiedGeneration</a> to attach additional details about the relationship between the dataset and the activity, e.g. the exact time that the dataset was produced during the lifetime of a project</td></tr>
</tbody>
</table>
Expand All @@ -1562,7 +1563,13 @@ <h4>Property: was generated by</h4>
</p>

<p>
Details about how to describe the activity that generated a dataset, such as a project, initiative, mission or survey, are out of scope for this document. <a href="http://www.w3.org/ns/prov#Activity">prov:Activity</a> provides for some basic properties such as begin and end time, associated agents etc. Further details may be provided through classes defined in applications. A number of ontologies for describing projects are available, for example VIVO for academic research projects [[vivo-isf]], DOAP (Description of a Project) for software projects [[doap]], and DBPedia for general projects [[dbpedia-ont]] which are expected to be suitable for different applications.
Details about how to describe the activity that generated a dataset, such as a project, initiative, on-going activity, mission or survey, are out of scope for this document.
<a href="http://www.w3.org/ns/prov#Activity">prov:Activity</a> provides for some basic properties such as begin and end time, associated agents etc.
Further details may be provided through classes defined in applications.
A number of ontologies for describing projects are available, for example
VIVO for academic research projects [[vivo-isf]],
DOAP (Description of a Project) for software projects [[doap]], and
DBPedia for general projects [[dbpedia-ont]] which are expected to be suitable for different applications.
</p>
</section>

Expand Down
13 changes: 7 additions & 6 deletions dcat/rdf/dcat.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -27,10 +27,10 @@
foaf:workInfoHomepage <http://people.csiro.au/Simon-Cox> ;
] ;
dct:contributor [
schema:affiliation [
foaf:homepage <http:www.thomsonreuters.com> ;
foaf:name "Thomson Reuters" ;
] ;
schema:affiliation [
foaf:homepage <http://www.thomsonreuters.com> ;
foaf:name "Thomson Reuters" ;
] ;
foaf:name "David Browning" ;
] ;
dct:contributor [
Expand Down Expand Up @@ -672,8 +672,7 @@ dcat:mediaType
rdfs:label "メディア・タイプ"@ja ;
rdfs:range dct:MediaType ;
rdfs:subPropertyOf dct:format ;
skos:scopeNote "This property SHOULD be used when the media type of the distribution is defined
in the IANA media types registry https://www.iana.org/assignments/media-types/, otherwise dct:format MAY be used with different values.";
skos:scopeNote "This property SHOULD be used when the media type of the distribution is defined in the IANA media types registry https://www.iana.org/assignments/media-types/, otherwise dct:format MAY be used with different values.";
skos:editorialNote "The range of dcat:mediaType has been tightened as part of the revision of DCAT." ;
skos:editorialNote "Status: English Definition text modified by DCAT revision team, translations pending. Note some inconsistency on def vs. usage" ;
.
Expand Down Expand Up @@ -787,4 +786,6 @@ prov:wasDerivedFrom
.
prov:wasGeneratedBy
rdfs:subPropertyOf dct:relation ;
skos:scopeNote "The activity associated with generation of a dataset will typically be an initiative, project, mission, survey, on-going activity ('business as usual') etc. Multiple prov:wasGeneratedBy properties can be used to indicate the dataset production context at various levels of granularity." ;
skos:scopeNote "Use prov:qualifiedGeneration to attach additional details about the relationship between the dataset and the activity, e.g. the exact time that the dataset was produced during the lifetime of a project" ;
.