Copyright © 2016 W3C ® ( MIT , ERCIM , Keio , Beihang ). W3C liability , trademark and document use rules apply.
This document provides a framework in which the quality of a dataset can be described, whether by the dataset publisher or by a broader community of users. It does not provide a formal, complete definition of quality, rather, it sets out a consistent means by which information can be provided such that a potential user of a dataset can make his/her own judgment about its fitness for purpose.
This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/.
This document presents the most mature version of the Data Quality Vocabulary that could be produced in the lifespan of the Data on the Web Best Practices Working Group . At time of publication, its main components have remained stable for several months, even after receiving feedback and suggestions from the community. We expect however that further clarifications and extensions of this model may be carried out by future working groups, considering requirements from specific domains or applications.
This document was published by the Data on the Web Best Practices Working Group as a Working Group Note. If you wish to make comments regarding this document, please send them to [email protected] ( subscribe , archives ). All comments are welcome.
Publication as a Working Group Note does not imply endorsement by the W3C Membership. This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.
This document was produced by a group operating under the 5 February 2004 W3C Patent Policy . W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy .
This document is governed by the 1 September 2015 W3C Process Document .
The Data on the Web Best Practices have pointed out the relevance of publishing information about the quality of data published on the Web . Accordingly, the W3C Data on the Web Best Practices Working Group has been chartered to create a vocabulary for expressing data quality. The Data Quality Vocabulary (DQV) presented in this document is foreseen as an extension to the DCAT vocabulary [ vocab-dcat ] to cover the quality of the data, how frequently is it updated, whether it accepts user corrections, persistence commitments etc. When used by publishers, this vocabulary will foster trust in the data amongst developers.
This vocabulary does not seek to determine what "quality" means. We believe that quality lies in the eye of the beholder; that there is no objective, ideal definition of it. Some datasets will be judged as low-quality resources by some data consumers, while they will perfectly fit others' needs. In accordance, we attach a lot of importance to allowing many actors to assess the quality of datasets and publish their annotations, certificates, opinions about a dataset. A dataset's publisher should seek to publish metadata that helps data consumers determine whether they can use the dataset to their benefit. However, publishers should not be the only ones to have a say on the quality of data published in an open environment like the Web. Certification agencies, data aggregators, data consumers can make relevant quality assessments, too.
We want to stimulate this by making it easier to publish, exchange and consume quality metadata, for every step of a dataset's lifecycle. This is why next to rather expected constructs like quality measurements, the Data Quality Vocabulary puts an emphasis on feedback, annotation, policies and certificates.
DQV draws inspiration from and is aligned with existing work on representing data quality, notably the daQ ontology for representing information (especially metrics) on the quality of linked open datasets [ DaQ ]. daQ is itself anchored in the RDF Data Cube framework for publishing statistical data [ Vocab-Data-Cube ]. Note that DQV elements can be applied not only to express metadata on the quality of datasets; they can also be used to express statements about the quality of that metadata itself. This is especially true when it comes to representing the provenance of that metadata or its conformance with respect to established metadata standards.
A list of DQV-related implementations including references to vocabulary extending DQV, tools serializing quality results in DQV, portals exposing data quality in DQV, and papers citing the DQV, is maintained at the DQV Implementation wiki page . Please feel free to contact the editors if you have any implementation to report.
The
namespace
for
DQV
is
http://www.w3.org/ns/dqv#
.
DQV,
however,
seeks
to
re-use
elements
from
other
vocabularies,
notably
DCAT
,
following
the
best
practices
for
data
vocabularies
identified
by
the
Data
on
the
Web
Best
Practices
Working
Group.
The table below indicates the full list of namespaces and prefixes used in this document.
Prefix | Namespace |
---|---|
daq | http://purl.org/eis/vocab/daq# |
dcat | http://www.w3.org/ns/dcat# |
dcterms | http://purl.org/dc/terms/ |
dqv | http://www.w3.org/ns/dqv# |
duv | http://www.w3.org/ns/duv# |
oa | http://www.w3.org/ns/oa# |
prov | http://www.w3.org/ns/prov# |
sdmx-attribute | http://purl.org/linked-data/sdmx/2009/attribute# |
skos | http://www.w3.org/2004/02/skos/core# |
The following vocabulary is based on DCAT [ vocab-dcat ] that it extends with a number of additional properties and classes suitable for expressing the quality of a dataset.
The quality of a given dataset or distribution is assessed via a number of observed properties. For instance, one may consider a dataset to be of high quality because it conforms to a specific standard while for other use-cases the quality of the data will depend on its level of interlinking with other datasets. To express these properties an instance of a dcat:Dataset or dcat:Distribution can be related to five different types of quality information represented by the following classes:
DQV defines quality measures as specific instances of Quality Measurements, adapting the daQ quality framework [ DaQ ], [ DaQ-RDFCUBE ]. It relies on quality dimensions and quality metrics.
rdfs:label
or
rdfs:comment
)
or
boolean
(e.g.,
whether
or
not
a
SPARQL
endpoint
is
accessible).
Besides quality measurements, DQV considers certificates, standards, and quality policies, which can also be organized according to dimensions. Quality metadata containers ( dqv:QualityMetadata ) can group together different quality statements, so that their provenance can be tracked jointly.
N.B.: "containment" refers to the inclusion of quality statements into "containers", which may or may not be treated as (RDF) graphs (see later example and the usage note for the class dqv:QualityMetadata ).
Quality information can be derived from other quality information. For example, a quality annotation can be derived from a standard or a quality measurement. Quality measurements can be derived from other measurements. Metrics can be derived from other metrics. A standard can be built on another standard or a (set of) metrics. DQV models such derivations through the property prov:wasDerivedFrom as illustrated in the diagram below.
Subclassing between DQV and W3C 's Provenance Ontology [ PROV-O ] has not been explicitly stated in this document, as PROV-O classes can be inferred by the use of PROV-O relations. This editorial choice is not meant to limit in any way the use of PROV-O with DQV. In fact, specific examples of PROV-O exploitation have been included to express the derivation between quality metrics, measurements and annotations , and to document the provenance of quality metadata and single quality measurements .
Some properties from third-party vocabularies like Dublin Core [ Dublin-Core ], RDF Data Cube [ Vocab-Data-Cube ] and Web Annotation [ WebAnnotation ] are included here in order to make the document more self-contained and better readable. The definitions of these properties are copied from their original specifications and the way these properties should be used in the context of Data Quality Vocabulary is explained in the DQV usage notes.
RDF Class: | dqv:QualityMeasurement |
---|---|
Definition: | Represents the evaluation of a given dataset (or dataset distribution) against a specific quality metric. |
Subclass of: | qb:Observation |
Equivalent to: | daq:Observation |
DQV usage note: | The unit of measure in quality measurement should be specified through the property sdmx-attribute:unitMeasure as recommended by RDF Data Cube [ Vocab-Data-Cube ]. The Ontology of units of Measure (OM) [ RijgersbergEtAl ] provides a list of HTTP dereferenceable unit of measures, which can be exploited as values for sdmx-attribute:unitMeasure . |
The following properties can be used with instances of this class: dqv:isMeasurementOf , qb:dataSet , dqv:computedOn , dqv:value .
RDF Property: | dqv:isMeasurementOf |
---|---|
Definition: | Indicates the metric being observed. |
Instance of: | qb:DimensionProperty |
Domain: | qb:Observation |
Range: | dqv:Metric |
Equivalent to: | daq:metric |
RDF Property: | qb:dataSet |
---|---|
Definition: | Indicates the data set of which this observation is a part. |
Domain: | qb:Observation |
Range: | qb:DataSet |
DQV usage note: | Indicates the dataset to which a quality measurement (which is an RDF Data Cube observation) belongs. This is not the dataset whose quality is being measured, which is indicated by dqv:computedOn . |
RDF Property: | dqv:computedOn |
---|---|
Definition: | Refers to the resource (e.g., a dataset, a linkset, a graph, a set of triples) on which the quality measurement is performed. In the DQV context, this property is generally expected to be used in statements in which objects are instances of dcat:Dataset or dcat:Distribution . |
Instance of: | qb:DimensionProperty |
Domain: | dqv:QualityMeasurement |
Range: | rdfs:Resource (introduced for compatibility with RDF Data Cube ) |
Equivalent to: | daq:computedOn |
Inverse property: | dqv:hasQualityMeasurement |
RDF Property: | dqv:value |
---|---|
Definition: | Refers to values computed by metric. |
Instance of: | qb:MeasureProperty , owl:DatatypeProperty |
Domain: | dqv:QualityMeasurement |
Equivalent to: | daq:value |
RDF Class: | dqv:Metric |
---|---|
Definition: | Represents a standard to measure a quality dimension. An observation (instance of dqv:QualityMeasurement ) assigns a value in a given unit to a Metric. |
Equivalent to: | daq:Metric |
The following properties can be used with instances of this class: dqv:inDimension , dqv:expectedDataType .
RDF Property: | dqv:expectedDataType |
---|---|
Definition: | Represents the expected data type for the metric's observed value (e.g., xsd:boolean, xsd:double etc...) |
Domain: | dqv:Metric |
Range: | xsd:anySimpleType |
Equivalent to: | daq:expectedDataType |
RDF Class: | dqv:Dimension |
---|---|
Definition: | Represents criteria relevant for assessing quality. Each quality dimension must have one or more metric to measure it. A dimension is linked with a category using the dqv:inCategory property. |
Subclass of: | skos:Concept |
Equivalent to: | daq:Dimension |
The following property can be used with instances of this class: dqv:inCategory . SKOS properties that can be used with instances of SKOS Concepts [ SKOS-reference ] can also be used with instances of this class. The appendix "Quality dimensions defined in ISO/IEC 25012" and "Quality dimensions defined for Linked Data" show examples of uses of this class.
RDF Property: | dqv:inCategory |
---|---|
Definition: | Represents the category a dimension is grouped in. |
Domain: | dqv:Dimension |
Range: | dqv:Category |
Inverse: | daq:hasDimension |
DQV usage note: | Categories are meant to systematically organize dimensions. The Data Quality Vocabulary defines no specific cardinality constraints for dqv:inCategory , since distinct quality frameworks might have different perspectives over a dimension. A dimension may therefore be associated to more than one category. However, those who define new quality metrics should try to avoid this as much as possible and assign only one category to the dimensions they define. |
RDF Class: | dqv:Category |
---|---|
Definition: | Represents a group of quality dimensions in which a common type of information is used as quality indicator. |
Subclass of: | skos:Concept |
Equivalent to: | daq:Category |
SKOS properties that can be used with instances of SKOS Concepts [ SKOS-reference ] can also be used with instances of this class. The appendix "Quality dimensions defined in ISO/IEC 25012" and "Quality dimensions defined for Linked Data" show examples of uses of this class.
Dimension
and
category
are
abstract
entities.
We
represent
instances
dqv:Dimension
and
dqv:Category
as
instances
of
skos:Concept
,
which
we
think
enable
similar
features
as
these
for
dimensions
and
categories
in
daQ.
Our
representation
choice
differs
significantly
for
metrics,
however.
daQ
uses
RDFS/OWL
classes
and
subclasses
so
as
to
represent
constraints
on
measurements
(e.g.,
on
the
type
of
values).
RDFS/OWL
does
not
allow
one
to
fully
capture
all
constraints.
Additionally,
other
languages
are
being
defined
to
represent
constraints
in
more
appropriate
ways.
We
think
it
is
therefore
not
appropriate
now
to
recommend
to
treat
specific
metrics
as
subclasses
of
dqv:Metric,
and
we
refer
implementers
to
future
progress
on
SHACL
and
related
technology.
See
Appendix
"Defining
and
using
parameters
for
metrics"
for
further
discussion.
RDF Class: | dqv:QualityMeasurementDataset |
---|---|
Definition: | Represents a dataset of quality measurements, evaluations of one or more datasets (or dataset distributions) against specific quality metrics. |
Subclass of: | qb:DataSet |
Equivalent to: | daq:QualityGraph |
The following property can be used with instances of this class: qb:structure . The appendix "Compatibility with RDF Data Cube" shows an example of use of this class.
RDF Property: | qb:structure |
---|---|
Definition: | Indicates the structure to which this data set conforms. |
Domain: | qb:DataSet |
Range: | qb:DataStructureDefinition |
DQV usage note: | In DQV, each dataset of quality measurements is an RDF Cube DataSet. This property can be used to indicate the RDF Data structure definition a dataset of quality measurements is expected to comply with. |
RDF Class: | dqv:QualityPolicy |
---|---|
Definition: | Represents a policy or agreement that is chiefly governed by data quality concerns. |
The following properties can be used with instances of this class: dqv:inDimension , odrl:target . The section "Express the conformance of a dataset with a quality policy" shows examples of uses of this class.
RDF Property: | odrl:target |
---|---|
Definition: | The target property specifies the Asset upon which the Action is performed. |
Domain: | odrl:Rule |
Range: | odrl:Asset |
DQV usage note: |
This property is used to attach an instance of dqv:QualityPolicy to a dataset, a linkset, a graph, a set of triples, etc. In the DQV context, this property is generally expected to be used in statements in which objects are instances of dcat:Dataset or dcat:Distribution . |
RDF Class: | dqv:QualityAnnotation |
---|---|
Definition: | Represents quality annotations, including ratings, quality certificates or feedback that can be associated to datasets or distributions. Quality annotations must have one oa:motivatedBy statement with an instance of oa:Motivation (and skos:Concept ) that reflects a quality assessment purpose. We define this instance as dqv:qualityAssessment . |
Subclass of: | oa:Annotation |
Equivalent to: |
EquivalentClasses( dqv:QualityAnnotation ObjectHasValue( oa:motivatedBy dqv:qualityAssessment ) ) |
The following properties can be used with instances of this class: dqv:inDimension , oa:hasTarget , oa:hasBody .
RDF Property: | oa:hasTarget |
---|---|
Definition: | The relationship between an Annotation and its Target. |
Domain: | oa:Annotation |
DQV usage note: | This property is used in DQV to connect an instance of dqv:QualityAnnotation or its subclasses ( dqv:QualityCertificate and dqv:UserQualityFeedback ) to the resource the annotation is about. Any kind of resource (e.g., a dataset, a linkset, a graph, a set of triples) could be a target. However, in the DQV context, this property is generally expected to be used in statements in which objects are instances of dcat:Dataset or dcat:Distribution . |
RDF Property: | oa:hasBody |
---|---|
Definition: | The object of the relationship is a resource that is a body of the Annotation. |
Domain: | oa:Annotation |
DQV usage note: | This property is used in DQV to connect an instance of dqv:QualityAnnotation or its subclasses ( dqv:QualityCertificate and dqv:UserQualityFeedback ) to the body of the annotation, e.g., a certificate or a textual comment. |
The Web Annotation Vocabulary [ WebAnnotation ] is intended as a W3C Recommendation, but it is still under development at the time of publishing this Note. We have made our best to consider the latest version available, but changes might take place until it becomes a formal Recommendation. For example, new kinds of annotation body might be included and supersede the types we have considered in DQV. For this reason, we invite readers to check examples in this Note with the latest version of the Web Annotation Vocabulary.
RDF Class: | dqv:QualityCertificate |
---|---|
Definition: | An annotation that associates a resource (especially, a dataset or a distribution) to another resource (for example, a document) that certifies the resource's quality according to a set of quality assessment rules. |
Subclass of: | dqv:QualityAnnotation |
The section "Express that a dataset received an ODI certificate" shows an example of use of this class.
Future DQV versions may opt for renaming this class. The current name is a little misleading, as it hints that instances of this class are quality certificates rather than annotations pointing to quality certificates. Feedback is welcome!
RDF Class: | dqv:UserQualityFeedback |
---|---|
Definition: | Represents feedback that users have on the quality of datasets or distributions. Besides dqv:qualityAssessment , which is the motivation required by all quality annotations, one of the predefined instances of oa:Motivation should be indicated as motivation to distinguish among the different kinds of feedback, e.g., classifications, questions. |
Subclass of: | dqv:QualityAnnotation duv:UserFeedback |
The section "Express a question about dataset quality" shows an example of use of this class.
RDF Class: | dqv:QualityMetadata |
---|---|
Definition: | Represents quality metadata, it is defined to group quality certificates, policies, measurements and annotations under a named graph. |
Subclass of: | rdfg:Graph |
DQV usage note: |
QualityMetadata containers do not necessary include all types of quality statements DQV can support. Implementers decide the granularity of containment. In the current version of DQV, we also leave open the choice of the containment "technique". Implementers can use (RDF) graph containment . They may also use an appropriate property of their choice — for example (a subproperty of) dcterms:hasPart — to link instances of dqv:QualityMetadata with instances of other DQV classes. |
The following properties can be used with instances of this class: prov:wasGeneratedBy , prov:wasAttributedTo , prov:wasDerivedFrom . The sections "Document the provenance of the quality metadata" and "Document the provenance of single quality measurements" show examples of uses of this class.
RDF Property: | prov:wasGeneratedBy |
---|---|
Definition: | Generation is the completion of production of a new entity by an activity. This entity did not exist before generation and becomes available for usage after this generation. |
Domain: | prov:Entity |
Range: | prov:Activity |
DQV usage note: | This property is used in DQV to connect an instance of dqv:QualityMetadata to the prov:Activity that has generated it. |
RDF Property: | prov:wasAttributedTo |
---|---|
Definition: | Attribution is the ascribing of an entity to an agent. |
Domain: | prov:Entity |
Range: | prov:Agent |
DQV usage note: | This property is used in DQV to connect an instance of dqv:QualityMetadata to the prov:Agent the metadata was attributed to. |
RDF Property: | dqv:inDimension |
---|---|
Definition: | Represents the dimensions a quality metric, certificate and annotation allow a measurement of. |
Range: | dqv:Dimension |
Equivalent to: |
SubObjectPropertyOf( ObjectInverseOf( daq:hasMetric ) dqv:inDimension ) |
DQV usage note: | Dimensions are meant to systematically organize metrics, quality certificates and quality annotations. The Data Quality Vocabulary defines no specific cardinality constraints for dqv:inDimension, since distinct quality frameworks might have different perspectives over a metric. A metric may therefore be associated to more than one dimension. However, those who define new quality metrics should try to avoid this as much as possible and assign only one dimension to the metrics they define. More than one dimension can be indicated for each quality annotation or certificate. |
RDF Property: | dcterms:conformsTo |
---|---|
Definition: | An established standard to which the described resource conforms. |
Range: | dcterms:Standard |
The section "Express the conformance of a dataset's metadata with a standard" shows examples of uses of this property.
RDF Property: | dqv:hasQualityMeasurement |
---|---|
Definition: | Refers to the performed quality measurements. Quality measurements can be performed to any kind of resource (e.g., a dataset, a linkset, a graph, a set of triples). However, in the DQV context, this property is generally expected to be used in statements in which subjects are instances of dcat:Dataset or dcat:Distribution . |
Range: | dqv:QualityMeasurement |
Inverse property: | dqv:computedOn |
RDF Property: | dqv:hasQualityMetadata |
---|---|
Definition: | Refers to a grouping of quality information such as certificates, policies, measurements and annotations as a named graph. Quality information represented in such a grouping can pertain to any kind of resource (e.g., a dataset, a linkset, a graph, a set of triples). However, in the DQV context, this property is generally expected to be used in statements in which subjects are instances of dcat:Dataset or dcat:Distribution . |
Range: | dqv:QualityMetadata |
RDF Property: | dqv:hasQualityAnnotation |
---|---|
Definition: | Refers to a quality annotation. Quality annotation can be applied to any kind of resource, e.g., a dataset, a linkset, a graph, a set of triples. However, in the DQV context, this property is generally expected to be used in statements in which subjects are instances of dcat:Dataset or dcat:Distribution . |
Range: | dqv:QualityAnnotation |
Equivalent to: |
SubObjectPropertyOf( dqv:hasQualityAnnotation ObjectInverseOf( oa:hasTarget ) ) |
RDF Property: | prov:wasDerivedFrom |
---|---|
Definition: | A derivation is a transformation of an entity into another, an update of an entity resulting in a new one, or the construction of a new entity based on a pre-existing entity. |
Domain: | prov:Entity |
Range: | prov:Entity |
DQV usage note: |
prov:wasDerivedFrom expresses a quite abstract relation of derivation. More specialized relations of derivation can be defined as subproperties of prov:wasDerivedFrom, whenever this is required by applications. |
The section "Expressing derivation between quality metrics, measurements and annotations" shows examples of uses of this property.
RDF Instance: | dqv:qualityAssessment |
---|---|
Definition: | Motivation that must be specified for quality annotations. |
Instance of: | oa:Motivation |
Narrower than: | oa:assessing |
Whenever DQV implementers need to extend the motivations for quality annotations, they should follow the instructions provided by the Web Annotation Data Model, and the concepts in the extension should be defined as specializations of dqv:qualityAssessment .
RDF Instance: | dqv:precision |
---|---|
Definition: | Precision is a quality dimension, which refers to the recorded level of details. It represents the exactness of a measurement or description. It is equivalent the notion of Precision from ISO 25012. |
Instance of: | dqv:Dimension |
The section "Express dataset precision and accuracy" shows an example of use of this instance.
The above section presents the most important classes and properties that DQV uses to represent quality-related metadata. I.e., these are the elements needed to express the machine-readable information that DQV-aware data consumers can exploit for their processes. However, in many cases extra human-readable information is also needed, e.g., to provide (multilingual) definitions and labels or just more context for the quality measurements, metrics, etc. that are expressed with the core DQV classes.
To this end, we recommend using appropriate vocabularies like SKOS [ SKOS-reference ], Dublin Core [ Dublin-Core ] or PROV [ PROV-O ]. SKOS and PROV provide elements that fit specific purposes but can be applied to a wide range of resources, i.e., they minimize their ontological commitment . The section "Express a quality assessment with quality metrics" shows examples with the properties skos:prefLabel and skos:definition . These properties can be applied to instances of dqv:Dimension , which are by default instances of skos:Concept , but also to instances of dqv:Metric , which are not. Dublin Core provides general-purpose metadata elements that can also be used to express, say, a general description of a measurement:
:currentnessMeasurement a dqv:QualityMeasurement ; dqv:value "false"^^xsd:boolean dcterms:description “The triples in the dataset are outdated” .
NB:
in
the
remainder
of
this
section,
the
prefix
"
:
"
refers
to
http://example.org/
:myDataset
,
and
its
distribution
:myDatasetDistribution
,
:myDataset a dcat:Dataset ;dcterms:title ;dcterms:title "My dataset" ; dcat:distribution :myDatasetDistribution . :myDatasetDistribution a dcat:Distribution ;dcat:downloadURL <http: dcterms:title ; dcat:mediaType ; dcat:byteSize ^^xsd:decimaldcat:downloadURL <http://www.example.org/files/mydataset.csv> ; dcterms:title "CSV distribution of dataset" ; dcat:mediaType "text/csv" ; dcat:byteSize "87120"^^xsd:decimal .
An
automated
quality
checker
has
provided
a
quality
assessment
with
two
(CSV)
quality
measurements
for
:myDatasetDistribution
.
:myDatasetDistribution dqv:hasQualityMeasurement :measurement1, :measurement2 .; ; ;:measurement1 a dqv:QualityMeasurement ; dqv:computedOn :myDatasetDistribution ; dqv:isMeasurementOf :downloadURLAvailabilityMetric ; dqv:value "true"^^xsd:boolean .; ; ;:measurement2 a dqv:QualityMeasurement ; dqv:computedOn :myDatasetDistribution ; dqv:isMeasurementOf :csvCompletenessMetric ; dqv:value "0.5"^^xsd:double .; ; ;#definition of dimensions and metrics :availability a dqv:Dimension ; skos:prefLabel "Availability"@en ; skos:definition "Availability of a dataset is the extent to which data (or some portion of it) is present, obtainable and ready for use."@en ; dqv:inCategory :accessibility .; ; ;:completeness a dqv:Dimension ; skos:prefLabel "Completeness"@en ; skos:definition "Completeness refers to the degree to which all required information is present in a particular dataset."@en ; dqv:inCategory :intrinsicDimensions .; ; ;:downloadURLAvailabilityMetric a dqv:Metric ; skos:definition "It checks if dcat:downloadURL is available and if its value is dereferenceable."@en ; dqv:expectedDataType xsd:boolean ; dqv:inDimension :availability .; ; ;:csvCompletenessMetric a dqv:Metric ; skos:definition "Ratio between the number of objects represented in the csv and the number of objects expected to be represented according to the declared dataset scope."@en ; dqv:expectedDataType xsd:double ; dqv:inDimension :completeness .
Categories and dimensions might be more extensively defined, see in the section 'Dimensions and metrics hints' for further examples. Any quality framework is free to define its own dimensions and categories.
The
results
of
metrics
obtained
in
the
previous
assessment
are
stored
in
the
:myQualityMetadata
graph.
# :myQualityMatadata is a graph
:myQualityMetadata {
:myDatasetDistribution
dqv:hasQualityMeasurement :measurement1, :measurement2
.
# The graph contains the rest of the statements presented in the previous example.
}
# :myQualityMetadata has been created by :myQualityChecker and it is the result of the
# :myQualityChecking activity
:myQualityMetadata
a dqv:QualityMetadata ;
prov:wasAttributedTo :myQualityChecker ;
prov:generatedAtTime "2015-05-27T02:52:02Z"^^xsd:dateTime ;
prov:wasGeneratedBy :myQualityChecking .
# :myQualityChecker is a service computing some quality metrics
:myQualityChecker
a prov:SoftwareAgent ;
rdfs:label "A quality assessment service"^^xsd:string .
# Further details about quality service/software can be provided, for example,
# deploying vocabularies such as Dataset Usage Vocabulary (DUV), Dublin Core or ADMS.SW
# :myQualityChecking is the activity that has generated :myQualityMetadata from
# :myDatasetDistribution
:myQualityChecking
a prov:Activity;
rdfs:label "The checking of myDatasetDistribution's quality"^^xsd:string;
prov:wasAssociatedWith :myQualityChecker;
prov:used :myDatasetDistribution;
prov:generated :myQualityMetadata;
prov:endedAtTime "2015-05-27T02:52:02Z"^^xsd:dateTime;
prov:startedAtTime "2015-05-27T00:52:02Z"^^xsd:dateTime
.
The
group
has
discussed
provenance
at
different
levels
of
granularity
(dqv:QualityMeasurement
and
dqv:QualityMetadata).
In
the
previous
example
we
have
shown
how
to
track
provenance
at
the
level
of
quality
metadata
as
a
whole.
In
the
following,
we
provide
an
example
of
provenance
for
a
single
quality
measurement,
:myMeasurement
.
:myDatasetDistribution dqv:hasQualityMeasurement :myMeasurement . # :myMeasurement has been created by :myQualityChecker and it is the result of the # :myQualityChecking activity :myMeasurement a dqv:QualityMeasurement ; dqv:computedOn :myDatasetDistribution ; dqv:isMeasurementOf :downloadURLAvailabilityMetric ; dqv:value "true"^^xsd:boolean ; prov:wasAttributedTo :myQualityChecker ; prov:generatedAtTime "2015-05-27T02:52:02Z"^^xsd:dateTime ; prov:wasGeneratedBy :myQualityChecking . :downloadURLAvailabilityMetric a dqv:Metric ; skos:definition "Checks if dcat:downloadURL is available and if its value is dereferenceable."@en ; dqv:expectedDataType xsd:boolean ; dqv:inDimension :availability . # :myQualityChecker is a service computing some quality metrics :myQualityChecker a prov:SoftwareAgent ; rdfs:label "A quality assessment service"^^xsd:string . # Further details about quality service/software can be provided, for example, # deploying vocabularies such as Dataset Usage Vocabulary (DUV), Dublin Core or ADMS.SW # :myQualityChecking is the activity that has generated :myMeasurement from :myDatasetDistribution :myQualityChecking a prov:Activity; rdfs:label "The checking of myDatasetDistribution's quality"^^xsd:string; prov:wasAssociatedWith :myQualityChecker; prov:used :myDatasetDistribution; prov:generated :myMeasurement; prov:endedAtTime "2015-05-27T02:52:02Z"^^xsd:dateTime; prov:startedAtTime "2015-05-27T00:52:02Z"^^xsd:dateTime .
Statements
similar
to
the
ones
applied
to
the
resource
:myQualityMetadata
above
can
be
applied
to
the
resource
:myDataset
to
indicate
the
provenance
of
the
dataset.
I.e.,
a
dataset
can
be
generated
by
a
specific
software
agent,
be
generated
at
a
certain
time,
etc.
The
HCLS
Community
Profile
for
describing
datasets
provides
further
examples.
Let us express that an ODI certificate for the "City of Raleigh Open Government Data" dataset is available at the URL <https://certificates.theodi.org/en/datasets/393/certificate>.
<https://certificates.theodi.org/en/datasets/393> a dcat:Dataset ; dqv:hasQualityAnnotation :myDatasetQA . :myDatasetQA a dqv:QualityCertificate ;oa:hasTarget <https: oa:hasBody <https:oa:hasTarget <https://certificates.theodi.org/en/datasets/393> ; oa:hasBody <https://certificates.theodi.org/en/datasets/393/certificate> ; oa:motivatedBy dqv:qualityAssessment .
Let us ask a question about the completeness of the "City of Raleigh Open Government Data" dataset.
<https://certificates.theodi.org/en/datasets/393> a dcat:Dataset ; dqv:hasQualityAnnotation :questionQA . :questionQA a dqv:UserQualityFeedback ;oa:hasTarget <https://certificates.theodi.org/en/datasets/> ;oa:hasTarget <https://certificates.theodi.org/en/datasets/393> ; oa:hasBody :textBody ; oa:motivatedBy dqv:qualityAssessment, oa:questioning ; dqv:inDimension :completeness . :textBody a oa:TextualBody ;rdf:value "Could you please provide information about the completeness of your dataset?" ; dc:language ; dc:formatrdf:value "Could you please provide information about the completeness of your dataset?" ; dc:language "en" ; dc:format "text/plain" .
Let us express that the "City of Raleigh Open Government Data" dataset is classified as a four stars dataset against the 5 Stars Linked Open Data rating system.
<https://certificates.theodi.org/en/datasets/393> a dcat:Dataset ; dqv:hasQualityAnnotation :classificationQA . :classificationQA a dqv:UserQualityFeedback ;oa:hasTarget ;oa:hasTarget <https://certificates.theodi.org/en/datasets/393> ; oa:hasBody :four_stars ; oa:motivatedBy dqv:qualityAssessment, oa:classifying ; dqv:inDimension :availability . :four_stars a skos:Concept; skos:inScheme :OpenData5Star ; skos:prefLabel "Four stars"@en ;skos:definition "Dataset available on the web with structured machine-readable nonskos:definition "Dataset available on the Web with structured machine-readable non proprietary format. It uses URIs to denote things."@en .
DQV
models
derivation
with
the
property
prov:wasDerivedFrom
.
For
example,
the
accessibility
of
the
dataset
:myDataset
can
be
derived
from
the
accessibility
of
its
distributions
:myCSVDatasetDistribution
and
:mySPARQLDatasetDistribution
.
:myDataset a dcat:Dataset ; dcterms:title "My dataset" ; dcat:distribution :myCSVDatasetDistribution, :mySPARQLDatasetDistribution . :myCSVDatasetDistribution a dcat:Distribution ;dcat:downloadURL ;dcat:downloadURL <http://www.example.org/files/mydataset.csv> ; dcterms:title "CSV distribution of dataset" ; dcat:mediaType "text/csv" ; dcat:byteSize "87120"^^xsd:decimal . :mySPARQLDatasetDistribution a dcat:Distribution ;dcat:accessURLdcat:accessURL <http://www.example.org/sparql> dcterms:title "SPARQL access to the dataset" ; dcat:mediaType "application/sparql-results+json" . # definition of dimensions and metrics :availability a dqv:Dimension ; skos:prefLabel "Availability"@en ; skos:definition "Availability of a dataset is the extent to which data (or some portion of it) is present, obtainable and ready for use."@en ; dqv:inCategory :accessibility . :downloadURLAvailabilityMetric a dqv:Metric ; skos:definition "Checks if dcat:downloadURL is available and if its value is dereferenceable."@en ; dqv:expectedDataType xsd:boolean ; dqv:inDimension :availability . :SPARQLAvailabilityMetric a dqv:Metric ; skos:definition "Checks if an URL specified in dcat:accessURL is available and if at that URL a SPARQL endpoint is active."@en ; dqv:expectedDataType xsd:boolean ; dqv:inDimension :availability . :datasetAvailabilityMetric a dqv:Metric ; prov:wasDerivedFrom :downloadURLAvailabilityMetric, :SPARQLAvailabilityMetric; skos:definition "Checks the availabitity of the specified distributions."@en ; dqv:expectedDataType xsd:boolean ; dqv:inDimension :availability .
Depending
on
the
specific
application
context,
the
expression
of
this
derivation
can
be
kept
at
level
of
the
quality
measurements.
In
the
following,
the
measurement
:measurement3
of
:myDataset
's
availability
is
derived
from
:measurement1
and
:measurement2
.
:myCSVDatasetDistribution dqv:hasQualityMeasurement :measurement1 ..:mySPARQLDatasetDistribution dqv:hasQualityMeasurement :measurement2 ..:myDataset dqv:hasQualityMeasurement :measurement3 .; ; ;:measurement1 a dqv:QualityMeasurement ; dqv:computedOn :myCSVDatasetDistribution ; dqv:isMeasurementOf :downloadURLAvailabilityMetric ; dqv:value "true"^^xsd:boolean; ; ;:measurement2 a dqv:QualityMeasurement ; dqv:computedOn :mySPARQLDatasetDistribution ; dqv:isMeasurementOf :SPARQLAvailabilityMetric ; dqv:value "false"^^xsd:boolean .; ; ; ;:measurement3 a dqv:QualityMeasurement ; dqv:computedOn :myDataset ; dqv:isMeasurementOf :datasetAvailabilityMetric ; prov:wasDerivedFrom :measurement1, :measurement2 ; dqv:value "false"^^xsd:boolean .
The
classification
of
:myDataset
as
:three_stars
can
be
derived
from
the
result
of
a
quality
measurement
:measurement2
:myDataset dqv:hasQualityAnnotation :myDatasetClassification .; ; ; ; ;:myDatasetClassification a dqv:UserQualityFeedback ; prov:wasDerivedFrom :measurement2 ; oa:hasTarget :myDataset ; oa:hasBody :three_stars ; oa:motivatedBy dqv:qualityAssessment, oa:classifying ; dqv:inDimension :availability .; ; ;:three_stars a skos:Concept; skos:inScheme :OpenData5Star ; skos:prefLabel "three stars"@en ; skos:definition "Dataset available on the Web with structured machine-readable non proprietary format."@en .
Let’s
consider
:myControlledVocabulary
,
a
controlled
vocabulary
made
available
on
the
Web
using
the
SKOS
[
SKOS-reference
]
and
DCAT
[
vocab-dcat
].
:myControlledVocabulary a dcat:Dataset ;dcterms:titledcterms:title "My controlled vocabulary" . :myControlledVocabularyDistribution a dcat:Distribution ;dcat:downloadURL <http: dcterms:title ; dcat:mediaType ; dcat:byteSize ^^xsd:decimaldcat:downloadURL <http://www.example.org/files/myControlledVocabulary.ttl> ; dcterms:title "SKOS/RDF distribution of my controlled vocabulary" ; dcat:mediaType "text/turtle" ; dcat:byteSize "190120"^^xsd:decimal .
qSKOS is an open source tool, which detects quality issues affecting SKOS vocabularies [ qSKOS ]. It considers 26 quality issues including, for example, “Incomplete Language Coverage” and “Label Conflicts” which are grouped in the category “Labeling and Documentation issues”. Quality issues addressed by qSKOS can be considered as DQV quality dimensions, whilst the number of concepts in which a quality issue occurs can be the metric deployed for each quality dimension.
# definition of instances for some of the metrics, dimensions and categories deployed # in qSKOS.; ; ; ;:numOfConceptsWithLabelConflicts a dqv:Metric; skos:prefLabel "Conflicting concepts"@en ; skos:definition "Number of concepts having conflicting labels"@en ; dqv:expectedDataType xsd:interger ; dqv:inDimension :LabelConflicts .; ; ; ; .:numOfConceptsWithIncompleteLanguageCoverage a dqv:Metric; skos:prefLabel "Language incomplete concepts"@en ; skos:definition "Number of concepts having an incomplete language coverage"@en ; dqv:expectedDataType xsd:interger ; dqv:inDimension :incompleteLanguageCoverage .; ; ; .:LabelConflicts a dqv:Dimension; skos:prefLabel "Label Conflicts"@en ; skos:definition "Dimension corresponding to the label conflicts quality issue"@en ; dqv:inCategory :labelingDocumentationIssues .; ; ; .:incompleteLanguageCoverage a dqv:Dimension; skos:prefLabel "Incomplete Language Coverage"@en ; skos:definition "Dimension corresponding to the incomplete language coverage issue"@en ; dqv:inCategory :labelingDocumentationIssues .; ;:labelingDocumentationIssues a dqv:Category ; skos:prefLabel "Labeling and Documentation Issues"@en ; skos:definition "Category grouping labeling and documentation issues"@en .
DQV
represents
the
qSKOS
quality
assessment
on
:myControlledVocabulary
for
the
dimensions
“Incomplete
Language
Coverage”
and
“Label
Conflicts”.
:myDatasetDistribution dqv:hasQualityMeasurement :measurement1, :measurement2 .; ; ;:measurement1 a dqv:QualityMeasurement ; dqv:computedOn :myControlledVocabulary ; dqv:isMeasurementOf :numOfConceptsWithMissingValues ; dqv:value "1500"^^xsd:integer .; ; ;:measurement2 a dqv:QualityMeasurement ; dqv:computedOn :myControlledVocabulary ; dqv:isMeasurementOf :numOfConceptsWithIncompleteLanguageCoverage ; dqv:value "450"^^xsd:integer .
(VoID) linksets are collections of (RDF) links between two datasets: the linkset's subject and the linkset's object, containing respectively the subjects and objects of all link statements. Linksets are as important as datasets when it comes to the joint exploitation of datasets served independently in Linked Data. The representation of quality for a linkset is another example of how DQV can be exploited.
Let’s
define
three
DCAT
datasets,
including
one
VoID
linkset,
which
connects
a
subject
dataset
to
an
object
dataset
named
respectively
by
void:subjectsTarget
and
by
void:objectsTarget
:
:myDataset1 a dcat:Dataset ; dcterms:title "My dataset 1" .; 2":myDataset2 a dcat:Dataset ; dcterms:title "My dataset 2" .; 2"; ; ;:myLinkset a dcat:Dataset, void:Linkset ; dcterms:title "A Linkset from My dataset 1 to My dataset 2"; void:linkPredicate skos:exactMatch ; void:subjectsTarget :myDataset1 ; void:objectsTarget :myDataset2 .
We
can
represent
information
about
the
quality
of
:myLinkset
using
the
“Multilingual
importing”
quality
metric
[
MultilingualImporting
].
This
metric
applies
to
linksets
between
datasets
that
include
SKOS
concepts
[
SKOS-reference
].
It
considers
the
concepts
that
have
been
matched
and
quantifies
the
information
gain
the
links
provide
if
one
adds
the
preferred
labels
or
the
alternative
labels
of
the
concepts
from
the
object
dataset
to
the
descriptions
of
the
concepts
from
the
subject
dataset.
Let
us
first
define
the
proper
metric,
dimension
and
category.
# Definition of instances for Metric, Dimension and Category.;:importingForPropertyPercentage a dqv:Metric ; skos:definition "Ratio between novel preferred or alternative labels gained from the object dataset via skos:exactMatch links and the preferred or alternative labels that are in the subject and object datasets."@en dqv:expectedDataType xsd:double ;.dqv:inDimension :completeness .; ; ;:completenessGain a dqv:Dimension ; skos:prefLabel "Completeness Gain"@en ; skos:definition "Degree to which a linkset contribute to add relevant information to a particular dataset."@en ; dqv:inCategory :complementationGain .;:complementationGain a dqv:Category ; skos:definition "Category that groups dimensions measuring the data quality gain obtained by exploiting linksets."@en .
The
quality
assessment
of
the
"label
importing"
depends
on
two
extra
parameters:
:onProperty
and
:onLanguage
,
which
are
respectively,
the
SKOS
property
and
the
language
tag
considered
for
measuring
the
completeness
gains.
We
add
the
following
statements
to
represent
these
parameters
(note
that
type
qb:DimensionProperty
and
the
range
definitions
are
firstly
needed
for
compatibility
with
RDF
Data
Cube
).
:onLanguage a qb:DimensionProperty, owl:DataProperty ; rdfs:comment "Language on which label importing is assessed."@en ; rdfs:domain dqv:QualityMeasurement; rdfs:label "Label import assessment language"@en ; rdfs:range xsd:string .; ; ; ;:onProperty a qb:DimensionProperty, rdf:Property ; rdfs:comment "Property on which label importing is assessed."@en ; rdfs:domain dqv:QualityMeasurement ; rdfs:label "Label import assessment property"@en ; rdfs:range rdf:Property .
Let us add actual quality assessments for alternative and preferred labels in Italian and English:
## for Italian alternative labels :measurement_exactMatchAltLabelIt a dqv:QualityMeasurement; dqv:computedOn :myLinkset ; dqv:value "1.0"^^xsd:double ; dcterms:date "2016-01-10"^^xsd:date ; dqv:isMeasurementOf :importingForPropertyPercentage ; :onLanguage "it" ; :onProperty skos:altLabel .## ; ; ; ; ; " ; .## for English alternative labels :measurement_exactMatchAltLabelEn a dqv:QualityMeasurement; dqv:computedOn :myLinkset ; dqv:value "0.1"^^xsd:double ; dcterms:date "2016-01-10"^^xsd:date; dqv:isMeasurementOf :importingForPropertyPercentage ; :onLanguage "en" ; :onProperty skos:altLabel .## ; ; ; ; ; " ; .## for Italian preferred labels :measurement_exactMatchPrefLabelIt a dqv:QualityMeasurement; dqv:computedOn :myLinkset ; dqv:value "0.5"^^xsd:double ; dcterms:date "2016-01-10"^^xsd:date ; dqv:isMeasurementOf :importingForPropertyPercentage ; :onLanguage "it" ; :onProperty skos:prefLabel .## ; ; ; ; ; " ; .## for English preferred labels :measurement_exactMatchPrefLabelEn a dqv:QualityMeasurement; dqv:computedOn :myLinkset ; dqv:value "1"^^xsd:double ; dcterms:date "2016-01-10"^^xsd:date ; dqv:isMeasurementOf :importingForPropertyPercentage ; :onLanguage "en" ; :onProperty skos:prefLabel .
It is often desirable to indicate that metadata about datasets in a catalogue are compliant with a metadata standard, or an application profile of an existing metadata standard. A typical example is the GeoDCAT Application Profile [ GeoDCAT-AP ], an extension of the DCAT vocabulary [ vocab-dcat ] to represent metadata for geospatial data portals. GeoDCAT-AP allows one to express that a dataset's metadata conforms to an existing standard, following the recommendations of ISO 19115, ISO 19157 and the EU INSPIRE directive. DCAT partly supports the expression of such metadata conformance statements. The following example illustrates how a (DCAT) catalog record can be said to be conformant with the GeoDCAT-AP standard itself.
:myDataset a dcat:Dataset . :myDatasetRecord a dcat:CatalogRecord ; foaf:primaryTopic :myDataset ; dcterms:conformsTo :geoDCAT-AP . :geoDCAT-AP a dcterms:Standard;dcterms:title ; dcterms:comment "GeoDCAT-AP is developed in the context of the Interoperability Solutions for European Public Administrations (ISA) Programme"@en; dcterms:issued ^^xsd:date ;dcterms:title "GeoDCAT Application Profile. Version 1.0" ; dcterms:comment "GeoDCAT-AP is developed in the context of the Interoperability Solutions for European Public Administrations (ISA) Programme"@en; dcterms:issued "2015-12-23"^^xsd:date ; foaf:page<https://joinup.ec.europa.eu/asset/dcat_application_profile/asset_release/geodcat-ap-v1><https://joinup.ec.europa.eu/asset/dcat_application_profile/asset_release/geodcat-ap-v10> .
Note
that
this
example
does
not
include
the
metadata
about
the
dataset
:myDataset
itself.
We
assume
this
is
present
in
an
RDF
data
source
accessible
via
the
URI
:myDatasetRecord
.
We
also
assume
that
:geoDCAT-AP
is
a
reference
URI
that
denotes
the
GeoDCAT-AP
standard,
which
can
be
re-used
across
many
catalog
record
descriptions,
not
just
a
locally
introduced
URI.
Finer-grained representation of conformance statements can be found in the literature, and applications with more complex requirements may implement them, including for example the requirement of representing 'non-conformance' tested by specific procedures. The GeoDCAT Application Profile, for example, suggests a "provisional mapping" for extended profiles, which re-uses the PROV data model for provenance (see Annex II.14 at [ GeoDCAT-AP ]). Such patterns come however at the cost of having to publish and exchange representations that are much more elaborate. They will also have to be aligned with the result of another ongoing efforts on data validation and the reporting thereof, as currently discussed around SHACL, for example. We have thus decided to postpone addressing these requirements for now.
DQV
introduces
the
class
dqv:QualityPolicy
to
express
that
a
Dataset
or
Distribution
follows
a
policy
or
agreement
that
is
chiefly
defined
by
data
quality
concerns.
DQV
does
not
provide
a
complete
framework
for
expressing
policies.
The
class
dqv:QualityPolicy
is
rather
meant
as
an
anchor
point,
through
which
DQV
implementers
can
relate
properties
and
classes
of
policy-dedicated
vocabularies,
such
as
ODRL
[
ODRL
],
to
the
core
elements
that
define
quality
of
datasets
and
distributions.
The
example
below
specifies
that
a
data
provider
grants
the
permission
to
access
a
dataset
and
commits
to
serve
the
data
with
a
certain
quality,
more
concretely,
99%
availability
of
a
SPARQL
endpoint
(distribution)
associated
with
the
dataset.
This
is
expressed
in
ODRL
as
an
offer
with
a
duty
on
the
service
provider
that
states
a
constraint
defined
using
a
DQV
metric
(
:sparqlEndpointUptime
),
for
which
measurements
have
to
be
greater
than
a
certain
percentage
(99).
The
odrl:assigner
is
the
issuer
of
the
policy
statement;
it
is
also
the
assignee
of
the
duty
to
deliver
the
distribution
as
the
policy
requires
it.
There
is
no
explicitly
mentioned
recipient
for
the
policy
itself,
since
this
examples
is
about
a
generic
data
access
scenario.
Note
that
instances
of
dqv:QualityPolicy
could
be
instances
of
the
class
odrl:Agreement
,
in
which
case
an
odrl:assignee
is
likely
to
appear
for
the
policy.
:serviceProvider a odrl:Party . :myDataset a dcat:Dataset ; dcat:distribution :myDatasetSparqlDistribution ; :myDatasetSparqlDistribution a dcat:Distribution . :policy1 a odrl:Offer, dqv:QualityPolicy ; odrl:permission [ a odrl:Permission ; odrl:target :myDataset ; odrl:action odrl:read ; odrl:assigner :serviceProvider; odrl:duty [ a odrl:Duty; odrl:assignee :serviceProvider; odrl:target :myDatasetSparqlDistribution ; odrl:constraint [ a odrl:Constraint ; prov:wasDerivedFrom :sparqlEndpointUptime;odrl:percentage ^^xsd:double ;odrl:percentage "99"^^xsd:double ; odrl:operator odrl:gteq ] ] ] .
The expression of constraints in ODRL seems quite unfit with expressing general constraints on values in RDF graphs, as we would require here. However, ODRL can be easily extended, and is schedule to undergo refinement in the context of the W3C Permissions & Obligations Expression Working Group . In the future implementers should investigate whether a general constraint expression language like the coming SHACL [ SHACL ] provides a more appropriate mechanism to be used on top of ODRL permissions and duties.
The need for documenting data precision (also sometimes referred to as "resolution") is a common requirement, in particular, when dealing with spatial data. The following example shows how DQV can meet this requirement.
:myDataset a dcat:Dataset ; dqv:hasQualityMeasurement :myDatasetPrecision, :myDatasetAccuracy . :myDatasetPrecision a dqv:QualityMeasurement ; dqv:isMeasurementOf :spatialResolutionAsDistance ;dqv:value ^^xsd:decimal ; sdmx-attribute:unitMeasure <http:dqv:value "1000"^^xsd:decimal ; sdmx-attribute:unitMeasure <http://www.wurvoc.org/vocabularies/om-1.8/metre> . :spatialResolutionAsDistance a dqv:Metric;skos:definition @en ;skos:definition "Spatial resolution of a dataset expressed as distance"@en ; dqv:expectedDataType xsd:decimal ; dqv:inDimension dqv:precision .
Precision can be alternatively expressed without unit of measure specifying spatial resolution by means of an "equivalent scale" with a fraction (e.g., 1:1,000, 1:1,000,000)
:myDataset a dcat:Dataset; dqv:hasQualityMeasurement :myDatasetPrecisionES .; ;:myDatasetPrecisionES a dqv:QualityMeasurement ; dqv:isMeasurementOf :spatialResolutionAsEquivalentScale ; dqv:value "0.000001"^^xsd:decimal .; , ; ;:spatialResolutionAsEquivalentScale a dqv:Metric; skos:definition "Spatial resolution of a dataset expressed as equivalent scale, by using a representative fraction (e.g., 1:1,000, 1:1,000,000)."@en ; dqv:expectedDataType xsd:decimal ; dqv:inDimension dqv:precision .
or specifying the angular distance.
:myDataset a dcat:Dataset; dqv:hasQualityMeasurement :myDatasetPrecisionAS . :myDatasetPrecisionAS a dqv:QualityMeasurement ; dqv:isMeasurementOf :spatialResolutionAsAngularDistance ;dqv:value ^^xsd:decimal ; sdmx-attribute:unitMeasure <http:dqv:value "3.5"^^xsd:decimal ; sdmx-attribute:unitMeasure <http://www.wurvoc.org/vocabularies/om-1.8/degree> . :spatialResolutionAsAngularDistance a dqv:Metric;skos:definition @en ;skos:definition "Spatial resolution of a dataset expressed as angular distance"@en ; dqv:expectedDataType xsd:decimal ; dqv:inDimension dqv:precision .
Note
that
the
precision
(or
resolution)
of
a
dataset
is
not
equivalent
to
its
accuracy.
High
precision
values
are
not
necessarily
accurate.
High
precision
values
can
even
be
pointless,
as
when
one
asserts
that
Magna
Carta
was
signed
at
1215-06-15T00:00:00
.
Accuracy
is
nonetheless
an
important
dimension
of
data
quality.
Data
accuracy
metrics
and
measurements
can
be
represented
with
DQV,
as
in
the
following
example:
:myDatasetAccuracy a dqv:QualityMeasurement ; dqv:isMeasurementOf :spatialAccuracy ;dqv:value ^^xsd:decimal sdmx-attribute:unitMeasure <http://www.wurvoc.org/vocabularies/om-/Percentage>dqv:value "98.2"^^xsd:decimal sdmx-attribute:unitMeasure <http://www.wurvoc.org/vocabularies/om-1.8/Percentage> . :spatialAccuracy a dqv:Metric;skos:definition "Percentage of spatial elements that are found accurate according to methodology XYZ"@en ;skos:definition "Percentage of spatial elements that are found accurate according to methodology XYZ"@en ; dqv:expectedDataType xsd:decimal ; dqv:inDimension ldqd:semanticAccuracy .
This section gathers relevant quality dimensions and ideas for corresponding metrics, which might be eventually represented as instances of dqv:Category , dqv:Dimension and dqv:Metric . The goal of the Data Quality Vocabulary is not to define a normative list of dimensions and metrics. There are already several reference classifications available, which are the result of a lot of community work. Unifying them here seems both hard and not desirable, as fundamental approaches to quality vary between domains or even applications. This section provides instead a set of examples, starting from use cases included in the Use Cases & Requirements document . In particular, we offer the quality dimension proposed in ISO 25012 [ ISOIEC25012 ] and Zaveri et al. [ ZaveriEtAl ] as two starting points. Ultimately, implementers will need to choose themselves the approach that fits best their needs. They can extend on these starting points, creating their own refinements of categories and dimensions, and of course their own metrics. They can mix existing approaches — we show that the proposals from ISO and Zaveri et al. are not completely disjoint. Implementers can also adopt completely different classifications, if existing ones do not fit their specific application scenarios. They should however be aware that relying on existing classifications and metrics increases interoperability, i.e., the chance that human and machine agents can properly understand and exploit their quality assessments.
Statistics
are
not
systematically
conceived
as
quality
measures.
Yet,
statistics
on
datasets
can
be
seen
as
quality
indicators
relevant
for
the
dimensions
listed
in
the
rest
of
this
section.
For
instance,
the
percentages
of
empty
string
attributes
and
of
URIs
that
do
not
point
to
any
useful
information
(either
directly
in
the
published
data
or
via
HTTP
content
negotiation)
can
indicate
quality
issues
for
compliance
or
completeness.
These
indicators
can
be
published
as
such
or
aggregated
with
other
statistics
into
further
refined
quality
assessments,
using
the
pattern
with
prov:wasDerivedFrom
presented
in
the
"Vocabulary
Overview"
section.
The following table gives examples of statistics that can be computed on a dataset and interpreted as quality indicators for completeness and understandability, coming from the VoID extension created for the Aether tool . We invite readers interested in statistics to investigate whether elements coming from Aether or similar efforts can match their needs.
Observation | Suggested term |
---|---|
Number of distinct external resources linked to | http://ldf.fi/void-ext#distinctIRIReferenceObjects |
Number of distinct external resources used (including schema terms) | http://ldf.fi/void-ext#distinctIRIReferences |
Number of distinct literals | http://ldf.fi/void-ext#distinctLiterals |
Number of languages used | http://ldf.fi/void-ext#languages |
The Aether VoID extension represents statistics as direct statements that have a dataset as subject and an integer as object. This pattern, which can be expected to be rather common, is different from the pattern that DQV inherits from daQ. Guidance on how DQV can work with other quality statistics vocabulary shall be provided with future versions of the DQV documentation.
ISO/IEC 25012 provides an example of quality dimensions grouped in three categories that can be adopted to document the quality of datasets. These quality dimensions and categories are listed in the table below.
Category | Dimension | Definition |
---|---|---|
Inherent Data Quality | Accuracy | The degree to which data has attributes that correctly represent the true value of the intended attribute of a concept or event in a specific context of use. |
Completeness | The degree to which subject data associated with an entity has values for all expected attributes and related entity instances in a specific context of use. | |
Consistency | The degree to which data has attributes that are free from contradiction and are coherent with other data in a specific context of use. It can be either or both among data regarding one entity and across similar data for comparable entities. | |
Credibility | The degree to which data has attributes that are regarded as true and believable by users in a specific context of use. Credibility includes the concept of authenticity (the truthfulness of origins, attributions, commitments). | |
Currentness | The degree to which data has attributes that are of the right age in a specific context of use. | |
Inherent and System-Dependent Data Quality | Accessibility | The degree to which data can be accessed in a specific context of use, particularly by people who need supporting technology or special configuration because of some disability. |
Compliance | The degree to which data has attributes that adhere to standards, conventions or regulations in force and similar rules relating to data quality in a specific context of use. | |
Confidentiality | The degree to which data has attributes that ensure that it is only accessible and interpretable by authorized users in a specific context of use. Confidentiality is an aspect of information security (together with availability, integrity) as defined in ISO/IEC 13335-1:2004. | |
Efficiency | The degree to which data has attributes that can be processed and provide the expected levels of performance by using the appropriate amounts and types of resources in a specific context of use. | |
Precision | The degree to which data has attributes that are exact or that provide discrimination in a specific context of use. | |
Traceability | The degree to which data has attributes that provide an audit trail of access to the data and of any changes made to the data in a specific context of use. | |
Understandability | The degree to which data has attributes that enable it to be read and interpreted by users, and are expressed in appropriate languages, symbols and units in a specific context of use. Some information about data understandability are provided by metadata. | |
System-Dependent Data Quality | Availability | The degree to which data has attributes that enable it to be retrieved by authorized users and/or applications in a specific context of use. |
Portability | The degree to which data has attributes that enable it to be installed, replaced or moved from one system to another preserving the existing quality in a specific context of use. | |
Recoverability | The degree to which data has attributes that enable it to maintain and preserve a specified level of operations and quality, even in the event of failure, in a specific context of use. |
DQV
can
express
the
dimensions
and
categories
listed
in
the
table
above.
The
following
example
includes
only
an
exemplification
of
the
ISO
dimensions
and
categories,
which
could
be
authoritatively
provided
by
ISO.
Semantic
relation
defined
in
SKOS
can
be
exploited
to
related
categories
and
dimensions.
For
example,
in
the
following,
skos:broader
has
been
exploited
to
define
iso:inherentSystemDependentDataQuality
as
a
specialization
of
iso:inherentDataQuality
and
iso:systemDependentDataQuality
.
# definition of ISO categories; .iso:inherentDataQuality a dqv:Category ; skos:prefLabel "Inherent Data Quality"@en. iso:systemDependentDataQuality a dqv:Category ;.skos:prefLabel "System-Dependent Data Quality"@en. iso:inherentSystemDependentDataQuality a dqv:Category ;.skos:prefLabel "Inherent and System-Dependent Data Quality"@en. skos:broader iso:inherentDataQuality, iso:systemDependentDataQuality . # definition of ISO dimensions iso:accuracy a dqv:Dimension ;; ;dqv:inCategory iso:inherentDataQuality ; skos:prefLabel "Accuracy"@en; skos:definition "The degree to which data has attributes that correctly represent the true value of the intended attribute of a concept or event in a specific context of use."@en . iso:completeness a dqv:Dimension ;; ;dqv:inCategory iso:inherentDataQuality ; skos:prefLabel "Completeness"@en; skos:definition "The degree to which subject data associated with an entity has values for all expected attributes and related entity instances in a specific context of use."@en . iso:consistency a dqv:Dimension ;; ; .dqv:inCategory iso:inherentDataQuality ; skos:prefLabel "Consistency"@en; skos:definition "The degree to which data has attributes that are free from contradiction and are coherent with other data in a specific context of use. It can be either or both among data regarding one entity and across similar data for comparable entities."@en . # ... ... iso:accessibility a dqv:Dimension ;; ;dqv:inCategory iso:inherentSystemDependentDataQuality ; skos:prefLabel "Accessibility"@en; skos:definition "The degree to which data can be accessed in a specific context of use, particularly by people who need supporting technology or special configuration because of some disability."@en . # ... etc ...
Zaveri et al. provides a review of quality dimensions, which is specifically suited for Linked Data [ ZaveriEtAl ].
Category | Dimension | Definition |
---|---|---|
Accessibility dimensions | Availability | Availability of a dataset is the extent to which data (or some portion of it) is present, obtainable and ready for use. |
Licensing | Licensing is defined as the granting of permission for a consumer to re-use a dataset under defined conditions. | |
Interlinking | Interlinking refers to the degree to which entities that represent the same concept are linked to each other, be it within or between two or more data sources. | |
Security | Security is the extent to which data is protected against alteration and misuse. | |
Performance | Performance refers to the efficiency of a system that binds to a large dataset, that is, the more performant a data source is the more efficiently a system can process data. | |
Intrinsic dimensions | Syntactic validity | Syntactic validity is defined as the degree to which an RDF document conforms to the specification of the serialization format. |
Semantic accuracy | Semantic accuracy is defined as the degree to which data values correctly represent the real world facts. | |
Consistency | Consistency means that a knowledge base is free of (logical/formal) contradictions with respect to particular knowledge representation and inference mechanisms. | |
Conciseness | Conciseness refers to the minimization of redundancy of entities at the schema and the data level. | |
Completeness | Completeness refers to the degree to which all required information is present in a particular dataset. | |
Contextual dimensions | Relevancy | Relevancy refers to the provision of information which is in accordance with the task at hand and important to the users’ query. |
Trustworthiness | Trustworthiness is defined as the degree to which the information is accepted to be correct, true, real and credible. | |
Understandability | Understandability refers to the ease with which data can be comprehended without ambiguity and be used by a human information consumer. | |
Timeliness | Timeliness measures how up-to-date data is relative to a specific task. | |
Representational dimensions | Representational-conciseness |
Representational-conciseness
refers
to
the
representation
of
the
data,
which
is
compact
and
well
|
Interoperability | Interoperability is the degree to which the format and structure of the information conforms to previously returned information as well as data from other sources. | |
Interpretability | Interpretability refers to technical aspects of the data, that is, whether information is represented using an appropriate notation and whether the machine is able to process the data. | |
Versatility | Versatility refers to the availability of the data in different representations and in an internationalized way. |
DQV can express these dimensions and categories as shown in the following example. The encoding of all the dimensions and categories mentioned above can be found at https://www.w3.org/2016/05/ldqd .
# definition of categories from Zaveri et al; .ldqd:accessibilityDimensions a dqv:Category ; skos:prefLabel "Accessibility"@en. ldqd:intrinsicDimensions a dqv:Category ;.skos:prefLabel "Intrinsic dimensions"@en. ldqd:contextualDimensions a dqv:Category ;.skos:prefLabel "Contextual dimensions"@en. ldqd:representationalDimensions a dqv:Category ;.skos:prefLabel "Representational Dimensions"@en. #definition of dimensions from Zaveri et al ldqd:availability a dqv:Dimension ;; ;dqv:inCategory ldqd:accessibilityDimensions ; skos:prefLabel "Availability"@en; skos:definition "Availability of a dataset is the extent to which data (or some portion of it) is present, obtainable and ready for use."@en . ldqd:licensing a dqv:Dimension ;; ;dqv:inCategory ldqd:accessibilityDimensions ; skos:prefLabel "Licensing"@en; skos:definition "Licensing is defined as the granting of permission for a consumer to re-use a dataset under defined conditions."@en . ldqd:interlinking a dqv:Dimension ;; ;dqv:inCategory ldqd:accessibilityDimensions ; skos:prefLabel "Consistency"@en; skos:definition "Interlinking refers to the degree to which entities that represent the same concept are linked to each other, be it within or between two or more data sources."@en . # ... etc ...
In
Zaveri
Et
Al.
[
ZaveriEtAl
]
some
dimensions
are
not
completely
independent
and
may
be
related.
These
relationships
can
be
represented
in
DQV
by
using
the
appropriate
SKOS
properties
or
by
specializing
the
SKOS
properties
if
more
specific
semantics
must
be
expressed.
For
example,
ldqd:availability
is
related
to
ldqd:performance
and
ldqd:interlinking
,
whilst
ldqd:semanticAccuracy
is
related
to
ldqd:timeliness
,
ldqd:trustworthiness
,
ldqd:consistency
,
ldqd:syntaticValidity
and
ldqd:completeness
.
ldqd:availability skos:related ldqd:performance , ldqd:interlinking ., , , .ldqd:semanticAccuracy skos:related ldqd:timeliness , ldqd:trustworthiness , ldqd:consistency , ldqd:syntaticValidity , ldqd:completeness , ldqd:interlinking ., .ldqd:consistency skos:related ldqd:conciseness , ldqd:syntaticValidity , ldqd:interoperability ., .ldqd:interoperability skos:related ldqd:conciseness , ldqd:syntaticValidity ., .ldqd:conciseness skos:related ldqd:completeness , ldqd:representationalConciseness ..ldqd:interpretability skos:related ldqd:versatility .# # # .# Note: skos:related is a symmetric property, hence from every statement # ex:subject skos:related ex:object in this example, one can infer that # the statement ex:object skos:related ex:subject is true.
Dimensions can also be related across different categorizations. For example, in the following, we present two possible links between dimensions from ISO/IEC 25012 [ ISOIEC25012 ] and Zaveri et al. Here we assume that completeness is equivalent across both classifications and that ISO's credibility is one specific facet of trustworthiness in Zaveri et al. (see Definition 12 in [ ZaveriEtAl ]). We pencil more such possible relationships in Annex C.
ldqd:completeness skos:exactMatch iso:completeness . ldqd:trustworthiness skos:narrowMatch iso:credibility .
This section presents examples of metrics inspired by those reviewed in Zaveri et al. [ ZaveriEtAl ], in order to further illustrate how dqv:Metric can be instantiated. Note that they are not all specific to Linked Data quality, as some dimensions in Zaveri et al. matches the dimensions of ISO/IEC 25012 (see previous sub-section and Annex).
These examples are just some of the possible ones. They show metrics for different dimensions and kinds of dataset distributions. We might consider reorganizing examples around specific criteria (e.g., include at least a metric for each dimension, or focus on metrics for a specific kind of distribution, e.g., RDF, JSON, CSV). We might also consider to add further examples about derived metrics, multivalued metrics and extra parameters, once we have solved the remaining issues.
:downloadURLAvailabilityMetric a dqv:Metric ;skos:definition "It checks if dcat:downloadURL is available and if its value is dereferenceable."@en ;skos:definition "It checks if dcat:downloadURL is available and if its value is dereferenceable."@en ; dqv:inDimension ldqd:availability ; dqv:expectedDataType xsd:boolean . :sparqlAvailabilityMetric a dqv:Metric ;skos:definition "It checks if a void:sparqlEndpoint is specified for a dataset and if the server responds to a SPARQL query."@en ;skos:definition "It checks if a void:sparqlEndpoint is specified for a dataset and if the server responds to a SPARQL query."@en ; dqv:inDimension ldqd:availability ; dqv:expectedDataType xsd:boolean . :misreportedContentTypeMetric a dqv:Metric ;skos:definition "It detects whether the HTTP response contains the header field stating the appropriate content type of the returned file, e.g. application/rdf+xml"@en ;skos:definition "It detects whether the HTTP response contains the header field stating the appropriate content type of the returned file, e.g. application/rdf+xml"@en ; dqv:inDimension ldqd:availability ; dqv:expectedDataType xsd:boolean . :licensingMetric a dqv:Metric ;skos:definition "It detects the indication of a license in a the DCAT/VoID description or in the dataset of a license itself."@en ;skos:definition "It detects the indication of a license in a the DCAT/VoID description or in the dataset of a license itself."@en ; dqv:inDimension ldqd:licensing ; dqv:expectedDataType xsd:boolean . :highThroughput a dqv:Metric ;skos:definition "It represents the maximum number of answered HTTP-requests per second."@en ;skos:definition "It represents the maximum number of answered HTTP-requests per second."@en ; dqv:inDimension ldqd:performance ; dqv:expectedDataType xsd:integer . :sparqlScalability a dqv:Metric ;skos:definition "It detects whether the time to answer an amount of ten requests divided by ten is not longer than the time it takes to answer one request."@en ;skos:definition "It detects whether the time to answer an amount of ten requests divided by ten is not longer than the time it takes to answer one request."@en ; dqv:inDimension ldqd:performance ; dqv:expectedDataType xsd:boolean . :noRDFSyntaxError a dqv:Metric ;skos:definition "It returns the number of syntax errors detected by an RDF validator."@en ;skos:definition "It returns the number of syntax errors detected by an RDF validator."@en ; dqv:inDimension ldqd:syntacticValidity; dqv:expectedDataType xsd:integer . :noJSONSyntaxError a dqv:Metric ;skos:definition "It returns the number of syntax errors detected by an JSON validator."@en ;skos:definition "It returns the number of syntax errors detected by an JSON validator."@en ; dqv:inDimension ldqd:syntacticValidity; dqv:expectedDataType xsd:integer . :populationCompletenessMetric a dqv:Metric ;skos:definition "Ratio between the number of objects represented in the dataset andskos:definition "Ratio between the number of objects represented in the dataset and the number of objects expected to be represented according to the declared datasetscope."@en ;scope."@en ; dqv:inDimension ldqd:completeness ; dqv:expectedDataType xsd:double .
The UCR document lists relevant requirement for data quality and granularity :
The aforementioned requirements have been further elaborated and extended by new use cases and examples, following discussions on the DWBP WG's mailing list, wiki pages (see here and here ), as well as external contributions during the review process (see the general list of DQV issues that includes such external feedback).
The editors acknowledge the chairs of this Working Group: Hadley Beeman, Yaso Córdova, Deirdre Lee and the staff contact Phil Archer.
The editors also gratefully acknowledge the contributions made to this document by all members of the working group, specially the contributions received from Ghislain Auguste Atemezing, Carlos Laufer, Annette Greiner, Michel Dumontier, Eric Stephan.
The editors would also like to thank comments received from non-members of this working group, such as Andrea Perego, Rachel E. Heaven, Linda van den Brink, Werner Bailer, Vladimir Alexiev, Jon Blower, Guillaume Duffes, Davide Ceolin, Anisa Rula.
Changes since the previous version include:
The
dimensions
listed
in
ISO/IEC
25012
[
ISOIEC25012
]
and
Zaveri
et
al.
[
ZaveriEtAl
]
are
not
disjoint.
Assuming
that
dimensions
are
expressed
as
instances
of
skos:Concept
,
the
following
table
includes
some
of
the
correspondences
that
can
be
considered
between
these
two
classifications.
Dimension from Zaveri et al. | Dimension from ISO/IEC 25012 | Suggested mapping relation |
---|---|---|
Availability | Availability | skos:exactMatch |
Completeness | Completeness | skos:exactMatch |
Consistency | Consistency | skos:exactMatch |
Timeliness | Currentness | skos:exactMatch |
Interoperability | Portability | skos:relatedMatch |
Interoperability | Compliance | skos:relatedMatch |
Semantic Accuracy | Accuracy | skos:broadMatch |
Trustworthiness | Credibility | skos:narrowMatch |
Trustworthiness | Traceability | skos:relatedMatch |
Understandability | Understandability | skos:exactMatch |
|
Understandability |
|
Syntactic Validity | Accuracy | skos:broadMatch |
Syntactic Validity | Compliance | skos:broadMatch |
Licensing | Accessibility | skos:relatedMatch |
Security | Traceability | skos:relatedMatch |
Security | Confidentiality | skos:relatedMatch |
Performance | Efficiency | skos:exactMatch |
Interlinking | Availability | skos:broadMatch |
Representation-conciseness | Compliance | skos:broadMatch |
Conciseness | Accuracy | skos:relatedMatch |
Conciseness | Consistency | skos:relatedMatch |
Some
metrics
come
with
mandatory
or
optional
parameters
.
Input
parameters
in
particular
play
a
key
role
in
describing
metrics
and
measurements:
their
values
specify
how
a
metric
is
applied
to
obtain
a
measurement.
E.g.,
when
a
quality
metric
is
defined
as
a
general
procedure
that
can
be
applied
to
different
types
of
statement
in
the
dataset,
a
parameter
can
be
used
to
indicate
the
type
a
given
measurement
has
focused
on.
Or
when
various
components
that
contribute
to
a
metric's
computation
can
be
assigned
different
weights.
Section
6.10
presents
examples
of
metrics
with
such
parameters
(
:onLanguage
and
:onProperty
).
During the design of DQV, questions were raised about the modeling of parameters in RDF and similar frameworks, especially about expressing that some parameters can be mandatory for measurements of some metrics (see Issue-223 ). The Working Group has postponed the issue, as we felt it was a much less mature aspect of the state of the art, and the we lacked resource to articulate a consensual decision. This appendix presents some of the options we have considered. We welcome readers' feedback!
The
first
issue
is
the
"meta-modeling"
of
parameters,
especially,
how
properties
such
as
:onLanguage
should
be
represented
using
the
modeling
constructs
of
RDF(S)
and
OWL
[
OWL-primer
].
One
can
mint
a
new
property
:parameterValue
:
:onLanguage rdfs:subPropertyOf :parameterValue .
Alternatively,
one
can
create
a
class
of
(parameter)
properties
:ParameterProperty
having
properties
like
:onLanguage
as
instances:
:onLanguage a :ParameterProperty .
Both patterns allow to represent parameters for quality metrics. They have their own strengths and weaknesses in terms of modeling elegance, complexity, etc. However, we could not carry a full analysis and recommend a preferred approach. Moreover, at the time of publishing it is unclear whether using either of them delivers crucial value to implementers interested in the basic needs presented in Section 6.10 . Especially, solutions for representing constraints using OWL axioms or Data Cube's Data Structure Definition, as discussed in the next sub-section, do not seem to be seriously impacted by choosing either of these two meta-modeling approaches, or none.
Note
finally
that
one
may
opt
for
a
more
basic
solution
that
avoids
explicit
modeling
parameters
altogether:
hardcoding
parameters
in
the
definition
of
metrics.
Namely,
in
order
to
represent
the
measurement
alternatives
specific
to
languages
(say,
English
or
Italian)
and
types
of
property
(say,
skos:prefLabel
or
skos:altLabel
),
one
could
"split"
original
metrics
like
:importingForPropertyPercentage
into
new
metrics
that
correspond
to
the
relevant
combination
of
parameters,
as
in
the
following:
:importingForPropertyPercentagePrefLabelIt a dqv:Metric ; skos:definition "Ratio between novel Italian preferred labels gained via skos:exactMatch links and Italian preferred labels already in the datasets."@en dqv:expectedDataType xsd:double ;.dqv:inDimension :completeness .;:importingForPropertyPercentagePrefLabelEn a dqv:Metric ; skos:definition "Ratio between novel English preferred labels gained via skos:exactMatch links and English preferred labels already in the datasets."@en dqv:expectedDataType xsd:double ;.dqv:inDimension :completeness .;:importingForPropertyPercentageAltLabelIt a dqv:Metric ; skos:definition "Ratio between novel Italian alternative labels gained via skos:exactMatch links and Italian alternative labels already in the datasets."@en dqv:expectedDataType xsd:double ;.dqv:inDimension :completeness .;:importingForPropertyPercentageAltLabelEn a dqv:Metric ; skos:definition "Ratio between novel English alternative labels gained via skos:exactMatch links and English alternative labels already in the datasets."@en dqv:expectedDataType xsd:double ;.dqv:inDimension :completeness .
This approach can be useful, as seen at the end of the Appendix on RDF Data Cube . It is however much less easy to implement, should the number of parameters or the sets of their possible values grow high, or, even worse, when the sets of possible values are not known at data modeling stage.
The
second
issue
is
the
expression
of
constraints
on
parameter
usage.
For
example,
specifying
that
every
measurement
of
the
metric
:importingForPropertyPercentage
should
be
the
subject
of
an
:onLanguage
statement
that
indicates
the
language
considered
for
the
measurement.
One
solution
is
to
employ
the
modeling
features
of
the
Web
Ontology
Language
OWL
and
create
a
new
(sub-)class
of
dqv:Metric
that
requires
the
presence
of
the
parameter
for
its
instances,
as
in
this
example
based
on
the
case
from
Section
6.10
:
:MetricWithLanguageParameter rdfs:subClassOf dqv:Metric, [ a owl:Restriction ; owl:onProperty :onLanguage ;owl:cardinality ^^xsd:nonNegativeIntegerowl:cardinality "1"^^xsd:nonNegativeInteger ] . :linksetImportingENSKOSPrefLabel a :MetricWithLanguageParameter ;skos:definition @en; :onLanguage .skos:definition "Importing on English prefLabel"@en; :onLanguage "en" .
This
solution
can
be
used
for
'meta-parameters',
that
is,
when
one
considers
a
class
of
parameter-dependent
metrics
—
where
assigning
a
value
for
a
parameter
allows
one
to
define
an
individual
metric
in
the
class.
However,
this
case
is
different
from
the
one
of
the
metric
"multilingual
importing"
in
Section
6.10
.
This
metric
indeed
specifies
that
its
measurements
should
be
bound
to
specific
languages.
But
it
does
not
say
which:
the
parameter
value
needs
to
be
assigned
at
the
level
of
the
actual
measurements.
Representing
that
would
require
defining
a
new
class
of
measurements,
say,
:MeasurementWithLanguageParameter
,
as
follows:
# The following statements should be added to the ones from Section 6.10 :MeasurementWithLanguageParameter rdfs:subClassOf dqv:Measurement, [ a owl:Restriction ; owl:onProperty :onLanguage ; owl:cardinality "1"^^xsd:nonNegativeInteger ] . :MetricWithLanguageParameter rdfs:subClassOf dqv:Metric, [ a owl:Restriction ; owl:onProperty [ owl:inverseOf dqv:isMeasurementOf ] ; owl:allValuesFrom :MeasurementWithLanguageParameter ] . :importingForPropertyPercentage a :MetricWithLanguageParameter . :measurement_exactMatchAltLabelItDataset1 dqv:isMeasurementOf :importingForPropertyPercentage .
Implementers
should
note
that
this
pattern
is
impacted
by
OWL's
open-world
assumption
.
The
class
definitions
above
do
not
lead
to
constraints
in
the
"traditional"
understanding!
I.e.,
if
an
OWL
reasoner
finds
a
measurement
of
:importingForPropertyPercentage
without
an
:onProperty
statement,
it
will
not
raise
a
formal
inconsistency
error.
It
will
instead
just
assume
that
the
statement
must
have
been
asserted
in
another
RDF
graph
elsewhere.
Other
approaches
may
be
followed
to
palliate
this.
The
RDF
Data
Cube
vocabulary
offers
a
Data
Structure
Definition
mechanism,
which
we
exemplify
in
the
Appendix
on
RDF
Data
Cube
.
This
solution
allows
a
Data
Cube
validation
tool
to
flag
a
language-less
measurement
of
:importingForPropertyPercentage
as
incomplete.
However,
as
hinted
in
this
Appendix,
Data
Cube's
Data
Structures
are
harder
to
apply
when
quality
assessments
of
different
types
are
mixed
together.
A
general
constraint
expression
language
like
the
coming
SHACL
[
SHACL
]
may
provide
an
appropriate
solution.
However,
SHACL
is
still
under
development
at
the
time
of
writing
this
document.
The RDF Data Cube vocabulary [ Vocab-Data-Cube ] provides a means to represent multi-dimension data, including statistics. Measurements represented in DQV can fit this approach, and there might be many benefits in representing them in a way compatible with Data cube prescriptions — starting with the possibility to load measurement data in visualization or processing tools compatible with Data Cube.
In DQV, instances of dqv:QualityMeasurement are also instances of Data Cube's qb:Observation. A dataset (RDF graph) of DQV measurements can be made further compatible with Data Cube by specifying an appropriate (Data Cube) Data Structure Definition, following a pattern introduced by the daQ vocabulary [ DaQ-RDFCUBE ]. The following example is aimed at representing measurements for the metrics capturing the quality of a linkset presented in Section 6.10:
:linksetQualityMeasurements a dqv:QualityMeasurementDataset ; qb:structure ex:dsd .ex:dsd a qb:DataStructureDefinition ; ## Expressing Data Cube dimensions qb:component [ qb:dimension dqv:isMeasurementOf ; qb:order 1 ] ; qb:component [ qb:dimension dqv:computedOn ; qb:order 2 ] ; qb:component [ qb:dimension dcterms:date ; qb:order 3 ] ; ## Expressing the Data Cube measure qb:component [ qb:measure dqv:value ; ] ; ## Expressing the Data Cube attribute (here, unit of measurement) qb:component [ qb:attribute sdmx-attribute:unitMeasure ; qb:componentRequired false ; qb:componentAttachment qb:DataSet ] .
Allowing data publishers to use the properties dqv:isMeasurementOf and dqv:computedOn in such data structures is actually the reason why they have been defined as instances of qb:DimensionProperty >. The following statements represent the linking of actual measurements in Section 6.10 to the dataset specified by the Data Structure Definition:
:measurement_exactMatchAltLabelItDataset1 qb:dataSet :linksetQualityMeasurements . :measurement_exactMatchAltLabelItDataset2 qb:dataSet :linksetQualityMeasurements . :measurement_exactMatchAltLabelEnDataset1 qb:dataSet :linksetQualityMeasurements . :measurement_exactMatchAltLabelEnDataset2 qb:dataSet :linksetQualityMeasurements . :measurement_exactMatchPrefLabelItDataset1 qb:dataSet :linksetQualityMeasurements . :measurement_exactMatchprefLabelItDataset2 qb:dataSet :linksetQualityMeasurements .
DQV users should be aware that applying Data Cube Data Structure Definitions to their quality information datasets has a broad impact on the possible content of these. All resources that are said to be in the dataset (using the qb:dataSet property) are indeed expected to have the components defined as mandatory in the data structure!
RDF Data Cube also states that "no two qb:Observations in the same qb:DataSet may have the same value for all dimensions". This integrity constraint implies that it is not allowed to have two distinct measurements for the same metric, resource and date. Metrics depending on parameters such as the ones from Section 6.10 shall be used with extra care so as to adhere to this constraint: data publishers will probably need to represent quality measurements for the same resource and date, but which are obtained by applying distinct parameters.
Adopters of DQV and Data Cube can consider two modelling options for addressing this:
Let's
apply
the
first
option
to
the
example
of
Section
6.10
.
The
“Multilingual
importing”
metric
there
requires
to
manage
two
parameters,
:onProperty
and
:onLanguage
,
which
gave
raise
to
one
instance
of
owl:DataProperty
each.
These
parameters
can
be
also
expressed
as
instances
qb:DimensionProperty
and
the
above
Data
Structure
extended
as
follows:
## Adding a new type to the parameter properties :onLanguage a qb:DimensionProperty . :onProperty a qb:DimensionProperty . ## Extending the structure of daq:dsq with two new dimensions ex:dsd qb:component [ qb:dimension :onProperty ; qb:order 4 ] ; qb:component [ qb:dimension :onLanguage ; qb:order 5 ] .
Alternatively, data publishers can keep to the original Data Structure. But in this case they should be prepared to not use the parameter properties introduced in 6.10. Instead, they could use the "split" metrics presented at the end of the Appendix on parameters . This solution is however not always applicable, as this Appendix shows it.