\HeaderA{plotSpikeHI}{plot hybridized target vs intensity}{plotSpikeHI}
\keyword{hplot}{plotSpikeHI}
\begin{Description}\relax
With final parameter setting, plot the amount of hybridized targets and intensities of
calibration controls.
\end{Description}
\begin{Usage}
\begin{verbatim}
plotSpikeHI(spike, parameter, array = 1, xlab = "log(Hybridized)",
            ylab = "log(Intensity)", main = colnames(spike$R)[array],
            xlim = NULL, ylim = NULL, pch = 19, cex = 0.2, 
            cy5col = "black", cy3col = "black", noerror = TRUE,
            noepch = 19, noecex = 0.1, noecy5col = "lightpink",
            noecy3col = "lightblue", curve = TRUE, lwd = 1.5, 
            curvecy5col = "red", curvecy3col = "green", ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{spike}] a \code{\LinkA{SpikeList}{SpikeList}} object.
\item[\code{parameter}] a \code{\LinkA{ParameterList}{ParameterList}} object.
\item[\code{array}] integer giving the array to be plotted. 
\item[\code{xlab}] a title for the x axis.
\item[\code{ylab}] a title for the y axis.
\item[\code{main}] an overall title for the plot.
\item[\code{xlim}] the x limits (min,max) of the plot.
\item[\code{ylim}] the y limits of the plot.
\item[\code{pch}] an integer code for one of plotting characters or symbols
for the spike data set. Default is 19.
\item[\code{cex}] a numerical value giving the amount by which the points which
indicate spike data set should be scaled relative to the default. 
Default is 0.2.
\item[\code{cy5col}] color of points for cy5. Default is black. 
\item[\code{cy3col}] color of points for cy3. Default is black. 
\item[\code{noerror}] a logical value. If it is \code{TRUE}, plot the amount of hybridized targets
assuming equal spot capacities. Default is \code{TRUE}. 
\item[\code{noepch}] pch for the points with equal spot capacities. Default is 19. 
\item[\code{noecex}] cex for the points with equal spot capacities. Default is 0.1.
\item[\code{noecy5col}] color for the points with equal spot capacities of cy5. 
Default is lightpink.
\item[\code{noecy3col}] color for the points with equal spot capacities of cy3.
Default is lightblue.
\item[\code{curve}] a logical value. If it is \code{TRUE}, plot final parameter setting.
Default is \code{TRUE}.
\item[\code{lwd}] width of the parameter curves. Default is 1.5.
\item[\code{curvecy5col}] color of the parameter curves for cy5. Default is red. 
\item[\code{curvecy3col}] color of the parameter curves for cy3. Default is green. 
\item[\code{...}] other graphical parameters can be used in function '\code{\LinkA{plot}{plot}}'. 
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
The function plots hybridized targets vs measured intensities of one array. The argument 
\code{array} gives the array index to be plotted. The function accepts the spike concentrations 
from the argument \code{spike} and the estimated spot error for each spot from the argument 
\code{parameter}. The hyrbidized targets for each spot can be calculated by the following 
formula:
formula.

The argument \code{noerror} says whether or not the hybridized targets, which are calculated
by the above mentioned formula assuming equal spot capacities, are plotted. If they are
plotted, other arguments like \code{noepch},\code{noecex},\code{noecy5col} and \code{noecy3col} are used to 
specify the type, the size and the color of the points.

Estimated parameter curves can be shown on the plot. Since model parameters are different
for two colors, two parameter curves are expected for one array. The funciton accepts 
parameters of both colors from the argument \code{parameter}. If the curves are plotted, the 
arguments \code{lwd}, \code{curvecy3col} and \code{curvecy5col} are used to specify the width and color
of the curves.

Details for the graphical parameters can be seen in function \code{\LinkA{plot}{plot}},
\code{\LinkA{points}{points}} and \code{\LinkA{curve}{curve}}.
\end{Details}
\begin{Value}
A plot is created on the current graphics device.
\end{Value}
\begin{Author}\relax
Hui Zhao
\end{Author}
\begin{References}\relax
Engelen, K., Naudts, B., DeMoor, B., Marchal, K. (2006) 
A calibration method for estimating absolute expression levels from 
microarray data. Bioinformatics  22: 1251-1258.
\end{References}
\begin{Examples}
\begin{ExampleCode}
# load data: spike and parameter
data(spike)
data(parameter)

# specify the array to be plotted.
array <- 1

# use the default values for other parameters
plotSpikeHI(spike,parameter,array=array)

\end{ExampleCode}
\end{Examples}

