Table of Contents

• 1. Introduction
• 2. Namespaces
• 3. Audience
• 4. Scope
• 5. Relationship to other Vocabularies
• 6. Examples
• 7. Vocabulary Overview
• 8. Vocabulary Specification
  • 8.1 Class:Agent
  • 8.2 Class:Annotation
  • 8.3 Class: Application
  • 8.4 Class: Dataset
  • 8.5 Class: Document
  • 8.6 Class: Activity
  • 8.7 Class: Rating
  • 8.8 Class: Citation
  • 8.9 Class: Feedback
  • 8.10 Class: DatasetCorrection
  • 8.11 Class: WebThing
• 9. DUV Requirements
• A. Acknowledgements
• B. Change history
• C. References
  • C.1 Normative references
  • C.2 Informative references

2. Namespaces

The namespace for DCAT is http://www.w3.org/ns/dcat#. However, it should be noted that DCAT makes extensive use of terms from other vocabularies, in particular Dublin Core. DCAT itself defines a minimal set of classes and properties of its own. A full set of namespaces and prefixes used in this document is shown in the table below.

3. Audience

The DUV is intended for data producers and publishers interested in tracking, sharing, and persisting consumer dataset usage. It is also intended for collaborators who require an exchange medium to advertise and interactively convey dataset usage.

4. Scope

The scope of DUV is defined by the Data on the Web Best Practices (DWBP) Use Case document based on the data usage requirements about datasets. These requirements include: citing data on the Web, tracking the usage of data, sharing feedback and rating data. These requirements were derived from fourteen real world use cases examples provided in the use case document.

5. Relationship to other Vocabularies

The DUV is a “glue” vocabulary reusing and extending existing vocabulary classes and properties to support citation, feedback, and usage. This section provides our rationale and approach for vocabulary selection and re-use.

Core to the dataset usage vocabulary is the “dataset”. The DUV uses the Data Catalog (DCAT) vocabulary dcat:Dataset class and all properties associated with the class. From a data usage perspective the DUV can be considered an extension of the dcat:Dataset.

The Web Annotation Vocabulary is used to describe duv:Feedback as a subclass inheriting the behavior of oa:Annotation. A crucial part of the Web Annotation Model are “motivations” that describe the role of particular Annotation. Each duv:Feedback must have at least one oa:motivated_by property with a relationship to an instance of oa:Motivation. A subset of the Motivation instances are important to describe feedback to data publishers, and blogs between dataset consumers. In addition to supporting duv:Feedback because the Web Annotation vocabulary provides a generic way of annotating any web resource, it is recommended that Web Annotation vocabulary be used to annotate the duv:Dataset for uses beyond the scope of the DUV.

The Provenance Ontology (Prov-O) is a vocabulary used by data providers to pass details about the data history to data users. Properties associated with prov:Activity provide relationships (prov:used, prov:hasGenerated) from a historical perspective using past tense forms of words and phrases. The developed and duv:WebThing reuses these properties by creating subProperties from Prov-O to describe usage from a present tense perspective.

Both the Citation Typing Ontology (CiTO) and Dublin Core vocabularies are used to describe citations and references between datasets and cited sources.

6. Examples

This section shows some examples to illustrate the application of the Dataset Usage Vocabulary.

Example 1 - Usage: A 2-D plot application developed by Laufer can be used to create temperature plots and consumes temperature readings from a dataset to produce the plot. A data logger used to provide temperature readings uses a configuration file for operation of the data logger.

@prefix rdf:  <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct:  <http://purl.org/dc/terms/> .
@prefix duv:  <http://www.w3.org/ns/duv#> .
@prefix :     <http://example.org#> .

:laufer
a foaf:Agent, foaf:Person;
   foaf:givenName "Laufer";
   foaf:mbox <mailto:laufer@example.org>
   duv:develops :xyplotter;
.

:xyplotter
  a duv:Application;
  rdfs:label "2dplotter" ;
  duv:consumes :dataset-03312004
  duv:developedBy :laufer ;
.

:insitu-measurement-data-logger
  a duv:WebThing;
  rdfs:label "surface meteorology data logger" ;
  duv:consumes :configfile ;
.

:configfile-csv
  a dcat:Distribution;
.

:configfile
  a dcat:Dataset ;
  dct:title "configuration settings" ;
  dcat:distribution :configfile-csv ;
.

:dataset-Jan-Mar-2004-csv 
  a dcat:Distribution;
.

