\Header{buildChromLocation}{A function to generate an instantiation of a chromLocation class}
\keyword{utilities}{buildChromLocation}
\begin{Description}\relax
This function will take the name of a data package and build a
chromLocation object representing that data set.
\end{Description}
\begin{Usage}
\begin{verbatim}
  buildChromLocation(dataPkg)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{dataPkg}] The name of the data package to be used
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
The requested data set must be available in the user's
\code{.libPaths()}, and the function will throw an error if this is
not the case.

If the data package is present, the necessary information will be
extracted from the data package and a \code{chromLocation} object will
be created.
\end{Details}
\begin{Value}
A \code{chromLocation} object representing the specified data set.
\end{Value}
\begin{Author}\relax
Jeff Gentry
\end{Author}
\begin{Examples}
\begin{ExampleCode}
   ## A bit of a hack to not have a package dependency on hgu95av2
   ## but need to fiddle w/ the warn level to not fail the example anyways.
   curWarn <- getOption("warn")
   options(warn=0)
   on.exit(options(warn=curWarn), add=TRUE)
   if (require(hgu95av2)) {
     z <- buildChromLocation("hgu95av2")
   } else print("This example requires the hgu95av2 data package")
\end{ExampleCode}
\end{Examples}

