DECODEEVT (Aug98)              ftools.xte              DECODEEVT (Aug98)



NAME
    decodeevt -- Decodes event keywords in XTE Science Event files
    
    
USAGE
    decodeevt infile outfile
    
    
DESCRIPTION
    This task decodes event keywords in an input XTE Science Event file,
    and generates  an  output  file  with  separate  columns  for  TIME,
    CHANNEL,   PCUID,  ANODE,  and  PROPANE.  If  no  PCUID  information 
    (integer: 0-4) is available in the input file,  the  values  in  the
    output  column  are  set  to  -999. If no ANODE information (string:
    "X1R"/"X3L" etc) is available, the column  contains  INDEFs.  If  no
    PROPANE  information  (bit  0/1)  is  available,  this column is not
    written to the output file.
    
    
PARAMETERS
    
    infile [string - file name]
        The name of input Science Event file.
    
    outfile [string - file name]
        The name of output file.
    
    (clobber = no) [boolean]
        If "yes", an existing file with the same name as  the  requested
        output file will be overwritten.
        
        
EXAMPLES
    1.  Decode a Science Event file using DECODEEVT.
    decodeevt infile=mySEfile outfile=myoutfile
    
    
NOTES:
    This tool supercedes the old, obselete SEEXPD.
    
    
BUGS
    Due  to  problems with the data descriptors in the input files, this
    tool  will  not  work  with  the  (very  rarely  used)  event  modes 
    E_62us_4M* and E_500us_64M*.
    
    Please report problems to xtehelp@athena.gsfc.nasa.gov.
    
    
SEE ALSO