GBMRSPGEN (Jul12)               ftools.caltools              GBMRSPGEN (Jul12)

NAME

    gbmrspgen -- response matrix generator for the Fermi Gamma-ray Burst Monitor
    
USAGE

    gbmrspgen -N -M2 -T path_to_my_tcat_trigdat_pha_file_dir

    
DESCRIPTION

    This task is provides an interface to the gbm response matrix generator written by 
    the GBM Instrument team.  It will create responses for all GBM spectra (*.pha) files 
    in a given GBM data directory.  This directory must contain the GBM TCAT file (usually 
    named something like "glg_tcat_*.fit") and the GBM TRIGDAT file (usually named (usually 
    named something like "glg_trigdat_all_*.fit")

RUNTIME ARGUMENTS

    -N  [string]
       force the code into single-matrix mode. Most users will want to use -N.

    -M [string]
       signals which type of matrix should be generated; 
          the possible values are: 
          -M0: Direct matrix only (includes spacecraft scattering),
          -M1: Earth atmospheric xsattering matrix only,
          -M2: Summed matrix: direct + earth scattering.
       Most users will want -M2.

    -T
       suppresses creation of the 'level1.inf' file.  Most users will want to use -T to
       suppress creation of the level1.inf file.

    -Qn.d
       determines an offset in seconds n.d relative to the trigger time to determine the 
       appropriate spacecraft attitude for the response calculation. Useful only in 
       conjunction with single-matrix mode (-N).

    -Vn   
       assigns a version number n to the response matrix file, useful if the user wishes to generate
       single response files for different peaks (separated in time) in a single triggered event.

    path_to_my_tcat_trigdat_pha_file_dir[string]
       path to the directory containing the GBM "TCAT", "TRIGDAT" and GBM "PHA" files. 
       For example:
          http://heasarc.gsfc.nasa.gov/FTP/fermi/data/gbm/bursts/2009/bn090126245/current/

EXAMPLES

    Create GBM response matrices for all the pha data in

      /FTP/fermi/data/gbm/bursts/2009/bn090126245

    in single matrix mode, including direct and earth-scattered emission

    % gbmrspgen -N -M2 -T /FTP/fermi/data/gbm/bursts/2009/bn090126245/current/

BUGS
 
    None

SEE ALSO

    None