res_vs_cov {Certara.Xpose.NLME} | R Documentation |
Residuals vs covariate plot
Description
Plot Residuals against a continuous or categorical covariate.
Usage
res_vs_cov(
xpdb,
mapping = NULL,
covariate,
res = "CWRES",
group = "ID",
type = "bpls",
title = "Residuals vs @x | @run",
subtitle = "Based on @nind individuals",
caption = "@dir",
tag = NULL,
log = NULL,
guide = TRUE,
facets,
.problem,
quiet,
...
)
Arguments
xpdb |
An xpose database object. |
mapping |
List of aesthetics mappings to be used for the xpose plot
(e.g. |
covariate |
Character; String of covariate name |
res |
Character; String of residual name; CWRES by default. |
group |
Grouping variable to be used for lines. |
type |
Character; String setting the type of plot to be used. Must be 'b' for categorical covariates, one or a combination of 'p','l','s' for continuous covariates. |
title |
Character; Plot title. Use |
subtitle |
Character; Plot subtitle. Use |
caption |
Character; Page caption. Use |
tag |
Character; Plot identification tag. Use |
log |
Character; String assigning logarithmic scale to axes, can be either ”, 'x', y' or 'xy'. |
guide |
Logical; Should the guide (e.g. reference distribution) be displayed. |
facets |
Either a character string to use |
.problem |
The $problem number to be used. By default returns the last estimation problem. |
quiet |
Logical, if |
... |
Any additional aesthetics to be passed on |
Value
An object of class xpose_plot
, ggplot
, and gg
. This object represents a customized plot created using ggplot2
.
The xpose_plot
class provides additional metadata and integration with xpose
workflows, allowing for advanced
customization and compatibility with other xpose
functions. Users can interact with the plot object as they
would with any ggplot2
object, including modifying aesthetics, adding layers, or saving the plot.
Layers mapping
Plots can be customized by mapping arguments to specific layers. The naming convention is
layer_option where layer is one of the names defined in the list below and option is
any option supported by this layer e.g. boxplot_fill = 'blue'
, etc.
box plot: options to
geom_boxplot
point plot: options to
geom_point
line plot: options to
geom_line
smooth plot: options to
geom_smooth
xscale: options to
scale_x_continuous
orscale_x_log10
yscale: options to
scale_y_continuous
orscale_y_log10
See Also
Examples
res_vs_cov(xpose::xpdb_ex_pk,
covariate = "SEX",
type = "b",
res = "WRES"
)
res_vs_cov(xpose::xpdb_ex_pk,
covariate = "AGE",
type = "ps",
res = c("CWRES", "WRES", "IRES", "IWRES")
)