D2S                      (Animal Breeder's Tool Kit)            D2S

 NAME
      d2s, s2t - change matrix storage mode

 SYNOPSIS
      d2s [-z](matrix file) (output SPARSE matrix file)
      s2t (SPARSE or TREE matrix file)

 DESCRIPTION
      d2s writes the  SPARSE storage form of a  matrix file to the
      output SPARSE matrix file.  If the input file is compressed,
      -z must  be specfied.   If a dash  (-) is specified  for the
      input  file, d2s will  accept standard input  from a process
      writing a matrix with a header record to standard output.

      s2t  is a toggle between SPARSE and TREE storage modes.  s2t
      will  change  a SPARSE  stored matrix  to  TREE, and  a TREE
      stored  matrix to  SPARSE.   s2t cannot accept  a compressed
      input matrix or standard input.

 EXAMPLES
      invert -i coef -o - | d2s - coef_inv.sp

      will write a SPARSE stored  representation of the inverse of
      the matrix coef to coef_inv.sp.

      s2t xtx

      will change  the matrix xtx  from SPARSE  to TREE if  xtx is
      SPARSE or from TREE to SPARSE if xtx is TREE.

 BUGS
      The matrix toggled by s2t cannot be compressed.