GEN_Z                    (Animal Breeder's Tool Kit)                GEN_Z



NAME

     gen_z - build an incidence matrix from a list of effects



SYNOPSIS

     gen_z [-s] -d (effect data vector file) -e (effect list file) 

          -r (observation vector file) -o (incidence matrix file)



DESCRIPTION

     gen_z writes an incidence matrix file to relate observations

     in the observation vector file to effects in the effect list

     file.    The effect  data  vector  file  contains an  effect

     corresponding to each observation in the observation vector.

     The  matrix   produced  will  have  rows   corresponding  to

     observations  and columns corresponding to effects listed in

     the effect list file.  



     The  -s parameter  indicates  to supress  a warning  message

     issued  when  a missing  value  code is  encountered  in the

     effect  data vector file but the  corresponding value in the

     observation vector file is not missing.



     The paramaters  -d, -e, -r,  -o must  be followed by  a file

     name.   The input  files named following -d,  -e and -r must

     contain a single  column.   The output file  named after  -o

     will  contain the  SPARSE stored  incidence matrix  relating

     observations to effects.



     Notice that  the difference between  gen_z and  fef is  that

     gen_z  takes and effects list file as input and fef produces

     an effects list file from the input data.



EXAMPLE

     gen_z -d dam_list -e pars.ord -r ww -o milk_z.ram



     builds the matrix file  milk_z.ram to relate observations in

     ww  to   parent  effects  listed  in   pars.ord.    dam_list

     establishes  the relationship  between  ww observations  and

     parent effects.



SEE ALSO

     fef