dm minor edits
authorLuc Moreau <l.moreau@ecs.soton.ac.uk>
Fri, 25 May 2012 08:07:53 +0100
changeset 2975 215fe8c8139d
parent 2974 b2e354aee0a2
child 2976 144c81a55a4b
dm minor edits
model/prov-dm.html
--- a/model/prov-dm.html	Fri May 25 07:43:18 2012 +0100
+++ b/model/prov-dm.html	Fri May 25 08:07:53 2012 +0100
@@ -114,7 +114,7 @@
           "URL: <a href=\"http://www.w3.org/TR/prov-constraints/\">http://www.w3.org/TR/prov-constraints/</a>",
 
         "PROV-N":
-          "Luc Moreau and Paolo Missier (eds.)"+
+          "Luc Moreau and Paolo Missier (eds.) "+
           "<a href=\"http://www.w3.org/TR/prov-n/\"><cite>PROV-N: The Provenance Notation</cite></a>. "+
           "2011, Working Draft. "+
           "URL: <a href=\"http://www.w3.org/TR/prov-n/\">http://www.w3.org/TR/prov-n/</a>",
@@ -124,6 +124,14 @@
           "<a href=\"http://www.w3.org/TR/prov-aq/\"><cite>Provenance Access and Query</cite></a>. "+
           "2011, Working Draft. "+
           "URL: <a href=\"http://www.w3.org/TR/prov-aq/\">http://www.w3.org/TR/prov-aq/</a>",