:dataset-03312004
  a dcat:Dataset;
  dct:title "Mars Quarterly Temperature Plot"; 
  dcat:distribution :dataset-Jan-Mar-2004-csv;
.

Example 2 - Feedback: Laufer provides feedback about the temperature readings dataset.

@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct:  <http://purl.org/dc/terms#> .
@prefix oa:   <http://www.w3.org/ns/oa#>  .
@prefix duv: <http://www.w3.org/ns/duv#> .
@prefix : <http://example.org#> .

:laufer
   a duv:Person  ;
   foaf:givenName "Laufer"  ;
   foaf:mbox <mailto:laufer@example.org> ;
.

:dataset-03312004
   a dcat:Dataset ;
   dct:title "Mars Quarterly Temperature Plot" ; 
.

:comment1
   a duv:Feedback ;
   oa:hasBody "Written in MS-DOS text format." ;
   oa:hasTarget :dataset-03312004 ;
   oa:annotatedBy :laufer ;
.

:comment2
   a duv:Feedback;
   duv:hasRating "3 Star";
   oa:hasBody "Linked Data Rating";
   oa:hasTarget :dataset-03312004;
.

Example 3 - Citation: A technical report :paperA identified by a DOI cites the dataset. The :dataset-03312013 is also identified by a digital object identifier (DOI).

@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct:  <http://purl.org/dc/terms#> .
@prefix oa:   <http://www.w3.org/ns/oa#>  .
@prefix cito: <http://purl.org/spar/cito#> .
@prefix duv: <http://www.w3.org/ns/duv#> .
@prefix : <http://example.org#> .

:dataset-03312013
    a dcat:Dataset;
    dc:identifier "doi:10.1038/ex2158";
    dct:title "Mars Quarterly Temperature Plot"@en ;
    dct:alternative "Qtrly Temp Plot"@en;
    dct:description "This plot features average surface temperatures measured by the Mars Land Rover. "@en ;
    dct:created "2013-03-31T15:18:00Z"^^xsd:dateTime ;
    dct:creator "Laufer" ;
    dct:license <http://creativecommons.org/licenses/by-sa/3.0/> ;
    dcat:keyword "Mars";
    dct:language <http://www.lexvo.org/page/iso639-3/eng> ;
    cito:isCitedAsDataSourceBy :paperA ; 
.

:thisCitation 
    a duv:Citation;
    cito:hasCitingEntity :dataset-03312004;
    cito:hasCitedEntity :paperA;
.

:paperA
   a foaf:document
   dc:identifier "doi:20.1055/ex7758";
   dct:title "Mars Weather Technical Report"@en;
   duv:cites :dataset-03312004;
.

7. Vocabulary Overview

This section is non-normative.

This section depicts the vocabulary as a conceptual model. Shaded boxes are used to identify each class. Labeled open arrows identify example properties between the classes. Unlabeled shaded arrows are used to show inheritance with the parent class identified by the arrow head.

The classes duv:Application, duv:WebThing, and prov:Activity are used to convey dataset usage. The classes duv:Citation, bibo:Document, cito:CitationAct are used to represent citation. The classes duv:Feedback, oa:Annotation, duv:Rating are used to represent feedback.

8. Vocabulary Specification

Property:title

Property: description

Property: title

Property: description

Property: developedBy

Property: consumes

Property: generates

Property: title

Property: description

Property: title

Property: description

Property: cites

Property: hasCitingEntity

Property: endorses

Property: annotatedBy

Property: retains

Property: has_rating

Property: has_datasetCorrection

9. DUV Requirements

This section shows some of the requirements that motivated the development of the Dataset Usage Vocabulary. These requirements were derived from the use cases described in Data on the Web Best Practices Use Cases & Requirements document.

R-TrackDataUsage

It should be possible to track the usage of data.

Capability of tracking data usage can help enhancing reputation of the datasets. Records of data usage shows all the successful outcome of the data usage and all the entities associated with it such as the person, organisation, application, research projects that has used these datasets. It increases trust in the data. It also provides provence about how data versions over the time.

R-UsageFeedback

Data consumers should have a way of sharing feedback and rating data.

User feedback is important to address data quality concerns about published dataset. Different users may have different experience with the same dataset so it is important to capture the context in which data was used and the profile of the user who uses it. R-UsageFeedback should also provide a way to communicate suggested corrections and update to the datasets by the users back to data publisher. Data publishers should  have a review mechanism to incorporate submitted corrections.

R-Citable

It should be possible to cite data on the Web.