prov.trace {provTraceR}

File lineage functions

Description

prov.trace traces file lineage from existing provenance.

prov.trace.run runs the specified script(s), collects provenance, and uses the provenance to trace file lineage.

Usage

prov.trace(
  scripts,
  prov.dir = NULL,
  file.details = FALSE,
  console = TRUE,
  save = FALSE,
  save.dir = NULL,
  check = TRUE
)

prov.trace.run(
  scripts,
  prov.dir = NULL,
  file.details = FALSE,
  console = TRUE,
  save = FALSE,
  save.dir = NULL,
  check = TRUE,
  prov.tool = "rdtLite",
  details = FALSE,
  ...
)

Arguments

scripts

a script name, a vector of script names, or a text file of script names (file extension = .txt)

prov.dir

provenance directory

file.details

whether to display file details

console

whether to display results in the console

save

whether to save results to the file prov-trace.txt

save.dir

where to save the results file. If NULL, use the R session temporary directory. If a period (.), use the current working directory. Otherwise use save.dir.

check

whether to check against the user's file system

prov.tool

provenance collection tool (rdtLite or rdt)

details

whether to collect fine-grained provenance

...

other parameters passed to the provenance collector

Value

string containing file lineage

string containing file lineage

Examples

prov.dir <- system.file("testdata", package="provTraceR")
prov.trace(c("script-1.R", "script-2.R"), prov.dir=prov.dir)