+
+        "UML":
+          "Object Management Group "+
+          "<a href=\"http://www.omg.org/spec/UML/2.0/Superstructure/PDF/\"><cite>Unified Modeling Language: Superstructure</cite></a>. "+
+          "version 2.0, 2005"+
+          "URL: <a href=\"http://www.omg.org/spec/UML/2.0/Superstructure/PDF/\">http://www.omg.org/spec/UML/2.0/Superstructure/PDF/</a>",
+
+
       };
       var respecConfig = {
           // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
@@ -1277,7 +1285,7 @@
 <h3>Component 1: Entities and Activities</h3>
 
 <p>The first component of PROV-DM is concerned with <a title="entity">entities</a> and <a title="activity">activities</a>, and their interrelations: <a>Usage</a>, <a>Generation</a>, <a>Start</a>, <a>End</a>, <a>Invalidation</a>, and <a>Communication</a>.  <a href="#figure-component1">Figure 5</a> uses UML to depict the first component.
-Core structures are displayed in the yellow area, consisting of two classes (<a>Entity</a>, <a>Activity</a>) and three binary associations between them (<a>Usage</a>, <a>Generation</a>, and <a>Communication</a>). The rest of the figure displays extended structures, including UML associations classes (represented in gray) to express expanded n-ary relations (for <a>Usage</a>, <a>Generation</a>, <a>Invalidation</a>, <a>Start</a>, <a>End</a>). The figure also makes explicit associations with <em>time</em> for these concepts (time being marked with the primitive stereotype).
+Core structures are displayed in the yellow area, consisting of two classes (<a>Entity</a>, <a>Activity</a>) and three binary associations between them (<a>Usage</a>, <a>Generation</a>, and <a>Communication</a>). The rest of the figure displays extended structures, including UML association classes (see [[!UML]], section 7.3.4, p. 42), represented in gray, to express expanded n-ary relations (for <a>Usage</a>, <a>Generation</a>, <a>Invalidation</a>, <a>Start</a>, <a>End</a>). The figure also makes explicit associations with <em>time</em> for these concepts (time being marked with the primitive stereotype).
 </p>
 
 <div style="text-align: center;">
@@ -1798,9 +1806,9 @@
 <pre class="codeexample">
 agent(ex:Paolo, [ prov:type="Person" ])
 agent(ex:Simon, [ prov:type="Person" ])
-entity(tr:WD-prov-dm-20111215, [ prov:type='rec54:WD'  ])
-wasAttributedTo(tr:WD-prov-dm-20111215, ex:Paolo, [prov:role="editor"])
-wasAttributedTo(tr:WD-prov-dm-20111215, ex:Simon, [prov:role="contributor"])
+entity(tr:WD-prov-dm-20111215, [ prov:type='rec54:WD' ])
+wasAttributedTo(tr:WD-prov-dm-20111215, ex:Paolo, [ prov:role="editor" ])
+wasAttributedTo(tr:WD-prov-dm-20111215, ex:Simon, [ prov:role="contributor" ])
 </pre>
 </div>
 
@@ -1825,28 +1833,30 @@
 <li><span class='attribute' id="association.attributes">attributes</span>: an OPTIONAL set (<span class="name">attrs</span>) of attribute-value pairs representing additional information about this association of this activity with this agent.</li>
 </ul></div>
 
-<div class="anexample" id="anexample-wasAssociateWith">
+<div class="anexample" id="anexample-wasAssociatedWith">
 <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>
 <pre class="codeexample">
-activity(ex:a, [prov:type="workflow execution"])
-agent(ex:ag1, [prov:type="operator"])
-agent(ex:ag2, [prov:type="designer"])
-wasAssociatedWith(ex:a, ex:ag1, -, [prov:role="loggedInUser", ex:how="webapp"])
-wasAssociatedWith(ex:a, ex:ag2, ex:wf,[prov:role="designer", ex:context="project1"])
-entity(ex:wf, [prov:type='prov:Plan' , ex:label="Workflow 1", 
-              ex:url="http://example.org/workflow1.bpel" %% xsd:anyURI])
+activity(ex:a, [ prov:type="workflow execution" ])
+agent(ex:ag1,  [ prov:type="operator" ])
+agent(ex:ag2,  [ prov:type="designer" ])
+wasAssociatedWith(ex:a, ex:ag1, -,     [ prov:role="loggedInUser", ex:how="webapp" ])
+wasAssociatedWith(ex:a, ex:ag2, ex:wf, [ prov:role="designer", ex:context="project1" ])
+entity(ex:wf, [ prov:type='prov:Plan' , 
+                ex:label="Workflow 1", 
+                ex:url="http://example.org/workflow1.bpel" %% xsd:anyURI ])
 </pre>
 Since the workflow <span class="name">ex:wf</span> is itself an entity, its provenance can also be expressed in PROV-DM: it can be generated by some activity and derived from other entities,
 for instance.
 </div>
 
-<div class="anexample" id="anexample-wasAssociateWith-2">
+<div class="anexample" id="anexample-wasAssociatedWith-2">
 <p>In some cases, one wants to indicate a plan was followed, without having to specify which agent was involved.</p>
 <pre class="codeexample">
-activity(ex:a,[prov:type="workflow execution"])
-wasAssociatedWith(ex:a,-,ex:wf)
-entity(ex:wf,[prov:type='prov:Plan', ex:label="Workflow 1", 
-              ex:url="http://example.org/workflow1.bpel" %% xsd:anyURI])
+activity(ex:a, [ prov:type="workflow execution" ])
+wasAssociatedWith(ex:a, -, ex:wf)
+entity(ex:wf, [ prov:type='prov:Plan', 
+                ex:label="Workflow 1", 
+                ex:url="http://example.org/workflow1.bpel" %% xsd:anyURI])
 </pre>
 In this case, it is assumed that an agent exists, but it has not been specified.
 </div>
@@ -1888,15 +1898,15 @@
 of the researcher (line-management) encoding the commands specified by the researcher; the researcher acts on behalf of the funder, who has a contractual agreement with the researcher. The terms
 'line-management' and 'contract' used in this example are domain specific.</p>
 <pre class="codeexample">
-activity(a,[prov:type="workflow"])
-agent(ag1,[prov:type="programmer"])
-agent(ag2,[prov:type="researcher"])
-agent(ag3,[prov:type="funder"])
-wasAssociatedWith(a,ag1,[prov:role="loggedInUser"])
-wasAssociatedWith(a,ag2)
-wasAssociatedWith(a,ag3)
-actedOnBehalfOf(ag1,ag2,a,[prov:type="line-management"])
-actedOnBehalfOf(ag2,ag3,a,[prov:type="contract"])
+activity(a,[ prov:type="workflow" ])
+agent(ag1, [ prov:type="programmer" ])
+agent(ag2, [ prov:type="researcher" ])
+agent(ag3, [ prov:type="funder" ])
+wasAssociatedWith(a, ag1, [ prov:role="loggedInUser" ])
+wasAssociatedWith(a, ag2)
+wasAssociatedWith(a, ag3)
+actedOnBehalfOf(ag1, ag2, a, [ prov:type="line-management" ])
+actedOnBehalfOf(ag2, ag3, a, [ prov:type="contract" ])
 </pre>
 </div>
 
@@ -2462,7 +2472,7 @@
 </pre>
 <p>According to the following provenance locator, provenance descriptions about <span class="name">ex:report1</span> can be found in bundle <span class="name">bob:bundle1</span>, which is available from the provenance service identified by the provided URI.</p>
 <pre class="codeexample"> 
-hasProvenanceIn(ex:report1, bob:bundle1, -, [ prov:service-uri="http://example.com/service"^xsd:anyURI ])
+hasProvenanceIn(ex:report1, bob:bundle1, -, [ prov:service-uri="http://example.com/service" %% xsd:anyURI ])
 </pre>
 </div>
 
@@ -3057,7 +3067,7 @@
 <div class="anexample" id="anexample-provenance-uri">
 <p>According to the following provenance locator, provenance descriptions about <span class="name">ex:report1</span> can be found in bundle <span class="name">bob:bundle1</span>, which is available from the provenance service identified by the provided URI.</p>
 <pre class="codeexample"> 
-hasProvenanceIn(ex:report1, bob:bundle1, -, [ prov:provenance-uri="http://example.com/service"^xsd:anyURI ])
+hasProvenanceIn(ex:report1, bob:bundle1, -, [ prov:provenance-uri="http://example.com/service" %% xsd:anyURI ])
 </pre>
 </div>
 
@@ -3081,7 +3091,7 @@
 <div class="anexample" id="anexample-service-uri">
 <p>According to the following provenance locator, provenance descriptions about <span class="name">ex:report1</span> can be found in the resource identified by the provided URI.</p>
 <pre class="codeexample"> 
-hasProvenanceIn(ex:report1, [ prov:service=uri="http://example.com/some-provenance.pn"^xsd:anyURI ])
+hasProvenanceIn(ex:report1, [ prov:service=uri="http://example.com/some-provenance.pn" %% xsd:anyURI ])
 </pre>
 </div>