Armitage            package:GeneticsBase            R Documentation

_C_o_c_h_r_a_n-_A_r_m_i_t_a_g_e _t_e_s_t _f_o_r _l_i_n_e_a_r _t_r_e_n_d_s _i_n _p_r_o_p_o_r_t_i_o_n_s _a_n_d _f_r_e_q_u_e_n_c_i_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     Cochran-Armitage test for linear trends in proportions and
     frequencies.

_U_s_a_g_e:

     Armitage(geneSetObj, method="A")
     Armitage.default(pedObj, method="A")
     ArmitageTest(x, mem)

_A_r_g_u_m_e_n_t_s:

geneSetObj: a geneSet object

  pedObj: a pedigree object

  method: genotype coding method. The default is additive coding ('A').
          The other two available coding methods are recessive coding
          ('R') and dominant coding ('D'), respectively.

       x: a vector of bialleleic markers coded by additive, recessive,
          or dominant model. Denote B as common allele and A as minor
          allele.

     _a_d_d_i_t_i_v_e _m_o_d_e_l: x=0 - BB; x=1 - AB; x=2 - AA

     _r_e_c_e_s_s_i_v_e _m_o_d_e_l: x=0 - BB; x=0 - AB; x=2 - AA

     _d_o_m_i_n_a_n_t _m_o_d_e_l: x=0 - BB; x=1 - AB; x=1 - AA 

     mem: disease membership. '1' - case; '0' - control

_D_e_t_a_i_l_s:

_V_a_l_u_e:

     The functions 'Armitage' and 'Armitage.default' return a matrix
     with 'nMarkers' rows and 2 columns, where 'nMarkers' is the number
     of markers. The two columns are test statistic ('stat') and
     p-value ('pvalue'), respectively.

     The function 'ArmitageTest' returns a list of two elements: 

   stat : test statistic

 pvalue : p-value of the test

_N_o_t_e:

     This implementation is based on the documentation at webpage:
     <URL:
     http://linkage.rockefeller.edu/pawe3d/help/Linear-trend-test-ncp.html>.

_A_u_t_h_o_r(_s):

     Gregory Warnes <warnes@bst.rochester.edu> Ross Lazarus
     <ross.lazarus@channing.harvard.edu> Weiliang Qiu
     <stwxq@channing.harvard.edu>

_R_e_f_e_r_e_n_c_e_s:

     Gordon D, Haynes C, Blumenfeld J, Finch SJ (2005)  PAWE-3D:
     visualizing Power for Association With Error in case/control 
     genetic studies of complex traits.  Bioinformatics 21:3935-3937.

     Gordon D, Finch SJ, Nothnagel M, Ott J (2002)  Power and sample
     size calculations for case-control genetic association  tests when
     errors are present: application to single nucleotide 
     polymorphisms.  Hum Hered 54:22-33.

     Chapman, D.G. and Nam, J.M. (1968)  Asymptotic power of chi square
     tests for linear trends in proportions.  Biometrics. 24, 315-327.

     Armitage, P. (1955)  Tests for linear trends in proportions and
     frequencies.  Biometrics. 11, 375-386.

     Cochran, W.G. (1954)  Some methods for strengthening the common
     chi-squared tests.  Biometrics. 10, 417-451.

_S_e_e _A_l_s_o:

_E_x_a_m_p_l_e_s:

       # not significant result
       ArmitageTest(x=c(2,1,1,1,0,0,1,0,0,1), mem=c(1,1,1,1,1,0,0,0,0,0))

       # significant result
       ArmitageTest(x=c(2,2,1,1,0,0,0,0,0,0), mem=c(1,1,1,1,1,0,0,0,0,0))

