ddg.source(file, ddgdir = NULL, local = FALSE, echo = verbose, print.eval = echo, verbose = getOption("verbose"), max.deparse.length = 150, chdir = FALSE, encoding = getOption("encoding"), ignore.ddg.calls = TRUE, ignore.init = ignore.ddg.calls, force.console=ignore.init)sourcesourcesourcesourcesourcesourcesourcesourcesource function to support provenance
collection for sourced files. For more information on the relevant
parameters and functions, see the source help page.Data Provenance is collected from the sourced file and a DDG is created.
If ignore.ddg.calls is set to TRUE, then all code statement beginning with "ddg." are ignored, i.e. they are not executed and are not incorporated into the DDG. Note that this only holds true for "ddg." calls at the top level, as nested calls within functions are executed with a call to the relevant function.This parameter may be used if an existing RScript is partly annotated and automatic console annotation is desired.
It may also be used if automatic annotations of a sourced script should be included in the DDG of the script sourcing the file. Ignoring "ddg." statements causes the automatically created DDG to be incorporated into the current DDG (if one is already initialized).
Note that if ignore.ddg.calls is set to TRUE, then ignore.init must also be TRUE. If this is not the case, then ignore.init will be coerced to TRUE.
The parameter ignore.init is used when a sourced script is already annotated and (rather than create a new DDG), the annotated DDG of the source script should be incorporated into the current DDG. When ignore.ddg.calls is set to FALSE and ignore.init is set to TRUE, all calls beginning with "ddg.init" or "ddg.run" will be ignored but others will be executed. This prevents the initialization of a new DDG and the provenance will be stored in the currently initialized DDG (if one exists).
Note that all calls to "library(RDataTracker)" are ignored in the sourced file.
The parameter of force.console turns on automatic node creation for the sourced
R Script. More precisely, a call to ddg.console.on is made before
any processing of the script. However, note that changes executed within the sourced
script to the console mode will make changes to the environment.
For example, if init.ignore is FALSE but force.console is set to TRUE, then
the ddg.init call in the source script will overwrite the console mode. In a sense,
script changes prevail, but under ambiguous situations, force.console will determine
the state of command capturing. In any case, the console is returned to the mode set
before the call to ddg.source.
Note that a call to ddg.save is always made once the script has been sourced.
source.