Copyright © 2011-2013 W3C® (MIT, ERCIM, Keio, Beihang), All Rights Reserved. W3C liability, trademark and document use rules apply.
The PROV Ontology (PROV-O) expresses the PROV Data Model [PROV-DM] using the OWL2 Web Ontology Language (OWL2) [OWL2-OVERVIEW]. It provides a set of classes, properties, and restrictions that can be used to represent and interchange provenance information generated in different systems and under different contexts. It can also be specialized to create new classes and properties to model provenance information for different applications and domains. The PROV Document Overview describes the overall state of PROV, and should be read before other PROV documents.
The namespace for all PROV-O terms is http://www.w3.org/ns/prov#.
The OWL encoding of the PROV Ontology is available here.
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 http://www.w3.org/TR/.
The W3C Director seeks review and feedback from W3C Advisory Committee representatives by 09 April 2013. This will allow the Director to assess consensus and determine whether to issue this document as a W3C Recommendation.
Others are encouraged by the Provenance Working Group to continue to send reports of implementation experience, and other feedback, to public-prov-comments@w3.org (subscribe, archives). Open discussion among developers is also welcome at public-prov-comments@w3.org (subscribe, archives).
This document was published by the Provenance Working Group as a Proposed Recommendation. This document is intended to become a W3C Recommendation. If you wish to make comments regarding this document, please send them to public-prov-comments@w3.org (subscribe, archives). All feedback is welcome.
Publication as a Proposed Recommendation 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.
The PROV Ontology (PROV-O) defines the OWL2 Web Ontology Language encoding of the PROV Data Model [PROV-DM]. This document describes the set of classes, properties, and restrictions that constitute the PROV Ontology. This ontology specification provides the foundation to implement provenance applications in different domains that can represent, exchange, and integrate provenance information generated in different systems and under different contexts. Together with the PROV Access and Query [PROV-AQ] and PROV Data Model [PROV-DM], this document forms a framework for provenance information interchange in domain-specific Web-based applications.
PROV-O is a lightweight ontology that can be adopted in a wide range of applications. With the exception of five axioms, PROV-O conforms to the OWL-RL profile [OWL2-PRIMER]. The PROV Ontology classes and properties are defined such that they can not only be used directly to represent provenance information, but also can be specialized for modeling application-specific provenance details in a variety of domains. Thus, the PROV Ontology is expected to be both directly usable in applications as well as serve as a reference model for creating domain-specific provenance ontologies and thereby facilitates interoperable provenance modeling. To demonstrate the use of PROV-O classes and properties, this document uses an example provenance scenario similar to the one introduced in the PROV-Primer [PROV-PRIMER].
The PROV Data Model [PROV-DM] introduces a set of concepts to represent provenance information in a variety of application domains. This document maps the PROV Data Model to PROV Ontology using the OWL2 ontology language [OWL2-OVERVIEW].
We briefly introduce some of the OWL2 modeling terms that will be used to describe the PROV Ontology. An OWL2 instance is an individual object in a domain of discourse, for example a person named Alice or a car named KITT. A set of individuals sharing common characteristics constitutes a class. Person and Car are examples of classes representing the set of individual persons and cars respectively. The OWL2 object properties are used to link individuals, classes, or create a property hierarchy. For example, the object property "hasOwner" can be used to link car with person. The OWL2 datatype properties are used to link individuals or classes to data values, including XML Schema datatypes [XMLSCHEMA11-2].
For the purpose of compliance, the normative sections of this document are Section 1.1, Section 1.2, Section 3, Section 4, and Appendix B
The key words "must", "must not", "required", "shall", "shall not", "should", "should not", "recommended", "may", and "optional" in this document are to be interpreted as described in [RFC2119].
This section is non-normative.
The following namespace prefixes are used throughout this document.
prefix | namespace IRI | definition |
rdf | http://www.w3.org/1999/02/22-rdf-syntax-ns# | The RDF namespace [RDF-CONCEPTS] |
xsd | http://www.w3.org/2000/10/XMLSchema# | XML Schema Namespace [XMLSCHEMA11-2] |
owl | http://www.w3.org/2002/07/owl# | The OWL namespace [OWL2-OVERVIEW] |
prov | http://www.w3.org/ns/prov# | The PROV namespace [PROV-DM] |
(others) | (various) | All other namespace prefixes are used in examples only. In particular, IRIs starting with "http://example.com" represent some application-dependent IRI [IRI] |
This section is non-normative.
PROV-O users may only need to use parts of the entire ontology, depending on their needs and according to how much detail they want to include in their provenance information. For this, the PROV-O terms (classes and properties) are grouped into three categories to provide an incremental introduction to the ontology: Starting Point terms, Expanded terms, and terms for Qualifying relationships.
Starting Point classes and properties provide the basis for the rest of the PROV Ontology and thus it is recommended that readers become comfortable with how to apply these terms before continuing to the remaining categories. These terms are used to create simple provenance descriptions that can be elaborated using terms from other categories. The classes and properties in this category are listed below and are discussed in Section 3.1.
Expanded classes and properties provide additional terms that can be used to relate classes in the Starting Point category. The terms in this category are applied in the same way as the terms in the Starting Point category. Many of the terms in this category are subclasses or subproperties of those in the Starting Point category. The classes and properties in this category are listed below and are discussed in Section 3.2.
Qualified classes and properties provide elaborated information about binary relations asserted using Starting Point and Expanded properties. The terms in this category are applied using a pattern that differs from those in the Starting Point and Expanded categories. While the relations from the previous two categories are applied as direct, binary assertions, the terms in this category are used to provide additional attributes of the binary relations. The pattern used in this category allows users to provide elaborate details that are not available using only Starting Point and Expanded terms. The classes and properties in this category are listed below and are discussed in Section 3.3.
This section introduces the terms in each of the following categories:
The Starting Point category is a small set of classes and properties that can be used to create simple, initial provenance descriptions. Three classes provide a basis for the rest of PROV-O:
The three primary classes relate to one another and to themselves using the properties shown in the following figure.
Activities start and end at particular points in time (described using properties prov:startedAtTime and prov:endedAtTime, respectively) and during their lifespan can use and generate a variety of Entities (described with prov:used and prov:wasGeneratedBy, respectively). For example, a blog writing activity may use a particular dataset and generate a bar chart. By expressing usage and generation, one can construct provenance chains comprising both Activities and Entities.
In addition, we can say that an Activity prov:wasInformedBy another Activity to provide some dependency information without explicitly providing the activities' start and end times. A prov:wasInformedBy relation between Activities suggests that the informed Activity used an Entity that was generated by the informing Activity, but the Entity itself is unknown or is not of interest. So, the prov:wasInformedBy property allows the construction of provenance chains comprising only Activities.
Provenance chains comprising only Entities can be formed using the prov:wasDerivedFrom property. A derivation is a transformation of one entity into another. For example, if the Activity that created the bar chart is not known or is not of interest, then we can say that the bar chart prov:wasDerivedFrom the dataset. Arbitrary RDF properties can be used to describe the fixed aspects of an Entity that are interesting within a particular application (for example, the file size and format of the dataset, or the aspect ratio of the bar chart).
While the properties prov:used, prov:wasGeneratedBy, prov:wasInformedBy, and prov:wasDerivedFrom can be used to construct provenance chains among Activities and Entities, Agents may also be ascribed responsibility for any Activity or Entity within a provenance chain. An Agent's responsibility for an Activity or Entity is described using the properties prov:wasAssociatedWith and prov:wasAttributedTo, respectively. Agents can also be responsible for other Agents' actions. In this case of delegation, the influencing Agent prov:actedOnBehalfOf another Agent that also bears responsibility for the influenced Activity or Entity.
The properties rdf:type and rdfs:label are used to express prov:type and prov:label, respectively.
Example 1: The following PROV-O describes the resources involved when creating a chart about crime statistics. The example uses only Starting Point terms and serves as a basis for elaboration that will be described in subsequent sections. In the example, Derek performs an aggregation of some government crime data, grouping by national regions that are described in a separate dataset by a civil action group.
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix foaf: <http://xmlns.com/foaf/0.1/> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.org#> . :bar_chart a prov:Entity; prov:wasGeneratedBy :illustrationActivity; prov:wasDerivedFrom :aggregatedByRegions; prov:wasAttributedTo :derek; . :derek a foaf:Person, prov:Agent; foaf:givenName "Derek"; foaf:mbox <mailto:derek@example.org>; prov:actedOnBehalfOf :natonal_newspaper_inc; . :national_newspaper_inc a foaf:Organization, prov:Agent; foaf:name "National Newspaper, Inc."; . :illustrationActivity a prov:Activity; prov:used :aggregatedByRegions; prov:wasAssociatedWith :derek; prov:wasInformedBy :aggregationActivity; . :aggregatedByRegions a prov:Entity; prov:wasGeneratedBy :aggregationActivity; prov:wasAttributedTo :derek; . :aggregationActivity a prov:Activity; prov:startedAtTime "2011-07-14T01:01:01Z"^^xsd:dateTime; prov:wasAssociatedWith :derek; prov:used :crimeData; prov:used :nationalRegionsList; prov:endedAtTime "2011-07-14T02:02:02Z"^^xsd:dateTime; . :crimeData a prov:Entity; prov:wasAttributedTo :government; . :government a foaf:Organization, prov:Agent . :nationalRegionsList a prov:Entity; prov:wasAttributedTo :civil_action_group; . :civil_action_group a foaf:Organization, prov:Agent .
The example states that the agent :derek
was associated with two
activities: :aggregationActivity
and :illustrationActivity
. The
activity :aggregationActivity
used
the entities :crimeData
(a crime statistics dataset) and :nationalRegionsList
(a list of national regions), and
generated a new entity, :aggregatedByRegions
that aggregates the statistics in
:crimeData
according to the regions in :nationalRegionsList
.
The :aggregatedByRegions
entity was then used by the :illustrationActivity
activity,
to generate a new entity :bar_chart
that depicts the aggregated statistics.
The example also states that the activity :illustrationActivity
was
informed by the activity :aggregationActivity
. Indeed, the former used
the entity :aggregatedByRegions
, which was generated by the latter.
Because the agent :derek
was associated with the activities
:aggregationActivity
and :illustrationActivity
, the entities
generated by these activities, i.e., :aggregatedByRegions
and :bar_chart
, were also
attributed to him.
Finally, the example states that the agent :derek
acted on behalf of the organization :national_newspaper_inc
.
The terms introduced in this section provide additional ways to describe the provenance among Entities, Activities, and Agents. The additional terms are illustrated in the following figure and can be separated into five different categories.
The first category extends the Starting Point terms with subclasses, subproperties, and a superproperty.
Three subclasses of Agent (prov:Person, prov:Organization, and prov:SoftwareAgent) and three subclasses of Entity are provided (prov:Collection, prov:Bundle, and prov:Plan).
A prov:Collection is an Entity that provides a structure (e.g. set, list, etc.) to some constituents (which are themselves Entities). The prov:Collection class can be used to express the provenance of the collection itself: e.g. who maintained the collection, which members it contained as it evolved, and how it was assembled. The prov:hadMember property is used to assert membership in a collection.
A prov:Bundle is a named set of provenance descriptions, which may itself have provenance. The named set of provenance descriptions may be expressed as PROV-O or any other form. The subclass of Bundle that names a set of PROV-O assertions is not provided by PROV-O, since it is more appropriate to do so using other recommendations, standards, or technologies. In any case, a Bundle of PROV-O assertions is an abstract set of RDF triples, and adding or removing a triple creates a new distinct Bundle of PROV-O assertions.
A prov:Plan is an entity that represents a set of actions or steps intended by one or more agents to achieve some goals.
More general and more specific properties are also provided by the expanded terms. More generally, the property prov:wasInfluencedBy is a superproperty that relates any influenced Entity, Activity, or Agent to any other influencing Entity, Activity, or Agent that had an effect on its characteristics. Three subproperties of prov:wasDerivedFrom are also provided for certain kinds of derivation among Entities: prov:wasQuotedFrom cites a potentially larger Entity (such as a book, blog, or image) from which a new Entity was created by repeating some or all of the original, prov:wasRevisionOf indicates that the derived Entity contains substantial content from the original Entity (e.g., two editions of a book), and prov:hadPrimarySource cites a preceding Entity produced by some agent with direct experience and knowledge about the topic (such as a reading from a sensor, or a journal written during an historical event).
The second category of expanded terms relates Entities according to their levels of abstraction, where some Entities may present more specific aspects than their more general counterparts. While prov:specializationOf links a more specific Entity to a more general one (e.g., today's BBC news home page versus BBC's news home page on any day), prov:alternateOf links Entities that present aspects of the same thing, but not necessarily the same aspects or at the same time (e.g., the serialization of a document in different formats or a backup copy of a computer file).
The third category of expanded terms allows further description of Entities. The property prov:value provides a literal value that is a direct representation of an entity. For example, the prov:value of a quote could be a string of the sentences stated, or the prov:value of an Entity involved in a numeric calculation could be the xsd:integer four. The property prov:atLocation can be used to describe the prov:Location of any Entity, Activity, Agent, or prov:InstantaneousEvent (i.e., the starting or ending of an activity or the generation, usage, or invalidation of an entity). The properties used to describe instances of prov:Location are outside the scope of PROV-O; reuse of other existing vocabulary is encouraged.
The fourth category of expanded terms describes the lifetime of an Entity beyond being generated by an Activity and used by other Activities. For example, a painting could not have been displayed before it was painted, and it could not be sold after it was destroyed by fire. Similar to how Activities have start and end times, an Entity may be bound by points in time for which it was generated or is no longer usable. The properties prov:generatedAtTime and prov:invalidatedAtTime can be used to bound the starting and ending moments of an Entity's existence. The Activities that led to the generation or invalidation of an Entity can be provided using prov:wasGeneratedBy and prov:wasInvalidatedBy, respectively. prov:generated and prov:invalidated are the inverses of prov:wasGeneratedBy and prov:wasInvalidatedBy, respectively, and are defined to facilitate Activity-as-subject as well as Entity-as-subject descriptions. For more about inverses, see the Appendix B.
The fifth category of expanded terms describes the lifetime of an Activity beyond its start and end times and predecessor Activities. Activities may also be started or ended by Entities, which are described using the properties prov:wasStartedBy and prov:wasEndedBy, respectively. Since Entities may start or end Activities, and Agents may be Entities, then Agents may also start or end Activities.
The following examples illustrate the expanded terms by elaborating the crime chart example from the previous section. After aggregating the dataset and creating the chart, Derek published a post to exhibit his work.
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix foaf: <http://xmlns.com/foaf/0.1/> . @prefix sioc: <http://rdfs.org/sioc/ns#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix my: <http://www.example.org/vocab#> . @prefix : <http://www.example.org#> . @base <http://www.example.com/derek-bundle.ttl> . <> a prov:Bundle, prov:Entity; prov:wasAttributedTo :postEditor; prov:generatedAtTime "2011-07-16T02:52:02Z"^^xsd:dateTime; . :derek a prov:Person, prov:Agent; ## prov:Agent is inferred from prov:Person foaf:givenName "Derek"; foaf:mbox <mailto:derek@example.org>; prov:actedOnBehalfOf :national_newspaper_inc; . :national_newspaper_inc a prov:Organization, prov:Agent; ## prov:Agent is inferred from prov:Organization foaf:name "National Newspaper, Inc."; . :postEditor a prov:SoftwareAgent, prov:Agent; ## prov:Agent is inferred from prov:SoftwareAgent foaf:name "Post Editor 3000"; . :more-crime-happens-in-cities a sioc:Post, prov:Entity; sioc:latest_version :post9821v2; sioc:previous_version :post9821v1; . ## Version 1 of the post :post9821v1 a sioc:Post, prov:Entity; prov:specializationOf :more-crime-happens-in-cities; ## PERMALINK to the latest revision. sioc:title "More crime happens in cities"; prov:value "I was currius..."; ## The text of this version (with a typo). prov:generatedAtTime "2011-07-16T01:52:02Z"^^xsd:dateTime; prov:wasGeneratedBy :publicationActivity1123; prov:wasInfluencedBy :aggregatedByRegions; ## This blog was influenced by Derek's data analysis. prov:hadPrimarySource :crimeData; ## Derek's blog derives from the crime data originally ## gathered by the government. prov:invalidatedAtTime "2011-07-16T02:02:02Z"^^xsd:dateTime; . :publicationActivity1123 a prov:Activity; prov:startedAtTime "2011-07-16T01:01:01Z"^^xsd:dateTime; prov:wasStartedBy :derek; prov:wasAssociatedWith :postEditor; prov:generated :post9821v1; prov:endedAtTime "2011-07-16T01:52:02Z"^^xsd:dateTime; prov:wasEndedBy :derek; . :aggregatedByRegions a prov:Entity; prov:atLocation <file://Users/aggr.txt>; . <file://Users/aggr.txt> a prov:Location . :crimeData a prov:Entity; prov:wasAttributedTo :government; . :government a prov:Organization, prov:Agent; . ## Version 2 of the post :post9821v2 a sioc:Post, prov:Entity; prov:specializationOf :more-crime-happens-in-cities; ## PERMALINK to the latest revision. prov:value "I was curious..."; ## The text of this version (with fixed typo). prov:generatedAtTime "2011-07-16T02:02:02Z"^^xsd:dateTime; prov:wasRevisionOf :post9821v1; prov:alternateOf :post9821v1; .
Agent :derek
, acting again on behalf of the :national_newspaper_inc
organization,
used the :postEditor
tool to publish a post about his recent data analysis :aggregatedByRegions
.
The blog editing tool tracked Derek's actions as PROV-O assertions and published them as a Bundle (the current file <>
).
The tool recorded that :derek
started and ended the publishing activity (:publicationActivity1123
)
that generated the post :post9821v1
. The post
included a permanent link where the content of the latest version is available
(:more-crime-happens-in-cities
) in addition to a textual snapshot of the current version (using prov:value).
Derek also included additional domain-specific descriptions of the post, such as its title.
Shortly after publishing the post, Derek noticed a typographical error in his narrative.
Because the fix would be minimal, he did not record the activity that led to the new version.
Instead, he related the new version (:post9821v2
) as a revision of the previous (:post9821v1
).
Since both versions of the blog are forms of the long-standing blog permalink :more-crime-happens-in-cities
,
the revisions are alternates of one another and each is a prov:specializationOf of :more-crime-happens-in-cities
.
Shortly after Derek published his blog post, Monica adapted the text for a wider audience in a new post (:post9822
).
This rewrite is an alternate, abbreviated view of the same topic that Derek wrote about and was created from his original text.
Since the provenance produced by the activities of Derek and Monica corresponded to different user views, the system
automatically published it in a different prov:Bundle.
The tool also asserted provenance about the bundle that it produced (e.g., the date of creation, its creator, and the fact that it Derek's bundle was used).
Because a bundle is a kind of entity, all provenance assertions that can be made about entities can also be made about bundles.
The use of bundles enables the creation of provenance of provenance.
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix foaf: <http://xmlns.com/foaf/0.1/> . @prefix sioc: <http://rdfs.org/sioc/ns#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://www.example.org#> . @base <http://www.example.com/monica-bundle.ttl> . <> a prov:Bundle, prov:Entity; prov:wasAttributedTo :postEditor; prov:wasDerivedFrom <http://www.example.com/derek-bundle.ttl> . prov:generatedAtTime "2011-07-16T03:03:03Z"^^xsd:dateTime; . :monica a prov:Person, prov:Agent; foaf:givenName "Monica"; foaf:mbox <mailto:monica@example.org>; . ## Revised post for a different audience is a new resource. :post9822 a sioc:Post, prov:Entity; sioc:title "More crime happens in cities (for dummies)"; prov:wasAttributedTo :monica, :postEditor; prov:alternateOf :more-crime-happens-in-cities; ## This post is an alternate of Derek's blog. prov:value "A quick overview of Derek's..."; ## Snapshot with the content of this version prov:wasRevisionOf :post9821v2; ## Monica rewrote Derek's version 2 to create hers. .
After some time, John wrote his own conclusions in his own post (:post19201
) quoting the previous two posts.
Each quote that John makes (:quote_from_monica
and :quote_from_derek
) is a new entity derived from the
previous blogs and is annotated with the time that the quote was taken.
The provenance of John's blog notes that his post is the result of the quotes that he took from Derek and Monica.
The blog post is also derived from Derek's :aggregatedByRegions
dataset because John inspected it and found a
concern that he discusses in his blog. All the provenance statements related to John's post are grouped in a new prov:Bundle.
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix foaf: <http://xmlns.com/foaf/0.1/> . @prefix sioc: <http://rdfs.org/sioc/ns#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://www.example.org#> . @base <http://www.example.com/john-bundle.ttl> . <> a prov:Bundle, prov:Entity; prov:wasAttributedTo :postEditor; prov:wasDerivedFrom <http://www.example.com/derek-bundle.ttl>, <http://www.example.com/monica-bundle.ttl>; prov:generatedAtTime "2012-08-08T08:08:08Z"^^xsd:dateTime; . :publicationActivity1124 a prov:Activity; prov:wasAttributedTo :postEditor, :john; prov:generated :post19201; . :post19201 a sioc:Post, prov:Entity; prov:wasAttributedTo :john; prov:value "I'm not so sure that..."; prov:wasDerivedFrom :quote_from_derek, :quote_from_monica, :aggregatedByRegions; prov:wasGeneratedBy :publicationActivity1124; . :john a prov:Person, prov:Agent; foaf:name "John"; . :quote_from_derek a prov:Entity; prov:value "Analysis of the datasets demonstrates that there is more crime."; prov:wasQuotedFrom :more-crime-happens-in-cities; prov:generatedAtTime "2012-08-08T01:01:01Z"^^xsd:dateTime; . :quote_from_monica a prov:Entity; prov:value "In summary, there are clearly more crimes in the country."; prov:wasQuotedFrom :post9822; prov:generatedAtTime "2012-08-08T02:02:02Z"^^xsd:dateTime; .
Unfortunately, there was a problem in the servers where :post19201
was being stored, and all the data related to the post was lost permanently.
Thus, the system invalidated the entity automatically and notified John about the error.
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix foaf: <http://xmlns.com/foaf/0.1/> . @prefix sioc: <http://rdfs.org/sioc/ns#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.org#> . :post19201 a sioc:Post, prov:Entity; prov:invalidatedAtTime "2012-09-02T01:31:00Z"^^xsd:dateTime; prov:wasInvalidatedBy :hard_disk_failure; . :hard_disk_failure a prov:Activity; prov:endedAtTime "2012-09-02T01:31:00Z"^^xsd:dateTime; .
The Qualified Terms category is the result of applying the Qualification Pattern [LD-Patterns-QR] to the simple (unqualified) relations available in the Starting Point and Expanded categories. The terms in this category are for users who wish to provide further details about the provenance-related influence among Entities, Activities, and Agents.
The Qualification Pattern restates an unqualified influence relation by using an intermediate class that represents the influence between two resources. This new instance, in turn, can be annotated with additional descriptions of the influence that one resource had upon another. The following two tables list the influence relations that can be qualified using the Qualification Pattern, along with the properties used to qualify them. For example, the second row of the first table indicates that to elaborate how an prov:Activity prov:used a particular prov:Entity, one creates an instance of prov:Usage that indicates the influencing entity with the prov:entity property. Meanwhile, the influenced prov:Activity indicates the prov:Usage with the property prov:qualifiedUsage. The resulting structure that qualifies the an Activity's usage of an Entity is illustrated in Figure 4a below.
Seven Starting Point relations can be further described using the Qualification Pattern. They are listed in the following normative table.
Influenced Class | Unqualified Influence | Influencing Class | Qualification Property | Qualified Influence | Influencer Property |
---|---|---|---|---|---|
prov:Entity | prov:wasGeneratedBy | prov:Activity | prov:qualifiedGeneration | prov:Generation | prov:activity |
prov:Entity | prov:wasDerivedFrom | prov:Entity | prov:qualifiedDerivation | prov:Derivation | prov:entity |
prov:Entity | prov:wasAttributedTo | prov:Agent | prov:qualifiedAttribution | prov:Attribution | prov:agent |
prov:Activity | prov:used | prov:Entity | prov:qualifiedUsage | prov:Usage | prov:entity |
prov:Activity | prov:wasInformedBy | prov:Activity | prov:qualifiedCommunication | prov:Communication | prov:activity |
prov:Activity | prov:wasAssociatedWith | prov:Agent | prov:qualifiedAssociation | prov:Association | prov:agent |
prov:Agent | prov:actedOnBehalfOf | prov:Agent | prov:qualifiedDelegation | prov:Delegation | prov:agent |
Seven Expanded relations can be further described using the Qualification Pattern. They are listed in the following normative table.
Influenced Class | Unqualified Influence | Influencing Class | Qualification Property | Qualified Influence | Influencer Property |
---|---|---|---|---|---|
prov:Entity or prov:Activity or prov:Agent | prov:wasInfluencedBy | prov:Entity or prov:Activity or prov:Agent | prov:qualifiedInfluence | prov:Influence | prov:influencer |
prov:Entity | prov:hadPrimarySource | prov:Entity | prov:qualifiedPrimarySource | prov:PrimarySource | prov:entity |
prov:Entity | prov:wasQuotedFrom | prov:Entity | prov:qualifiedQuotation | prov:Quotation | prov:entity |
prov:Entity | prov:wasRevisionOf | prov:Entity | prov:qualifiedRevision | prov:Revision | prov:entity |
prov:Entity | prov:wasInvalidatedBy | prov:Activity | prov:qualifiedInvalidation | prov:Invalidation | prov:activity |
prov:Activity | prov:wasStartedBy | prov:Entity | prov:qualifiedStart | prov:Start | prov:entity |
prov:Activity | prov:wasEndedBy | prov:Entity | prov:qualifiedEnd | prov:End | prov:entity |
The qualification classes and properties shown in the previous two tables can also be found in the normative cross reference in the next section of this document. All influence classes (e.g. prov:Association, prov:Usage) are extensions of prov:Influence and either prov:EntityInfluence, prov:ActivityInfluence, or prov:AgentInfluence, which determine the property used to cite the influencing resource (either prov:entity, prov:activity, or prov:agent, respectively). Because prov:Influence is a broad relation, its most specific subclasses (e.g. prov:Communication, prov:Delegation, prov:End, prov:Revision, etc.) should be used when applicable.
For example, given the unqualified statement:
:e1 a prov:Entity; prov:wasGeneratedBy :a1; . :a1 a prov:Activity .
One can find that prov:wasGeneratedBy can be qualified using the qualification property prov:qualifiedGeneration, the class prov:Generation (a subclass of prov:ActivityInfluence), and the property prov:activity. From this, the influence relation above can be restated with the qualification pattern as:
:e1 a prov:Entity; prov:wasGeneratedBy :a1; prov:qualifiedGeneration :e1Gen; # Add the qualification. . :e1Gen a prov:Generation; prov:activity :a1; # Cite the influencing Activity. ex:foo :bar; # Describe the Activity :a1's influence upon the Entity :e1. . :a1 a prov:Activity .
The asserter can thus attach additional properties to :e1Gen
to describe the generation of :e1
by :a1
.
As can be seen in this example, qualifying an influence relation provides a second form (e.g. :e1 prov:qualifiedGeneration :e1Gen
) to express an equivalent influence relation
(e.g. :e1 prov:wasGeneratedBy :a1
).
It is correct and acceptable for an implementer to use either qualified or unqualified forms as they choose (or both),
and a consuming application should be prepared to recognize either form.
Consuming applications should recognize both qualified and unqualified forms, and treat the qualified form as implying the unqualified form.
Because the qualification form is more verbose, the unqualified form should be favored in cases where additional properties are not provided.
When the qualified form is expressed, including the equivalent unqualified form can facilitate PROV-O consumption, and is thus encouraged.
In addition to the previous two tables, Figure 4 illustrates the classes and properties needed to apply the qualification pattern to ten of the fourteen qualifiable influence relations. For example, while prov:qualifiedUsage, prov:Usage, and prov:entity are used to qualify prov:used relations, prov:qualifiedAssociation, prov:Association, and prov:agent are used to qualify prov:wasAssociatedWith relations. This pattern applies to the twelve other influence relations that can be qualified.
In subfigure a the prov:qualifiedUsage property parallels the prov:used property and references an instance of prov:Usage, which in turn provides attributes of the prov:used relation between the Activity and Entity. The prov:entity property is used to cite the Entity that was used by the Activity. In this case, the time that the Activity used the Entity is provided using the prov:atTime property and a literal xsd:dateTime value. The prov:atTime property can be used to describe any prov:InstantaneousEvent (including prov:Start, prov:Generation, prov:Usage, prov:Invalidation, and prov:End).
Similarly in subfigure j, the prov:qualifiedAssociation property parallels the prov:wasAssociatedWith property and references an instance of prov:Association, which in turn provides attributes of the prov:wasAssociatedWith relation between the Activity and Agent. The prov:agent property is used to cite the Agent that influenced the Activity. In this case, the plan of actions and steps that the Agent used to achieve its goals is provided using the prov:hadPlan property and an instance of prov:Plan. Further, the prov:hadRole property and prov:Role class can be used to describe the function that the agent served with respect to the Activity. Both prov:Plan and prov:Role are left to be extended by applications.
The following two examples show the result of applying the Usage and Association patterns to the chart-making example from Section 3.1.
The prov:qualifiedUsage property parallels the prov:used property to provide an additional description to :illustrationActivity
. The instance of prov:Usage cites the data used (:aggregatedByRegions
) and the time the activity used it (2011-07-14T03:03:03Z
).
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.org#> . :illustrationActivity a prov:Activity; ## Using Starting Point terms, prov:used :aggregatedByRegions; ## the illustration activity used the aggregated data (to create the bar chart). . :aggregatedByRegions a prov:Entity . :illustrationActivity prov:qualifiedUsage [ ## Qualify how the :illustrationActivity a prov:Usage; ## used prov:entity :aggregatedByRegions; ## the Entity :aggregatedByRegions prov:atTime "2011-07-14T03:03:03Z"^^xsd:dateTime; ## Qualification: The aggregated data was used ## at a particular time to create the bar chart.. ]; .
The prov:qualifiedAssociation property parallels the
prov:wasAssociatedWith property to provide an additional description about the :illustrationActivity
that Derek influenced.
The instance of prov:Association cites the influencing agent (:derek
) that followed the instructions (:tutorial_blog
).
Further, Derek served the role of :illustrationist
during the activity.
@prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.org#> . :illustrationActivity a prov:Activity; ## Using Starting Point terms, prov:wasAssociatedWith :derek; ## the illustration activity was associated with Derek in some way. . :derek a prov:Agent . :illustrationActivity prov:qualifiedAssociation [ ## Qualify how the :illustrationActivity a prov:Association; ## was associated with prov:agent :derek ## the Agent Derek. prov:hadRole :illustrationist; ## Qualification: The role that Derek served. prov:hadPlan :tutorial_blog; ## Qualification: The plan (or recipe, instructions) ## that Derek followed when creating the graphical chart. ]; . :tutorial_blog a prov:Plan, prov:Entity . :illustrationist a prov:Role .
This section finishes with two more examples of qualification as applied to the chart-making example from Section 3.1.
The prov:qualifiedGeneration property parallels the prov:wasGeneratedBy property to provide an additional description to :bar_chart
. The instance of prov:Generation cites the time (2011-07-14T15:52:14Z) that the activity (:illustrationActivity
) generated the chart (:bar_chart
).
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.org#> . :bar_chart a prov:Entity; ## Using Starting Point terms, prov:wasGeneratedBy :illustrationActivity; ## the chart was generated in an illustration activity. . :illustrationActivity a prov:Activity . :bar_chart prov:qualifiedGeneration [ ## Qualify how the :bar_chart a prov:Generation; ## was generated by prov:activity :illustrationActivity; ## the Activity :illustrationActivity. prov:atTime "2011-07-14T15:52:14Z"^^xsd:dateTime; ## Qualification: The Activity generated ## the bar_chart at a particular time. ]; .
The prov:qualifiedDerivation property parallels the prov:wasDerivedFrom
property to provide an additional description to :bar_chart
. The instance of prov:Derivation
cites the activity (:illustrationActivity
) and the Usages and Generations that the activity conduced to create the :bar_chart
.
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.org#> . :bar_chart a prov:Entity; ## Using Starting Point terms, prov:wasDerivedFrom :aggregatedByRegions; ## the chart was derived from the aggregated dataset. . :aggregatedByRegions a prov:Entity . :bar_chart prov:qualifiedDerivation [ ## Qualify a prov:Derivation; ## how :bar_chart was derived from prov:entity :aggregatedByRegions; ## the dataset Entity :aggregatedByRegions. prov:hadActivity :aggregating_activity; ## Qualification: The activity that derived the :bar_chart. prov:hadUsage :use_of_aggregatedData; ## Qualification: How the activity used :aggregatedByRegions. prov:hadGeneration :generation_of_bar_chart; ## Qualification: How the activity generated the :bar_chart. ]; .
This section provides details for each class and property defined by the PROV Ontology, grouped by the categories described above:
The superscripts op and dp denote that a property is an OWL object property or data property, respectively.
Each PROV-O term in this cross reference links to the corresponding PROV-DM concept. The PROV-DM's table Cross-References to PROV-O and PROV-N provides an overview of the correspondences between PROV-O and PROV-DM.
The qualification classes and properties shown in Table 2 and Table 3 of the previous section can also be found in each entry of this cross reference. If the property can be qualified, the can be qualified with header indicates the qualifying property and influence class that should be used. Conversely, the qualifies headers in the listings for qualification terms indicate the unqualified property that they qualify. In the OWL file itself, the annotation properties prov:qualifiedForm and prov:unqualifiedForm provide the same linkages between the unqualified properties and their qualifiying terms.
Most examples shown in this cross reference are encoded using the Turtle RDF serialization. When it is convenient to do so (e.g., when an example describes a prov:Bundle), it may use the [TRIG] syntax. Although this document does not specify how to encode Bundles in RDF, TriG's named graph construct is used only to illustrate the concept of creating a named set of PROV assertions. Note that all examples are non-normative.
The classes and properties that provide a basis for all other PROV-O terms are discussed in Section 3.1.
IRI:http://www.w3.org/ns/prov#Entity
An entity is a physical, digital, conceptual, or other kind of thing with some fixed aspects; entities may be real or imaginary.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix dcterms: <http://purl.org/dc/terms/> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :bar_chart a prov:Entity; dcterms:title "Aggregated statistics from the crime file"^^xsd:string; prov:wasAttributedTo :derek; . :derek a prov:Agent .
IRI:http://www.w3.org/ns/prov#Activity
An activity is something that occurs over a period of time and acts upon or with entities; it may include consuming, processing, transforming, modifying, relocating, using, or generating entities.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :graduation a prov:Activity, :Graduation; prov:startedAtTime "2012-04-15T13:00:00-04:00"^^xsd:dateTime; prov:used :ms_smith; prov:generated :doctor_smith; prov:endedAtTime "2012-04-15T14:30:00-04:00"^^xsd:dateTime; . :ms_smith a prov:Entity . :doctor_smith a prov:Entity .
IRI:http://www.w3.org/ns/prov#Agent
An agent is something that bears some form of responsibility for an activity taking place, for the existence of an entity, or for another agent's activity.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix foaf: <http://xmlns.com/foaf/0.1/> . @prefix : <http://example.com#> . :derek a prov:Agent, prov:Person; foaf:givenName "Derek"^^xsd:string; foaf:mbox <mailto:derek@example.org>; foaf:homePage <http://derek.example.com>; prov:actedOnBehalfOf :national_newspaper_inc; . :national_newspaper_inc a prov:Agent, prov:Organization; foaf:name "National Newspaper, Inc."; .
IRI:http://www.w3.org/ns/prov#wasGeneratedBy
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.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :bar_chart a prov:Entity; prov:wasGeneratedBy :illustrating; . :illustrating a prov:Activity .
IRI:http://www.w3.org/ns/prov#wasDerivedFrom
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.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.com/vocab#> . @prefix : <http://example.com/> . :bar_chart a prov:Entity, ex:Barchart; prov:wasDerivedFrom :aggregatedByRegions; . :aggregatedByRegions a prov:Entity, ex:Dataset; .
IRI:http://www.w3.org/ns/prov#wasAttributedTo
Attribution is the ascribing of an entity to an agent.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :geneSequencing a prov:Activity; prov:startedAtTime "2012-04-25T01:30:00Z"^^xsd:dateTime; prov:used :drosophilaSample-84; prov:wasAssociatedWith :lab-technician-GH-32; prov:endedAtTime "2012-04-25T03:40:00Z"^^xsd:dateTime; . :drosophilaSample-84 a prov:Entity; prov:wasAttributedTo :lab-technician-FE-56; . :lab-technician-GH-32 a prov:Agent . :lab-technician-FE-56 a prov:Agent .
Attribution is the ascribing of an entity to an agent.
IRI:http://www.w3.org/ns/prov#startedAtTime
Start is when an activity is deemed to have been started by an entity, known as trigger. The activity did not exist before its start. Any usage, generation, or invalidation involving an activity follows the activity's start. A start may refer to a trigger entity that set off the activity, or to an activity, known as starter, that generated the trigger.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :geneSequencing a prov:Activity; prov:startedAtTime "2012-04-25T01:30:00Z"^^xsd:dateTime; prov:used :drosophilaSample-84; prov:wasAssociatedWith :lab-technician-GH-32; prov:endedAtTime "2012-04-25T03:40:00Z"^^xsd:dateTime; . :drosophilaSample-84 a prov:Entity . :lab-technician-GH-32 a prov:Agent .
The time at which an activity started. See also prov:endedAtTime.
IRI:http://www.w3.org/ns/prov#used
Usage is the beginning of utilizing an entity by an activity. Before usage, the activity had not begun to utilize this entity and could not have been affected by the entity.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :sortActivity a prov:Activity; prov:atTime "2011-07-16T01:52:02Z"^^xsd:dateTime; prov:used :datasetA; prov:generated :datasetB; . :datasetA a prov:Entity. :datasetB a prov:Entity. # See qualified Usage for example on how the role of :datasetA can be described for this Activity
A prov:Entity that was used by this prov:Activity. For example, :baking prov:used :spoon, :egg, :oven .
IRI:http://www.w3.org/ns/prov#wasInformedBy
Communication is the exchange of an entity by two activities, one activity using the entity generated by the other.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :writing-celebrity-gossip a prov:Activity; prov:wasInformedBy :voicemail-interception; . :voicemail-interception a prov:Activity .
An activity a2 is dependent on or informed by another activity a1, by way of some unspecified entity that is generated by a1 and used by a2.
IRI:http://www.w3.org/ns/prov#endedAtTime
End is when an activity is deemed to have been ended by an entity, known as trigger. The activity no longer exists after its end. Any usage, generation, or invalidation involving an activity precedes the activity's end. An end may refer to a trigger entity that terminated the activity, or to an activity, known as ender that generated the trigger.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :geneSequencing a prov:Activity; prov:startedAtTime "2012-04-25T01:30:00Z"^^xsd:dateTime; prov:used :drosophilaSample-84; prov:wasAssociatedWith :lab-technician-GH-32; prov:endedAtTime "2012-04-25T03:40:00Z"^^xsd:dateTime; . :drosophilaSample-84 a prov:Entity . :lab-technician-GH-32 a prov:Agent .
The time at which an activity ended. See also prov:startedAtTime.
IRI:http://www.w3.org/ns/prov#wasAssociatedWith
An activity association is an assignment of responsibility to an agent for an activity, indicating that the agent had a role in the activity. It further allows for a plan to be specified, which is the plan intended by the agent to achieve some goals in the context of this activity.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :illustrating a prov:Activity; prov:wasAssociatedWith :derek; . :derek a prov:Person, prov:Agent, prov:Entity .
An prov:Agent that had some (unspecified) responsibility for the occurrence of this prov:Activity.
IRI:http://www.w3.org/ns/prov#actedOnBehalfOf
Delegation is the assignment of authority and responsibility to an agent (by itself or by another agent) to carry out a specific activity as a delegate or representative, while the agent it acts on behalf of retains some responsibility for the outcome of the delegated work. For example, a student acted on behalf of his supervisor, who acted on behalf of the department chair, who acted on behalf of the university; all those agents are responsible in some way for the activity that took place but we do not say explicitly who bears responsibility and to what degree.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix foaf: <http://xmlns.com/foaf/0.1/> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :derek a prov:Agent; foaf:givenName "Derek"^^xsd:string; foaf:mbox <mailto:derek@example.org>; prov:actedOnBehalfOf :national_newspaper_inc; . :national_newspaper_inc a prov:Agent, prov:Organization; foaf:name "National Newspaper, Inc."; .
An object property to express the accountability of an agent towards another agent. The subordinate agent acted on behalf of the responsible agent in an actual activity.
The additional terms used to describe relations among Starting Point classes are discussed in Section 3.2.
The terms used to qualify the Starting Point and Expanded properties are discussed in Section 3.3.
IRI:http://www.w3.org/ns/prov#Influence
Influence is the capacity of an entity, activity, or agent to have an effect on the character, development, or behavior of another by means of usage, start, end, generation, invalidation, communication, derivation, attribution, association, or delegation.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix my: <http://example.com/ontology#> . @prefix : <http://example.com/> . # Although a domain extension (e.g. ':wasConductedBy') is not defined by PROV-O, # the relation between a surgery and an agent can still be qualified # by reusing prov:Influence and one of its three subclasses # (depending on the type of influencer): # AgentInfluence, EntityInfluence, and ActivityInfluence. my:wasConductedBy rdfs:subPropertyOf prov:wasAssociatedWith . :conductingSurgery_1 a prov:Activity; # This unqualified influence is unknown in PROV, # but would be a subproperty of wasAssociatedWith. my:wasConductedBy :bob; # Even though PROV systems do not understand my:wasConductedBy, prov:qualifiedAssociation [ # they can recognize that the unknown relation # is being qualified with a prov:hadRole. a prov:Association, prov:AgentInfluence, # Inferred prov:Influence; # Inferred prov:agent :bob; # The object of my:wasConductedBy prov:hadRole my:surgeon; ]; . :bob a prov:Agent . my:surgeon a prov:Role .
Because prov:Influence is a broad relation, its most specific subclasses (e.g. prov:Communication, prov:Delegation, prov:End, prov:Revision, etc.) should be used when applicable.
An instance of prov:Influence provides additional descriptions about the binary prov:wasInfluencedBy relation from some influenced Activity, Entity, or Agent to the influencing Activity, Entity, or Agent. For example, :stomach_ache prov:wasInfluencedBy :spoon; prov:qualifiedInfluence [ a prov:Influence; prov:entity :spoon; :foo :bar ] . Because prov:Influence is a broad relation, the more specific relations (Communication, Delegation, End, etc.) should be used when applicable.
IRI:http://www.w3.org/ns/prov#EntityInfluence
EntityInfluence is the capacity of an entity to have an effect on the character, development, or behavior of another by means of usage, start, end, derivation, or other.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :sortActivity a prov:Activity; prov:used :rawData; prov:qualifiedUsage [ a prov:Usage, prov:EntityInfluence; ## Instances of Start, End, Usage, Derivation, and Invalidation prov:entity :datasetA; ## qualify the influenced of an Entity (cited by prov:entity). prov:hadRole :inputToBeSorted; ]; prov:generated :sortedData; . :rawData a prov:Entity . :sortedData a prov:Entity .
EntityInfluence provides additional descriptions of an Entity's binary influence upon any other kind of resource. Instances of EntityInfluence use the prov:entity property to cite the influencing Entity.
It is not recommended that the type EntityInfluence be asserted without also asserting one of its more specific subclasses.
IRI:http://www.w3.org/ns/prov#Usage
Usage is the beginning of utilizing an entity by an activity. Before usage, the activity had not begun to utilize this entity and could not have been affected by the entity.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :sortActivity a prov:Activity; prov:startedAtTime "2011-07-16T01:52:02Z"^^xsd:dateTime; prov:qualifiedUsage [ a prov:Usage; prov:entity :datasetA; ## The entity used by the prov:Usage prov:hadRole :inputToBeSorted; ## the role of the entity in this prov:Usage ]; prov:generated :datasetB; . :datasetA a prov:Entity . :datasetB a prov:Entity . :inputToBeSorted a prov:Role . ## The role of :datasetA cannot be expressed using only starting-point terms: :sortActivity a prov:Activity; prov:startedAtTime "2011-07-16T01:52:02Z"^^xsd:dateTime; prov:used :datasetA; prov:generated :datasetB; .
An instance of prov:Usage provides additional descriptions about the binary prov:used relation from some prov:Activity to an prov:Entity that it used. For example, :keynote prov:used :podium; prov:qualifiedUsage [ a prov:Usage; prov:entity :podium; :foo :bar ].
IRI:http://www.w3.org/ns/prov#Start
Start is when an activity is deemed to have been started by an entity, known as trigger. The activity did not exist before its start. Any usage, generation, or invalidation involving an activity follows the activity's start. A start may refer to a trigger entity that set off the activity, or to an activity, known as starter, that generated the trigger.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . ### Start can be used to qualify wasStartedBy with time and location information. ### In this example, a consistency checking activity is started by the update of a data record. :consistency_checking a prov:Activity; prov:wasStartedBy :updated_data_record; prov:qualifiedStart [ a prov:Start; prov:entity :updated_data_record; prov:atTime "2011-07-06T01:48:36Z"^^xsd:dateTime; prov:atLocation :scienceLab_003; prov:hadActivity :syntax_checking; ]; . :updated_data_record a prov:Entity . ### There is an explicit process of checking the syntax of the updated data record :syntax_checking a prov:Activity ; prov:startedAtTime "2011-07-06T01:48:36Z"^^xsd:dateTime; prov:endedAtTime "2011-07-06T02:12:36Z"^^xsd:dateTime; prov:wasAssociatedWith :syntax_checker ; . :syntax_checker a prov:SoftwareAgent .
An instance of prov:Start provides additional descriptions about the binary prov:wasStartedBy relation from some started prov:Activity to an prov:Entity that started it. For example, :foot_race prov:wasStartedBy :bang; prov:qualifiedStart [ a prov:Start; prov:entity :bang; :foo :bar; prov:atTime '2012-03-09T08:05:08-05:00'^^xsd:dateTime ] .
IRI:http://www.w3.org/ns/prov#End
End is when an activity is deemed to have been ended by an entity, known as trigger. The activity no longer exists after its end. Any usage, generation, or invalidation involving an activity precedes the activity's end. An end may refer to a trigger entity that terminated the activity, or to an activity, known as ender that generated the trigger.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . ### End can be used to qualify wasEndedBy with time and location information. ### In this example, an experiment is stopped because an intermediate inconsitent resul. :experiment a prov:Activity; prov:wasEndedBy :inconsistentResult; prov:qualifiedEnd [ a prov:End; prov:entity :inconsistentResult; prov:atTime "2011-07-16T01:52:02Z"^^xsd:dateTime; prov:atLocation :scienceLab_003; prov:hadActivity :analyse_intermediate_result ; ]; . :inconsistentResult a prov:Entity . ### An implicit process analyzes the intermediate result to confirm its expected consistency analyse_intermediate_result a prov:Activity ; prov:startedAtTime "2011-07-15T12:52:02Z"^^xsd:dateTime; prov:endedAtTime "2011-07-16T01:52:02Z"^^xsd:dateTime; .
An instance of prov:End provides additional descriptions about the binary prov:wasEndedBy relation from some ended prov:Activity to an prov:Entity that ended it. For example, :ball_game prov:wasEndedBy :buzzer; prov:qualifiedEnd [ a prov:End; prov:entity :buzzer; :foo :bar; prov:atTime '2012-03-09T08:05:08-05:00'^^xsd:dateTime ].
IRI:http://www.w3.org/ns/prov#Derivation
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.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . # The simplest (and least detailed) form of derivation. :bar_chart a prov:Entity; prov:wasDerivedFrom :aggregatedByRegions; . # The simple form can be accompanied by a qualified form: # which provides more details about how :bar_chart was # derived from :aggregatedRegions. :bar_chart a prov:Entity; prov:wasDerivedFrom :aggregatedByRegions; prov:qualifiedDerivation [ a prov:Derivation; prov:entity :aggregatedByRegions; # Derivations can cite the influencing Activity in doing the derivation. prov:hadActivity :create_the_chart; # They can also cite the Usage and Generation that the Activity # performed to generate :bar_chart. prov:hadUsage :data_loading; prov:hadGeneration :plot_the_chart; ]; . ### The process during which the chart was created, from loading the data to the software, to process the data and plot the chart. ### Additional metadata was recorded, like when it started (before the usage), ended (after the generation of the chart) and who was associated with it. :create_the_chart a prov:Activity; prov:wasAssociatedWith :derek; prov:startedAtTime "2012-04-03T00:00:00Z"^^xsd:dateTime; prov:endedAtTime "2012-04-03T00:00:10Z"^^xsd:dateTime; . ### The final chart was plotted :plot_the_chart a prov:Generation, prov:InstantaneousEvent; prov:atTime "2012-04-03T00:00:01Z"^^xsd:dateTime; . ### The data was getting used to create the chart :data_loading a prov:Usage; prov:atTime "2012-04-03T00:00:00Z"^^xsd:dateTime; .
The more specific forms of prov:Derivation (i.e., prov:Revision, prov:Quotation, prov:PrimarySource) should be asserted if they apply.
An instance of prov:Derivation provides additional descriptions about the binary prov:wasDerivedFrom relation from some derived prov:Entity to another prov:Entity from which it was derived. For example, :chewed_bubble_gum prov:wasDerivedFrom :unwrapped_bubble_gum; prov:qualifiedDerivation [ a prov:Derivation; prov:entity :unwrapped_bubble_gum; :foo :bar ].
IRI:http://www.w3.org/ns/prov#PrimarySource
A primary source for a topic refers to something produced by some agent with direct experience and knowledge about the topic, at the time of the topic's study, without benefit from hindsight. Because of the directness of primary sources, they 'speak for themselves' in ways that cannot be captured through the filter of secondary sources. As such, it is important for secondary sources to reference those primary sources from which they were derived, so that their reliability can be investigated. A primary source relation is a particular case of derivation of secondary materials from their primary sources. It is recognized that the determination of primary sources can be up to interpretation, and should be done according to conventions accepted within the application's domain.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :myPost a prov:Entity; prov:hadPrimarySource :donQuixote; prov:qualifiedPrimarySource [ a prov:PrimarySource; prov:entity :donQuixote; :confidenceValue "6"^^xsd:integer; rdfs:comment """Not sure if Don Quixote was the original source, so asserting a confidence value of 6 out of 10."""; ]; . :donQuixote a prov:Entity.
An instance of prov:PrimarySource provides additional descriptions about the binary prov:hadPrimarySource relation from some secondary prov:Entity to an earlier, primary prov:Entity. For example, :blog prov:hadPrimarySource :newsArticle; prov:qualifiedPrimarySource [ a prov:PrimarySource; prov:entity :newsArticle; :foo :bar ] .
IRI:http://www.w3.org/ns/prov#Quotation
A quotation is the repeat of (some or all of) an entity, such as text or image, by someone who may or may not be its original author. Quotation is a particular case of derivation.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.com/vocab#> . @prefix : <http://example.com/> . :dagstuhl-quote a prov:Entity; prov:value "why would people record and share provenance in the first place?"; prov:wasQuotedFrom <http://purl.org/twc/page/thoughts-from-the-dagstuhl-workshop>; prov:qualifiedQuotation [ a prov:Quotation; prov:entity <http://purl.org/twc/page/thoughts-from-the-dagstuhl-workshop>; ex:fromSection 2; ]; prov:wasAttributedTo <http://data.semanticweb.org/person/luc-moreau>; . <http://purl.org/twc/page/thoughts-from-the-dagstuhl-workshop> a prov:Entity; prov:wasAttributedTo <http://data.semanticweb.org/person/paul-groth>; . <http://data.semanticweb.org/person/luc-moreau> a prov:Person, prov:Agent . <http://data.semanticweb.org/person/paul-groth> a prov:Person, prov:Agent .
An instance of prov:Quotation provides additional descriptions about the binary prov:wasQuotedFrom relation from some taken prov:Entity from an earlier, larger prov:Entity. For example, :here_is_looking_at_you_kid prov:wasQuotedFrom :casablanca_script; prov:qualifiedQuotation [ a prov:Quotation; prov:entity :casablanca_script; :foo :bar ].
IRI:http://www.w3.org/ns/prov#Revision
A revision is a derivation for which the resulting entity is a revised version of some original. The implication here is that the resulting entity contains substantial content from the original. Revision is a particular case of derivation.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.com/vocab#> . @prefix : <http://example.com/> . :draft2 a prov:Entity; prov:wasRevisionOf :draft1; prov:qualifiedRevision [ a prov:Revision; prov:entity :draft1; ex:peerReviewed false; ]; prov:wasAssociatedWith :edward; prov:qualifiedAssociation [ a prov:Association; prov:agent :edward; prov:hadRole :editor; ]; . :draft1 a prov:Entity . :edward a prov:Person, prov:Agent; .
An instance of prov:Revision provides additional descriptions about the binary prov:wasRevisionOf relation from some newer prov:Entity to an earlier prov:Entity. For example, :draft_2 prov:wasRevisionOf :draft_1; prov:qualifiedRevision [ a prov:Revision; prov:entity :draft_1; :foo :bar ].
IRI:http://www.w3.org/ns/prov#ActivityInfluence
ActivitiyInfluence is the capacity of an activity to have an effect on the character, development, or behavior of another by means of generation, invalidation, communication, or other.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :bar_chart a prov:Entity; prov:wasGeneratedBy :illustrating; prov:qualifiedGeneration :making-bar-chart; . :making-bar-chart a prov:Generation, prov:ActivityInfluence; ## Instances of Generation, Invalidation and Communication qualify prov:activity :illustrating; ## the influence of an Activity (cited by prov:activity) rdfs:comment "Ended up with bar chart as line chart looked ugly."@en; . :illustrating a prov:Activity .
It is not recommended that the type ActivityInfluence be asserted without also asserting one of its more specific subclasses.
ActivityInfluence provides additional descriptions of an Activity's binary influence upon any other kind of resource. Instances of ActivityInfluence use the prov:activity property to cite the influencing Activity.
IRI:http://www.w3.org/ns/prov#Generation
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.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix bbc: <http://www.bbc.co.uk/> . @prefix eg: <http://example.com/vocab#> . @prefix : <http://example.com/> . :bbcNews2012-04-03 a prov:Entity, eg:DailyNews; rdfs:comment """The BBC news home page on 2012-04-03 contained a reference to a given news item, but the BBC news home page on the next day did not."""; prov:wasGeneratedBy :publishingActivity; prov:qualifiedGeneration [ a prov:Generation, prov:InstantaneousEvent; prov:atTime "2012-04-03T00:00:01Z"^^xsd:dateTime; prov:activity :publishingActivity; ]; prov:qualifiedInvalidation [ a prov:Invalidation, prov:InstantaneousEvent; prov:atTime "2012-04-03T23:59:59Z"^^xsd:dateTime; ]; . :publishingActivity a prov:Activity; .
An instance of prov:Generation provides additional descriptions about the binary prov:wasGeneratedBy relation from a generated prov:Entity to the prov:Activity that generated it. For example, :cake prov:wasGeneratedBy :baking; prov:qualifiedGeneration [ a prov:Generation; prov:activity :baking; :foo :bar ].
IRI:http://www.w3.org/ns/prov#Communication
Communication is the exchange of an entity by two activities, one activity using the entity generated by the other.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.com/vocab#> . @prefix : <http://example.com/> . :writing-celebrity-gossip a prov:Activity; prov:wasInformedBy :voicemail-interception; prov:qualifiedCommunication :informing-the-journalist; . :informing-the-journalist a prov:Communication; prov:activity :voicemail-interception; ex:mediaType "email"; . :voicemail-interception a prov:Activity .
An instance of prov:Communication provides additional descriptions about the binary prov:wasInformedBy relation from an informed prov:Activity to the prov:Activity that informed it. For example, :you_jumping_off_bridge prov:wasInformedBy :everyone_else_jumping_off_bridge; prov:qualifiedCommunication [ a prov:Communication; prov:activity :everyone_else_jumping_off_bridge; :foo :bar ].
IRI:http://www.w3.org/ns/prov#Invalidation
Invalidation is the start of the destruction, cessation, or expiry of an existing entity by an activity. The entity is no longer available for use (or further invalidation) after invalidation. Any generation or usage of an entity precedes its invalidation.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix wgs: <http://www.w3.org/2003/01/geo/wgs84_pos#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix foaf: <http://xmlns.com/foaf/0.1/> . @prefix : <http://example.com/> . :the-Painter a prov:Entity, :Painting; rdfs:label "Le Peintre"@fr, "The Painter"@en; prov:wasAttributedTo <http://dbpedia.org/resource/Pablo_Picasso>; prov:wasInvalidatedBy :swissair_Flight_111_crash; prov:qualifiedInvalidation [ a prov:Invalidation; prov:activity :swissair_Flight_111_crash; prov:atTime "1998-09-02T01:31:00Z"^^xsd:dateTime; prov:atLocation <http://purl.org/twc/location/Swissair-Flight-111-crash>; ]; . <http://purl.org/twc/location/Swissair-Flight-111-crash> a prov:Location; wgs:lat 44.409167; wgs:long -63.973611; . <http://dbpedia.org/resource/Pablo_Picasso> a prov:Agent; foaf:depiction <http://upload.wikimedia.org/wikipedia/commons/9/98/Pablo_picasso_1.jpg>; . :swissair_Flight_111_crash a prov:Activity; prov:used <http://dbpedia.org/resource/Swissair_Flight_111>; prov:startedAtTime "1998-09-02T01:31:00Z"^^xsd:dateTime; prov:atLocation <http://dbpedia.org/resource/Atlantic_ocean>; .
An instance of prov:Invalidation provides additional descriptions about the binary prov:wasInvalidatedBy relation from an invalidated prov:Entity to the prov:Activity that invalidated it. For example, :uncracked_egg prov:wasInvalidatedBy :baking; prov:qualifiedInvalidation [ a prov:Invalidation; prov:activity :baking; :foo :bar ].
IRI:http://www.w3.org/ns/prov#AgentInfluence
AgentInfluence is the capacity of an agent to have an effect on the character, development, or behavior of another by means of attribution, association, delegation, or other.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :illustrating a prov:Activity; prov:wasAssociatedWith :derek; prov:qualifiedAssociation [ a prov:Association, prov:AgentInfluence; ## Instances of Generation, Invalidation and Communication qualify prov:agent :derek; ## the influence of an Agent (cited by prov:agent) prov:hadRole :illustrationist ]; . :derek a prov:Person, prov:Agent, prov:Entity . :illustratonist a prov:Role .
AgentInfluence provides additional descriptions of an Agent's binary influence upon any other kind of resource. Instances of AgentInfluence use the prov:agent property to cite the influencing Agent.
It is not recommended that the type AgentInfluence be asserted without also asserting one of its more specific subclasses.
IRI:http://www.w3.org/ns/prov#Attribution
Attribution is the ascribing of an entity to an agent. When an entity e is attributed to agent ag, entity e was generated by some unspecified activity that in turn was associated to agent ag. Thus, this relation is useful when the activity is not known, or irrelevant.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.com/vocab#> . @prefix : <http://example.com/> . <http://dbpedia.org/resource/Fallingwater> a prov:Entity; prov:wasAttributedTo <http://dbpedia.org/resource/Edgar_J._Kaufmann>, <http://dbpedia.org/resource/Frank_Lloyd_Wright>, :western-Pennsylvania-Conservancy; prov:qualifiedAttribution [ a prov:Attribution; prov:agent <http://dbpedia.org/resource/Edgar_J._Kaufmann>; ex:hadRole :owner; ]; prov:qualifiedAttribution [ a prov:Attribution; prov:agent <http://dbpedia.org/resource/Frank_Lloyd_Wright>; ex:hadRole :architect; ]; prov:qualifiedAttribution [ a prov:Attribution; prov:agent :western-Pennsylvania-Conservancy; ex:hadRole :conserver; ]; . <http://dbpedia.org/resource/Edgar_J._Kaufmann> a prov:Person, prov:Agent . <http://dbpedia.org/resource/Frank_Lloyd_Wright> a prov:Person, prov:Agent . :western-Pennsylvania-Conservancy a prov:Organization, prov:Agent .
An instance of prov:Attribution provides additional descriptions about the binary prov:wasAttributedTo relation from an prov:Entity to some prov:Agent that had some responsible for it. For example, :cake prov:wasAttributedTo :baker; prov:qualifiedAttribution [ a prov:Attribution; prov:entity :baker; :foo :bar ].
IRI:http://www.w3.org/ns/prov#Association
An activity association is an assignment of responsibility to an agent for an activity, indicating that the agent had a role in the activity. It further allows for a plan to be specified, which is the plan intended by the agent to achieve some goals in the context of this activity.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :illustrating a prov:Activity; prov:wasAssociatedWith :derek, :steve; prov:qualifiedAssociation [ a prov:Association; prov:agent :derek; prov:hadRole :illustrationist; ]; prov:qualifiedAssociation [ a prov:Association; prov:agent :steve; prov:hadRole :stylist; prov:hadPlan :style-guide; rdfs:comment "Steve helped Derek conform with the publisher's style guide."@en; ]; . :derek a prov:Person, prov:Agent, prov:Entity . :steve a prov:Person, prov:Agent, prov:Entity . :illustratonist a prov:Role . :stylist a prov:Role . :style-guide a prov:Plan, prov:Entity .
An instance of prov:Association provides additional descriptions about the binary prov:wasAssociatedWith relation from an prov:Activity to some prov:Agent that had some responsiblity for it. For example, :baking prov:wasAssociatedWith :baker; prov:qualifiedAssociation [ a prov:Association; prov:agent :baker; :foo :bar ].
IRI:http://www.w3.org/ns/prov#Plan
A plan is an entity that represents a set of actions or steps intended by one or more agents to achieve some goals.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :illustrating a prov:Activity; prov:qualifiedAssociation :steve-checking-style-guide; . :steve-checking-style-guide a prov:Association; prov:agent :steve; prov:hadPlan :style-guide; rdfs:comment "Steve followed the publisher's style guide"@en; . :style-guide a prov:Plan, prov:Entity; rdfs:comment "Use blue graphs for positive spin, red for negative"@en; .
There exist no prescriptive requirement on the nature of plans, their representation, the actions or steps they consist of, or their intended goals. Since plans may evolve over time, it may become necessary to track their provenance, so plans themselves are entities. Representing the plan explicitly in the provenance can be useful for various tasks: for example, to validate the execution as represented in the provenance record, to manage expectation failures, or to provide explanations.
IRI:http://www.w3.org/ns/prov#Delegation
Delegation is the assignment of authority and responsibility to an agent (by itself or by another agent) to carry out a specific activity as a delegate or representative, while the agent it acts on behalf of retains some responsibility for the outcome of the delegated work. For example, a student acted on behalf of his supervisor, who acted on behalf of the department chair, who acted on behalf of the university; all those agents are responsible in some way for the activity that took place but we do not say explicitly who bears responsibility and to what degree.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.com/vocab#> . @prefix : <http://example.com/> . ### In this example, Frank (an insurance agent) acts on behalf of his company for performing ### a policy sale :policySale a prov:Activity; prov:wasAssociatedWith :insuranceAgent_Frank; . :insuranceAgent_Frank a prov:Person; prov:actedOnBehalfOf :insuranceCompany_A; prov:qualifiedDelegation [ a prov:Delegation; prov:agent :insuranceCompany_A; ex:rewardScheme "commission"; prov:hadActivity :policySale ; ]; .
An instance of prov:Delegation provides additional descriptions about the binary prov:actedOnBehalfOf relation from a performing prov:Agent to some prov:Agent for whom it was performed. For example, :mixing prov:wasAssociatedWith :toddler . :toddler prov:actedOnBehalfOf :mother; prov:qualifiedDelegation [ a prov:Delegation; prov:entity :mother; :foo :bar ].
IRI:http://www.w3.org/ns/prov#InstantaneousEvent
The PROV data model is implicitly based on a notion of instantaneous events (or just events), that mark transitions in the world. Events include generation, usage, or invalidation of entities, as well as starting or ending of activities. This notion of event is not first-class in the data model, but it is useful for explaining its other concepts and its semantics.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix bbc: <http://www.bbc.co.uk/> . @prefix : <http://example.com/> . :bbcNews2012-04-03 a prov:Entity, :DailyNews; rdfs:comment """The BBC news home page on 2012-04-03 contained a reference to a given news item, but the BBC news home page on the next day did not."""; prov:qualifiedGeneration [ a prov:Generation, prov:InstantaneousEvent; prov:atTime "2012-04-03T00:00:01Z"^^xsd:dateTime; ]; prov:qualifiedInvalidation [ a prov:Invalidation, prov:InstantaneousEvent; prov:atTime "2012-04-03T23:59:59Z"^^xsd:dateTime; ]; .
An instantaneous event, or event for short, happens in the world and marks a change in the world, in its activities and in its entities. The term 'event' is commonly used in process algebra with a similar meaning. Events represent communications or interactions; they are assumed to be atomic and instantaneous.
IRI:http://www.w3.org/ns/prov#Role
A role is the function of an entity or agent with respect to an activity, in the context of a usage, generation, invalidation, association, start, and end.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :divideActivity a prov:Activity; prov:used :variableA, :variableB; prov:qualifiedUsage [ a prov:Usage; prov:entity :variableA; prov:hadRole :dividend; ]; prov:qualifiedUsage [ a prov:Usage; prov:entity :variableB; prov:hadRole :divisor; ]; prov:generated :result_112234; . :variableA a prov:Entity; prov:value 10; . :variableB a prov:Entity; prov:value 2; . :dividend a prov:Role. :divisor a prov:Role. :result_112234 a prov:Entity; prov:value 5; prov:wasGeneratedBy :divideActivity; .
IRI:http://www.w3.org/ns/prov#wasInfluencedBy
Influence is the capacity of an entity, activity, or agent to have an effect on the character, development, or behavior of another by means of usage, start, end, generation, invalidation, communication, derivation, attribution, association, or delegation.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :illustrationActivity a prov:Activity; prov:used :aggregatedByRegions; prov:wasAssociatedWith :derek; prov:wasInformedBy :aggregationActivity; . :illustrationActivity a prov:Activity; prov:wasInfluencedBy :aggregatedByRegions, # prov:wasInfluencedBy is a superproperty of :derek, # many of the direct binary :aggregationActivity; # PROV-O properties. . :aggregationActivity a prov:Activity . :derek a prov:Agent . :aggregatedByRegions a prov:Entity .
Because prov:wasInfluencedBy is a broad relation, its more specific subproperties (e.g. prov:wasInformedBy, prov:actedOnBehalfOf, prov:wasEndedBy, etc.) should be used when applicable.
This property has multiple RDFS domains to suit multiple OWL Profiles. See PROV-O OWL Profile.
IRI:http://www.w3.org/ns/prov#qualifiedInfluence
Influence is the capacity of an entity, activity, or agent to have an effect on the character, development, or behavior of another by means of usage, start, end, generation, invalidation, communication, derivation, attribution, association, or delegation.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix my: <http://example.com/ontology#> . @prefix : <http://example.com/> . # Although domain extension 'my:wasConductedBy' is not defined by PROV-O, # the relation between a surgery and an agent can still be qualified # by reusing prov:Influence and one of its three subclasses: # AgentInfluence, EntityInfluence, and ActivityInfluence # (depending on the type of the influencing object). :conductingSurgery_1 a prov:Activity; # This unqualified influence is unknown in PROV; # it would be a subproperty of prov:wasAssociatedWith. my:wasConductedBy :bob; prov:wasInfluencedBy :bob; prov:qualifiedInfluence [ # Even though PROV systems do not understand my:wasConductedBy, # they will at least understand that :bob influenced the # surgery in some way. a prov:Influence; # Inferred prov:agent :bob; # The object of my:wasConductedBy # Domain extension properties may be used to describe the # influences that an Entity, Activity, or Agent # have upon another Entity, Activity, or Agent. my:degree .72; ]; . :bob a prov:Agent .
Because prov:qualifiedInfluence is a broad relation, the more specific relations (qualifiedCommunication, qualifiedDelegation, qualifiedEnd, etc.) should be used when applicable.
IRI:http://www.w3.org/ns/prov#qualifiedGeneration
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.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :bar_chart a prov:Entity; prov:wasGeneratedBy :illustrating; prov:qualifiedGeneration [ a prov:Generation; prov:activity :illustrating; rdfs:comment "Ended up with bar chart as line chart looked ugly."@en; ]; . :illustrating a prov:Activity .
If this Activity prov:generated Entity :e, then it can qualify how it performed the Generation using prov:qualifiedGeneration [ a prov:Generation; prov:entity :e; :foo :bar ].
IRI:http://www.w3.org/ns/prov#qualifiedDerivation
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.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :bar_chart a prov:Entity; prov:wasDerivedFrom :aggregatedByRegions; prov:qualifiedDerivation [ a prov:Derivation; prov:entity :aggregatedByRegions; ## More details about the activity underpinning the derivation prov:hadGeneration :chat_plotting; prov:hadActivity :chart_creation ; ]; . ### The process of creating the chart, from loading the data, to process it, and plot it to end users :chart_creation a prov:Activity ; prov:wasAssociatedWith :derek; prov:startedAtTime "2011-07-16T01:52:02Z"^^xsd:dateTime; prov:endedAtTime "2011-07-16T03:00:02Z"^^xsd:dateTime; . #### Now the chart is plotted :chat_plotting a prov:Generation ; prov:atTime "2011-07-16T03:00:02Z"^^xsd:dateTime; .
If this Entity prov:wasDerivedFrom Entity :e, then it can qualify how it was derived using prov:qualifiedDerivation [ a prov:Derivation; prov:entity :e; :foo :bar ].
IRI:http://www.w3.org/ns/prov#qualifiedPrimarySource
A primary source for a topic refers to something produced by some agent with direct experience and knowledge about the topic, at the time of the topic's study, without benefit from hindsight. Because of the directness of primary sources, they 'speak for themselves' in ways that cannot be captured through the filter of secondary sources. As such, it is important for secondary sources to reference those primary sources from which they were derived, so that their reliability can be investigated. A primary source relation is a particular case of derivation of secondary materials from their primary sources. It is recognized that the determination of primary sources can be up to interpretation, and should be done according to conventions accepted within the application's domain.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix dcterms: <http://purl.org/dc/terms/> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.com/vocab#> . @prefix : <http://example.com/> . :temperatureDisplay a prov:Entity; prov:hadPrimarySource :sensorReading20120510; prov:qualifiedPrimarySource [ a prov:PrimarySource; prov:entity :sensorReading20120510; ex:precisionLoss true; rdfs:comment """The displayed temperature does not show the full precision available in the reading."""; ]; . :sensorReading20120510 a prov:Entity; prov:wasGeneratedBy :temperatureSensor; .
If this Entity prov:hadPrimarySource Entity :e, then it can qualify how using prov:qualifiedPrimarySource [ a prov:PrimarySource; prov:entity :e; :foo :bar ].
IRI:http://www.w3.org/ns/prov#qualifiedQuotation
A quotation is the repeat of (some or all of) an entity, such as text or image, by someone who may or may not be its original author. Quotation is a particular case of derivation.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix my: <http://example.com/vocab/my#> . @prefix : <http://example.com/> . :bl-dagstuhl a prov:Entity; prov:value """During the workshop, it became clear to me that the consensus based models (which are often graphical in nature) can not only be formalized but also be directly connected to these database focused formalizations. I just needed to get over the differences in syntax. This could imply that we could have nice way to trace provenance across systems and through databases and be able to understand the mathematical properties of this interconnection."""; prov:wasQuotedFrom <http://purl.org/twc/page/thoughts-from-the-dagstuhl-workshop>; prov:qualifiedQuotation [ a prov:Quotation; prov:entity <http://purl.org/twc/page/thoughts-from-the-dagstuhl-workshop>; my:fromSection 1; ]; . <http://purl.org/twc/page/thoughts-from-the-dagstuhl-workshop> a prov:Entity; prov:wasAttributedTo <http://data.semanticweb.org/person/paul-groth>; . <http://data.semanticweb.org/person/luc-moreau> a prov:Person, prov:Agent . <http://data.semanticweb.org/person/paul-groth> a prov:Person, prov:Agent .
If this Entity prov:wasQuotedFrom Entity :e, then it can qualify how using prov:qualifiedQuotation [ a prov:Quotation; prov:entity :e; :foo :bar ].
IRI:http://www.w3.org/ns/prov#qualifiedRevision
A revision is a derivation for which the resulting entity is a revised version of some original. The implication here is that the resulting entity contains substantial content from the original. Revision is a particular case of derivation.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :draft2 a prov:Entity; prov:wasRevisionOf :draft1; prov:qualifiedRevision [ a prov:Revision; prov:entity :draft1 ]; prov:wasAttributedTo :eddie; . :draft1 a prov:Entity . :eddie a prov:Person, prov:Agent, prov:Entity .
If this Entity prov:wasRevisionOf Entity :e, then it can qualify how it was revised using prov:qualifiedRevision [ a prov:Revision; prov:entity :e; :foo :bar ].
IRI:http://www.w3.org/ns/prov#qualifiedAttribution
Attribution is the ascribing of an entity to an agent. When an entity e is attributed to agent ag, entity e was generated by some unspecified activity that in turn was associated to agent ag. Thus, this relation is useful when the activity is not known, or irrelevant.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.com/vocab#> . @prefix : <http://example.com/> . ## When the role of the agent is not known or does not matter: :nationalRegionsList a prov:Entity; prov:wasAttributedTo :civil_action_group; . :civil_action_group a prov:Agent . ## If we want to express the role of the agent: :nationalRegionsList a prov:Entity; prov:qualifiedAttribution [ a prov:Attribution; prov:agent :civil_action_group; ex:hadRole :owner; ] .
If this Entity prov:wasAttributedTo Agent :ag, then it can qualify how it was influenced using prov:qualifiedAttribution [ a prov:Attribution; prov:agent :ag; :foo :bar ].
IRI:http://www.w3.org/ns/prov#qualifiedInvalidation
Invalidation is the start of the destruction, cessation, or expiry of an existing entity by an activity. The entity is no longer available for use (or further invalidation) after invalidation. Any generation or usage of an entity precedes its invalidation.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.com/ontology#> . @prefix : <http://example.com/> . :the-Painter a prov:Entity, ex:Painting; rdfs:label "Le Peintre"@fr, "The Painter"@en; prov:wasAttributedTo <http://dbpedia.org/resource/Pablo_Picasso>; prov:wasInvalidatedBy :swissair_Flight_111_crash; prov:qualifiedInvalidation [ a prov:Invalidation; prov:activity :swissair_Flight_111_crash; prov:atTime "1998-09-02T01:31:00Z"^^xsd:dateTime; prov:atLocation <http://purl.org/twc/location/Swissair-Flight-111-crash>; ]; . :swissair_Flight_111_crash a prov:Activity . <http://purl.org/twc/location/Swissair-Flight-111-crash> a prov:Location .
If this Entity prov:wasInvalidatedBy Activity :a, then it can qualify how it was invalidated using prov:qualifiedInvalidation [ a prov:Invalidation; prov:activity :a; :foo :bar ].
IRI:http://www.w3.org/ns/prov#qualifiedStart
Start is when an activity is deemed to have been started by an entity, known as trigger. The activity did not exist before its start. Any usage, generation, or invalidation involving an activity follows the activity's start. A start may refer to a trigger entity that set off the activity, or to an activity, known as starter, that generated the trigger.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . # Start can be used to qualify wasStartedBy with time and location information. :consistency_checking a prov:Activity; prov:wasStartedBy :updated_data_record; prov:qualifiedStart [ a prov:Start; prov:entity :updated_data_record; prov:atTime "2011-07-06T01:48:36Z"^^xsd:dateTime; prov:atLocation :scienceLab_003; prov:hadActivity :syntax_checking; ]; . :updated_data_record a prov:Entity . ### There is an explicit process of checking the syntax of the updated data record :syntax_checking a prov:Activity ; prov:startedAtTime "2011-07-06T01:48:36Z"^^xsd:dateTime; prov:endedAtTime "2011-07-06T02:12:36Z"^^xsd:dateTime; prov:wasAssociatedWith :syntax_checker ; . :syntax_checker a prov:SoftwareAgent .
If this Activity prov:wasStartedBy Entity :e1, then it can qualify how it was started using prov:qualifiedStart [ a prov:Start; prov:entity :e1; :foo :bar ].
IRI:http://www.w3.org/ns/prov#qualifiedUsage
Usage is the beginning of utilizing an entity by an activity. Before usage, the activity had not begun to utilize this entity and could not have been affected by the entity.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.com/vocab#> . @prefix : <http://example.com/> . :newsPublication a prov:Activity; prov:used :tsunami_image; prov:qualifiedUsage [ a prov:Usage; prov:entity :tsunami_image; ex:hasCopyrightPermission :licensedUse; ex:hasOwner :reuters; ]; . :tsunami_image a prov:Entity . :reuters a prov:Agent .
IRI:http://www.w3.org/ns/prov#qualifiedCommunication
Communication is the exchange of an entity by two activities, one activity using the entity generated by the other.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :writing-celebrity-gossip a prov:Activity; prov:wasAssociatedWith :journalist; prov:wasInformedBy :voicemail-interception; prov:qualifiedCommunication [ a prov:Communication; prov:activity :voicemail-interception; rdfs:comment """The journalist was informed by the private investigator, but we don't know how or what he was told."""@en; ]; . :voicemail-interception a prov:Activity; prov:wasAssociatedWith :private-investigator; . :private-investigator a prov:Agent . :journalist a prov:Agent .
If this Activity prov:wasInformedBy Activity :a, then it can qualify how it was influenced using prov:qualifiedCommunication [ a prov:Communication; prov:activity :a; :foo :bar ].
IRI:http://www.w3.org/ns/prov#qualifiedAssociation
An activity association is an assignment of responsibility to an agent for an activity, indicating that the agent had a role in the activity. It further allows for a plan to be specified, which is the plan intended by the agent to achieve some goals in the context of this activity.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :illustrating a prov:Activity; prov:wasAssociatedWith :derek, :steve; prov:qualifiedAssociation [ a prov:Association; prov:agent :derek; prov:hadRole :illustrationist; rdfs:comment "Derek made the illustration"@en ]; prov:qualifiedAssociation [ a prov:Association; prov:agent :steve; prov:hadRole :stylist; prov:hadPlan :style-guide; rdfs:comment "Steve helped Derek conform with the publisher's style guide."@en ]; prov:qualifiedAssociation [ a prov:Association; prov:agent :derek; prov:hadRole :stylist; rdfs:comment "But Derek also did some styling of his own."@en ] . :derek a prov:Person, prov:Agent . :steve a prov:Person, prov:Agent . :illustratonist a prov:Role . :stylist a prov:Role . :style-guide a prov:Plan, prov:Entity .
If this Activity prov:wasAssociatedWith Agent :ag, then it can qualify the Association using prov:qualifiedAssociation [ a prov:Association; prov:agent :ag; :foo :bar ].
IRI:http://www.w3.org/ns/prov#qualifiedEnd
End is when an activity is deemed to have been ended by an entity, known as trigger. The activity no longer exists after its end. Any usage, generation, or invalidation involving an activity precedes the activity's end. An end may refer to a trigger entity that terminated the activity, or to an activity, known as ender that generated the trigger.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . ### End can be used to qualify wasEndedBy with time and location information :experiment a prov:Activity; prov:wasEndedBy :inconsistentResult; prov:qualifiedEnd [ a prov:End; prov:entity :inconsistentResult; prov:atTime "2011-07-16T01:52:02Z"^^xsd:dateTime; prov:atLocation :scienceLab_003; prov:hadActivity :analyse_intermediate_result ; ]; . :inconsistentResult a prov:Entity . ### An implicit process of analysing the intermediate result to confirm its expected consistency analyse_intermediate_result a prov:Activity ; prov:startedAtTime "2011-07-15T12:52:02Z"^^xsd:dateTime; prov:endedAtTime "2011-07-16T01:52:02Z"^^xsd:dateTime; .
If this Activity prov:wasEndedBy Entity :e1, then it can qualify how it was ended using prov:qualifiedEnd [ a prov:End; prov:entity :e1; :foo :bar ].
IRI:http://www.w3.org/ns/prov#qualifiedDelegation
Delegation is the assignment of authority and responsibility to an agent (by itself or by another agent) to carry out a specific activity as a delegate or representative, while the agent it acts on behalf of retains some responsibility for the outcome of the delegated work. For example, a student acted on behalf of his supervisor, who acted on behalf of the department chair, who acted on behalf of the university; all those agents are responsible in some way for the activity that took place but we do not say explicitly who bears responsibility and to what degree.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.com/vocab#> . @prefix : <http://example.com/> . :traffic-stop a prov:Activity; prov:wasAssociatedWith :chauffeur, :traffic-officer-34; prov:qualifiedAssociation [ a prov:Association; prov:agent :chauffeur; # The chauffeur was the one violating traffic rules. prov:hadRole :violator; ]; prov:qualifiedAssociation [ a prov:Association; prov:agent :traffic-officer-34; # The officer was the one enforcing the traffic rules. prov:hadRole :enforcer; ]; . :chauffeur a prov:Person; prov:actedOnBehalfOf :celebrity-in-car; prov:qualifiedDelegation [ a prov:Delegation; prov:agent :celebrity-in-car; # The celebrity employed the chauffeur during the enforcement. prov:hadRole :employer; prov:hadActivity :driving-during-the-year ; ]; . #The chaffeur was employed for a whole year as a driver :driving-during-the-year a prov:Activity ; prov:wasAssociatedWith :chaffeur; prov:qualifiedAssociation [ a prov:Association; prov:hadRole :driver; ]; prov:startedAtTime "2011-07-16T01:52:02Z"^^xsd:dateTime; prov:endedAtTime "2012-07-16T01:52:02Z"^^xsd:dateTime;; . :traffic_officer_34 a prov:Person; prov:actedOnBehalfOf :city-of-Paris; prov:qualifiedDelegation [ a prov:Delegation; prov:agent :city-of-Paris; # The city of Paris employed the officer during the enforcement. prov:hadRole :employer; prov:hadActivity :control-city-traffic ; ]; . :control-city-traffic a prov:Activity .
If this Agent prov:actedOnBehalfOf Agent :ag, then it can qualify how with prov:qualifiedResponsibility [ a prov:Responsibility; prov:agent :ag; :foo :bar ].
IRI:http://www.w3.org/ns/prov#influencer
This property is used as part of the qualified influence pattern. Subclasses of prov:Influence use these subproperties to reference the resource (Entity, Agent, or Activity) whose influence is being qualified.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :illustrationActivity a prov:Activity; prov:qualifiedUsage :illustration_usage; prov:qualifiedAssociation :illustration_association; prov:qualifiedCommunication :illustration_communication; . :illustration_usage a prov:Usage; prov:entity :aggregatedByRegions; prov:influencer :aggregatedByRegions; # Inferred . :illustration_association a prov:Association; prov:agent :derek; prov:influencer :derek; # - - - - - - - Inferred . :illustration_communication a prov:Communication; prov:activity :aggregationActivity; prov:influencer :aggregationActivity; # Inferred . :aggregationActivity a prov:Activity . :derek a prov:Agent . :aggregatedByRegions a prov:Entity .
Subproperties of prov:influencer are used to cite the object of an unqualified PROV-O triple whose predicate is a subproperty of prov:wasInfluencedBy (e.g. prov:used, prov:wasGeneratedBy). prov:influencer is used much like rdf:object is used.
IRI:http://www.w3.org/ns/prov#entity
The prov:entity property references an prov:Entity which influenced a resource. This property applies to an prov:EntityInfluence, which is given by a subproperty of prov:qualifiedInfluence from the influenced prov:Entity, prov:Activity or prov:Agent.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :world-literature-homework-submission-32 a prov:Entity; prov:hadPrimarySource :donQuixote; prov:qualifiedPrimarySource [ a prov:PrimarySource; prov:entity :donQuixote; # Other attributes of the relationship ]; . :donQuixote a prov:Entity .
IRI:http://www.w3.org/ns/prov#hadUsage
Usage is the beginning of utilizing an entity by an activity. Before usage, the activity had not begun to utilize this entity and could not have been affected by the entity.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :digestedProteinSample1 a prov:Entity; prov:wasDerivedFrom :proteinSample; prov:qualifiedDerivation [ a prov:Derivation; prov:hadUsage [ a prov:Usage; prov:entity :Trypsin; prov:hadRole :treatmentEnzyme; ]; ]; prov:entity :proteinSample; . :proteinSample a prov:Entity .
The _optional_ Usage involved in an Entity's Derivation.
IRI:http://www.w3.org/ns/prov#hadGeneration
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.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.com/vocab#> . @prefix : <http://example.com/> . :bar_chart a prov:Entity, ex:Chart; prov:wasDerivedFrom :aggregatedByRegions; prov:qualifiedDerivation [ a prov:Derivation; prov:entity :aggregatedByRegions; prov:hadGeneration :illustration; ]; . :aggregatedByRegions a ex:Dataset . :illustration a prov:Generation, prov:InstantaneousEvent; prov:activity :illustrationActivity; prov:atTime "2012-04-03T00:00:11Z"^^xsd:dateTime; . :illustrationActivity a prov:Activity; prov:startedAtTime "2012-04-03T00:00:00Z"^^xsd:dateTime; prov:endedAtTime "2012-04-03T00:00:25Z"^^xsd:dateTime; .
The _optional_ Generation involved in an Entity's Derivation.
IRI:http://www.w3.org/ns/prov#activity
The prov:activity property references an prov:Activity which influenced a resource. This property applies to an prov:ActivityInfluence, which is given by a subproperty of prov:qualifiedInfluence from the influenced prov:Entity, prov:Activity or prov:Agent.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :making-bar-chart a prov:Generation, prov:ActivityInfluence; prov:activity :illustrating; rdfs:comment "Ended up with bar chart as line chart looked ugly."@en; . :illustrating a prov:Activity . :bar_chart a prov:Entity; prov:wasGeneratedBy :illustrating; prov:qualifiedGeneration :making-bar-chart; .
IRI:http://www.w3.org/ns/prov#agent
The prov:agent property references an prov:Agent which influenced a resource. This property applies to an prov:AgentInfluence, which is given by a subproperty of prov:qualifiedInfluence from the influenced prov:Entity, prov:Activity or prov:Agent.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :world_flight_1937 a prov:Activity; prov:wasAssociatedWith <http://dbpedia.org/resource/Amelia_Earhart>, <http://dbpedia.org/resource/Purdue_University>, <http://dbpedia.org/resource/Lockheed_Aircraft_Company>; prov:qualifiedAssociation [ a prov:Association; prov:agent <http://dbpedia.org/resource/Amelia_Earhart>; prov:hadRole :pilot; ]; prov:qualifiedAssociation [ a prov:Association; prov:agent <http://dbpedia.org/resource/Purdue_University>; prov:hadRole :financer; ]; prov:qualifiedAssociation [ a prov:Association; prov:agent <http://dbpedia.org/resource/Lockheed_Aircraft_Company>; prov:hadRole :plane_builder; ]; rdfs:seeAlso <http://en.wikipedia.org/wiki/Amelia_Earhart#1937_world_flight>; . <http://dbpedia.org/resource/Amelia_Earhart> a prov:Person, prov:Agent . <http://dbpedia.org/resource/Purdue_University> a prov:Organization, prov:Agent . <http://dbpedia.org/resource/Lockheed_Aircraft_Company> a prov:Organization, prov:Agent .
IRI:http://www.w3.org/ns/prov#hadPlan
A plan is an entity that represents a set of actions or steps intended by one or more agents to achieve some goals.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :illustrating a prov:Activity; prov:wasAssociatedWith :derek, :steve; prov:qualifiedAssociation [ a prov:Association; prov:agent :steve; prov:hadRole :stylist; prov:hadPlan :style-guide; rdfs:comment "Steve followed the style guide"@en; ]; . :style-guide a prov:Plan, prov:Entity; rdfs:comment "Use blue graphs for positive spin, red for negative"@en; .
The _optional_ Plan adopted by an Agent in Association with some Activity. Plan specifications are out of the scope of this specification.
IRI:http://www.w3.org/ns/prov#hadActivity
An activity is something that occurs over a period of time and acts upon or with entities; it may include consuming, processing, transforming, modifying, relocating, using, or generating entities.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . # The activity that which used, generated, invalidated # or was responsible for the entity. In this qualified Derivation # prov:hadActivity references the activity that generated the bar chart. :bar_chart a prov:Entity; prov:wasDerivedFrom :aggregatedByRegions; prov:wasGeneratedBy :make_bar_chart; prov:qualifiedDerivation [ a prov:Derivation; prov:entity :aggregatedByRegions; prov:hadActivity :make_bar_chart; # references same activity as prov:wasGeneratedBy ]; . :aggregatedByRegions a prov:Entity . :make_bar_chart a prov:Activity .
The _optional_ Activity of an Influence, which used, generated, invalidated, or was the responsibility of some Entity. This property is _not_ used by ActivityInfluence (use prov:activity instead).
This property has multiple RDFS domains to suit multiple OWL Profiles. See PROV-O OWL Profile.
IRI:http://www.w3.org/ns/prov#atTime
The PROV data model is implicitly based on a notion of instantaneous events (or just events), that mark transitions in the world. Events include generation, usage, or invalidation of entities, as well as starting or ending of activities. This notion of event is not first-class in the data model, but it is useful for explaining its other concepts and its semantics.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :Timearticle20120430_publication a prov:InstantaneousEvent; prov:atTime "2012-04-30T20:40:40"^^xsd:dateTime; .
The time at which an InstantaneousEvent occurred, in the form of xsd:dateTime.
IRI:http://www.w3.org/ns/prov#hadRole
A role is the function of an entity or agent with respect to an activity, in the context of a usage, generation, invalidation, association, start, and end.
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix : <http://example.com/> . :divideActivity a prov:Activity; prov:used :variableA; prov:qualifiedUsage [ a prov:Usage; prov:entity :variableA; prov:hadRole :dividend; ]; prov:used :variableB; prov:qualifiedUsage [ a prov:Usage; prov:entity :variableB; prov:hadRole :divisor; ]; . :variableA a prov:Entity . :variableB a prov:Entity . :dividend a prov:Role . :divisor a prov:Role .
The _optional_ Role that an Entity assumed in the context of an Activity. For example, :baking prov:used :spoon; prov:qualified [ a prov:Usage; prov:entity :spoon; prov:hadRole roles:mixing_implement ].
This property has multiple RDFS domains to suit multiple OWL Profiles. See PROV-O OWL Profile.
The PROV-O terms in this cross reference are shown below alphabetically, along with their entry number.
This section is non-normative.
To encourage widespread adoption, PROV-O's design is intentionally minimal and lightweight. Because the OWL 2 RL profile is aimed at RDF applications that require scalable reasoning without sacrificing too much expressive power [OWL2-PRIMER], it served as a baseline for all axioms included in PROV-O. The PROV-O axioms that do not suit the OWL 2 RL profile are listed in Table 5. All five use an anonymous class union for the domain or range of a property, while OWL 2 RL requires the classes to be explicitly named. Although introducing "placeholder" classes would have suited the OWL 2 RL profile, these additional "abstract" classes would have been irrelevant to the modeling of provenance information, increased the size of PROV-O unnecessarily, and exposed a potential to confuse users. All five axioms listed in the following table use a non-superclass expression in a position that requires a superclass expression and do not conform to the OWL 2 RL Profile.
Non OWL-RL PROV-O Axiom |
---|
prov:atLocation rdfs:domain [ owl:unionOf (prov:Activity prov:Agent prov:Entity prov:InstantaneousEvent) ] |
prov:wasInfluencedBy rdfs:domain [ owl:unionOf (prov:Activity prov:Agent prov:Entity) ] |
prov:wasInfluencedBy rdfs:range [ owl:unionOf (prov:Activity prov:Agent prov:Entity) ] |
prov:hadActivity rdfs:domain [ owl:unionOf (prov:Delegation prov:Derivation prov:Start prov:End) ] |
prov:hadRole rdfs:domain [ owl:unionOf (prov:Association prov:InstantaneousEvent) ] |
To provide guidance for OWL 2 RL environments that ignore the union domain axioms, some property domains or ranges have also been defined with the closest common superclass for the classes in the union, as shown in the following table.
Property | Direction | Domain/range |
---|---|---|
prov:atLocation | rdfs:domain | (implied: owl:Thing) |
prov:wasInfluencedBy | rdfs:domain / rdfs:range | (implied: owl:Thing) |
prov:hadActivity | rdfs:domain | prov:Influence |
prov:hadRole | rdfs:domain | prov:Influence |
Multiple RDFS domains and ranges [RDF-SCHEMA] for a property are interpreted as an intersection, and thus the above do not provide any additional information in an OWL 2 DL or OWL 2 Full profile, which also understands the unions. The more general domain should not be interpreted as saying, e.g., "prov:hadActivity can be used with any prov:Influence", but as "Anything using prov:hadActivity is (at least) a prov:Influence".
To maximize interoperability, PROV-O intentionally avoids defining too many properties' inverses. In fact, it only defines two (prov:generated and prov:invalidated). When all inverses are defined for all properties, modelers may choose from two logically equivalent properties when making each assertion. Although the two options may be logically equivalent, developers consuming the assertions may need to exert extra effort to handle both (e.g., by either adding an OWL reasoner or writing code and queries to handle both cases). This extra effort can be reduced by preferring one inverse over another.
For example, the first PROV-O statement (below) could just as easily be asserted as the second statement. But if a client queries using prov:wasDerivedFrom when :hadDerivation was used in the assertion, no results will be returned unless OWL reasoning is applied (or the size of the query is doubled).
<http://www.w3.org/TR/prov-o/> prov:wasDerivedFrom <http://www.w3.org/TR/prov-dm/> . # These two statements are equivalent if prov:wasDerivedFrom is an inverse of :hadDerivation. # But extra effort is required to handle both cases (if one is not already using OWL reasoning). # We cannot assume that everybody is using OWL reasoning. # We do not want people to write more code and query than necessary. <http://www.w3.org/TR/prov-dm/> :hadDerivation <http://www.w3.org/TR/prov-o/> .
So, PROV-O avoids this situation by encouraging modelers to use one property instead of its inverse; the preferred property to use is the one defined in the PROV-O ontology. Those asserting and querying for the preferred property avoid the need for OWL reasoning, additional code, and larger queries while maintaining the same level of interoperability.
However, the absence of defined inverses can lead to a different risk to interoperability. Because modelers are free to create their own properties to suit their needs, they may be motivated to assert the inverse of any PROV-O property defined herein.
For example, since PROV-O does not define the inverse of prov:wasDerivedFrom, and if three developers would rather model their assertions in the opposite direction, the following set of assertions might be found in the future web of provenance. These assertions are not in an interoperable form without the use of an OWL reasoner, additional code, or larger queries.
# If PROV-O's properties' inverses are not defined, modelers may be motivated to introduce their own inverse property name. # The following three statements are equivalent if their predicates are all inverses of prov:wasDerivedFrom. <http://www.w3.org/TR/prov-dm/> my:hadDerivation <http://www.w3.org/TR/prov-o/> . <http://www.w3.org/TR/prov-dm/> your:ledTo <http://www.w3.org/TR/prov-o/> . <http://www.w3.org/TR/prov-dm/> their:derivedTo <http://www.w3.org/TR/prov-o/> .
To balance these two interoperability risks, this document reserves the names of the PROV-O inverses. The name of a property's inverse is determined by appending the value of its http://www.w3.org/ns/prov#inverse annotation to the PROV namespace (http://www.w3.org/ns/prov#). Modelers wishing to use inverses of the properties defined by PROV-O should use those reserved by this document.
For example, the same three modelers above that defined my:hadDerivation
, your:ledTo
, and their:derivedTo
should instead look for the http://www.w3.org/ns/prov#inverse annotation on prov:wasDerivedFrom to determine that they should use the property http://www.w3.org/ns/prov#hadDerivation.
@prefix prov: <http://www.w3.org/ns/prov#> . # Each PROV-O property is annotated with the local name of its inverse. prov:wasDerivedFrom a owl:ObjectProperty; rdfs:isDefinedBy <http://www.w3.org/ns/prov#>; prov:inverse "hadDerivation"; rdfs:domain prov:Entity; rdfs:range prov:Entity; . # Instead of defining their own, modelers should use the # recommended inverse local name within the PROV namespace: <http://www.w3.org/TR/prov-dm/> prov:hadDerivation <http://www.w3.org/TR/prov-o/> . # Following this recommendation avoids a proliferation of inverse definitions, # while encouraging the use of one inverse over another. # This increases interoperability.
The following table lists the recommended inverse names that should be used if a modeler does not want to use the recommended PROV-O property. For convenience, this file lists the resulting inverse properties.
This section is non-normative.
:illustration_usage
rather than
:usage_1
.
This section is non-normative.
This section is non-normative.
This document has been produced by the PROV Working Group, and its contents reflect extensive discussion within the Working Group as a whole. The editors extend special thanks to Sandro Hawke (W3C/MIT) and Ivan Herman (W3C/ERCIM), W3C contacts for the PROV Working Group.
The editors acknowledge valuable contributions from the following: Tom Baker, David Booth, Robert Freimuth, Satrajit Ghosh, Ralph Hodgson, Renato Iannella, Jacek Kopecky, James Leigh, Jacco van Ossenbruggen, Alan Ruttenberg, Reza Samavi, and Antoine Zimmermann.
Members of the PROV Working Group at the time of publication of this document were: Ilkay Altintas (Invited expert), Reza B'Far (Oracle Corporation), Khalid Belhajjame (University of Manchester), James Cheney (University of Edinburgh, School of Informatics), Sam Coppens (IBBT), David Corsar (University of Aberdeen, Computing Science), Stephen Cresswell (The National Archives), Tom De Nies (IBBT), Helena Deus (DERI Galway at the National University of Ireland, Galway, Ireland), Simon Dobson (Invited expert), Martin Doerr (Foundation for Research and Technology - Hellas(FORTH)), Kai Eckert (Invited expert), Jean-Pierre EVAIN (European Broadcasting Union, EBU-UER), James Frew (Invited expert), Irini Fundulaki (Foundation for Research and Technology - Hellas(FORTH)), Daniel Garijo (Universidad Politécnica de Madrid), Yolanda Gil (Invited expert), Ryan Golden (Oracle Corporation), Paul Groth (Vrije Universiteit), Olaf Hartig (Invited expert), David Hau (National Cancer Institute, NCI), Sandro Hawke (W3C/MIT), Jörn Hees (German Research Center for Artificial Intelligence (DFKI) Gmbh), Ivan Herman, (W3C/ERCIM), Ralph Hodgson (TopQuadrant), Hook Hua (Invited expert), Trung Dong Huynh (University of Southampton), Graham Klyne (University of Oxford), Michael Lang (Revelytix, Inc.), Timothy Lebo (Rensselaer Polytechnic Institute), James McCusker (Rensselaer Polytechnic Institute), Deborah McGuinness (Rensselaer Polytechnic Institute), Simon Miles (Invited expert), Paolo Missier (School of Computing Science, Newcastle university), Luc Moreau (University of Southampton), James Myers (Rensselaer Polytechnic Institute), Vinh Nguyen (Wright State University), Edoardo Pignotti (University of Aberdeen, Computing Science), Paulo da Silva Pinheiro (Rensselaer Polytechnic Institute), Carl Reed (Open Geospatial Consortium), Adam Retter (Invited Expert), Christine Runnegar (Invited expert), Satya Sahoo (Invited expert), David Schaengold (Revelytix, Inc.), Daniel Schutzer (FSTC, Financial Services Technology Consortium), Yogesh Simmhan (Invited expert), Stian Soiland-Reyes (University of Manchester), Eric Stephan (Pacific Northwest National Laboratory), Linda Stewart (The National Archives), Ed Summers (Library of Congress), Maria Theodoridou (Foundation for Research and Technology - Hellas(FORTH)), Ted Thibodeau (OpenLink Software Inc.), Curt Tilmes (National Aeronautics and Space Administration), Craig Trim (IBM Corporation), Stephan Zednik (Rensselaer Polytechnic Institute), Jun Zhao (University of Oxford), Yuting Zhao (University of Aberdeen, Computing Science).
The editors also thank the developers of the tools that helped create the PROV-O ontology and portions of this document. Without these great tools, developing PROV-O would have been much less of a pleasure.
The more specific subproperties of prov:wasDerivedFrom (i.e., prov:wasQuotedFrom, prov:wasRevisionOf, prov:hadPrimarySource) should be used when applicable.