model/prov-dm.html
changeset 4515 9fb92e012cec
parent 4510 d77aa368ddfa
child 4516 998d228b4a8e
     1.1 --- a/model/prov-dm.html	Mon Oct 08 23:15:50 2012 +0200
     1.2 +++ b/model/prov-dm.html	Tue Oct 09 11:54:15 2012 +0100
     1.3 @@ -2196,6 +2196,7 @@
     1.4  Revision is a particular case of <a>derivation</a> of an entity into its revised version.
     1.5  The type is of a revision derivation is denoted by:
     1.6  <dfn title="dfn-prov:revision" id="dfn-prov:revision"><span class="name">prov:Revision</span></dfn>.
     1.7 +PROV defines no revision-specific attributes.
     1.8  </p>
     1.9  
    1.10  <!-- <p> A <dfn title="wasRevisionOf">revision</dfn> relation<span class="withPn">, written <span class="pnExpression">wasRevisionOf(id; e2, e1, a, g2, u1, attrs)</span> in PROV-N,</span> has:</p>
    1.11 @@ -2241,6 +2242,7 @@
    1.12   is a particular case of  <a>derivation</a> in which an entity is derived from an original entity by copying, or "quoting", some or all of it.
    1.13  The type is of a quotation derivation is denoted by:
    1.14  <dfn title="dfn-prov:quotation" id="dfn-prov:quotation"><span class="name">prov:Quotation</span></dfn>.
    1.15 +PROV defines no quotation-specific attributes.
    1.16  </p>
    1.17  
    1.18  
    1.19 @@ -2294,6 +2296,7 @@
    1.20  application's domain. 
    1.21  The type is of a  primary source derivation is denoted by:
    1.22  <dfn title="dfn-prov:primary-source" id="dfn-prov:primary-source"><span class="name">prov:PrimarySource</span></dfn>.
    1.23 +PROV defines no attributes specific to primary source.
    1.24  </p>
    1.25  
    1.26  
    1.27 @@ -2338,7 +2341,7 @@
    1.28  </figure>
    1.29  </div>
    1.30  
    1.31 -<p>Component 3 further defines a general notion of <a>influence</a>, as a super-relation of all relations defined so far. <a href="#figure-component3b">Figure 8</a> displays one new association class, generalizing previously introduced associations.</p>
    1.32 +<p>Component 3 further defines a general notion of <a>influence</a>, a relation implied by all relations defined so far. <a href="#figure-component3b">Figure 8</a> displays one new association class, generalizing previously introduced associations.</p>
    1.33  
    1.34  
    1.35  <div style="text-align: center;">
    1.36 @@ -2382,7 +2385,7 @@
    1.37  
    1.38  <div class="glossary-ref" data-ref="glossary-person"></div></li> 
    1.39  </ul>
    1.40 -
    1.41 +<p>PROV defines no attributes specific to SoftwareAgent, Organization, and Person.</p>
    1.42  
    1.43  
    1.44  
    1.45 @@ -2451,6 +2454,9 @@
    1.46  <p>While each of <a href="#association.id"><span class='attribute'>id</span></a>, <a href="#association.agent"><span class='attribute'>agent</span></a>,  <a href="#association.plan"><span class='attribute'>plan</span></a>, and  <a href="#association.attributes"><span class='attribute'>attributes</span></a> is OPTIONAL, at least one of them MUST be present.</p>
    1.47  
    1.48  
    1.49 +<p>PROV defines no plan-specific attributes.</p>
    1.50 +
    1.51 +
    1.52  <div class="anexample" id="anexample-wasAssociatedWith">
    1.53  <p>In the following example, a designer agent and an operator agent are associated with an activity. The designer's goals are achieved by a workflow <span class="name">ex:wf</span>, described as an an entity of type <span class="name"><a>plan</a></span>.   </p>
    1.54  <pre class="codeexample">
    1.55 @@ -2560,9 +2566,41 @@
    1.56  </ul>
    1.57  
    1.58  <p>
    1.59 -<a>Usage</a>, <a>start</a>, <a>end</a>, <a>generation</a>, <a>invalidation</a>, <a>communication</a>, <a>derivation</a>, <a>attribution</a>, <a>association</a>, and <a>delegation</a> are particular cases of  influence. It is RECOMMENDED to adopt these more specific relations when writing provenance descriptions. It is anticipated that the <a>Influence</a> relation may be useful to express queries over provenance information.
    1.60 +<a>Usage</a>, <a>start</a>, <a>end</a>, <a>generation</a>, <a>invalidation</a>, <a>communication</a>, <a>derivation</a>, <a>attribution</a>, <a>association</a>, and <a>delegation</a> are also <a>influence</a>. It is RECOMMENDED to adopt these more specific relations when writing provenance descriptions. It is anticipated that the <a>Influence</a> relation may be useful to express queries over provenance information.
    1.61  </p>
    1.62  
    1.63 +
    1.64 +<div id="mapping-relations-to-influence-table" style="text-align: left;">
    1.65 +The following table establishes the correspondence between 
    1.66 +the attributes <a class='attribute' href="#influence.influencee">influencee</span></a> and <a class='attribute' href="#influence.influencer">influencer</span></a>, and attributes of
    1.67 +<a>usage</a>, <a>start</a>, <a>end</a>, <a>generation</a>, <a>invalidation</a>, <a>communication</a>, <a>derivation</a>, <a>attribution</a>, <a>association</a>, and <a>delegation</a>.
    1.68 +
    1.69 +<table  class="thinborder" style="margin-left: auto; margin-right: auto;">
    1.70 +<caption id="mapping-relations-to-influence-table">Mapping Relations to Influence</caption> <!-- Table 7-->
    1.71 +<tr><td><a><b>Relation Name</b></a></td><td><b><a class='attribute' href="#influence.influencee">influencee</span></a></b></td><td><b><a class='attribute' href="#influence.influencer">influencer</span></a></b></td></tr>
    1.72 +<tr><td style="border-width: 0px; "></td><td style="border-width: 0px; "></td><td style="border-width: 0px; "></td></tr>
    1.73 +
    1.74 +<tr class="component1-color"><td><a>Generation</a></td><td><a class='attribute' href="#generation.entity">entity</span></a></td><td><a class='attribute' href="#generation.activity">activity</span></a></td></tr>
    1.75 +<tr class="component1-color"><td><a>Usage</a></td><td><a class='attribute' href="#usage.activity">activity</span></a></td><td><a class='attribute' href="#usage.entity">entity</span></a></td></tr>
    1.76 +<tr class="component1-color"><td><a>Communication</a></td><td><a class='attribute' href="#communication.informed">informed</span></a></td><td><a class='attribute' href="#communication.informant">informant</span></a></td></tr>
    1.77 +<tr class="component1-color"><td><a>Start</a></td><td><a class='attribute' href="#start.activity">activity</span></a></td><td><a class='attribute' href="#start.trigger">trigger</span></a></td></tr>
    1.78 +<tr class="component1-color"><td><a>End</a></td><td><a class='attribute' href="#end.activity">activity</span></a></td><td><a class='attribute' href="#end.trigger">trigger</span></a></td></tr>
    1.79 +<tr class="component1-color"><td><a>Invalidation</a></td><td><a class='attribute' href="#invalidation.entity">entity</span></a></td><td><a class='attribute' href="#invalidation.activity">activity</span></a></td></tr>
    1.80 +
    1.81 +<tr><td style="border-width: 0px; "></td><td style="border-width: 0px; "></td><td style="border-width: 0px; "></td></tr>
    1.82 +
    1.83 +<tr class="component2-color"><td><a>Derivation</a></td><td><a class='attribute' href="#derivation.generatedEntity">generatedEntity</span></a></td><td><a class='attribute' href="#derivation.usedEntity">usedEntity</span></a></td></tr>
    1.84 +
    1.85 +<tr><td style="border-width: 0px; "></td><td style="border-width: 0px; "></td><td style="border-width: 0px; "></td></tr>
    1.86 +
    1.87 +
    1.88 +<tr class="component3-color"><td><a>Attribution</a></td><td><a class='attribute' href="#attribution.entity">entity</span></a></td><td><a class='attribute' href="#attribution.agent">agent</span></a></td></tr>
    1.89 +<tr class="component3-color"><td><a>Association</a></td><td><a class='attribute' href="#association.activity">activity</span></a></td><td><a class='attribute' href="#association.agent">agent</span></a></td></tr>
    1.90 +<tr class="component3-color"><td><a>Delegation</a></td><td><a class='attribute' href="#delegation.delegate">delegate</span></a></td><td><a class='attribute' href="#delegation.responsible">responsible</span></a></td></tr>
    1.91 +</table>
    1.92 +</div>
    1.93 +
    1.94 +
    1.95  <div class="anexample">
    1.96  <p>We refer to the example of <a class="section-ref" href="#section-example-two"><span>TBD</span></a>, and specifically to <a  href="#prov-a-document2-top">Figure 3</a>.
    1.97  We could have expressed that the influence of
    1.98 @@ -2599,7 +2637,7 @@
    1.99  <figure style="max-width: 95%; ">
   1.100  
   1.101  <img src="uml/component4.png" alt="bundles"/><br>
   1.102 -<figcaption id="figure-component4">Figure 9: Bundle Component Overview</figcaption>
   1.103 +<figcaption id="figure-component4">Bundle Component Overview</figcaption>
   1.104  </figure>
   1.105  </div>
   1.106  
   1.107 @@ -2620,10 +2658,10 @@
   1.108  
   1.109  <p>
   1.110  <div class="attributes" id="attributes-bundle">
   1.111 - A <dfn title="dfn-bundle" id="dfn-bundle-declaration">bundle constructor</dfn>  allows the content and the name of a bundle to be specified; it is written <span class="pnExpression">bundle id description_1 ... description_n endBundle</span> and consists of:
   1.112 + A <dfn title="dfn-bundle" id="dfn-bundle-constructor">bundle constructor</dfn>  allows the content and the name of a bundle to be specified; it is written <span class="pnExpression">bundle id description_1 ... description_n endBundle</span> and consists of:
   1.113  <ul>
   1.114 -<li><span class='attribute' id="bundle.declaration.id">id</span>:  an identifier for the bundle;</li>
   1.115 -<li><span class='attribute' id="bundle.declaration.descriptions">descriptions</span>: a set of provenance descriptions <span class="name">
   1.116 +<li><span class='attribute' id="bundle.constructor.id">id</span>:  an identifier for the bundle;</li>
   1.117 +<li><span class='attribute' id="bundle.constructor.descriptions">descriptions</span>: a set of provenance descriptions <span class="name">
   1.118  description_1</span>, ..., <span class="name">description_n</span>.</li>
   1.119  </ul>
   1.120  <p>A bundle's identifier <span class="name">id</span> identifies a unique set of descriptions.</p>
   1.121 @@ -2642,10 +2680,11 @@
   1.122  
   1.123  <p>A  bundle is a named set of descriptions, but it is also an entity so that its provenance can be described.  </p>
   1.124  
   1.125 -PROV defines the following type for bundles:
   1.126 +<p>PROV defines the following type for bundles:</p>
   1.127  <ul>
   1.128  <li><span class="name">prov:Bundle</span> is the type that denotes <a title="bundle">bundles</a>.
   1.129  </ul>
   1.130 +<p>PROV defines no bundle-specific attributes.</p>
   1.131  
   1.132  
   1.133  <p>
   1.134 @@ -3258,7 +3297,7 @@
   1.135  
   1.136    <li><span class="name">prov:EmptyCollection</span> denotes an empty collection.
   1.137  </ul>
   1.138 -
   1.139 +<p>PROV defines no collection-specific attributes.</p>
   1.140  
   1.141  <div class="anexample">
   1.142  <pre class="codeexample">
   1.143 @@ -3344,7 +3383,7 @@
   1.144  
   1.145  <div id="attributes-at-a-glance-divz" style="text-align: left;">
   1.146  <table   class="thinborder" style="margin-left: auto; margin-right: auto;">
   1.147 -<caption id="attributes-at-a-glance">PROV-DM Attributes At a Glance</caption> <!-- Table 7 -->
   1.148 +<caption id="attributes-at-a-glance">PROV-DM Attributes At a Glance</caption> <!-- Table 8 -->
   1.149  <tr><td><b>Attribute</b></td><td><b>Allowed In</b></td><td><b>value</b></td><td><b>Section</b></td></tr> 
   1.150  <tr><td style="border-width: 0px; "></td><td style="border-width: 0px; "></td><td style="border-width: 0px; "><td style="border-width: 0px; "></td></tr>
   1.151  <tr><td><a title="label">prov:label</a></td><td><em>any construct</em></td><td>A <a>Value</a> of type <a class="section-ref" href="http://www.w3.org/TR/xmlschema11-2/#string">xsd:string</a></td><td><a class="section-ref" href="#term-attribute-label"><span>TBD</span></a> </td></tr>
   1.152 @@ -3452,7 +3491,7 @@
   1.153  
   1.154  
   1.155  <table class="thinborder" style="margin-left: auto; margin-right: auto;">
   1.156 -<caption id="prov-dm-predefined-types">PROV-DM Predefined Types</caption> <!-- Table 8 -->
   1.157 +<caption id="prov-dm-predefined-types">PROV-DM Predefined Types</caption> <!-- Table 9 -->
   1.158  <tr><td><b>Type</b></td><td><b>Specification</b></td><td><b>Core concept</b></td></tr>
   1.159  <tr><td style="border-width: 0px; "></td><td style="border-width: 0px; "></td><td style="border-width: 0px; "></td></tr>
   1.160  <tr><td><a title="bundle"><span class="name">prov:Bundle</span></a></td><td><a class="section-ref" href="#term-bundle"><span>TBD</span></a></td><td><a>Entity</a></td></tr>
   1.161 @@ -3869,7 +3908,7 @@
   1.162  
   1.163  <div id="prov-dm-to-prov-o-and-prov-n-fig" style="text-align: left;">
   1.164  <table  class="thinborder" style="margin-left: auto; margin-right: auto;">
   1.165 -<caption id="prov-dm-to-prov-o-and-prov-n">Cross-References to PROV-O and PROV-N</caption> <!-- Table 5-->
   1.166 +<caption id="prov-dm-to-prov-o-and-prov-n">Cross-References to PROV-O and PROV-N</caption> <!-- Table 10-->
   1.167  <tr><td><a><b>PROV-DM</b></a></td><td><b>PROV-O</b></td><td><b>PROV-N</b></td><td><b>Component</b></td></tr>
   1.168  <tr><td style="border-width: 0px; "></td><td style="border-width: 0px; "></td><td style="border-width: 0px; "></td><td style="border-width: 0px; "></td></tr>
   1.169  
   1.170 @@ -4089,6 +4128,8 @@
   1.171  <li> <a href="http://www.w3.org/2011/prov/track/issues/509">ISSUE-509</a>: modified the introductory text to UML figures, so that they refer to relation names (e.g. WasStartedBy) as visualized in figures
   1.172  <li> <a href="http://www.w3.org/2011/prov/track/issues/515">ISSUE-515</a>: fixed typo
   1.173  <li> <a href="http://www.w3.org/2011/prov/track/issues/531">ISSUE-531</a>: added sentence on the use of prov:location attribute.
   1.174 +
   1.175 +<li> <a href="http://www.w3.org/2011/prov/track/issues/519">ISSUE-519</a>, <a href="http://www.w3.org/2011/prov/track/issues/523">ISSUE-523</a>, <a href="http://www.w3.org/2011/prov/track/issues/524">ISSUE-524</a>, <a href="http://www.w3.org/2011/prov/track/issues/529">ISSUE-529</a>: changed UML diagram of figure 8 by removing explicit inheritance from influence for  usage, start, end, generation, invalidation, communication, derivation, attribution, association, and delegation.  Instead, introduced correspondance table 7.  Furthermore, in response to these issues, it was made clear that PROV defines no attribute specific to subtypes such as SoftwareAgent, ..., Plan, Revision, Bundle, Collection.
   1.176  </ul>
   1.177  
   1.178  </section>