t.test                 package:ctest                 R Documentation

_S_t_u_d_e_n_t'_s _t-_T_e_s_t

_D_e_s_c_r_i_p_t_i_o_n:

     t.test performs one and two sample t-tests on vectors of data.

_U_s_a_g_e:

     t.test(x, y = NULL, alternative = c("two.sided", "less", "greater"),
            mu = 0, paired = FALSE, var.equal = FALSE, conf.level = 0.95)

_A_r_g_u_m_e_n_t_s:

       x: a numeric vector of data values.

       y: an optional numeric vector data values.

alternative: character specifying the alternative hypothesis, must be
          one of `"two.sided"' (default), `"greater"' or `"less"'.  You
          can specify just the initial letter.

      mu: a number indicating the true value of the mean (or difference
          in means if you are performing a two sample test).

  paired: a logical indicating whether you want a paired t-test.

var.equal: a logical variable indicating whether to treat the two
          variances as being equal. If `TRUE' then the pooled variance
          is used to estimate the variance otherwise the Welch
          approximation to the degrees of freedom is used.

conf.level: confidence level of the interval.

_D_e_t_a_i_l_s:

     If `paired' is `TRUE' then both `x' and `y' must be specified and
     they must be the same length.  Missing values are removed (in
     pairs if `paired' is `TRUE').  If `var.equal' is `TRUE' then the
     pooled estimate of the variance is used.  By default, if
     `var.equal' is `FALSE' then the variance is estimated separately
     for both groups and the Welch modification to the degrees of
     freedom is used.

_V_a_l_u_e:

     A list with class `"htest"' containing the following components: 

statistic: the value of the t-statistic.

parameters: the degrees of freedom for the t-statistic.

 p.value: the p-value for the test.

conf.int: a confidence interval for the mean appropriate to the
          specified alternative hypothesis.

estimate: the estimated mean or difference in means depending on
          whether it was a one-sample test or a two-sample test.

null.value: the specified hypothesized value of the mean or mean
          difference depending on whether it was a one-sample test or a
          two-sample test.

alternative: a character string describing the alternative hypothesis.

  method: a character string indicating what type of t-test was
          performed.

data.name: a character string giving the name(s) of the data.

_E_x_a_m_p_l_e_s:

     t.test(1:10,y=c(7:20))      # P = .00001855
     t.test(1:10,y=c(7:20, 200)) # P = .1245    -- NOT significant anymore

