home *** CD-ROM | disk | FTP | other *** search
/ Big Green CD 8 / BGCD_8_Dev.iso / NEXTSTEP / UNIX / Educational / R-0.49-MI / R-0.49-I / help / ctest / prop.test < prev    next >
Encoding:
Text File  |  1997-09-13  |  3.5 KB  |  79 lines
  1.     
  2.     _T_e_s_t _f_o_r _E_q_u_a_l _o_r _G_i_v_e_n _P_r_o_p_o_r_t_i_o_n_s
  3.     
  4.          prop.test(x, n, p = NULL, alternative = "two.sided",
  5.                    conf.level = 0.95, correct = TRUE)
  6.     
  7.     _A_r_g_u_m_e_n_t_s:
  8.     
  9.             x, n : vectors of counts of successes and trials,
  10.                    respectively.  Only pairs with finite values
  11.                    are used.  The elements of x must be nonnega-
  12.                    tive and not greater than the corresponding
  13.                    elements of n which must be positive.  All
  14.                    elements should be integers.
  15.     
  16.                p : a vector of probabilities of success.  p must
  17.                    have the same length as x and n, and its ele-
  18.                    ments must be greater than 0 and less than 1.
  19.     
  20.      alternative : indicates the alternative hypothesis and must
  21.                    be one of "two.sided", "greater" or "less".
  22.                    You can specify just the initial letter.
  23.                    Only used for testing the null that a single
  24.                    proportion equals a given value, or that two
  25.                    proportions are equal;  ignored otherwise.
  26.     
  27.       conf.level : confidence level of the returned confidence
  28.                    interval.  Must be a single number between 0
  29.                    and 1.  Only used when testing the null that
  30.                    a single proportion equals a given value, or
  31.                    that two proportions are equal;  ignored oth-
  32.                    erwise.
  33.     
  34.          correct : a logical indicating whether Yates' con-
  35.                    tinuity correction should be applied.
  36.     
  37.     _D_e_s_c_r_i_p_t_i_o_n:
  38.     
  39.          prop.test can be used for testing the null that the
  40.          proportions (probabilities of success) in several
  41.          groups are the same, or that they equal certain given
  42.          values.
  43.     
  44.          If p is NULL and there is more than one group, the null
  45.          tested is that the proportions in each group are the
  46.          same.  If there are two groups, the alternatives are
  47.          that the probability of success in the first group is
  48.          less than, not equal to, or greater than the probabil-
  49.          ity of success in the second group, as specified by
  50.          alternative.  A confidence interval for the difference
  51.          of proportions with confidence level as specified by
  52.          conf.level and clipped to [-1,1] is returned.  Con-
  53.          tinuity correction is used only if it does not exceed
  54.          the difference of the sample proportions in absolute
  55.          value.  Otherwise, if there are more than 2 groups, the
  56.          alternative is always "two.sided", the returned confi-
  57.          dence interval is NULL, and continuity correction is
  58.          never used.
  59.     
  60.          If there is only one group, then the null tested is
  61.          that the underlying probability of success is p, or .5
  62.          if p is not given.  The alternative is that the proba-
  63.          bility of success if less than, not equal to, or
  64.          greater than p or 0.5, respectively, as specified by
  65.          alternative.  A confidence interval for the underlying
  66.          proportion with confidence level as specified by
  67.          conf.level and clipped to [0,1] is returned.  Con-
  68.          tinuity correction is used only if it does not exceed
  69.          the difference between sample and null proportions in
  70.          absolute value.
  71.     
  72.          Finally, if p is given and there are more than 2
  73.          groups, the null tested is that the underlying proba-
  74.          bilities of success are those given by p.  The alterna-
  75.          tive is always "two.sided", the returned confidence
  76.          interval is NULL, and continuity correction is never
  77.          used.
  78.     
  79.