From af7c6de4db9981ac814362c441fbac22c8faa2d7 Mon Sep 17 00:00:00 2001 From: Johannes Ranke Date: Thu, 24 Nov 2022 09:02:26 +0100 Subject: Start online docs of the development version --- docs/dev/reference/mkinresplot.html | 324 +++++++++++++++--------------------- 1 file changed, 137 insertions(+), 187 deletions(-) (limited to 'docs/dev/reference/mkinresplot.html') diff --git a/docs/dev/reference/mkinresplot.html b/docs/dev/reference/mkinresplot.html index 30377f2c..4d99f5be 100644 --- a/docs/dev/reference/mkinresplot.html +++ b/docs/dev/reference/mkinresplot.html @@ -1,70 +1,15 @@ - - - - - - - -Function to plot residuals stored in an mkin object — mkinresplot • mkin - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Function to plot residuals stored in an mkin object — mkinresplot • mkin - - - - - - - - - + + - - - - -
-
- -
- -
+

This function plots the residuals for the specified subset of the observed variables from an mkinfit object. A combined plot of the fitted model and -the residuals can be obtained using plot.mkinfit using the +the residuals can be obtained using plot.mkinfit using the argument show_residuals = TRUE.

-
mkinresplot(
-  object,
-  obs_vars = names(object$mkinmod$map),
-  xlim = c(0, 1.1 * max(object$data$time)),
-  standardized = FALSE,
-  xlab = "Time",
-  ylab = ifelse(standardized, "Standardized residual", "Residual"),
-  maxabs = "auto",
-  legend = TRUE,
-  lpos = "topright",
-  col_obs = "auto",
-  pch_obs = "auto",
-  frame = TRUE,
-  ...
-)
- -

Arguments

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
object

A fit represented in an mkinfit object.

obs_vars

A character vector of names of the observed variables for +

+
mkinresplot(
+  object,
+  obs_vars = names(object$mkinmod$map),
+  xlim = c(0, 1.1 * max(object$data$time)),
+  standardized = FALSE,
+  xlab = "Time",
+  ylab = ifelse(standardized, "Standardized residual", "Residual"),
+  maxabs = "auto",
+  legend = TRUE,
+  lpos = "topright",
+  col_obs = "auto",
+  pch_obs = "auto",
+  frame = TRUE,
+  ...
+)
+
+ +
+

Arguments

+
object
+

A fit represented in an mkinfit object.

+ + +
obs_vars
+

A character vector of names of the observed variables for which residuals should be plotted. Defaults to all observed variables in -the model

xlim

plot range in x direction.

standardized

Should the residuals be standardized by dividing by the -standard deviation given by the error model of the fit?

xlab

Label for the x axis.

ylab

Label for the y axis.

maxabs

Maximum absolute value of the residuals. This is used for the -scaling of the y axis and defaults to "auto".

legend

Should a legend be plotted?

lpos

Where should the legend be placed? Default is "topright". Will -be passed on to legend.

col_obs

Colors for the observed variables.

pch_obs

Symbols to be used for the observed variables.

frame

Should a frame be drawn around the plots?

...

further arguments passed to plot.

- -

Value

- -

Nothing is returned by this function, as it is called for its side -effect, namely to produce a plot.

-

See also

+the model

-

mkinplot, for a way to plot the data and the fitted -lines of the mkinfit object, and plot_res for a function -combining the plot of the fit and the residual plot.

-

Author

+
xlim
+

plot range in x direction.

+ + +
standardized
+

Should the residuals be standardized by dividing by the +standard deviation given by the error model of the fit?

+ + +
xlab
+

Label for the x axis.

+ + +
ylab
+

Label for the y axis.

+ + +
maxabs
+

Maximum absolute value of the residuals. This is used for the +scaling of the y axis and defaults to "auto".

+ + +
legend
+

Should a legend be plotted?

+ + +
lpos
+

Where should the legend be placed? Default is "topright". Will +be passed on to legend.

+ + +
col_obs
+

Colors for the observed variables.

+ + +
pch_obs
+

Symbols to be used for the observed variables.

+ + +
frame
+

Should a frame be drawn around the plots?

+ + +
...
+

further arguments passed to plot.

+ +
+
+

Value

+ + +

Nothing is returned by this function, as it is called for its side +effect, namely to produce a plot.

+
+
+

See also

+

mkinplot, for a way to plot the data and the fitted +lines of the mkinfit object, and plot_res for a function +combining the plot of the fit and the residual plot.

+
+
+

Author

Johannes Ranke and Katrin Lindenberger

+
-

Examples

-
-model <- mkinmod(parent = mkinsub("SFO", "m1"), m1 = mkinsub("SFO")) -
#> Temporary DLL for differentials generated and loaded
fit <- mkinfit(model, FOCUS_2006_D, quiet = TRUE) -
#> Warning: Observations with value of zero were removed from the data
mkinresplot(fit, "m1") -
-
+
+

Examples

+

+model <- mkinmod(parent = mkinsub("SFO", "m1"), m1 = mkinsub("SFO"))
+#> Temporary DLL for differentials generated and loaded
+fit <- mkinfit(model, FOCUS_2006_D, quiet = TRUE)
+#> Warning: Observations with value of zero were removed from the data
+mkinresplot(fit, "m1")
+
+
+
+
+
- - - + + -- cgit v1.2.1