gtbkg

See gtgtbkg:

Help | Example

Also see:

Synopsis:

Creates a background spectrum file (PHA1).

The pha file that is created contains total counts based on a Likelihood source model and covers the same energy bands and region-of-interest as the input pha file. The model will typically contain interstellar and extragalactic diffuse components as well as nearby point sources.

Usage: gtbkg phafile outfile scfile expcube expmap irfs srcmdl target

Links:

General Parameters

  phafile [file]
    Name of input spectrum file (PHA1). This file should be produced with gtbin (option PHA1).
     
  outfile [file]
    Output spectrum file (PHA1 format).
     
  scfile [file]
    Spacecraft data file containing information such as the spacecraft pointing as a function of time. This file could be generated by gtorbsim for simulated observations (see gtorbsim help) or, more commonly, it can be obtained from SLAC's data portal.
     
  (sctable = SC_DATA) [string]
    Spacecraft data extension. This is a hidden parameter. (default: SC_DATA)
     
  expcube [file]
    FITS file containing livetime as a function of sky position and off-axis angle. This file can be generated by gtltcube, or obtained from SLAC's data portal.
     
  expmap [file]
    Exposure map file created using gtexpmap. This is an exposure map of the form that is used with unbinned likelihood analysis and is used in this context since Xspec analyses of LAT data presently only support acceptance cone based extraction regions. Do not use an exposure map that is appropriate for binned analysis.
     
  irfs = HANDOFF [string]
   

Instrument Response Functions. The instrument response (PSF, effective area, energy resolution) is currently a function of energy, inclination angle (the angle between the source and the LAT normal), and photon category.

Since the LAT will usually surveys the sky, a source is observed at different inclination angles. Each count is therefore characterized by a different instrument response function (IRF).

     
  srcmdl [file]
    XML file containing the source model definitions. The source model can be generated by the Model Editor (modeleditor) utility or by following source model templates.
     
  target [string]
    The name of the target source as it appears in the source model file. Its contribution will be excluded from the background calculation. If there are no sources to exclude, this field may be left blank or set to "none".
     
  (chatter)
    This parameter fixes the output verbosity: no screen output (0), nominal screen output (2), maximum verbosity (4). (default: 2)
     
  (clobber = yes)
    If true, an existing file of the same name will be overwritten. This is a hidden parameter. (default: yes)
     
  (debug = no)
   

Activate debugging mode. (default: no)

When debug is "no", all exceptions that are not caught and handled by individual tool-specific code are caught by a top-level exception handler that
displays information about the exception and then exits.

When debug is "yes", such exceptions are not caught by the top level code. Instead the tool produces a segmentation violation, which is more useful for debugging. When debugging mode is enabled, the tool produces more verbose output describing any errors or exceptions that are encountered.

     
  (gui = no)
    If the parameter specified is "yes", the Graphical User Interface (GUI) mode is activated. This is a hidden parameter. (default: no)
     
  (mode = ql)
    Mode of automatic parameters. This is a hidden parameter. (default: ql)
     

Owned by: J. Chiang

Last updated by: Chuck Patterson 01/03/2011