This example takes a PROV-O activity graph and uses the PROV Python library, which is an implementation of the Provenance Data Model by the World Wide Web Consortium, to create a graphical representations like PNG, SVG, PDF.
In [4]:
#if you need to install dependencies, do so in this cell
!pip install pydot prov
In [2]:
!conda install -y python-graphviz
We will use the Example 1 available on https://www.w3.org/TR/prov-o/ e.g. https://www.w3.org/TR/prov-o/#narrative-example-simple-1
To create a provenance document (a package of provenance statements or assertions), import ProvDocument class from prov.model:
In [5]:
from prov.model import ProvDocument
import prov.model as pm
Create some setup variables filename and basename which will be used for the encoding of the outputs
In [6]:
filename = "https://raw.githubusercontent.com/oznome/jupyter-examples/master/prov/rdf/prov-ex1.ttl"
basename = "prov-ex1"
In [7]:
import urllib.request
url = filename
data = urllib.request.urlopen(url).read()
Use the prov library to deserialize the example document
In [8]:
# Create a new provenance document
d1 = pm.ProvDocument.deserialize(content=data, format="rdf")
In addition to the PROV-N output (as above), the document can be exported into a graphical representation with the help of the GraphViz. It is provided as a software package in popular Linux distributions, or can be downloaded for Windows and Mac.
Once you have GraphViz installed and the dot command available in your operating system's paths, you can save the document we have so far into a PNG file as follows.
In [9]:
basename
Out[9]:
In [10]:
from prov.dot import prov_to_dot
d = prov_to_dot(d1)
In [11]:
d.write_png(basename+'.png')
The above saves the PNG file as article-prov.png in your current folder. If you're runing this tutorial in Jupyter Notebook, you can see it here as well.
In [12]:
from IPython.display import Image
Image(filename=basename+'.png')
Out[12]:
In [13]:
# Or save to a PDF
d.write_pdf(basename + '.pdf')
Similarly, the above saves the document into a PDF file in your current working folder. Graphviz supports a wide ranges of raster and vector outputs, to which you can export your provenance documents created by the library. To find out what formats are available from your version, run dot -T? at the command line.
PROV-JSON is a JSON representation for PROV that was designed for the ease of accessing various PROV elements in a PROV document and to work well with web applications. The format is natively supported by the library and is its default serialisation format.
In [14]:
print(d1.serialize(indent=2))
You can also serialize the document directly to a file by providing a filename (below) or a Python File object.
In [15]:
d1.serialize(basename + '.json')
In [ ]: