

   SSiinngguullaarr VVaalluuee DDeeccoommppoossiittiioonn ooff aa MMaattrriixx

        svd(x, nu=min(n,p), nv=min(n,p))

   AArrgguummeennttss::

          x: a matrix whose SVD decomposition is to be com-
             puted.

         nu: the number of left eigenvectors to be computed.
             This must be one of `0', `nrow(x)' and `ncol(x)'.

         nv: the number of right eigenvectors to be computed.
             This must be one of `0', and `ncol(x)'.

   DDeessccrriippttiioonn::

        `svd' provides an interface to the LINPACK routine
        DSVDC.  The singular value decompostion plays an impor-
        tant role in many statistical techniques.

   VVaalluuee::

        The SVD decomposition of the matrix as computed by LIN-
        PACK.  The components in the returned value correspond
        directly to the values returned by DSVDC.

          d: a vector containing the singular values of `x'.

          u: a matrix whose columns contain the left eigenvec-
             tors of `x'.

          v: a matrix whose columns contain the right eigenvec-
             tors of `x'.

   RReeffeerreenncceess::

        Dongarra, J. J., J. R. Bunch, C. B. Moler and G. W.
        Stewart (1978).  LINPACK Users Guide, SIAM Publica-
        tions, Philadelphia.

   SSeeee AAllssoo::

        `eigen', `qr'.

