From c73795e7ce30c88b68339d9d978b34bf4a0cb2bc Mon Sep 17 00:00:00 2001 From: ranke Date: Mon, 6 Mar 2006 09:59:51 +0000 Subject: Added the drfit-package help page, a new sample data file and a preliminary version of the drfit-Rnews article. R/drfit.R - the possibility to directly write pdf graphs was added - the results dataframe now has numbered lines where it didn't The checkplate and checksubstance functions are now classified internal in their help files. git-svn-id: http://kriemhild.uft.uni-bremen.de/svn/drfit@57 d1b72e20-2ee0-0310-a1c4-ad5adbbefcdc --- man/drfit.Rd | 74 +++++++++++++++++++++++++++++++----------------------------- 1 file changed, 38 insertions(+), 36 deletions(-) (limited to 'man/drfit.Rd') 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) -- cgit v1.2.1