MULT                (Animal Breeder's Tool Kit)                     MULT

 NAME
      mult - multiply two matrices

 SYNOPSIS
      mult [-t][-z](matrix file)[*v] [-t][-z](matrix file)
           (output matrix file)

 DESCRIPTION
      mult multiplies the two conforming matrices contained in the
      input  matrix files,  placing  the resulting  matrix in  the
      output  matrix  file.    The  input  matrices  need  not  be
      contained in separate  files; a matrix may be  multiplied by
      itself  by naming the  same file twice.   If an input matrix
      file is  compressed, -z  must be  specified when  naming the
      file.   Order of  the command  line arguments  is important,
      there must be three matrix files named.  The first matrix is
      multiplied by  the second,  with the  result  placed in  the
      third file named.


      Options recognized by mult are:

           -t     Multiply the transpose of the matrix specified.

           *v     Prior to matrix multiplication, multiply elements
                  of the first matrix by the scalar value v, or by
                  the DIAGONAL stored matrix v.  This is useful for
                  multiplying incidence matrices by blocks of an
                  inverse residual matrix.  The *v must appear on the
                  command line following the name of the first input
                  matrix.  If the csh is being used you will need to
                  preceed the * with the escape character (.

           -z     Indicates that an input matrix is compressed.

 EXAMPLES
      mult -tx_bw x_bw xtx

      produces  the  matrix xtx  as  a result  of  multiplying the
      transpose of x_bw by x_bw.

      mult -tbz*Rbw wz bztrwz

      produces the same matrix bztrwz as

      mult -tbz Rbw bzRbw; mult bzRbw wz bztrwz

      if bz, wz and Rbw conform and Rbw is a DIAGONAL stored matrix.