create.graph {provGraphR}

Create provenance graph

Description

create.graph uses saved provenance to create an adjacency graph that captures the dependencies between data and the R statements that use or modify the data.

get.prov returns the provenance that corresponds with the given adjacency graph

Usage

create.graph(prov.input = NULL, isFile = TRUE)

get.prov(adj.graph)

Arguments

prov.input

This is either a file name, a string containing provenance collected by rdt or rdtLite, or parsed provenance. The exact format of the JSON files is described in ExtendedProvJson.md.

isFile

A logical value indicating whether prov.input should be treated as a file name (isFile=TRUE) or a string containing provenance (isFile=False). If prov.input is not a string, this parameter is ignored.

adj.graph

the adjacency graph

Details

The graph contains a node for each R statement that is executed, for each variable set, and for each file read or written, and for each URL read. There is an edge from each R statement node to the nodes representing variables set in that statement, or files written by the statement. There is an edge from each variable node to the statement nodes that use the variable with that value. There is also an edge from each input file or URL to the statement node that performs the input operation.

The lineage of any data value can be traced through this graph by calling get.lineage.

Value

create.graph returns an object that contains the parsed provenance and a matrix representation of the graph. In the matrix, there is a row and a column for each data and procedure node in the graph. The values in the matrix are either 1 or 0. A 1 indicates that there is an edge for the column node to the row node. create.graph returns NULL if there is no provenance available.

Examples

adj.graph <- create.graph(system.file("testdata", "basic.json", package = "provGraphR"))