Description Usage Arguments Details Value Note Author(s) References See Also Examples
Relative potencies (also called selectivity indices) for arbitrary doses are compared between fitted dose-response curves.
1 2 3 4 5 6 7 8 9 10 11 12 | EDcomp(object, percVec, percMat = NULL, compMatch = NULL, od = FALSE, vcov. = vcov,
reverse = FALSE,
interval = c("none", "delta", "fieller", "fls"),
level = ifelse(!(interval == "none"), 0.95, NULL),
reference = c("control", "upper"),
type = c("relative", "absolute"),
display = TRUE, pool = TRUE, logBase = NULL,
multcomp = FALSE, ...)
relpot(object, plotit = TRUE, compMatch = NULL, percVec = NULL, interval = "none",
type = c("relative", "absolute"),
scale = c("original", "percent", "unconstrained"), ...)
|
object |
an object of class 'drc'. |
percVec |
a numeric vector of dosage values. |
percMat |
a matrix with 2 columns providing the pairs of indices |
compMatch |
an optional character vector of names of assays to be compared. If not specified all comparisons are supplied. |
od |
logical. If TRUE adjustment for over-dispersion is used. This argument only makes a difference for binomial data. |
vcov. |
function providing the variance-covariance matrix. |
reverse |
logical. If TRUE the order of comparison of two curves is reversed. |
interval |
character string specifying the type of confidence intervals to be supplied. The default is "none".
Use "delta" for asymptotics-based confidence intervals (using the delta method and the t-distribution).
Use "fieller" for confidence intervals based on Fieller's theorem (with help from the delta method).
Use "fls" for confidence interval back-transformed from logarithm scale (in case the parameter in the model fit is
log(ED50) as is the case for the |
level |
numeric. The level for the confidence intervals. Default is 0.95. |
reference |
character string. Is the upper limit or the control level the reference? |
type |
character string specifying whether absolute or relative response levels are supplied. |
logBase |
numeric. The base of the logarithm in case logarithm transformed dose values are used. |
display |
logical. If TRUE results are displayed. Otherwise they are not (useful in simulations). |
pool |
logical. If TRUE curves are pooled. Otherwise they are not. This argument only works for models with
independently fitted curves as specified in |
multcomp |
logical to switch on output for use with the package multcomp (which needs to be activated first). Default is FALSE (corresponding to the original output). |
... |
In |
plotit |
logical. If TRUE the relative potencies are plotted as a function of the response level. |
scale |
character string indicating the scale to be used on the x axis: original or percent response level (only having an effect for type="relative"). |
The function relpot
is a convenience function, which is useful for assessing how the relative potency
changes as a function of the response level (e.g., for plotting as outlined by Ritz et al (2006)).
Fieller's theorem is incorporated using the formulas provided by Kotz and Johnson (1983) and Finney (1978).
For objects of class 'braincousens' or 'mlogistic' the additional argument may be the 'upper' argument or the 'interval' argument. The 'upper' argument specifies the upper limit of the bisection method. The upper limits needs to be larger than the EDx level to be calculated. The default limit is 1000. The 'interval' argument should specify a rough interval in which the dose yielding the maximum hormetical response lies. The default interval is 'c(0.001, 1000)'. Notice that the lower limit should not be set to 0 (use something like 1e-3, 1e-6, ...).
An invisible matrix containing the shown matrix with two or more columns, containing the estimates
and the corresponding estimated standard errors and possibly lower and upper confidence limits.
Or, alternatively, a list with elements that may be plugged directly into parm
in the package multcomp (in case the argument multcomp
is TRUE).
This function only works for the following built-in functions available in the package drc:
braincousens
, cedergreen
, ucedergreen
, llogistic
,
and weibull1
.
Christian Ritz
Finney, D. J. (1978) Statistical method in Biological Assay, London: Charles Griffin House, 3rd edition (pp. 80–82).
Kotz, S. and Johnson, N. L. (1983) Encyclopedia of Statistical Sciences Volume 3, New York: Wiley \& Sons (pp. 86–87).
Ritz, C. and Cedergreen, N. and Jensen, J. E. and Streibig, J. C. (2006) Relative potency in nonsimilar dose-response curves, Weed Science, 54, 407–412.
A related function is ED.drc
(used for calculating effective doses).
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 | spinach.LL.4 <- drm(SLOPE~DOSE, CURVE, data = spinach, fct = LL.4())
EDcomp(spinach.LL.4, c(50,50))
EDcomp(spinach.LL.4, c(10,50))
EDcomp(spinach.LL.4, c(10,50), reverse = TRUE)
## Using the package multcomp
#sires <- SI(spinach.LL.4, c(25, 50, 75))
#library(multcomp)
#summary(glht(parm(sires[[2]][[1]], sires[[2]][[2]]), rhs = 1))
## Comparing specific ratios: 25/25, 50/50, 75/75
#sires2 <- SI(spinach.LL.4, c(25, 50, 75), matrix(c(1, 1, 2, 2, 3, 3), 3, 2, byrow = TRUE))
#library(multcomp)
#summary(glht(parm(sires2[[2]][[1]], sires2[[2]][[2]]), rhs = 1))
## Relative potency of two herbicides
m2 <- drm(DryMatter~Dose, Herbicide,
data = S.alba, fct = LL.3())
EDcomp(m2, c(50, 50))
EDcomp(m2, c(50, 50), interval = "delta")
EDcomp(m2, c(50, 50), interval = "fieller")
## Comparison based on an absolute
## response level
m3 <- drm(SLOPE~DOSE, CURVE,
data = spinach, fct = LL.4())
EDcomp(m3, c(0.5,0.5), compMatch = c(2,4), type = "absolute", interval = "fieller")
EDcomp(m3, c(55,80), compMatch = c(2,4))
# same comparison using a relative response level
## Relative potency transformed from log scale
m4 <- drm(drymatter~log(dose), treatment, data=G.aparine[-c(1:40), ],
pmodels = data.frame(treatment,treatment,1,treatment), fct = LL2.4())
EDcomp(m4, c(50,50), interval = "fls", logBase = exp(1))
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.