Model residuals plotted against population predictions (PRED).
The residuals can be one of:
RES: model residuals
WRES: weighted model residuals
CWRES: conditional weighted model residuals
EWRES/ECWRES: Monte Carlo based model residuals
NPDE: Normalized prediction distribution error
res_vs_pred(xpdb, mapping = NULL, res = "CWRES", group = "ID", type = "pls", title = "@y vs. @x | @run", subtitle = "Ofv: @ofv", caption = "@dir", tag = NULL, log = NULL, guide = TRUE, facets, .problem, quiet, ...) absval_res_vs_pred(xpdb, mapping = NULL, res = "CWRES", group = "ID", type = "pls", title = "@y vs. @x | @run", subtitle = "Ofv: @ofv", caption = "@dir", tag = NULL, log = NULL, guide = FALSE, facets, .problem, quiet, ...)
An xpose database object.
List of aesthetics mappings to be used for the xpose plot
Type of residual to be used. Default is "CWRES".
Grouping variable to be used for lines.
String setting the type of plot to be used. Can be points 'p', line 'l', smooth 's' and text 't' or any combination of the four.
Plot title. Use
Plot subtitle. Use
Page caption. Use
Plot identification tag. Use
String assigning logarithmic scale to axes, can be either '', 'x', y' or 'xy'.
Enable guide display (e.g. unity line).
The $problem number to be used. By default returns the last estimation problem.
Any additional aesthetics to be passed on
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. point_color = 'blue', smooth_method = 'lm', etc.
point: options to
line: options to
guide: options to
smooth: options to
text: options to
xscale: options to
yscale: options to
Every xpose plot function has built-in faceting functionalities. Faceting arguments
are passed to the functions
facet_wrap_paginate when the
argument is a character string (e.g.
facets = c('SEX', 'MED1')) or
facet_grid_paginate when facets is a formula (e.g.
facets = SEX~MED1).
All xpose plot functions accept all the arguments for the
facet_grid_paginate functions e.g.
facets = SEX~MED1, ncol = 3, nrow = 3, page = 1, margins = TRUE, labeller = 'label_both').
Faceting options can either be defined in plot functions (e.g.
facets = 'SEX')) or assigned globally to an xpdb object via the
<- update_themes(xpdb_ex_pk, xp_theme = list(facets = 'SEX'))). In the latter example all plots
generate from this xpdb will automatically be stratified by `SEX`.
By default, some plot functions use a custom stratifying variable named `variable`, e.g.
eta_distrib(). When using the
facets argument, `variable` needs to be added manually
facets = c('SEX', 'variable') or
facets = c('SEX', 'variable'), but is optional,
when using the
facets argument in
xp_theme variable is automatically added whenever needed.
Template titles can be used to create highly informative diagnostics plots.
They can be applied to any plot title, subtitle, caption and tag. Template titles
are defined via a single string containing key variables staring with a `@` (e.g. `@ofv`)
which will be replaced by their actual value when rendering the plot.
For example `'@run, @nobs observations in @nind subjects'` would become
`'run001, 1022 observations in 74 subjects'`. The available key variables
are listed under
# Standard residual res_vs_pred(xpdb_ex_pk, res = c('IWRES', 'CWRES'))#>#>#># Absolute value of the residuals absval_res_vs_pred(xpdb_ex_pk, res = 'CWRES')#>#>