ADDSUB             (Animal Breeder's Tool Kit)             ADDSUB


 NAME

      addsub

          add  a  smaller matrix (sub matrix)  to a  larger matrix
          starting from a given position of row and column

 SYNOPSIS

      addsub [-z](SPARSE matrix file) [-z](SPARSE matrix file)[*s]
          (output SPARSE matrix file) [row number] [column number]

 DESCRIPTION

      adds a small matrix (submatrix) to a large one begining from
      the given row number and column number and writes the output
      in a file.

      The second matrix (submatrix)should be either smalleror eqal
      to the first one. The resulting  matrix has the same  number
      of rows and columns as the first one.


      EXAMPLE:    addsub aa bb cc 5 5


      will add the SPARSE martix bb to SPARSE matrix  aa, starting
      from  5th row and 5th column of matrix aa. The   matrix   bb
      should be  smaller than  or  eqal to   aa  in  terms  of its
      dimentions.  The resulting  matrix is given in sparse matrix
      form in file cc. The matrix in  cc has the same dimention as
      aa.

      The submatrix may also be  multiplied  by  a  scaler  before
      addition.


      EXAMPLE:    addsub XtX "Ainv*3.5" XtXG 20 20


      here the matrix Ainv is multiplied by a scaler  3.5 before
      being  added  to XtX.


      If  a dash (-) is used for  the output matrix, the resulting
      matrix will be written to standard output.  One input matrix
      file  may also be a dash (-), indicating standard input from
      a  process writing a matrix with a header record to standard
      output.

      The -z  option is used  to indicate compressed  input matrix
      files.

      Detected errors, such as non-conforming input matrices, will
      be reported to standard error and the process will abort.



 SEE ALSO

      add, sadd