From Provenance WG Wiki

The master copy of this document is currently maintained offline - please do not edit the document here (for now)

Section references are to http://www.w3.org/TR/2012/WD-prov-dm-20120503/, indicating the intended source of material.

Contents 1 Core 1.1 Abstract 1.2 Introduction 1.2.1 Structure of this Document 1.2.2 Notational Conventions 1.3 Preliminaries 1.3.1 Use of PROV-N 1.3.2 Identifiers, namespaces and qualified names 1.3.3 Attributes and values 1.3.4 Extension 1.3.5 Validity 1.4 Structure of provenance and provenance traces 1.5 Provenance core concepts 1.5.1 Entity 1.5.2 Activity 1.5.3 Agent 1.5.4 Derivation 1.5.5 Use 1.5.6 Generation 1.5.7 [Invalidation] 1.5.8 Attribution 1.5.9 Association 1.5.10 Responsibility 1.5.11 [communication] 1.5.12 [startedby] 1.6 Attributes 1.6.1 prov:label 1.6.2 prov:location 1.6.3 prov:role 1.6.4 prov:type 1.6.5 prov:value 2 Extensions 2.1 Abstract 2.2 Introduction 2.2.1 Structure of this Document 2.2.2 Notational Conventions 2.3 Illustration of PROV-DM by an Example 2.3.1 The Authors View 2.3.2 The Process View 2.3.3 Attribution of Provenance 2.4 Types and Relations 2.4.1 Entities 2.4.1.1 Specialization 2.4.1.2 Alternate 2.4.2 Activities 2.4.2.1 Start 2.4.2.2 End 2.4.2.3 [Communication] 2.4.2.4 [Start by Activity] 2.4.3 Derivations 2.4.3.1 Revision 2.4.3.2 Quotation 2.4.3.3 Original Source 2.4.3.4 Trace 2.5 Collections 2.5.1 Collection 2.5.2 Dictionary 2.5.3 Insertion 2.5.4 Removal 2.5.5 Membership 2.6 Annotations 2.6.1 Note 2.6.2 Annotation

Core

Abstract

Provenance describes the entities, people and activities involved in producing a piece of data or thing, from which the ancestry of an artifact can be discovered in the form of a /provenance trace/, together with information about agencies involved in the various steps leading to that entities existence. The core provenance data model describes elements that comprise the essential structural core of provenance information. This core structure may be enhanced with additional elements, some of which are described in a companion extensions specification, that represent more detailed information about the specific nature of that ancestry.

Introduction

Structure of this Document

Notational Conventions

Preliminaries

Use of PROV-N

Identifiers, namespaces and qualified names

(from 4.7.1, 4.7.2, 4.7.3)

Attributes and values

concept, not specifics

(part from 4.7.4, 4.7.5)

Extension

(refinement)

(from 5)

Validity

(selected material from 6, mainly a reference to the "constraints" document)

Structure of provenance and provenance traces

(material from 2.5, etc.)

Introduce the core triumvirate, with diagram

Diagram/example of a provenance trace (new, simplified)

Provenance core concepts

Entity

(From 4.1.1)

   entity(id, [attr1=val1, ...])

Activity

(from 4.1.2)

   activity(id, st, et, [attr1=val1, ...])

Agent

(from 4.2.1)

   agent(id, [attr1=val1, ...])

Derivation

(from 4.3.1)

   wasDerivedFrom(id, e2, e1, [a], [g2], [u1], attrs)

Use

(from 4.1.4)

   used(id,a,e,t,attrs)

Generation

(from 4.1.3)

   wasGeneratedBy(id,e,a,t,attrs)

[Invalidation]

(from 4.1.7)

   wasInvalidatedBy(id,e,a,t,attrs)

@@I've tentatively included this here as it's a natural counterpart to Generation.

Attribution

(from 4.2.2)

   wasAttributedTo(id,e,ag,attrs)

Association

(from 4.2.3)

   wasAssociatedWith(id,a,ag,[pl],attrs)

("Direction"? - "wasDirectedBy"?)

Responsibility

(from 4.2.4)

   actedOnBehalfOf(id,ag2,ag1,[a],attrs)

("Delegation"? - "wasDelegatedBy")

[communication]

(from 4.1.8)

   wasInformedBy(id,a2,a1,attrs)

@@Two interactions here I think should have a common structural ancestor ("influencedBy"?)

[startedby]

(from 4.1.9)

   wasStartedByActivity(id, a2, a1, attrs)

@@Two interactions here I think should have a common structural ancestor ("influencedBy"?)

Attributes

(from 4.7.4, et seq)

prov:label

prov:location

prov:role

prov:type

prov:value

Extensions

Abstract

The core provenance data model constructs describe the essential structures of a provenance trace, but to not provide specific information about the relationships between entities, activities and agents. Provenance extension constructs may be used to augment or refine the core constructs to provide such additional information about relationships that are commonly encountered in information and data processing activities.

Introduction

Structure of this Document

Notational Conventions

Illustration of PROV-DM by an Example

(From 3, et seq.)

(This could be the current example material, with a simplified example used in the core spec)

The Authors View

The Process View

Attribution of Provenance

Types and Relations

Entities

Specialization

(from 4.4.1)

Alternate

(from 4.4.2)

Activities

Start

(from 4.1.5)

End

(from 4.1.6)

[Communication]

(from 4.1.8, if not in core)

[Start by Activity]

(from 4.1.9, if not in core)

Derivations

Revision

(from 4.3.2)

Quotation

(from 4.3.3)

Original Source

(from 4.3.4)

Trace

(from 4.3.5)

Collections

(From 4.5 et seq)

Collection

Dictionary

Insertion

Removal

Membership

Annotations

(from 4.6 et seq)

Note

(from 4.6.1)

Annotation

(from 4.6.2)