FEF                      (Animal Breeder's Tool Kit)               FEF





NAME

     fef - make an incidence matrix for any fixed effects



SYNOPSIS

     fef  -d (effect data vector file) -r (observation vector file) 

          -e (output effect list file) [-s]



DESCRIPTION

     fef writes  the  incidence matrix  relating observations  to

     fixed effects to  standard output.  The incidence  matrix is

     constructed according to  a vector of  fixed effects in  the

     effect data  vector file and corresponding  right hand sides

     observations in  the  observation vector  file.   A list  of

     effects  in  order of  first  occurrence is  written  to the

     output effect  list file.   Column  order  of the  incidence

     matrix produced will  correspond to the order  of effects in

     the effect list file.  



     Parameters required by fef are:



          -d (effect data vector file)

               Indicate  the name  of  the  file  containing  the

               vector of effects corresponding to observations.



          -r (observation vector file)

               Indicate  the  name  of the  file  containing  the

               vector of observations.



          -e (output effect list file)

               Name  the file  to contain  a list  of effects  in

               order of first occurence.



     The -s option will  suppress warning of observations without

     a known corresponding effect.



     Both  the effect  data vector  and observation  vector files

     must be single vector files of equal length.  Unknown effect

     data and observations must be indicated with a period (.).



     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

     fef -d sex -r ww_obs -e sex.list  > x_sex



     will write  the incidence matrix for  sex to x_sex.   y is a

     vector  of observations  and sex  is a  vector of  sex codes

     corresponding to the observations.   sex.list will contain a

     list of unique sex codes.   The order in which sex codes are

     listed  in  sex.list   indicates  which   column  of   x_sex

     corresponds to which sex code.



SEE ALSO

     gen_z