\HeaderA{root.profile}{ROOT Profile Plot}{root.profile}
\keyword{device}{root.profile}
\begin{Description}\relax
Creates a ROOT profile plot, i.e. a plot of parallel coordinates
\end{Description}
\begin{Usage}
\begin{verbatim}
root.profile(x, treename = "*", varlist = NULL, as.log = TRUE, globalscale = TRUE, boxes = TRUE, ylim = NULL, canvasname = "ProfilePlot", save.as = "", w = 800, h = 600)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] S4 object, usually of class \code{\LinkA{DataTreeSet}{DataTreeSet}} or \code{\LinkA{ExprTreeSet}{ExprTreeSet}}.
\item[\code{treename}] name of tree, usually all trees present in \code{rootfile} of object \code{x}.
\item[\code{varlist}] leaf name of tree, usual \dQuote{fInten} or \dQuote{fLevel}.
\item[\code{as.log}] logical indicating if \code{varlist} should be drawn as logarithmic data.
\item[\code{globalscale}] logical indicating if all axes should be drawn at the same scale.
\item[\code{boxes}] logical indicating if box-and-whisker plots should be drawn.
\item[\code{ylim}] size limits c(min,max) of \code{varlist}.
\item[\code{canvasname}] name of ROOT canvas
\item[\code{save.as}] gaphics tye for saving canvas, one of \dQuote{ps}, \dQuote{eps}, \dQuote{pdf},
\dQuote{jpg}, \dQuote{gif}, \dQuote{png}, \dQuote{tiff}
\item[\code{w}] the width of the device in pixels.
\item[\code{h}] the height of the device in pixels.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Creates a ROOT profile plot for all trees \code{treename="*"} present in \code{rootfile}. In this 
case \code{varlist} must be the name of one tree leaf only; for \code{varlist=NULL} leaf "fInten"
will be used for class \code{\LinkA{DataTreeSet}{DataTreeSet}} and leaf "fLevel" will be used for class
\code{\LinkA{ExprTreeSet}{ExprTreeSet}}. If \code{treename} is the name of one tree only then \code{varlist}
can contain up to all leaves of the tree, separated by colons, e.g. \code{varlist="fLevel:fStdev"}.

For \code{boxes=TRUE} the profile plot draws box-and-whisker plots and can thus be considered the
equivalent of the  usual \code{boxplot}.

A ROOT profile plot, i.e. a plot of parallel coordinates, is drawn in a \dQuote{TreeViewer}, a
graphic user interface designed to handle \code{\LinkA{ROOT}{ROOT}} trees. You can activate context menus
by right-clicking on items or inside the right panel.

The \dQuote{TreeViewer} is explained in \url{http://root.cern.ch/root/html/TTreeViewer.html}.

By selecting menu \dQuote{File->Save->canvasname.xxx} you can save the figure as e.g. *gif, *.jpg,
*.pdf, *.ps or even as C++ macro.

Alternatively, you can save the plot by setting \code{save.as}. However, this will close the
canvas immediately after opening it.
\end{Details}
\begin{Note}\relax
Always select menu item \dQuote{Quit ROOT} from menu \dQuote{File} to close the ROOT tree viewer,
otherwise you are in the CINT C/C++ interpreter from \code{\LinkA{ROOT}{ROOT}}. To exit CINT,
you need to type \dQuote{.q}.
\end{Note}
\begin{Author}\relax
Christian Stratowa
\end{Author}
\begin{Examples}
\begin{ExampleCode}
## Not run: 
## first, load ROOT scheme file and ROOT data file
scheme.test3 <- root.scheme(paste(.path.package("xps"),"schemes/SchemeTest3.root",sep="/"))
data.test3 <- root.data(scheme.test3, paste(.path.package("xps"),"rootdata/DataTest3_cel.root",sep="/"))

root.profile(data.test3)
## End(Not run)
\end{ExampleCode}
\end{Examples}

