Primer: Changed alternate intuitive example to be about backups; fixed minor figure errors; changed to new boilerplate and bibliography
--- a/primer/Primer.html Wed Nov 21 11:46:11 2012 -0500
+++ b/primer/Primer.html Wed Nov 21 16:50:01 2012 +0000
@@ -16,48 +16,13 @@
<script src="http://www.w3.org/2007/OWL/toggles.js"></script>
<script src="http://dev.w3.org/2009/dap/ReSpec.js/js/respec.js" class="remove"></script>
+ <script src="../model/provbib.js" class="remove"></script>
<script class="remove">
var addExtraReferences = function() {
for (var k in extraReferences)
berjon.biblio[k] = extraReferences[k];
};
var extraReferences = {
- "PROV-DM":
- "Luc Moreau, Paolo Missier "+
- "<a href=\"http://www.w3.org/TR/prov-dm/\"><cite>The PROV Data Model and Abstract Syntax Notation</cite></a>. "+
- "Working Draft, "+
- "URL: <a href=\"http://www.w3.org/TR/prov-dm/\">http://www.w3.org/TR/prov-dm/</a>",
-
- "PROV-O":
- "Satya Sahoo, Deborah McGuinness "+
- "<a href=\"http://www.w3.org/TR/prov-o/\"><cite>The PROV Ontology: Model and Formal Semantics</cite></a>. "+
- "Working Draft, "+
- "URL: <a href=\"http://www.w3.org/TR/prov-o/\">http://www.w3.org/TR/prov-o/</a>",
-
- "PROV-N":
- "Luc Moreau, Paolo Missier "+
- "<a href=\"http://www.w3.org/TR/prov-n/\"><cite>PROV-N: The PROV Notation</cite></a>. "+
- "Working Draft, "+
- "URL: <a href=\"http://www.w3.org/TR/prov-n/\">http://www.w3.org/TR/prov-n/</a>",
-
- "PROV-XML":
- "Hook Hua, Curt Tilmes, Stephan Zednik "+
- "<a href=\"http://www.w3.org/TR/prov-xml/\"><cite>PROV-XML: The PROV XML Schema</cite></a>. "+
- "Working Draft, "+
- "URL: <a href=\"http://www.w3.org/TR/prov-xml/\">http://www.w3.org/TR/prov-xml/</a>",
-
- "PROV-AQ":
- "Graham Klyne, Paul Groth "+
- "<a href=\"http://www.w3.org/TR/prov-aq/\"><cite>PROV-AQ: Provenance Access and Query</cite></a>. "+
- "Working Draft, "+
- "URL: <a href=\"http://www.w3.org/TR/prov-aq/\">http://www.w3.org/TR/prov-aq/</a>",
-
- "PROV-CONSTRAINTS":
- "James Cheney, Paolo Missier, Luc Moreau "+
- "<a href=\"http://www.w3.org/TR/prov-constraints/\"><cite>Constraints of the Provenance Data Model</cite></a>. "+
- "Working Draft, "+
- "URL: <a href=\"http://www.w3.org/TR/prov-constraints/\">http://www.w3.org/TR/prov-constraints/</a>",
-
"TURTLE":
"Eric Prud'hommeaux, Gavin Carothers "+
"<a href=\"http://www.w3.org/TR/2011/WD-turtle-20110809/\"><cite>Turtle: Terse RDF Triple Language</cite></a>. "+
@@ -152,7 +117,7 @@
wgPatentURI: "http://www.w3.org/2004/01/pp-impl/46974/status",
// Add extraReferences to bibliography database
- preProcess: [addExtraReferences]
+ preProcess: [addProvReferences,addExtraReferences]
};
</script>
</head>
@@ -167,46 +132,39 @@
of its use. The primer is intended as a starting point for those wishing
to create or use PROV data.
</p>
+ <p>
+ The PROV Document Overview describes the overall state of PROV, and should be read before other PROV documents.
+ </p>
<!-- p>
This is a document for internal discussion, which will ultimately
evolve in the first Public Working Draft of the Primer.</p -->
</section>
- <section id="sotd">
- This document is part of a set of specifications aiming to define the
- various aspects that are necessary to achieve the vision of
- interoperable interchange of provenance information in heterogeneous
- environments such as the Web. This document is an
- intuitive introduction and guide with simple illustrative examples
- of the core aspects of PROV.
+<section id="sotd">
+<h4>PROV Family of Documents</h4>
+This document is part of the PROV family of documents, a set of documents defining various aspects that are necessary to achieve the vision of inter-operable
+interchange of provenance information in heterogeneous environments such as the Web. These documents are:
+<ul>
+<li> <a href="http://www.w3.org/TR/2012/WD-prov-overview-20121211/">PROV-OVERVIEW</a> (Note), an overview of the PROV family of documents [[PROV-OVERVIEW]];</li>
+<li> <a href="http://www.w3.org/TR/2012/WD-prov-primer-20121211/">PROV-PRIMER</a> (Note), a primer for the PROV data model [[PROV-PRIMER]];</li>
+<li> <a href="http://www.w3.org/TR/2012/CR-prov-o-20121211/">PROV-O</a> (Recommendation), the PROV ontology, an OWL2 ontology allowing the mapping of PROV to RDF [[!PROV-O]];</li>
+<li> <a href="http://www.w3.org/TR/2012/CR-prov-dm-20121211/">PROV-DM</a> (Recommendation), the PROV data model for provenance (this document);</li>
+<li> <a href="http://www.w3.org/TR/2012/CR-prov-n-20121211/">PROV-N</a> (Recommendation), a notation for provenance aimed at human consumption [[!PROV-N]];</li>
+<li> <a href="http://www.w3.org/TR/2012/CR-prov-constraints-20121211/">PROV-CONSTRAINTS</a> (Recommendation), a set of constraints applying to the PROV data model [[!PROV-CONSTRAINTS]];</li>
+<li> <a href="http://www.w3.org/TR/2012/WD-prov-aq-20120619/">PROV-AQ</a> (Note), the mechanisms for accessing and querying provenance [[PROV-AQ]]; </li>
+<li> <a href="http://www.w3.org/TR/2012/WD-prov-xml-20121211/">PROV-XML</a> (Note), an XML schema for the PROV data model [[PROV-XML]].</li>
- <h4>PROV Family of Specifications</h4>
- The PROV family of specifications aims to define the various aspects that are necessary to achieve the vision of inter-operable
- interchange of provenance information in heterogeneous environments such as the Web.
- The specifications are as follows.
- <ul>
- <li> PROV-PRIMER, a primer for the PROV data model (this document),</li>
- <li> PROV-DM, the PROV data model for provenance,</li>
- <li> PROV-DM-CONSTRAINTS, a set of constraints applying to the PROV data model,</li>
- <li> PROV-N, a notation for provenance aimed at human consumption,</li>
- <li> PROV-O, the PROV ontology, an OWL-RL ontology allowing the mapping of PROV to RDF;</li>
- <li> PROV-AQ, the mechanisms for accessing and querying provenance; </li>
- <li> PROV-SEM, a formal semantics for the PROV data model.</li>
- <li> PROV-XML, an XML schema for the PROV data model.</li>
- </ul>
- <h4>How to read the PROV Family of Specifications</h4>
- <ul>
- <li>The primer is the entry point to PROV offering a pedagogical presentation of the provenance model.</li>
- <li>The Linked Data and Semantic Web community should focus on PROV-O defining PROV classes and properties specified in an OWL-RL ontology. For further details, PROV-DM and PROV-DM-CONSTRAINTS specify the constraints applicable to the data model, and its interpretation. PROV-SEM provides a mathematical semantics.</li>
- <li>The XML community should focus on PROV-XML defining an XML schema for PROV-DM. Further details can also be found in PROV-DM, PROV-DM-CONSTRAINTS, and PROV-SEM.</li>
- <li>Developers seeking to retrieve or publish provenance should focus of PROV-AQ.</li>
- <li>Readers seeking to implement other PROV serializations
- should focus on PROV-DM and PROV-DM-CONSTRAINTS. PROV-O, PROV-N, PROV-XML offer examples of mapping to RDF, text, and XML, respectively.</li>
- </ul>
-
-
- </section>
+</ul>
+<h4>How to read the PROV Family of Documentation</h4>
+<ul>
+<li>The primer is the entry point to PROV offering an introduction to the provenance model.</li>
+<li>The Linked Data and Semantic Web community should focus on PROV-O defining PROV classes and properties specified in an OWL2 ontology. For further details, PROV-DM and PROV-CONSTRAINTS specify the constraints applicable to the data model, and its interpretation. </li>
+<li>Developers seeking to retrieve or publish provenance should focus on PROV-AQ.</li>
+<li>Readers seeking to implement other PROV serializations
+should focus on PROV-DM and PROV-CONSTRAINTS. PROV-O and PROV-N offer examples of mapping to RDF and text, respectively.</li>
+</ul>
+</section>
<section>
<h2>Introduction</h2>
@@ -284,8 +242,8 @@
<p>There are additional reference documents for PROV that are not covered in this
primer, including the PROV Access and Query aspects of the specification [[PROV-AQ]],
the constraints on the PROV data model [[PROV-CONSTRAINTS]],
- a formal semantics of the PROV data model (PROV-SEM), and the PROV XML notation
- (PROV-XML). </p>
+ a formal semantics of the PROV data model [[PROV-SEM]], and the PROV XML notation
+ [[PROV-XML]]. </p>
</section>
@@ -492,10 +450,10 @@
they describe the same webpage.
</p>
<p>
- As another example, if a file is copied from one directory to another, we may want to say that
- (according to our model) these are both the same file, just in a different location.
- We may say that the file in the first directory, F1, is an alternate of the
- file in the second directory, F2. Note that it is
+ As another example, if a file is copied from one directory to another to create a backup,
+ we may say that the copies are alternate versions of the same, location-independent, file.
+ Specifically, we may say that the file in the first directory, entity F1, is an alternate of the
+ file in the second directory, entity F2. Note that it is
the context (location) rather than content of the file that differs between the entities
in this case.
</p>
Binary file primer/images/roles.png has changed
--- a/primer/images/roles.svg Wed Nov 21 11:46:11 2012 -0500
+++ b/primer/images/roles.svg Wed Nov 21 16:50:01 2012 +0000
@@ -17,7 +17,7 @@
height="332.392"
xml:space="preserve"
sodipodi:docname="roles.svg"
- inkscape:export-filename="C:\Mercurial\prov\primer\images\roles.png"
+ inkscape:export-filename="D:\Mercurial\prov\primer\images\roles.png"
inkscape:export-xdpi="90"
inkscape:export-ydpi="90"><metadata
id="metadata8"><rdf:RDF><cc:Work
@@ -464,7 +464,7 @@
guidetolerance="10"
inkscape:pageopacity="0"
inkscape:pageshadow="2"
- inkscape:window-width="1440"
+ inkscape:window-width="1600"
inkscape:window-height="838"
id="namedview4"
showgrid="false"
@@ -518,6 +518,7 @@
+
</g><g
inkscape:export-ydpi="79.550438"
inkscape:export-xdpi="79.550438"
@@ -549,6 +550,7 @@
+
</g><g
transform="matrix(1,0,0,-1,294.12,802.15)"
id="g334"
@@ -575,6 +577,7 @@
+
</g><g
transform="matrix(0.9368205,0,0,-1,-142.39394,1034.7)"
id="g340"
@@ -617,6 +620,7 @@
+
</g><g
transform="matrix(1,0,0,-1,-175.5,1034.7)"
id="g498"
@@ -693,6 +697,7 @@
+
</g>
@@ -721,6 +726,7 @@
+
</g><g
transform="matrix(1.5826615,0,0,-1,38.212014,965.3546)"
id="g936-0"
@@ -752,6 +758,7 @@
+
</g><g
transform="matrix(1,0,0,-1,-169.56841,991.0782)"
id="g318"
@@ -798,6 +805,7 @@
+
</g><text
style="font-size:12px"
y="-421.20554"
@@ -819,14 +827,8 @@
-<path
- id="path344-6-9-2"
- style="fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none"
- d="m 76.780911,678.50155 8.200081,-3.47522 -0.423603,7.8163 -7.776478,-4.34108 z"
- inkscape:export-filename="/home/lavm/papers/papers/prov-wg/hg/model/images/w3-publication1.png"
- inkscape:export-xdpi="79.550438"
- inkscape:export-ydpi="79.550438"
- inkscape:connector-curvature="0" />
+
+
@@ -863,6 +865,7 @@
+
</g><g
transform="matrix(0.40082252,0.4151758,2.3866708,-0.77329411,-480.79716,961.35321)"
id="g572-2"
@@ -905,6 +908,7 @@
+
</g><g
transform="matrix(-0.6837653,0.41048076,1.4796713,1.9262836,-179.39281,286.98448)"
id="g572-2-5"
@@ -947,6 +951,7 @@
+
</g><g
transform="matrix(-0.62188296,0.39975874,1.3457576,1.8759678,-168.43478,203.36898)"
id="g572-2-5-9"
@@ -989,6 +994,7 @@
+
</g><g
transform="matrix(0.00870226,0.28186705,1.6936272,-0.18063826,-164.96914,810.84161)"
id="g572-2-8"
Binary file primer/images/time.png has changed
--- a/primer/images/time.svg Wed Nov 21 11:46:11 2012 -0500
+++ b/primer/images/time.svg Wed Nov 21 16:50:01 2012 +0000
@@ -17,7 +17,7 @@
height="334.96368"
xml:space="preserve"
sodipodi:docname="time.svg"
- inkscape:export-filename="C:\Mercurial\prov\primer\images\time.png"
+ inkscape:export-filename="D:\Mercurial\prov\primer\images\time.png"
inkscape:export-xdpi="90"
inkscape:export-ydpi="90"><metadata
id="metadata8"><rdf:RDF><cc:Work
@@ -417,7 +417,7 @@
guidetolerance="10"
inkscape:pageopacity="0"
inkscape:pageshadow="2"
- inkscape:window-width="1440"
+ inkscape:window-width="1600"
inkscape:window-height="838"
id="namedview4"
showgrid="false"
@@ -480,6 +480,7 @@
+
</g>
@@ -516,6 +517,7 @@
+
<g
inkscape:export-ydpi="79.550438"
inkscape:export-xdpi="79.550438"
@@ -536,6 +538,7 @@
+
</g><path
inkscape:connector-curvature="0"
inkscape:export-ydpi="79.550438"
@@ -574,6 +577,7 @@
+
</g><g
transform="matrix(1.0394571,0,0,-1,502.75321,1070.2623)"
id="g936-0-2-1"
@@ -604,6 +608,7 @@
+
</g><g
inkscape:export-ydpi="79.550438"
inkscape:export-xdpi="79.550438"
@@ -649,6 +654,7 @@
+
</g><g
transform="matrix(0.9376888,0.34747621,0.34747621,-0.9376888,651.76262,989.27394)"
id="g334-3-1-0"
@@ -672,6 +678,7 @@
+
</g><g
inkscape:export-ydpi="79.550438"
inkscape:export-xdpi="79.550438"
@@ -711,6 +718,7 @@
+
</g><g
transform="matrix(1.0611643,0,0,-1,-123.33092,1236.364)"
id="g262-7-3"><path
@@ -735,6 +743,7 @@
+
</g><g
inkscape:export-ydpi="79.550438"
inkscape:export-xdpi="79.550438"
@@ -771,6 +780,7 @@
+
</g><g
inkscape:export-ydpi="79.550438"
inkscape:export-xdpi="79.550438"
@@ -792,6 +802,7 @@
+
</g><path
inkscape:connector-curvature="0"
inkscape:export-ydpi="79.550438"
@@ -834,6 +845,7 @@
+
</g><g
transform="matrix(1.694849,0,0,-1.5821629,158.89211,1431.5985)"
id="g558-3-4-2-1-2"
@@ -879,6 +891,7 @@
+
</g><path
style="fill:none;stroke:#000000;stroke-width:0.65616947px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
d="m 304.6916,995.61216 71.60192,-29.59491"
@@ -921,6 +934,7 @@
+
</g><g
transform="matrix(-0.79741846,0.01415798,0.60418273,1.6898123,518.66471,439.49058)"
id="g572-2-8-3"
@@ -988,6 +1002,7 @@
+
</g><g
inkscape:export-ydpi="79.550438"
inkscape:export-xdpi="79.550438"
@@ -1017,6 +1032,7 @@
+
</g><g
inkscape:export-ydpi="79.550438"
inkscape:export-xdpi="79.550438"
@@ -1034,6 +1050,7 @@
+
</g><g
inkscape:export-ydpi="79.550438"
inkscape:export-xdpi="79.550438"
@@ -1068,4 +1085,12 @@
-</g></g></svg>
\ No newline at end of file
+
+</g><path
+ id="path502-6-2-0-1"
+ style="fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none"
+ d="m 411.75957,901.94103 9.09492,-5.69468 3.10399,5.59238 -12.19891,0.1023 z"
+ inkscape:export-filename="/home/lavm/papers/papers/prov-wg/hg/model/images/w3-publication1.png"
+ inkscape:export-xdpi="79.550438"
+ inkscape:export-ydpi="79.550438"
+ inkscape:connector-curvature="0" /></g></svg>
\ No newline at end of file