BOD2RMF (Apr05)                ftools.gro               BOD2RMF (Apr05)



NAME
    bod2rmf -- Makes XSPEC RMF file for BATSE occultation data.    
    
USAGE
    bod2rmf inrfil datadir outputdir ladnum viewper  tjd_start  tjd_stop
    sradeg sdecdg zradeg zdecdg xradeg xdecdg rmffil clobber    
    
DESCRIPTION
    This  utility  creates detector response matrix (in RMF FITS format)
    for to  be  used  BATSE  occultation  data  (NHIS  type),  or  other
    non-triggered  data  types.   A separate detector response matrix is
    required for each CGRO orientation (constant  within  a  given  CGRO
    viewing  period),  source  direction, and BATSE detector (LAD).  The
    response matrix is generated using LAD  matrix  integrator  software
    (Version  3.0).   For Earth occultation data, The corresponding (PHA
    FITS) spectral data files in  XSPEC  format  are  created  by  FTOOL
    bod2pha.  The  observation  start  and stop times, or alternitively,
    the CGRO Viewing Preiod  number  are  used  to  obtain  the  correct
    calibration  parameters.  If the viewing period number is specified,
    the spacecraft orientation (X- and Z-axis clestial coordinates)  are
    determined automatically.    
    The  FITS  file,  inst_resp.fits,  which  contains detector-specific
    response matrix data, is read in by this  utility  and  is  required
    for  it  to  function.  This file lives in /refdata. In addtion, the
    file "vp_list.fits", also found in that directory is needed  if  the
    "viewper" options (see below) is to be used.    
    The  BATSE  Earth  occultation database, and related information are
    availble   through   the   HEASARC,    or    on    the    web    at:  
    <ftp://cossc.gsfc.nasa.gov/compton/data/batse/occultation>     (also    
    see <http://cossc.gsfc.nasa.gov/batse/index.html>        
    
PARAMETERS
    
    inrfil [string]        
        file containing detector specific response data    
    datadir [string]        
        name of directory containing viewing period list file    
    outputdir [string]        
        name of directory for output files    
    ladnum [integer]        
        BATSE LAD number (0 to 7)    
    viewper [integer]        
        viewing period number - user enters either  this  value  or  the
        tjdsta/tjdstp pair    
    tjd_start [real]        
        truncated Julian Day (JD - 2440000) of observation start time    
    tjd_stop [real]        
        truncated Julian Day (JD - 2440000) of observation stop time    
    sradeg [real]        
        r.a. of source in degrees    
    sdecdg [real]        
        dec. of source in degrees    
    zradeg [real]        
        r.a. of CGRO z-axis in degrees    
    zdecdg [real]        
        dec. of CGRO z-axis in degrees    
    xradeg [real]        
        r.a. of CGRO x-axis in degrees    
    xdecdg [real]        
        dec. of CGRO x-axis in degrees    
    rmffil [string]        
        root name of output XSPEC RMF FITS file    
    clobber [integer]        
        indicates whether or not to overwrite the existing output files        
        
EXAMPLES
    1.  Create  the  BATSE  LAD  number 4 instrument response matrix for
    CGRO Viewing Period 2.0 (==0020). The  source  of  interest  is  the
    Crab, and the output file is to be named "Crab_VP0020_lad4.rmf".    
    bod2rmf  viewper=2  sradg=82.63 sdecdg=22.01 rmffil=Crab_VP0020_lad4
    ladnum=4    
    
FILES NEEDED
    The Viewing Period list file "vp_list.fits",is  also  required;  see
    <ftp://cossc.gsfc.nasa.gov/compton/>.   This  should  be  placed  in 
    data_dir/vp_list.fits.  Their  are  additional  calibration   files, 
    which  should  be transparent to the user, and are included with the
    FTOOLS distribution.    
    
MODIFICATIONS
    In earlier versions, the energy channel  boundaries  for  a  certain
    epoch  (TJD  10179 - 10464) were comuted incorrectly. This was fixed
    in April 2005 (but subsequent to the HEASOFT 6.0 release).    
    
BUGS
    
    
SEE ALSO
    bodgetvp, bod2pha, bodfluxhis, groview