SUBM                (Animal Breeder's Tool Kit)                     SUBM



NAME

     subm - get a submatrix of a matrix



SYNOPSIS

     subm (matrix  file) (submatrix file) (start row) 

          (start column) [(end row) (end column)]



DESCRIPTION

     subm creates  a submatrix of a  matrix.  The  element in the

     first row, first column  of the submatrix will be  the start

     row, start column  element of the input matrix.   If end row

     and  end column are not specified, the last row, last column

     element of the submatrix  will be the last row,  last column

     element  of the input  matrix, otherwise the  last row, last

     column element of  the submatrix  will be the  end row,  end

     column of the input matrix. 



     subm will write the  submatrix to standard output if  a dash

     (-) is specified instead of a file name.  Standard input  is

     also accepted with a dash (-) as the input matrix file name,

     provided the input is from a process writing a matrix with a

     header record to standard output.



EXAMPLE

     For the matrix file X containing the matrix



               | 1 0 0 1 0 0 |

               | 0 1 0 1 0 0 |

               | 1 0 0 0 1 0 |

               | 0 0 1 0 1 0 |

               | 0 0 1 0 0 1 |

               | 0 1 0 0 0 1 |



     subm X Xs 1 1 6 3



     will write the file Xs to contain the matrix                

                                        

               | 1 0 0 |

               | 0 1 0 |

               | 1 0 0 |

               | 0 0 1 |

               | 0 0 1 |

               | 0 1 0 |