\Header{oneway.test}{Test for Equal Means in a One-Way Layout}
\keyword{htest}{oneway.test}
\begin{Description}\relax
Test whether two or more samples from normal distributions have the
same means.  The variances are not necessarily assumed to be equal.
\end{Description}
\begin{Usage}
\begin{verbatim}
oneway.test(formula, data, subset, na.action, var.equal = FALSE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{formula}] a formula of the form \code{lhs \textasciitilde{} rhs} where \code{lhs}
gives the sample values and \code{rhs} the corresponding groups.
\item[\code{data}] an optional data frame containing the variables in the
model formula.
\item[\code{subset}] an optional vector specifying a subset of observations
to be used.
\item[\code{na.action}] a function which indicates what should happen when
the data contain \code{NA}s.  Defaults to
\code{getOption("na.action")}.
\item[\code{var.equal}] a logical variable indicating whether to treat the
variances in the samples as equal.  If \code{TRUE}, then a simple F
test for the equality of means in a one-way analysis of variance is 
preformed.  If \code{FALSE}, an approximate method of Welch (1951)
is used, which generalizes the commonly known 2-sample Welch test to
the case of arbitrarily many samples.
\end{ldescription}
\end{Arguments}
\begin{Value}
A list with class \code{"htest"} containing the following components:
\begin{ldescription}
\item[\code{statistic}] the value of the test statistic.
\item[\code{parameter}] the degrees of freedom of the exact or approximate F
distribution of the test statistic.
\item[\code{p.value}] the p-value of the test.
\item[\code{method}] a character string indicating the test performed.
\item[\code{data.name}] a character string giving the names of the data.
\end{ldescription}
\end{Value}
\begin{References}\relax
B. L. Welch (1951),
On the comparison of several mean values: an alternative approach.
\emph{Biometrika}, \bold{38}, 330--336.
\end{References}
\begin{SeeAlso}\relax
The standard t test (\code{\Link{t.test}}) as the special case for two
samples;
the Kruskal-Wallis test \code{\Link{kruskal.test}} for a nonparametric
test for equal location parameters in a one-way layout.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
data(sleep)
## Not assuming equal variances
oneway.test(extra ~ group, data = sleep)
## Assuming equal variances
oneway.test(extra ~ group, data = sleep, var.equal = TRUE)
## which gives the same result as
anova(lm(extra ~ group, data = sleep))
\end{ExampleCode}
\end{Examples}

