--- a/model/prov-dm.html Mon Jun 11 09:23:00 2012 +0100
+++ b/model/prov-dm.html Mon Jun 11 13:42:16 2012 +0100
@@ -2799,19 +2799,15 @@
wasAssociatedWith(ex:a2,ex:Bob,[prov:role="controller"])
endBundle
</pre>
-<p>A performance rating tool reads these bundles, and rates the performance of the agent described in these bundles. The performance rating tool creates a new bundle <span class="name">tool:analysis01</span> containing the following. A new agent <span class="name">tool:Bob-2011-11-16</span> is declared as a contextualization of <span class="name">ex:Bob</span> as described in context <span class="name">ex:run1</span>, and likewise for <span class="name">tool:Bob-2011-11-17</span> with respect to <span class="name">ex:run2</span>. The tool then defines two specializations of these contextualized agents with an associated rating. The performance of the agent in the first bundle is judged to be good since the duration of <span class="name">ex:a1</span> is one hour, whereas it is judged to be bad in the second bundle since <span class="name">ex:a2</span>'s duration is seven hours.
+<p>A performance rating tool reads these bundles, and rates the performance of the agent described in these bundles. The performance rating tool creates a new bundle <span class="name">tool:analysis01</span> containing the following. A new agent <span class="name">tool:Bob-2011-11-16</span> is declared as a contextualization of <span class="name">ex:Bob</span> as described in context <span class="name">ex:run1</span>, and likewise for <span class="name">tool:Bob-2011-11-17</span> with respect to <span class="name">ex:run2</span>. The tool adds a performance attribute to each of these specialized entities as follows: the performance of the agent in the first bundle is judged to be good since the duration of <span class="name">ex:a1</span> is one hour, whereas it is judged to be bad in the second bundle since <span class="name">ex:a2</span>'s duration is seven hours.
<pre class="codeexample">
bundle tool:analysis01
- agent(tool:Bob-2011-11-16)
+ agent(tool:Bob-2011-11-16, [perf:rating="good"])
contextualizationOf(tool:Bob-2011-11-16, ex:Bob, ex:run1)
- agent(tool:rated-Bob-2011-11-16, [perf:rating="good"])
- specialization(tool:rated-Bob-2011-11-16, tool:Bob-2011-11-16)
-
- agent(tool:Bob-2011-11-17)
+
+ agent(tool:Bob-2011-11-17, [perf:rating="bad"])
contextualizationOf(tool:Bob-2011-11-17, ex:Bob, ex:run2)
- agent(tool:rated-Bob-2011-11-17, [perf:rating="bad"])
- specialization(tool:rated-Bob-2011-11-17, tool:Bob-2011-11-17)
endBundle
</pre>
</div>
@@ -2820,31 +2816,30 @@
<div class="anexample" id="aexample-contextualization-viz">
<p>Consider the following bundle of descriptions, in which derivation and generations have been identified.
<pre class="codeexample">
-bundle obs:bundle7
+bundle obs:bundle1
entity(ex:report1, [prov:type="report", ex:version=1])
wasGeneratedBy(ex:g1; ex:report1,-,2012-05-24T10:00:01)
entity(ex:report2, [prov:type="report", ex:version=2])
wasGeneratedBy(ex:g2; ex:report2,-,2012-05-25T11:00:01)
wasDerivedFrom(ex:d; ex:report2, ex:report1)
endBundle
-entity(obs:bundle7, [ prov:type='prov:Bundle' ])
-wasAttributedTo(obs:bundle7, ex:observer01)
+entity(obs:bundle1, [ prov:type='prov:Bundle' ])
+wasAttributedTo(obs:bundle1, ex:observer01)
</pre>
-Bundle <span class="name">obs:bundle7</span> is rendered by a visualisation tool. It may useful for the tool configuration for this bundle to be shared along with the provenance descriptions, so that other users can render provenance as it was originally rendered. The original bundle obviously cannot be changed. However, one can create a new bundle, as follows.
+Bundle <span class="name">obs:bundle1</span> is rendered by a visualisation tool. It may useful for the tool configuration for this bundle to be shared along with the provenance descriptions, so that other users can render provenance as it was originally rendered. The original bundle obviously cannot be changed. However, one can create a new bundle, as follows.
<pre class="codeexample">
bundle tool:bundle8
entity(tool:bundle8, [ prov:type='viz:Configuration', prov:type='prov:Bundle' ])
wasAttributedTo(tool:bundle8, viz:Visualizer)
- entity(tool:report1, [viz:color="orange"]) // is it appropriate to add viz attributes to tool:report1 or should we specialize it?
- contextualizationOf(tool:report1, obs:bundle7, ex:report1)
+ entity(tool:report1, [viz:color="orange"])
+ contextualizationOf(tool:report1, obs:bundle1, ex:report1)
entity(tool:report2, [viz:color="blue"])
- contextualizationOf(tool:report2, obs:bundle7, ex:report2)
-
+ contextualizationOf(tool:report2, obs:bundle1, ex:report2)
wasDerivedBy(tool:d; tool:report2, tool:report1, [viz:style="dotted"])
- contextualizationOf(tool:d, obs:bundle7, ex:d)
+ contextualizationOf(tool:d, obs:bundle1, ex:d)
endBundle
</pre>
@@ -2857,7 +2852,7 @@
created new identifiers <span class="name">tool:report1</span>,
<span class="name">tool:report2</span>, and
<span class="name">tool:d</span>.
-They denote entities which are alternates of with <span class="name">ex:report1</span> and <span class="name">ex:report2</span>, described in bundle <span class="name">obs:bundle7</span>, with visualization attribute for the color to be used when rendering these entities.
+They denote entities which are alternates of with <span class="name">ex:report1</span> and <span class="name">ex:report2</span>, described in bundle <span class="name">obs:bundle1</span>, with visualization attribute for the color to be used when rendering these entities.
Likewise, the derivation has a style attribute. </p>
<p>According to their definition,