
plotExpr
,
plotFile
, or plotFunction
.
For the text-based formats (i.e. pdf or ps), a .diff file is created.
If ImageMagick is installed, plots of the differences will also be
produced.
compare(test, control, path = test$info$directory, erase = c("none", "identical", "files", "all"))
qcPlotExpression
,
qcPlotFile
, or qcPlotFunction
.
The specification for test
and control
can be mixed and
matched, as long as the resulting objects are of the same class.
"none"
,
"identical"
, "files"
, or "all"
.
Currently only "none"
is fully supported.
qcCompareExprResult
, qcCompareFileResult
or
qcCompareFunResult
containing the results of the comparisons.qcCompareExprResult
files contain a list of info about the Operating
System, R version, date, call, the info from the test, info from the
control, and then information about the results of the comparisons
(results by filetype giving the result, names of diff files and plots of
differences if produced), including any unpaired plots or filetypes
(with corresponding warnings/errors).For qcCompareFile
or qcCompareFun
an initial info
section is included, followed by a list containing each individual
qcCompareExprResult
.
It is possible for some plots to appear say, in the test group, but
not in the control group (i.e. the function plot
has an extra
example plot in a new version of R). These such plots are classified
as ‘unpaired’. Unpaired files do not have a corresponding plot
to compare with so are separated into an unpaired section. It is also
possible for entire filetypes to be unpaired. Currently if there is a
completely unpaired function or file when trying to compare, recycling
will be used. This is intended to change in the future.
In many instances, it is also useful to know whether there is any change in warnings or errors. If any difference is detected in the warnings/errors for a filetype, all of the warnings or errors (whichever had the difference detected) for that filetype are given. It is then up to the user to decide what the difference is (i.e. whether the ordering has changed or if one group has an extra warning etc.).
For each set of plot-logs being compared, a comparison log will be
produced. So for each pair of qcPlotExprResult logs being compared, a
comparison log will be produced with a name of the form
‘testPrefix+controlPrefix-compareExprLog.xml’. When comparing
qcPlotFileResults or qcPlotFunctionResults there will also be a
compareFileLog or compareFunLog produced which will take a name of the
form ‘testPrefix+controlPrefix-compareFunLog.xml’, where the
testPrefix and controlPrefix are chosen from the first prefixes in the
set of compareExprLogs being compared (which in turn come from the first
plotExpr logs). These logs are placed in path
.
plotExpr
, plotFile
,
plotFunction
, writeReport
## Not run:
# # Create sets to compare (1st and 3rd are different)
# comp1 <- plotExpr(c("plot(1:10)", "plot(4:40)", "x<-3", "plot(2:23)"),
# c("pdf", "ps"), "myPrefix", "comp1")
# comp2 <- plotExpr(c("plot(1:11)", "plot(4:40)", "x<-3", "plot(5:15)"),
# c("pdf", "ps"), "myPrefix", "comp2")
# compExpr <- compare(comp1, comp2)
# # All the diff output has been placed in "comp1" (the test directory)
# compExpr
# # For a better way of viewing this, see ?writeReport
# ## End(Not run)
Run the code above in your browser using DataLab