\HeaderA{cv}{A filter function for the coefficient of variation.}{cv}
\keyword{manip}{cv}
\begin{Description}\relax
\code{cv} returns a function with values for \code{a} and \code{b}
bound. This function takes a single argument. It computes the
coefficient of variation for the input vector and returns \code{TRUE} if
the coefficient of variation is between \code{a} and
\code{b}. Otherwise it returns \code{FALSE}
\end{Description}
\begin{Usage}
\begin{verbatim}
cv(a=1, b=Inf, na.rm=TRUE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{a}] The lower bound for the cv. 
\item[\code{b}] The upper bound for the cv. 
\item[\code{na.rm}] If set to \code{TRUE} any \code{NA}'s will be removed. 
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
The coefficient of variation is the standard deviation divided by the 
absolute value of the mean.
\end{Details}
\begin{Value}
It returns a function of one argument. The function has an environment
with bindings for \code{a} and \code{b}.
\end{Value}
\begin{Author}\relax
R. Gentleman
\end{Author}
\begin{SeeAlso}\relax
\code{\LinkA{pOverA}{pOverA}}, \code{\LinkA{kOverA}{kOverA}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
  set.seed(-3)
  cvfun <- cv(1,10)
  cvfun(rnorm(10,10))
  cvfun(rnorm(10))
\end{ExampleCode}
\end{Examples}