DMPRMF (June94)              ftools.caltools             DMPRMF (June94)



NAME
    dmprmf -- Displays OGIP standard Response FITS file
    
    
USAGE
     infile dispebd disprmf disphd dipsmat outfile ebdchan rmfener
    
    
DESCRIPTION
    
       DMPRMF displays  the  contents  of  an  OGIP  standard  RMF  file
    (containing  the  detector response matrix) to the terminal or to an
    ASCII file, if the user enters an output filename. The  EBOUNDS  and
    RMF  extensions can be displayed with user-defined channel or energy
    ranges respectively. In addition the response matrix can be  written
    as an image in FITS format, if the user enters an image filename.
    
    
    
SUPPORTED FITS FILE FORMATS
    
       Currently  only  the  following  OGIP  standards are supported by
    this task
    
    For the RSP_MATRIX extension:
        HDUCLAS1/HDUVERS1= 'RESPONSE'/'1.0.0'
        
        HDUCLAS2/HDUVERS2= 'RSP_MATRIX'/'1.1.0'
                (commonly also known as "RMFVERSN=1992a")
    
    For the EBOUNDS extension:
        HDUCLAS1/HDUVERS1= 'RESPONSE'/'1.0.0'
        
        HDUCLAS2/HDUVERS2= 'EBOUNDS'/'1.1.0'
    
    For further details see OGIP Calibration Memo CAL/GEN/92-002a.
    
    
    
PARAMETERS
    
    infile [character string]
         The input filename containing the RMF data  in  OGIP  standard,
        as a BINARY table extension
    
    ebdfile (%) [character string]
         The  EBOUNDS  filename,  the  default  "%"  indicates  that the
        EBOUNDS is in the same file as the RMF data. This  is  a  hidden
        parameter
    
    dispebd [boolean]
         The default is "Y", the EBOUNDS data is displayed
    
    disprmf [boolean]
         The default is "Y", the RMF data is displayed
    
    disphd [boolean]
         The default is "N",only the mandatory keywords are displayed
    
    primary (primary="N") [boolean]
         The  default  is  "N",  the  primary  header of RMF file is not
        displayed.  This is a hidden parameter
    
    dispmat [boolean]
         The default is "Y", the full matrix is displayed
    
    outfile [character string]
         The name of the output file to be  written  to.  If  no  output
        file is entered then there is a screen display
     .ls  chatter  (chatter=9) [integer]  The value of the chatter flag,
    useful for reassurance & diagostics  purposes. The default value  is
    chatter=9,  with  chatter  <=  5 being very  quiet and chatter >= 20
    very verbose. This is a hidden parameter
    
    ebdchan [integer]
         Ebounds channel display range
    
    rmfener [integer]
         Energy display range
    
    imagefile (imagefile=" ") [character string]
         This is a hidden parameter, to define an output image  filename
        if  desired.   The  default  is no image filename. This image is
        for display purposes only.  It should be noted that  the  energy
        bins along the y-axis can be variable.
    
    page (page="yes")  [boolean] 
         Default  is  "yes",  screen display is paged . This is a hidden
        parameter
    
    more [boolean]
         Default is "yes", continue display
    
    (clobber = false) [boolean]
         Flag specifying whether or not a  pre-existing  file  with  the
        same  name  as that  requested as the output file from this task
        will be overwritten.
    
    
EXAMPLES
    1. To display "my_file.rmf" , showing the EBOUNDS data with  channel
       range  10-20,  the  RMF  data  with  energy  range  234-256,  and 
    displaying    only the mandatory header :
    
    ca> dmprmf my_file.rmf ebdchan=10-20 rmfener=234-256
    
    
    
BUGS
    None known
    
    
SEE ALSO
    Rdrsp (xspec)  Legacy No.2
    
    
    
LOG OF SIGNIFICANT CHANGES
    
    
    v1.0.6 (1994 June)
            Additional  functionality,  the  response  matrix   can   be 
        written as an  image
    
    v1.0.0 (1993 March)
            Initial public release
    
    
    
PRIMARY AUTHOR
    
    Rehana Yusaf
    HEASARC
    NASA/GFSC
    http://heasarc.gsfc.nasa.gov/cgi-bin/ftoolshelp
    (301) 286-6115