prov.json: Provenance Access Functions

In ProvTools/RDataTracker: Provenance Collector for R

Description

prov.json returns the current provenance graph as a prov-json string.

prov.dir returns the current provenance directory.

prov.display displays the current provenance as a graph.

Usage

prov.json()

prov.dir()

prov.display()

Details

RDataTracker collects provenance as a script executes. Once collected, prov.json can be called to access the provenance as a JSON string. This is useful for applications that operate on the provenance. The JSON is consistent with the PROV-JSON standard.

One such application is a graphic visualizer built into RDataTracker. To view the provenance graphically, call prov.display. In the provenance graph, the nodes are data values and operations, with edges connecting them to show data and control flow dependencies. The visualizer also allows the user to view intermediate values of variables, and to graphically view the lineage of how a value was computed, or to look at how a value is used moving forward in the computation. The user can also search for specific data or operation nodes, files, or error messages in the provenance.

Value

prov.json returns the current provenance graph as a prov-json string

prov.dir returns the current provenance directory.

prov.display loads and displays the current provenance graph in DDG Explorer. The prov.display function does not return a value.

References

PROV-JSON standard: https://www.w3.org/Submission/2013/SUBM-prov-json-20130424/

RDataTracker PROV-JSON output: https://github.com/End-to-end-provenance/RDataTracker/blob/export/JSON-format.md

See Also

prov.init and prov.run for functions to collect provenance

Examples

prov.init()
a <- 1
b <- 2
ab <- a + b
prov.quit()
str <- prov.json()
pdir <- prov.dir()
## Not run: prov.display() 

ProvTools/RDataTracker documentation built on May 9, 2019, 3:29 a.m.