replaced EntityInRole with QualifiedInvolvement and its subclasses
authorSatya Sahoo <satya.sahoo@case.edu>
Wed, 09 Nov 2011 22:00:38 -0500
changeset 865 c419e8ca5719
parent 864 380afc36586f
child 866 4edb6544d3b0
replaced EntityInRole with QualifiedInvolvement and its subclasses
ontology/ProvenanceFormalModel.html
--- a/ontology/ProvenanceFormalModel.html	Wed Nov 09 21:26:00 2011 -0500
+++ b/ontology/ProvenanceFormalModel.html	Wed Nov 09 22:00:38 2011 -0500
@@ -356,22 +356,84 @@
 
 
 
-		<section id="entityinrole">
-		  <h4>EntityInRole</h4>	    
+		<section id="qualifiedinvolvement">
+		  <h4>QualifiedInvolvement</h4>	    
 		  <div><b>Class Description</b></div>
-	      <p>EntityInRole is defined to be a role "assumed by a Entity or an agent." [[PROV-DM]]</p>
+	      <p>The QualifiedInvolvement class represents an n-ary property to capture qualifying information related to the  use of Entity by ProcessExecution.</p>
 		  <div><b>OWL syntax</b></div>
-		  <pre>prov:EntityInRole rdfs:subClassOf prov:Entity.</pre>
-		  <div><b>Example</b></div>
-		  <p> Example of instances of class EntityInRole from the <a href="http://www.w3.org/TR/2011/WD-prov-dm-20111018/#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#Bob_as_Author"&gt;
-				    &lt;rdf:type rdf:resource="http://www.w3.org/ns/prov-o/EntityInRole"/&gt;
+		  <pre>prov:QualifiedInvolvement rdfs:subClassOf owl:Thing.</pre>
+		
+		  <section id="usage">
+  		    <h4>Usage</h4>	    
+		    <div><b>Class Description</b></div>
+		    <p>The Usage class represents an n-ary property to capture qualifying information related to the the use, generation, control, and participation.</p>
+		    <div><b>OWL syntax</b></div>
+		    <pre>prov:Usage rdfs:subClassOf prov:QualifiedInvolvement.</pre>
+		    <div><b>Example</b></div>
+		    <p> Example of instances of class Usage from the <a href="http://www.w3.org/TR/2011/WD-prov-dm-20111018/#a-file-scenario"> provenance scenario </a> provenance scenario ??? is given below.		
+		    <div class="exampleOuter">
+			  <pre class="example">
+				&lt;rdf:Description rdf:about="http://www.example.com/crimeFile#u1"&gt;
+				    &lt;rdf:type rdf:resource="http://www.w3.org/ns/prov-o/Usage"/&gt;
+				    &lt;prov:? rdf:resource="http://www.example.com/crimeFile#Bob"/&gt;				    
+				&lt;/rdf:Description&gt;
+			  </pre>
+	  		  </div>
+	        </section>
+	
+			<section id="participation">
+  		  	  <h4>Participation</h4>	    
+		      <div><b>Class Description</b></div>
+		  	  <p>The Participation class represents an n-ary property to capture qualifying information related to the participation of Entity in ProcessExecution.</p>
+		  	  <div><b>OWL syntax</b></div>
+		  	  <pre>prov:Participation rdfs:subClassOf prov:QualifiedInvolvement.</pre>
+		  	  <div><b>Example</b></div>
+		  	  <p> Example of instances of class Participation from the <a href="http://www.w3.org/TR/2011/WD-prov-dm-20111018/#a-file-scenario"> provenance scenario </a> provenance scenario ??? is given below.		
+		  	  <div class="exampleOuter">
+			  <pre class="example">
+				&lt;rdf:Description rdf:about="http://www.example.com/crimeFile#p1"&gt;
+				    &lt;rdf:type rdf:resource="http://www.w3.org/ns/prov-o/Participation"/&gt;
+				    &lt;prov:? rdf:resource="http://www.example.com/crimeFile#Bob"/&gt;				    
+				&lt;/rdf:Description&gt;
+			  </pre>
+	  		  </div>
+	        </section>
+	
+	        <section id="control">
+  		  		<h4>Control</h4>	    
+		  		<div><b>Class Description</b></div>
+		  		<p>The Control class represents an n-ary property to capture qualifying information related to the control of ProcessExecution by Agent.</p>
+		  		<div><b>OWL syntax</b></div>
+		  		<pre>prov:Control rdfs:subClassOf prov:QualifiedInvolvement.</pre>
+		  		<div><b>Example</b></div>
+		  		<p>Example of instances of class Control from the <a href="http://www.w3.org/TR/2011/WD-prov-dm-20111018/#a-file-scenario"> provenance scenario </a> provenance scenario ??? is given below.		
+		  		<div class="exampleOuter">
+				<pre class="example">
+				&lt;rdf:Description rdf:about="http://www.example.com/crimeFile#c1"&gt;
+				    &lt;rdf:type rdf:resource="http://www.w3.org/ns/prov-o/Control"/&gt;
 				    &lt;prov:wasAssumedBy rdf:resource="http://www.example.com/crimeFile#Bob"/&gt;				    
 				&lt;/rdf:Description&gt;
-			</pre>
-	  		</div>	    	
+			    </pre>
+	  			</div>
+	      	</section>
+	
+			<section id="generation">
+	  		    <h4>Generation</h4>	    
+			    <div><b>Class Description</b></div>
+			    <p>The Generation class represents an n-ary property to capture qualifying information related to the generation of Entity by ProcessExecution.</p>
+			    <div><b>OWL syntax</b></div>
+			    <pre>prov:Generation rdfs:subClassOf prov:QualifiedInvolvement.</pre>
+			    <div><b>Example</b></div>
+			    <p> Example of instances of class Generation from the <a href="http://www.w3.org/TR/2011/WD-prov-dm-20111018/#a-file-scenario"> provenance scenario</a> ??? is given below.		
+			    <div class="exampleOuter">
+				  <pre class="example">
+					&lt;rdf:Description rdf:about="http://www.example.com/crimeFile#g1"&gt;
+					    &lt;rdf:type rdf:resource="http://www.w3.org/ns/prov-o/Generation"/&gt;
+					    &lt;prov:? rdf:resource="http://www.example.com/crimeFile#Bob"/&gt;				    
+					&lt;/rdf:Description&gt;
+				  </pre>
+		  		  </div>
+		      </section>	    	
 	  </section>
 	
 	  <section id="recipe">
@@ -666,26 +728,7 @@
 					&lt;/rdf:Description&gt;	
 				</pre>
 			  </div> 
-	    </section>
-		
-		<section id="wasassumedby">
-		  <h4>wasAssumedBy</h4>
-	      <p>This property links an instance of <code>Entity</code> to its assumed <em>role</em>. This allows an instance of an Entity to participate in different or same instances of ProcessExecution class in different ways.
-          </p>
-          <img src="diagram-history/khalidDiagrams/wasAssumedBy.png" 
-               style="height: 3em"  alt="wasAssumedBy links EntityInRole to Entity" />	
-          <div class="exampleOuter">
-            <pre class="example">
-	            &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:wasAssumedBy rdf:resource="http://www.example.com/crimeFile#Bob"/&gt;	                
-                &lt;/rdf:Description&gt;	
-	                </pre>
-	              </div>		
-	              <p>
-	              The example above corresponds to the PROV-ASN assertion:<code>used(pe1, bob, qualifier(role="author")</code>
-	              </p>
-		    </section>
+	    </section>	
 
 		<section id="attribution">
 			  <h4>wasAttributedTo</h4>