plot.calibnls2 - Plot Results of Calibration Analysis from a calibnls2 Object
On to:
DESCRIPTION
USAGE
REQUIRED-ARGUMENTS
OPTIONAL-ARGUMENTS
CONSTRAINTS
DETAILS
SEE-ALSO
EXAMPLE
DESCRIPTION:
Plot:
- 1) the values of the function R against the abscissa, if these values
have been stored in the calibration object.
The points of the R confidence interval are identified by letter "R".
- 2) a graph with the standard fitted curve, the ordinates
to study,
the S confidence interval and, if any, the R confidence interval.
USAGE:
plot.calibnls2(calibnls2.object,
xlab=c("R.x", "independent variable"),
ylab=c("R.values", "fitted standard curve"),
smooth=F, n.fitted=0,
title="", ask.pause=T, ask.modify=F, ...)
REQUIRED ARGUMENTS:
- calibnls2.object
-
an object of class "calibnls2", i.e a structure
returned by function `calib.nls2'.
OPTIONAL ARGUMENTS:
- xlab
-
labels for the x axes.
Character string or vector of two character strings.
If a single string, it applies
to the second graph and the x-axis label for the first graph, if it exists,
is the default value.
- ylab
-
labels for the y axes: same as "xlab".
- smooth
-
TRUE if the standard fitted curve should be smoothed.
- n.fitted
-
the number of regularly spaced points on the x-axis
where the regression function is calculated
for improving the smoothing of the fitted curve.
if equal to 0 and "smooth" is TRUE, only the values
of the standard fitted curve are taken into account.
- title
-
the title of the plots.
- ask.pause
-
a logic that should be TRUE if a pause is requested between each plot;
the execution is stopped until the user types a carriage return character (interactive mode).
- ask.modify
-
a logic that should be TRUE if the user intends to
modify the plots:
the user is then asked to type any S commands of his choice before each plot disappears.
He can therefore interactively add texts or legends, for example,
activate another device or save the plot into a file.
Each S-command must be typed on a single line.
- ...
-
any other arguments accepted by function "plot"
except from: main, xlab, ylab, type.
CONSTRAINTS:
- A graphical device should have been previously activated.
- The nls2.object used to create
the argument `calibnls2.object' must be available.
- The data frame containing the observations must be available,
(its name is nls2.object$call$data).
It is then assumed that this data frame has been neither deleted nor
modified since the nls2.object was created.
- If the argument `n.fitted' is positive,
the function `loadnls2', argument `model' set to a non-null value,
should have been previously called.
DETAILS:
This function is a method for the generic function `plot'
for class `calibnls2'.
It can be invoked by calling `plot' for an object of the appropriate
class, or directly by calling `plot.calibnls2' regardless of the
class of the object.
SEE ALSO:
`calib.nls2'
EXAMPLE:
X11()
plot(calib.out, title="CORTISOL")
- Mon Sep 30 1996 -