tcplPlot: #—————— Generic Plotting Function for tcpl

In USEPA/CompTox-ToxCast-tcpl: ToxCast Data Analysis Pipeline

#——————————————————————————- Generic Plotting Function for tcpl

Description

tcplLoadData queries the tcpl databases and returns a plot for the given level and data type.

Usage

tcplPlot(
  type = "mc",
  fld = "m4id",
  val = NULL,
  compare.val = NULL,
  by = NULL,
  output = c("console", "pdf", "png", "jpg", "svg", "tiff"),
  fileprefix = paste0("tcplPlot_", Sys.Date()),
  multi = NULL,
  verbose = FALSE,
  nrow = NULL,
  ncol = NULL,
  dpi = 600,
  flags = FALSE,
  yuniform = FALSE,
  yrange = c(NA, NA)
)

Arguments

type	Character of length 1, the data type, "sc" or "mc".
fld	Character, the field(s) to query on.
val	List, vectors of values for each field to query on. Must be in the same order as 'fld'.
compare.val	List, vectors of values for each field to query on to compare with val. Must be in the same order as 'fld'. Must have the same length as val (1:1 comparison). Must be set to compare plots; otherwise leave NULL
by	Parameter to divide files into e.g. "aeid".
output	How should the plot be presented. To view the plot in application, use "console", or to save as a file type, use "pdf", "jpg", "png", "svg", or "tiff".
fileprefix	Prefix of file when saving.
multi	Boolean, by default TRUE for "pdf". If multi is TRUE, output by default 4 plots per page for 'verbose' = TRUE and 6 plots per page for 'verbose' = FALSE.
verbose	Boolean, by default FALSE. If TRUE, a table with fitting parameters is included with the plot.
nrow	Integer, number of rows in multiplot. By default 2.
ncol	Integer, number of columns in multiplot. By default 3, 2 if verbose.
dpi	Integer, image print resolution. By default 600.
flags	Boolean, by default FALSE. If TRUE, level 6 flags are displayed below annotations on plot
yuniform	Boolean, by default FALSE. If TRUE, all plots will have uniform y axis scaling, automatically determined.
yrange	Integer of length 2, for directly setting the y-axis range, c(<min>,<max>). By default, c(NA,NA).

Details

The data type can be either 'mc' for mutliple concentration data, or 'sc' for single concentration data. Multiple concentration data will be loaded into the 'mc' tables, whereas the single concentration will be loaded into the 'sc' tables.

Leaving fld NULL will return all data.

Examples

## Store the current config settings, so they can be reloaded at the end
## of the examples
conf_store <- tcplConfList()
tcplConfExample()

tcplPlot(fld = "m4id", val = c(18609966)) ## Create a level 4 plot

## Reset configuration
options(conf_store)

USEPA/CompTox-ToxCast-tcpl documentation built on May 2, 2024, 2:25 p.m.