

_C_a_n_o_n_i_c_a_l _C_o_r_r_e_l_a_t_i_o_n_s

     cancor(x, y, xcenter=TRUE, ycenter=TRUE)

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

       x: a matrix containing the x coordinates.

       y: a matrix containing the y coordinates.

 xcenter: a parameter describing any centering to be done on
          the x values before the analysis.  The default is
          substract the column means, but it is possible to
          supply a vector of values to be subtracted from
          the columns. It is possible to turn off any
          adjustment.

 ycenter: like the parameter `xcenter', but for the y
          values.

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

     This function performs a canonical correlation analysis
     for the given data.  The analysis seeks linear combina-
     tions of the y variables which are well explained by
     linear combinations of the x variables.

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

     A list containing the following components:

   xcoef: estimated coefficients for the x variables.

   ycoef: estimated coefficients for the y variables.

 xcenter: the values used to adjust the x variables.

 ycenter: the values used to adjust the x variables.

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

     Hotelling H. (1936).  ``Relations between two sets of
     variables''.  Biometrika, 28, 321-327.

     Seber, G. A. F. (1984).  Multivariate Analysis. New
     York: Wiley.

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

     `qr', `svd'.

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

     soil <- evap.x[,1:3]
     air <- evap.x[,-(1:3)]
     airsoil <- cancor(air, soil)

