

   CCaannoonniiccaall CCoorrrreellaattiioonnss

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

   AArrgguummeenntts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 val-
             ues.

   DDeessccrriippttiioon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Vaalluue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Reeffeerreennccees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Seeee AAllssoo::

        `qr', `svd'.

   EExxaammpplleess::

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

