described EntityInRole
authorStian Soiland-Reyes <soiland-reyes@cs.manchester.ac.uk>
Fri, 21 Oct 2011 11:53:08 +0100
changeset 764 0b45791580c5
parent 763 9a369cccf8f1
child 765 ba48e75086ca
described EntityInRole
ontology/ProvenanceFormalModel.html
--- a/ontology/ProvenanceFormalModel.html	Fri Oct 21 11:53:00 2011 +0100
+++ b/ontology/ProvenanceFormalModel.html	Fri Oct 21 11:53:08 2011 +0100
@@ -245,7 +245,8 @@
                   &lt;rdf:type rdf:resource="http://www.w3.org/ns/prov-o/Entity"/&gt;
                   &lt;rdf:type rdf:resource="http://www.example.com/crime#CrimeFile"/&gt;
                   &lt;cf:hasLocation rdf:resource="http://www.example.com/crimeFile#sharedDirectoryLocation1"/&gt;
-                  &lt;cf:hasFileContent rdf:datatype="http://www.w3.org/2001/XMLSchema#string"&gt;There was a lot of crime in London last month.&lt;/cf:hasFileContent&gt;                 
+                  &lt;cf:hasFileContent rdf:datatype="http://www.w3.org/2001/XMLSchema#string"&gt;There 
+                    was a lot of crime in London last month.&lt;/cf:hasFileContent&gt;                 
                 &lt;/rdf:Description&gt;
 			</pre>
 		  </div>		
@@ -398,20 +399,38 @@
 		  <p> Example of instances of class EntityInRole from the <a href="http://dvcs.w3.org/hg/prov/raw-file/default/model/ProvenanceModel.html#a-file-scenario"> provenance scenario </a> are <i>author</i> role assumed by Bob and <i>file creator</i> role assumed by Alice. The RDF/XML syntax for asserting that Bob assumes the role of an author is given below.		
 		  <div class="exampleOuter">
 			<pre class="example">
-				&lt;rdf:Description rdf:about="http://www.example.com/crimeFile#AliceAsAuthor"&gt;
+				&lt;rdf:Description rdf:about="http://www.example.com/crimeFile#BobAsAuthor"&gt;
 				    &lt;rdf:type rdf:resource="http://www.w3.org/ns/prov-o/EntityInRole"/&gt;
-				    &lt;prov:assumedBy rdf:resource="http://www.example.com/crimeFile#Alice"/&gt;
+				    &lt;prov:assumedBy rdf:resource="http://www.example.com/crimeFile#Bob"/&gt;
 				    &lt;prov:assumedRole rdf:resource="http://www.example.com/crime#author"/&gt;
 				&lt;/rdf:Description&gt;
 			</pre>
 		  </div>
-                  <div class='issue'>prov:assumedBy and prov:assumedRole
-                  (or equivalent) properties have not yet been defined
-                  in this ontology. This is
-                   <a href="http://www.w3.org/2011/prov/track/issues/103">ISSUE-103</a>
-                  and 
-                   <a href="http://www.w3.org/2011/prov/track/issues/111">ISSUE-111</a>
-                  </div>
+          <p>
+            An <code>EntityInRole</code> can be used together with
+            <code>used</code>, <code>wasGeneratedBy</code> and
+            <code>wasControlledBy</code> to specify that the
+            <code>assumedBy</code> entity
+            participated in the relation in a given <em>role</em>. The role is
+            specified using <code>assumedRole</code>, referring to a
+            <code>Role</code>.
+          </p>
+          <div class="exampleOuter">
+            <pre class="example">
+                &lt;rdf:Description rdf:about="http://www.example.com/crimeFile#pe1"&gt;
+                  &lt;prov:used rdf:parseType="Resource"&gt;
+                      &lt;rdf:type rdf:resource="http://www.w3.org/ns/prov-o/EntityInRole"/&gt;
+                      &lt;prov:assumedBy rdf:resource="http://www.example.com/crimeFile#Bob"/&gt;
+                      &lt;prov:assumedRole rdf:resource="http://www.example.com/crime#author"/&gt;
+                      &lt;crime:parameter&gt;p1&lt;/crime:parameter&gt;
+                  &lt;/prov:assumedRoleAt&gt;
+                &lt;/rdf:Description&gt;	
+            </pre>
+          </div>		
+          <p>
+          The example above corresponds to in [[PROV-DM]] ASN 
+          <code>used(pe1, Bob, qualifier(role="author", parameter="p1")</code>.
+          </p>
 
 	    <div class='issue'>The PROV-DM defines the term <a href="http://dvcs.w3.org/hg/prov/raw-file/default/model/ProvenanceModel.html#expression-qualifier">Qualifier</a>, which is incorporated implicitly in definition of OWL sub-classes and sub-properties that specialize a parent class or property by defining additional qualifying constraints. Hence, <a href="http://dvcs.w3.org/hg/prov/raw-file/default/model/ProvenanceModel.html#expression-qualifier">Qualifier</a> is not modeled explicitly in PROV ontology.</div>	
 	  </section>
@@ -896,7 +915,8 @@
                               &lt;cf:hasFilePath rdf:datatype="http://www.w3.org/2001/XMLSchema#string"&gt;/share/crime.txt&lt;/cf:hasFilePath&gt;
                           &lt;/rdf:Description&gt;
                       &lt;/cf:hasLocation&gt; 
-                      &lt;cf:hasFileContent rdf:datatype="http://www.w3.org/2001/XMLSchema#string"&gt;There was a lot of crime in London last month.&lt;/cf:hasFileContent&gt;                 
+                      &lt;cf:hasFileContent rdf:datatype="http://www.w3.org/2001/XMLSchema#string"&gt;There 
+                        was a lot of crime in London last month.&lt;/cf:hasFileContent&gt;                 
                      &lt;/rdf:Description&gt;
                      &lt;rdf:Description rdf:about="http://www.example.com/crimeFile#pe2"&gt;
                          &lt;rdf:type rdf:resource="http://www.w3.org/ns/prov-o/ProcessExecution"/&gt;
@@ -1516,7 +1536,7 @@
 		</p>
 		<div class="exampleOuter">
 		  <pre class="example">
-			  &lt;rdf:Description rdf:about="http://www.example.com/crimeFile#alice"&gt;
+			  &lt;rdf:Description rdf:about="http://www.example.com/crimeFile#Alice"&gt;
                   &lt;rdf:type rdf:resource="http://www.example.com/crime#Journalist"/&gt;
 			  &lt;/rdf:Description&gt;
 		  </pre>
@@ -1535,7 +1555,7 @@
 		<p>we can infer that</p>
 		<div class="exampleOuter">
 		  <pre class="example">
-			  &lt;rdf:Description rdf:about="http://www.example.com/crimeFile#alice"&gt;
+			  &lt;rdf:Description rdf:about="http://www.example.com/crimeFile#Alice"&gt;
                   &lt;rdf:type rdf:resource="http://www.w3.org/ns/prov-o/Agent"/&gt;
 			  &lt;/rdf:Description&gt;
 		  </pre>
@@ -1543,7 +1563,7 @@
 		<p>and</p>
 		<div class="exampleOuter">
 		  <pre class="example">
-			  &lt;rdf:Description rdf:about="http://www.example.com/crimeFile#alice"&gt;
+			  &lt;rdf:Description rdf:about="http://www.example.com/crimeFile#Alice"&gt;
                   &lt;rdf:type rdf:resource="http://www.w3.org/ns/prov-o/Entity"/&gt;
 			  &lt;/rdf:Description&gt;
 		  </pre>