aboutsummaryrefslogtreecommitdiff
path: root/chm/drfit.html
blob: 23dd70fce47fbd6da90900cd1382d3b70f115a3a (plain) (blame)
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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
<html><head><title>Fit dose-response models</title>
<link rel="stylesheet" type="text/css" href="Rchm.css">
</head>
<body>

<table width="100%"><tr><td>drfit(drfit)</td><td align="right">R Documentation</td></tr></table><object type="application/x-oleobject" classid="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<param name="keyword" value="R:   drfit">
<param name="keyword" value=" Fit dose-response models">
</object>


<h2>Fit dose-response models</h2>


<h3>Description</h3>

<p>
Fit dose-response relationships to dose-response data and calculate
biometric results for (eco)toxicity evaluation
</p>


<h3>Usage</h3>

<pre>
  drfit(data, startlogEC50 = NA, lognorm = TRUE, logis = FALSE, 
    linearlogis = FALSE, b0 = 2, f0 = 0)
</pre>


<h3>Arguments</h3>

<table summary="R argblock">
<tr valign="top"><td><code>data</code></td>
<td>
A data frame as returned from <code><a href="drdata.html">drdata</a></code>.  The data frame has to
contain at least a factor called "substance", a vector called "unit"
containing the unit used for the dose, a column "response" with the
response values of the test system normalized between 0 and 1 and a column
"dose" with the numeric dose values. For later use of the
<code><a href="drplot.html">drplot</a></code> function, a factor called "dosefactor" also has to be
present, containing the dose as a factor.
</td></tr>
<tr valign="top"><td><code>startlogEC50</code></td>
<td>
Especially for the linearlogis model, a suitable log10 of the EC50 has to be given 
by the user, since it is not correctly estimated for data showing hormesis with
the default estimation method.</td></tr>
<tr valign="top"><td><code>lognorm</code></td>
<td>
A boolean defining if cumulative density curves of normal distributions
are fitted to the data. Default ist TRUE.</td></tr>
<tr valign="top"><td><code>logis</code></td>
<td>
A boolean defining if cumulative densitiy curves of logistic distributions
are fitted to the data. Default is FALSE.</td></tr>
<tr valign="top"><td><code>linearlogis</code></td>
<td>
A boolean defining if the linear-logistic function as defined by van Ewijk and Hoekstra
1993 is fitted to the data. Default is FALSE.</td></tr>
<tr valign="top"><td><code>b0,f0</code></td>
<td>
If the linearlogistic model is fitted, b0 and f0 give the possibility to
adapt the starting values for the parameters b and f.</td></tr>
</table>

<h3>Value</h3>

<table summary="R argblock">
<tr valign="top"><td><code>results</code></td>
<td>
A data frame containing at least one line for each substance. If the data did not
show a mean response &lt; 0.5 at the highest dose level, the modeltype is set to "none".
Every successful fit is reported in one line. Parameters of the fitted curves are only
reported if the fitted EC50 is not higher than the highest dose.</td></tr>
</table>

<h3>Author(s)</h3>

<p>
Johannes Ranke 
<a href="mailto:jranke@uni-bremen.de">jranke@uni-bremen.de</a> 
<a href="http://www.uft.uni-bremen.de/chemie/ranke">http://www.uft.uni-bremen.de/chemie/ranke</a>
</p>


<h3>Examples</h3>

<pre>
data(antifoul)
r &lt;- drfit(antifoul)
format(r,digits=2)
</pre>



<hr><div align="center"><a href="00Index.html">[Package Contents]</a></div>

</body></html>

Contact - Imprint