RDataTracker (version 2.25.0)

Debugging: RDataTracker Debugging

Description

These functions turn debugging output on or off during the collection of data provenance by RDataTracker.

Usage

ddg.debug.lib.on()
ddg.debug.lib.off()
ddg.breakpoint()
ddg.set.breakpoint(script.name, line.num)
ddg.list.breakpoints()
ddg.clear.breakpoints()

Arguments

script.name

the name of the script for the new breakpoint.

line.num

the line number for the new breakpoint.

Details

With debugging on, RDataTracker displays output in the console as the provenance graph is created, showing each node and edge that is created. Debugging is off by default. Script debugging is enabled by (1) setting debug to TRUE in ddg.run, (2) inserting one or more breakpoints in the script with ddg.breakpoint, and/or (3) inserting breakpoints at the command line using ddg.set.breakpoint with the script name and line number. Breakpoints inserted at the command line can be displayed with ddg.list.breakpoints and cleared with ddg.clear.breakpoints. Once in debugging mode, the user can execute the next command by pressing Enter, continue execution until the next breakpoint by entering "C", view the ddg text created for the last command by entering "D", or quit debugging and complete execution by entering "Q".

Examples

dir.create("ddg", showWarnings=FALSE)
ddg.init()
ddg.debug.lib.on()
ddg.debug.lib.off()
ddg.save()