<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><title>R: AUC as a function of time</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link rel="stylesheet" type="text/css" href="R.css" />
</head><body>

<table width="100%" summary="page for plotAUC.s"><tr><td>plotAUC.s</td><td style="text-align: right;">R Documentation</td></tr></table>

<h2>AUC as a function of time</h2>

<h3>Description</h3>

<p>Compute area under the ROC curve for several values of
the time horizon</p>


<h3>Usage</h3>

<pre>
plotAUC.s(X,etime,status,u=NULL,tt,s,vtimes,fc=NULL,plot=TRUE)
</pre>


<h3>Arguments</h3>

<table summary="R argblock">
<tr valign="top"><td><code>X</code></td>
<td>
<p>n by S matrix of longitudinal score/biomarker for i-th
subject at j-th occasion (NA if unmeasured)</p>
</td></tr>
<tr valign="top"><td><code>etime</code></td>
<td>
<p>n vector with follow-up times</p>
</td></tr>
<tr valign="top"><td><code>status</code></td>
<td>
<p>n vector with event indicators</p>
</td></tr>
<tr valign="top"><td><code>u</code></td>
<td>
<p>Lower limit for evaluation of sensitivity and
specificity. Defaults to <code>vtimes[s]</code> (see below)</p>
</td></tr>
<tr valign="top"><td><code>tt</code></td>
<td>
<p>A vector of upper limits (time-horizons) for evaluation
of sensitivity and specificity.</p>
</td></tr>
<tr valign="top"><td><code>s</code></td>
<td>
<p>n vector of measurements/visits to use for each subject. all(s&lt;=S)</p>
</td></tr>
<tr valign="top"><td><code>vtimes</code></td>
<td>
<p>S vector with visit times</p>
</td></tr>
<tr valign="top"><td><code>fc</code></td>
<td>
<p>Events are defined as fc = 1. Defaults to $I(cup X(t_j)&gt;cutoff)$</p>
</td></tr>
<tr valign="top"><td><code>plot</code></td>
<td>
<p>Do we plot the AUCs? Defaults to <code>TRUE</code></p>
</td></tr>
</table>


<h3>Details</h3>

<p>Area under the ROC curve is computed for each value of the vector
tt. The resulting vector is returned. If <code>plot=TRUE</code> (which is
the default) also a plot of tt vs AUC is displayed. 
</p>


<h3>Value</h3>

<p>A vector with AUCs 
</p>


<h3>Author(s)</h3>

<p>Alessio Farcomeni <a href="mailto:alessio.farcomeni@uniroma1.it">alessio.farcomeni@uniroma1.it</a></p>


<h3>References</h3>

<p>Barbati, G. and Farcomeni, A. (2017) Prognostic assessment of
repeatedly measured time-dependent biomarkers, with application to
dilated cardiomuopathy, <em>Statistical Methods &amp; Applications</em>, in
press 
</p>


<h3>See Also</h3>

<p><cite>roc.s</cite>, <cite>butstrap.s</cite>, <cite>auc</cite>
</p>


<h3>Examples</h3>

<pre>
# parameters
n=25
tt=3
Tmax=10
u=1.5
s=sample(3,n,replace=TRUE)
vtimes=c(0,1,2,5)

# generate data 

ngrid=1000
ts=seq(0,Tmax,length=ngrid)
X2=matrix(rnorm(n*ngrid,0,0.1),n,ngrid)
for(i in 1:n) {
sa=sample(ngrid/6,1)
vals=sample(3,1)-1
X2[i,1:sa[1]]=vals[1]+X2[i,1:sa[1]]
X2[i,(sa[1]+1):ngrid]=vals[1]+sample(c(-2,2),1)+X2[i,(sa[1]+1):ngrid]
}

S1=matrix(sample(4,n,replace=TRUE),n,length(vtimes))
S2=matrix(NA,n,length(vtimes))

S2[,1]=X2[,1]

for(j in 2:length(vtimes)) {
tm=which.min(abs(ts-vtimes[j]))
S2[,j]=X2[,tm]}

cens=runif(n)
ripart=1-exp(-0.01*apply(exp(X2),1,cumsum)*ts/1:ngrid)

Ti=rep(NA,n)
for(i in 1:n) {
Ti[i]=ts[which.min(abs(ripart[,i]-cens[i]))]
}

cens=runif(n,0,Tmax*2)
delta=ifelse(cens&gt;Ti,1,0)
Ti[cens&lt;Ti]=cens[cens&lt;Ti]

## 

## an important marker 

aucs=plotAUC.s(S2,Ti,delta,u,seq(2,5,length=5),s,vtimes) 

</pre>


</body></html>
