aboutsummaryrefslogtreecommitdiff
path: root/man/drfit.Rd
diff options
context:
space:
mode:
Diffstat (limited to 'man/drfit.Rd')
-rw-r--r--man/drfit.Rd74
1 files changed, 38 insertions, 36 deletions
diff --git a/man/drfit.Rd b/man/drfit.Rd
index bbe7496..6e9ef47 100644
--- a/man/drfit.Rd
+++ b/man/drfit.Rd
@@ -12,17 +12,17 @@
}
\arguments{
\item{data}{
- A data frame containing dose-response data. The data frame has to
- contain at least a factor called "substance", a numeric vector "dose" with
- the dose values, a vector called "unit" containing the unit used for the
- dose and a numeric vector "response" with the response values of the test system
- normalized between 0 and 1. Such a data frame can be easily obtained if a
- compliant RODBC data source is available for use in conjunction with the
- function \code{\link{drdata}}.
+ A data frame containing dose-response data. The data frame has to contain
+ at least a factor called \dQuote{substance}, a numeric vector \dQuote{dose}
+ with the dose values, a vector called \dQuote{unit} containing the unit
+ used for the dose and a numeric vector \dQuote{response} with the response
+ values of the test system normalized between 0 and 1. Such a data frame can
+ be easily obtained if a compliant RODBC data source is available for use in
+ conjunction with the function \code{\link{drdata}}.
- If there is a column called "ok" and it is set to "no fit" in a specific
- line, then the corresponding data point will be excluded from the fitting
- procedure, although it will be plotted.
+ If there is a column called \dQuote{ok} and it is set to \dQuote{no fit} in
+ a specific line, then the corresponding data point will be excluded from
+ the fitting procedure, although it will be plotted.
}
\item{startlogED50}{
Especially for the linlogit model, a suitable log10 of the ED50 has to be given
@@ -64,32 +64,34 @@
}
\value{
\item{results}{
- A data frame containing at least one line for each substance. If the data
- did not show a mean response < 0.5 at the highest dose level, the
- modeltype is set to "inactive". If the mean response at the lowest dose
- is smaller than 0.5, the modeltype is set to "active". In both cases,
- no fitting procedure is carried out.
- Every successful fit is reported in one line. Parameters of the fitted
- curves are only reported if the fitted ED50 is not higher than the
- highest dose.
- \code{ndl} is the number of dose levels in the raw data, \code{n} is the
- rounded mean of the number of replicates at each dose level in the raw
- data, \code{lld} is the decadic logarithm of the lowest dose and
- \code{lhd} is the decadic logarithm of the highest dose.
- For the "linlogit", "logit" and "probit" models, the parameter
- \code{a} that is reported coincides with the logED50, i.e the logED50 is
- one of the model parameters that is being fitted, and therefore
- a standard deviation \code{std} is reported for the logED50. In the
- case of the "weibull" model, \code{a} is a location parameter.
- Parameter \code{b} in the case of the "linlogit" fit is the variable
- b from the \code{\link{linlogitf}} function. In the case of "probit" fit
- it is the standard deviation of the fitted normal distribution, in the case
- of the "logit" fit it is the \code{scale} parameter in the \code{\link{plogis}}
- function, and in the "weibull" fit it is the \code{shape} parameter of the
- fitted \code{\link{pweibull}} function. Only the "linlogit" fit produces a
- third parameter \code{c} which is the variable f from the
- \code{\link{linlogitf}} function.}
- }
+ A data frame containing at least one line for each substance. If the data
+ did not show a mean response < 0.5 at the highest dose level, the
+ modeltype is set to \dQuote(inactive). If the mean response at the lowest
+ dose is smaller than 0.5, the modeltype is set to \dQuote(active). In
+ both cases, no fitting procedure is carried out. Every successful fit is
+ reported in one line. Parameters of the fitted curves are only reported
+ if the fitted ED50 is not higher than the highest dose.
+
+ \code{ndl} is the number of dose levels in the raw data, \code{n} is the
+ rounded mean of the number of replicates at each dose level in the raw
+ data, \code{lld} is the decadic logarithm of the lowest dose and
+ \code{lhd} is the decadic logarithm of the highest dose. For the
+ \dQuote{linlogit}, \dQuote{logit} and \dQuote{probit} models, the
+ parameter \code{a} that is reported coincides with the logED50, i.e the
+ logED50 is one of the model parameters that is being fitted, and
+ therefore a standard deviation \code{std} is reported for the logED50. In
+ the case of the \dQuote(weibull) model, \code{a} is a location parameter.
+ Parameter \code{b} in the case of the \dQuote(linlogit) fit is the
+ variable b from the \code{\link{linlogitf}} function. In the case of
+ \dQuote(probit) fit it is the standard deviation of the fitted normal
+ distribution, in the case of the \dQuote(logit) fit it is the
+ \code{scale} parameter in the \code{\link{plogis}} function, and in the
+ \dQuote(weibull) fit it is the \code{shape} parameter of the fitted
+ \code{\link{pweibull}} function. Only the \dQuote(linlogit) fit produces
+ a third parameter \code{c} which is the variable f from the
+ \code{\link{linlogitf}} function.}
+
+}
\examples{
data(antifoul)
r <- drfit(antifoul)

Contact - Imprint