Copyright © 2011-2012 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark and document use rules apply.
The PROV Ontology (PROV-O) expresses the PROV Data Model using the OWL2 Web Ontology Language (OWL2). 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 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/.
This is the third public release of the PROV-DM document. This is a Last Call Working Draft. The design is not expected to change significantly, going forward, and now is the key time for external review.
This specification identifies two features at risk: prov:mentionOf and prov:asInBundle might be removed from PROV-O if implementation experience reveals problems with supporting this construct. These two OWL properties are based on the PROV Mentions feature.
This document was published by the Provenance Working Group as a Last Call Working Draft. 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). The Last Call period ends 18 September 2012. All feedback is welcome.
Publication as a Working Draft 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 is a Last Call Working Draft and thus the Working Group has determined that this document has satisfied the relevant technical requirements and is sufficiently stable to advance through the Technical Recommendation process.
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-PAQ] and PROV Data Model [PROV-DM], this document forms a framework for provenance information interchange in domain-specific Web-based applications.
PROV-O is lightweight so that it can be adopted in the widest range of applications. With the exception of five axioms, PROV-O conforms to the OWL-RL profile [OWL-2-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-RDF-BASED-SEMANTICS].
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, and a set of individuals sharing a set of additional characteristics is called 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].
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].
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 applying usage and generation, one can construct provenance chains comprising both Activities and Entities.
In addiition, 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 not interesting or is unknown. So, the prov:wasInformedBy property allows the assertion 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 interesting or is unknown, 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 to a particular application (for example, the file size and format of the dataset, or the aspect ratio of the bar chart).
An Agent can be responsible for an Activity or an Entity, which is described using the properties prov:wasAssociatedWith and prov:wasAttributedTo, respectively. Agents can also be responsible for other Agents' actions. In this case, the Agent that influenced an Activity or Entity prov:actedOnBehalfOf another Agent that also bears some responsibility for the resulting Activity or Entity.
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 prov: <http://www.w3.org/ns/prov#> . @prefix foaf: <http://xmlns.com/foaf/0.1/> . @prefix : <http://example.org#> . :bar_chart a prov:Entity; prov:wasGeneratedBy :illustrationActivity; prov:wasDerivedFrom :aggregatedByRegions; . :illustrationActivity a prov:Activity; prov:used :aggregatedByRegions; prov:wasAssociatedWith :derek; prov:wasInformedBy :aggregationActivity; . :aggregatedByRegions a prov:Entity; prov:wasGeneratedBy :aggregationActivity; . :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; . :nationalRegionsList a prov:Entity; prov:wasAttributedTo :civil_action_group; . :aggregatedByRegions prov:wasAttributedTo :derek . :bar_chart prov:wasAttributedTo :derek . :derek a prov:Agent; a foaf:Person; foaf:givenName "Derek"^^xsd:string; foaf:mbox <mailto:derek@example.org>; prov:actedOnBehalfOf :natonal_newspaper_inc; . :national_newspaper_inc a prov:Agent; a prov:Organization; foaf:name "National Newspaper, Inc."; . :government a prov:Organization, foaf:Organization . :civil_action_group a prov:Organization, foaf:Organization .
The example states that the agent ex:derek
was associated with two
activities: ex:aggregationActivity
and ex:illustrationActivity
. The
activity ex:aggregationActivity
used
the entities ex:crimeData
(a crime statistics dataset) and ex:nationalRegionsList
(a list of national regions), and
generated a new entity, ex:aggregatedByRegions
, that aggregates the statistics in
ex:crimeData
according to the regions in ex:nationalRegionsList
.
The ex:aggregatedByRegions
entity was then used by the ex:illustrationActivity
activity,
to generate a new entity ex:chart1
that depicts the aggregated statistics.
The example also states that the activity ex:illustrationActivity
was
informed by the activity ex:aggregationActivity
. Indeed, the former used
the entity ex:aggregatedByRegions
, which was generated by the latter.
Because the agent ex:derek
was associated with the activities
ex:aggregationActivity
and ex:illustrationActivity
, the entities
generated by these activities, i.e., ex:aggregatedByRegions
and ex:chart1
, were
attributed to him.
Finally, the example states that the agent ex:derek
acted on behalf of the organization ex: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 one 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 maintains the collection (attribution), which members it contains as it evolves, 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 provenance descriptions may be expressed as PROV-O or in some other form. The subclass of Bundle that contains 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 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. More specifically, three subproperties of prov:wasDerivedFrom are 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 an older 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 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). prov:mentionOf is a special type of prov:specializationOf whose subject presents as an aspect a particular prov:Bundle in which its more general Entity was described (prov:asInBundle is used to cite the Bundle in which the generalization was mentioned).
The prov:mentionOf and prov:asInBundle properties are "at risk" and may be removed from this specification based on feedback. Please send feedback to public-prov-comments@w3.org.
These two properties are used to encode the PROV-DM's Mention construct, which might be removed from PROV if implementation experience reveals problems with supporting this construct.
The third category allows further description of Entities. The property prov:value holds a literal value for the 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., generation, usage, or invalidation of an entity and the starting or ending of an activity). 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 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.
The fifth category 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.
We illustrate below the use of the expanded terms using the crime file example from the previous section as reference. Derek then published a post about his work with the aggregated file.
@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://example.org/my#> . @prefix : <http://example.org#> . :bundlePost { :bundlePost a prov:Bundle . :derek a prov:Person, prov:Agent, foaf:Person; ## Typically prov:Agent will be inferred from prov:Person foaf:givenName "Derek"^^xsd:string; foaf:mbox <mailto:derek@example.org>; prov:actedOnBehalfOf :national_newspaper_inc; . :national_newspaper_inc a prov:Organization, prov:Agent; ## Typically prov:Agent will be inferred from prov:Organization foaf:name "National Newspaper, Inc."; . :postEditor a prov:SoftwareAgent, prov:Agent; ## Typically prov:Agent will be inferred from prov:SoftwareAgent foaf:name "Post Editor 3000"; . :aggregatedByRegions a prov:Entity; prov:atLocation <file://Users/aggr.txt>; . :more-crime-happens-in-cities a prov:Location, sioc:Post, prov:Entity; sioc:latest_version :post9821v2; sioc:previous_version :post9821v1; . ## Version 1 of the post :post9821v1 a prov:Entity, sioc:Post; prov:wasGeneratedBy :publicationActivity1123; prov:atLocation :more-crime-happens-in-cities; ## PERMALINK to the (latest revision of the) post my:snapshotContent :postContent0; ## Snapshot with the content of this version sioc:title "More crime happens in cities"^^xsd:string; prov:hadPrimarySource :aggregatedByRegions; ## This version of the post used the file "aggregatedByRegions" as a primary source. ## Since the author stated that he based his post in the file, ## the system used this relationship to keep the attribution clear. prov:wasAttributedTo :derek; prov:generatedAtTime "2011-07-16T01:52:02Z"^^xsd:dateTime; . ## Version 2 of the post :post9821v2 a prov:Entity, sioc:Post; prov:atLocation :more-crime-happens-in-cities; ## PERMALINK to the (latest revision of the) post my:snapshotContent :postContent1; ## Snapshot with the content of this version prov:wasRevisionOf :post9821v1; prov:alternateOf :post9821v1; prov:wasAttributedTo :derek; . :publicationActivity1123 a prov:Activity; prov:wasStartedAt "2011-07-16T01:01:01Z"^^xsd:dateTime; prov:wasEndedAt "2011-07-16T01:52:02Z"^^xsd:dateTime; prov:wasAssociatedWith :derek, :postEditor; prov:used :aggregatedByRegions; prov:generated :post9821v1; prov:wasStartedBy :derek; prov:wasEndedBy :derek . }
Agent ex:derek
, acting again on behalf of the :national_newspaper_inc
organization,
publishes a post about his recent changes to the aggregated file (ex:aggregatedByRegions
) using the tool ex:postEditor
. Since he is the one who started and ended the publishing activity (ex:publicationActivity1123
), that information
is recorded as well. The post produced by ex:derek
(ex:post9821v1
) includes a permanent link where the content of the latest version is shown
(ex:more-crime-happens-in-cities
) plus a snapshot of the content of the current version (ex:postContent0
). Derek also adds additional metadata of the post, like the title.
However, shortly after having published the post, Derek detects a typo. He does not want to record the activity that led to the new version, so he just creates a new version and
summarizes the changes in a revision of the original post (ex:post9821v2
). This revision is also an alternate of the original post,
since they are both forms of the long-standing blog.
Thus, the permalink to the latest version (ex:more-crime-happens-in-cities
) remains the same in the new revision, but a different URL is given for its snapshot (ex:postContent1
).
Shortly after Derek's post publication, Monica adapts the text for a wider audience in a new post (ex:post9822
). This version is a specialization of the original post,
and an alternate of the version modified by Derek. Since the provenance produced by the activities of Derek and Monica correspond to different user views, the system
automatically publish it in different prov:Bundles (ex:bundlePost and ex:bundlePost1
).
@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://example.org#my> . @prefix : <http://example.org#> . :bundlePost1 { :bundlePost1 a prov:Bundle . :monica a prov:Person, prov:Agent, foaf:Person; foaf:givenName "Monica"^^xsd:string; foaf:mbox <mailto:monica@example.org> . ## Rephrasing of the post in a new resource for a different audience :post9822 a prov:Entity, sioc:Post; prov:atLocation :more-crime-happens-in-cities-for-dummies; ## PERMALINK to the (latest revision of the) post my:snapshotContent :postContent2; ## Snapshot with the content of this version prov:alternateOf :post9821v2; ## This post is an alternate of the second version modified by Derek. prov:specializationOf :more-crime-happens-in-cities; ## This post is an specialization of the post initially created by Derek. prov:wasInfluencedBy :aggregatedByRegions; ## If the file hadn't existed, Monica would have not written the post. ## However the file is not what Monica used as primary source for writting the new post, ## so we can't consider the post to have "been derived from" it. sioc:title "More crime happens in cities (for dummies)"^^xsd:string; prov:wasAttributedTo :monica; . }
Some time passes by, and John writes his own conclusions quoting the previous two posts:
@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#> . :bundlePost2 { :bundlePost2 a prov:Bundle; prov:hasAnnotation :noteMadeByParser; . :john a prov:Agent; . # Rows of the post quoting post :post9821v1 :quote1 a prov:Entity; prov:value "Analysis of the datasets demonstrate that there is more crime"; prov:wasQuotedFrom :post9821v1. # Rows of the post quoting post :post9821v2 :quote2 a prov:Entity; prov:value "In sumary, there are clearly more crimes in the country"; prov:wasQuotedFrom :post9821v2. :publicationActivity1123 a prov:Activity; prov:used :quote1, :quote2, :aggregatedByRegions; prov:generated :post19201. :post19201 a prov:Entity, sioc:Post; prov:wasAttributedTo :john; prov:wasDerivedFrom :post9821v1, :post9821v2; prov:wasGeneratedBy :publicationActivity1123; prov:hadPrimarySource :aggregatedByRegions; . }
Agent ex:John
also names the URI of the original source (ex:aggregatedByRegions
). All the provenance statements related to his post
are grouped in a new prov:Bundle (ex:bundlePost2
).
Unfortunately, there is a problem in the servers where :post19201
is being stored, and all the data related to the post is lost. Thus, the system
invalidates the entity automatically and notifies 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 prov:Entity, sioc:Post; prov:invalidatedAtTime "2012-09-02T01:31:00Z"^^xsd:dateTime; prov:wasInvalidatedBy :hard_disk_failure; . :hard_disk_failure a prov:Activity; prov:wasEndedAt "2012-09-02T01:31:00Z"^^xsd:dateTime; .
The Qualified Terms category is for users who wish to provide further details about the provenance-related influence among Entities, Activities, and Agents. The terms in this category are the result of applying the Qualification Pattern [LD-Patterns-QR] to the simple (unqualified) relations available in the Starting Point and Expanded categories. The Qualification Pattern consists of restating the unqualified relation by using an intermediate class that represents the influence between two resources. This new instance, in turn, can be annotated with additional descriptions about the influence relationship between the two resources cited. 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. While the prov:Usage cites the influencing entity with the prov:entity property, the influenced prov:Activity cites the prov:Usage with the property prov:qualifiedUsage. This structure is illustrated in Figure 4a below.
Seven Starting Point relations that can be further described using the Qualification Pattern.
Influenced Class | Unqualified Influence | Qualification Property | Qualified Influence | Influencer Property | Influencing Class |
---|---|---|---|---|---|
prov:Agent | prov:actedOnBehalfOf | prov:qualifiedDelegation | prov:Delegation | prov:agent | prov:Agent |
prov:Activity | prov:used | prov:qualifiedUsage | prov:Usage | prov:entity | prov:Entity |
prov:Activity | prov:wasAssociatedWith | prov:qualifiedAssociation | prov:Association | prov:agent | prov:Agent |
prov:Entity | prov:wasAttributedTo | prov:qualifiedAttribution | prov:Attribution | prov:agent | prov:Agent |
prov:Entity | prov:wasDerivedFrom | prov:qualifiedDerivation | prov:Derivation | prov:entity | prov:Entity |
prov:Entity | prov:wasGeneratedBy | prov:qualifiedGeneration | prov:Generation | prov:activity | prov:Activity |
prov:Activity | prov:wasInformedBy | prov:qualifiedCommunication | prov:Communication | prov:activity | prov:Activity |
Six Expanded relations that can be further described using the Qualification Pattern.
Influenced Class | Unqualified Influence | Qualification Property | Qualified Influence | Influencer Property | Influencing Class |
---|---|---|---|---|---|
prov:Entity | prov:hadPrimarySource | prov:qualifiedSource | prov:Source | prov:entity | prov:Entity |
prov:Activity | prov:wasEndedBy | prov:qualifiedEnd | prov:End | prov:entity | prov:Entity |
prov:Entity | prov:wasInvalidatedBy | prov:qualifiedInvalidation | prov:Invalidation | prov:activity | prov:Activity |
prov:Entity | prov:wasQuotedFrom | prov:qualifiedQuotation | prov:Quotation | prov:entity | prov:Entity |
prov:Entity | prov:wasRevisionOf | prov:qualifiedRevision | prov:Revision | prov:entity | prov:Entity |
prov:Activity | prov:wasStartedBy | prov:qualifiedStart | prov:Start | prov:entity | prov:Entity |
The qualification classes and properties shown in the previous two tables can also be found in the 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 to use to cite the influencing resource (either prov:entity, prov:activity, or prov:agent, respectively).
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 and the class prov:Generation (a subclass of prov:ActivityInfluence). 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 . :a1 a prov:Activity . :e1Gen a prov:Generation; prov:activity :a1; # Cite the influencing Activity. ex:foo :bar; # Add additional attributes about the influence relation. .
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 the thirteen unqualified 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 eleven 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 ex:illustrationActivity
. The instance of prov:Usage cites the data used (ex: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 ex: <http://example.org#> . ex:illustrationActivity a prov:Activity; ## (Using Starting Point terms) prov:used ex:aggregatedByRegions; ## The aggregated data was used to create the chart. . ex:aggregatedByRegions a prov:Entity . ex:illustrationActivity prov:qualifiedUsage [ a prov:Usage; prov:entity ex:aggregatedByRegions; ## Qualification: The aggregated data was used prov:atTime "2011-07-14T03:03:03Z"^^xsd:dateTime; ## at a particular time when creating the chart. ]; .
The prov:qualifiedAssociation property parallels the
prov:wasAssociatedWith property to provide an additional description about the ex:illustrationActivity
that Derek influenced.
The instance of prov:Association cites the influencing agent (ex:derek
) that followed the instructions (ex:tutorial_blog
).
Further, Derek served the role of illustrationist during the activity.
@prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.org#> . ex:illustrationActivity a prov:Activity; ## (Using Starting Point terms) prov:wasAssociatedWith ex:derek; ## Derek was responsible for the chart making in some way. . ex:derek a prov:Agent . ex:illustrationActivity prov:qualifiedAssociation [ ## Qualification: What plan (or recipe, instructions) a prov:Association; ## did Derek follow when creating the graphical chart? prov:agent ex:derek prov:hadPlan ex:tutorial_blog; prov:hadRole ex:illustrationist; ]; . ex:tutorial_blog a prov:Plan, prov:Entity . ex: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 ex:chart1
. The instance of prov:Generation cites the time (2011-07-14T15:52:14Z) that the activity (ex:illustrationActivity
) generated the chart (ex:chart1
).
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.org#> . ex:chart1 a prov:Entity; ## (Using Starting Point terms) prov:wasGeneratedBy ex:illustrationActivity; ## The chart was generated in an illustration activity. . ex:illustrationActivity a prov:Activity . ex:chart1 prov:qualifiedGeneration [ a prov:Generation; prov:activity ex:illustrationActivity; ## Qualification: The chart was prov:atTime "2011-07-14T15:52:14Z"^^xsd:dateTime; ## generated at a particular time. ]; .
The prov:qualifiedDerivation property parallels the prov:wasDerivedFrom property to provide an additional description to ex:chart1
. The instance of prov:Derivation cites the activity (ex:illustrationActivity
) and the Usages and Generations that the activity conduced to create the chart (ex:chart1
).
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> . @prefix prov: <http://www.w3.org/ns/prov#> . @prefix ex: <http://example.org#> . ex:chart1 a prov:Entity; ## (Using Starting Point terms) prov:wasDerivedFrom ex:aggregatedByRegions; ## The chart was derived from the aggregate. . ex:aggregatedByRegions a prov:Entity . ex:chart1 prov:qualifiedDerivation [ a prov:Derivation; prov:entity ex:aggregatedByRegions; ## Qualification: additional information about the derivation: prov:hadUsage ex:usage; ## Which activity derived the aggregate? prov:hadActivity ex:activity; ## What did the activity use to derive the aggregate? prov:hadGeneration ex:generation; ## How did the activity generate the derived aggregate? ]; .
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 iteself, the annotation properties prov:qualifiedForm and prov:unqualifiedForm provide the same linkages between the unqualified properties and their qualifiying terms.
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#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#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#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."; .
IRI:http://www.w3.org/ns/prov#endedAtTime
End is when an activity is deemed to have ended. 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 an entity, known as trigger, 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#startedAtTime
Start is when an activity is deemed to have started. The activity did not exist before its start. Any usage or generation involving an activity follows the activity's start. A start may refer to an entity, known as trigger, 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#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#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#wasDerivedFrom
A derivation is a transformation of an entity into another, a construction of an entity into another, or an update of an entity, resulting in a new one.
@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#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#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.
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#ActivityInfluence
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.
@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 is intended to be a general subclass of Influence of an Activity. It is a superclass for more specific kinds of Influences (e.g. Generation, Communication, and Invalidation).
IRI:http://www.w3.org/ns/prov#AgentInfluence
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.
@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 is intended to be a general subclass of Influence of an Agenty. It is a superclass for more specific kinds of Influences (e.g. Association, Attribution, Delegation).
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#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#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#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#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/> . :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"; ]; .
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#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; :foo :bar; # Derivations can cite the influencing Activity in doing the derivation. prov:hadActivity :illustration_activity; # They can also cite the Usage and Generation that the Activity # performed to generate :bar_chart. prov:hadUsage :how_illustration_activity_used_data; prov:hadGeneration :bar_chart_generation; ]; . :illustration_activity a prov:Activity; prov:wasAttributedTo :derek; . :bar_chart_generation a prov:Generation, prov:InstantaneousEvent; prov:atTime "2012-04-03T00:00:01Z"^^xsd:dateTime; . :how_illustration_activity_used_data a prov:Usage; .
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#End
End is when an activity is deemed to have ended. 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 an entity, known as trigger, 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; ]; . :inconsistentResult a prov:Entity .
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#EntityInfluence
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.
@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 :datasetA; 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 :datasetB; .
It is not recommended that the type EntityInfluence be asserted without also asserting one of its more specific subclasses.
EntityInfluence is intended to be a general subclass of Influence of an Entity. It is a superclass for more specific kinds of Influences (e.g. Usage, Derivation, Source).
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#Influence
Influence is the capacity 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 :surgeon; ]; . :bob a prov:Agent . my:surgeon a prov:Role .
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#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#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"; 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"; 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#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#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://thinklinks.wordpress.com/2012/03/07/thoughts-from-the-dagstuhl-principles-of-provenance-workshop/>; prov:qualifiedQuotation [ a prov:Quotation; prov:entity <http://thinklinks.wordpress.com/2012/03/07/thoughts-from-the-dagstuhl-principles-of-provenance-workshop/>; ex:fromSection 2; ]; prov:wasAttributedTo <http://data.semanticweb.org/person/luc-moreau>; . <http://thinklinks.wordpress.com/2012/03/07/thoughts-from-the-dagstuhl-principles-of-provenance-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#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#Source
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:hadOriginalSource :donQuixote; prov:qualifiedSource [ a prov:Source; 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:Source 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:qualified [ a prov:Source; prov:entity :newsArticle; :foo :bar ] .
IRI:http://www.w3.org/ns/prov#Start
Start is when an activity is deemed to have started. The activity did not exist before its start. Any usage or generation involving an activity follows the activity's start. A start may refer to an entity, known as trigger, 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. :experiment a prov:Activity; prov:wasStartedBy :researcher; prov:qualifiedStart [ a prov:Start; prov:entity :researcher; prov:atTime "2011-07-06T01:48:36Z"^^xsd:dateTime; prov:atLocation :scienceLab_003; ]; . :researcher a prov:Agent .
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#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 . ## Expressing the above using starting-point terms ## the role of :datasetA cannot be expressed :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#activity
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.
@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; .
The property used by an prov:ActivityInfluence to cite the prov:Activity that influenced an Entity, Activity, or Agent. It can be used to refer to the activity involved in generating an entity, informing another activity, or starting another activity.
IRI:http://www.w3.org/ns/prov#agent
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.
@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 .
The property used by a prov:AgentInfluence to cite the Agent that influenced an Entity, Activity, or Agent. It can be used to express the agent involved in being responsible for an activity, being attributed to an entity, starting or ending an activity, or being responsible for another subordinate agent in an activity.
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#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.
@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:hadOriginalSource :donQuixote; prov:qualifiedSource [ a prov:Source; prov:entity :donQuixote; # Other attributes of the relationship ]; . :donQuixote a prov:Entity .
The property used by an prov:EntityInfluence to cite the Entity that was influenced by an Entity, Activity, or Agent. It can be used to refer to the entity involved in deriving another entity, being quoted or revised from, being the source of another entity, or being used in an activity.
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).
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 : <http://example.com/> . :bar_chart prov:wasDerivedFrom :aggregatedByRegions; prov:qualifiedDerivation [ a prov:Derivation; prov:entity :aggregatedByRegions; prov:hadGeneration :illustration; ]; . :illustration a prov:Generation, prov:InstantaneousEvent; prov:atTime "2012-04-03T00:00:01Z"^^xsd:dateTime; . ## An alternative way to express some of the above information :bar_chart prov:wasDerivedFrom :aggregatedByRegions; prov:wasGeneratedBy :illustrationActivity; . :illustrationActivity a prov:Activity; prov:endedAtTime "2012-04-03T00:00:01Z"^^xsd:dateTime; .
The _optional_ Generation involved in an Entity's Derivation.
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 :steve-checking-style-guide; . :steve-checking-style-guide 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#hadRole
prov:hadRole references the Role (i.e. the function of an entity with respect to an activity), in the context of a usage, generation, 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 ].
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; :treatmentEnzyme :Trypsin; ]; ]; . :proteinSample a prov:Entity .
The _optional_ Usage involved in an Entity's Derivation.
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 :usage_1; prov:qualifiedAssociation :association_1; prov:qualifiedCommunication :communication_1; . :usage_1 a prov:Usage; prov:entity :aggregatedByRegions; prov:influencer :aggregatedByRegions; # Inferred . :association_1 a prov:Association; prov:agent :derek; prov:influencer :derek; # - - - - - - - Inferred . :communication_1 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#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#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:qualifedAttribution [ 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 using prov:qualifiedAttribution [ a prov:Attribution; prov:agent :ag; :foo :bar ].
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:wasAttributedTo :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:wasAttributedTo :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 Inform[ed] using prov:qualifiedCommunication [ a prov:Communication; prov:activity :a; :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. ex:hadRole :violator; ]; prov:qualifiedAssociation [ a prov:Association; prov:agent :traffic-officer-34; # The officer was the one enforcing the traffic rules. ex: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. ex:hadRole :employer; ]; . :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. ex:hadRole :employer; ]; .
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#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 prov:wasDerivedFrom :aggregatedByRegions; prov:qualifiedDerivation [ a prov:Derivation; prov:entity :aggregatedByRegions; ## More details about the activity underpinning the derivation prov:hadGeneration :illustration; ]; .
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#qualifiedEnd
End is when an activity is deemed to have ended. 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 an entity, known as trigger, 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/> . ## The end of the experiment might have been triggered by this inconsistent result :experiment a prov:Acticity; prov:wasEndedBy :inconsistentResult; prov:qualifiedEnd [ a prov:End; prov:entity :inconsistentResult; prov:atTime "2011-07-16T01:52:02Z"^^xsd:dateTime; prov:atLocation :scienceLab003; ]; . :inconsistentResult a prov:Entity.
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#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 did performed the Generation using prov:qualifiedGeneration [ a prov:Generation; prov:entity :e; :foo :bar ].
IRI:http://www.w3.org/ns/prov#qualifiedInfluence
Influence is the capacity 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 the influencing object): # AgentInfluence, EntityInfluence, and ActivityInfluence. :conductingSurgery_1 a prov:Activity; # This unqualified influence is unknown in PROV, # this would be a subproperty of wasAssociatedWith prov:wasInfluencedBy :bob; prov:qualifiedInfluence [ # Even though PROV systems do not understand :wasConductedBy, a prov:Influence; # Inferred prov:agent :bob; # The object of :wasConductedBy prov:hadRole :surgeon; ]; . :bob a prov:Agent . my:surgeon a prov:Role .
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#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 : <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"; prov:atLocation <http://purl.org/twc/location/Swissair-Flight-111-crash>; ]; .
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#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://thinklinks.wordpress.com/2012/03/07/thoughts-from-the-dagstuhl-principles-of-provenance-workshop>; prov:qualifiedQuotation [ a prov:Quotation; prov:entity <http://thinklinks.wordpress.com/2012/03/07/thoughts-from-the-dagstuhl-principles-of-provenance-workshop>; my:fromSection 1; ]; . <http://thinklinks.wordpress.com/2012/03/07/thoughts-from-the-dagstuhl-principles-of-provenance-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:wasAssociatedWith :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#qualifiedSource
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 : <http://example.com/> . :temperatureDisplay a prov:Entity; prov:hadPrimarySource :sensorReading20120510; prov:qualifiedSource [ a prov:Source; 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:hadOriginalSource Entity :e, then it can qualify how using prov:qualifiedSource [ a prov:Source; prov:entity :e; :foo :bar ].
IRI:http://www.w3.org/ns/prov#qualifiedStart
Start is when an activity is deemed to have started. The activity did not exist before its start. Any usage or generation involving an activity follows the activity's start. A start may refer to an entity, known as trigger, 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 :experiment a prov:Activity; prov:wasStartedBy :researcher; prov:qualifiedStart [ a prov:Start; prov:entity :researcher; prov:atTime "2011-07-06T01:48:36Z"^^xsd:dateTime; prov:atLocation :scienceLab_003; ]; . :researcher a prov:Agent .
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#wasInfluencedBy
Influence is the capacity 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, the more specific relations (prov:wasInformedBy, prov:actedOnBehalfOf, prov:endedBy, etc.) should be used when applicable.
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 [OWL-2-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 3. 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 [ (prov:Activity prov:Agent prov:Entity prov:InstantaneousEvent) ] |
prov:hadActivity rdfs:domain [ (prov:Delegation prov:Derivation prov:Start) ] |
prov:wasInfluencedBy rdfs:range [ (prov:Activity prov:Agent prov:Entity) ] |
prov:wasInfluencedBy rdfs:domain [ (prov:Activity prov:Agent prov:Entity) ] |
prov:hadRole rdfs:domain [ (prov:Association prov:End prov:Generation prov:Invalidation prov:Start prov:Usage) ] |
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:hadActivity | rdfs:domain | prov:Influence |
prov:hadRole | rdfs:domain | prov:Influence |
prov:wasInfluencedBy | rdfs:domain / rdfs:range | (implied: owl:Thing) |
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:AsymmetricProperty, owl:IrreflexiveProperty, 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.
Thanks to the members of the Provenance Working Group for their feedback throughout the development of the PROV Ontology and this documentation page. We also thank the developers of the tools that helped create the PROV-O ontology and portions of this page. Without these great tools, developing PROV-O would have been much less of a pleasure.
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.