See gttsmap:

Help | Examples

Also see:

gttsmap

Synopsis: Calculates a test-statistic map for source localization
and detection.

Usage: gttsmap evfile scfile expmap expcube srcmdl outfile irfs optimizer ftol nxpix nypix binsz coordsys xref yref proj

Links:

General Parameters

  evfile [file]
   

Input LAT event data file.

If multiple events files are desired, an ASCII file with the complete list of them should be entered here with an "@" sign before the name. For example, if the name of that ASCII file is "events", then its parameter should be entered: evfile=@events.

     
  (evtable = EVENTS) [string]
    Event table extension name. This is a hidden parameter. (default: EVENTS)
     
  scfile [file]
   

Spacecraft data file.

Contains information such as the spacecraft pointing as a function of time. Can be generated by gtorbsim for simulated observations, or it can be obtained from SLAC's Data Portal.

     
  (sctable = SC_DATA) [string]
    Spacecraft data extension. This is a hidden parameter. (default: SC_DATA)
     
  expmap = none [file]
   

Exposure map file.

Exposure map file created by gtexpmap and like those used in an unbinned likelihood analysis.

     
  expcube = none [file]
   

Exposure hypercube file.

FITS file containing livetime as a function of sky position and off-axis angle. This file should be generated by gtltcube, or it can be obtained from SLAC's Data Portal.

     
  srcmdl [file]
   

XML file containing the source model definitions for known sources that are input into your calculation.

Same source model file used by gtlike. Can be generated by the Model Editor
(modeleditor)
utility (recommended), or by following source model templates.

     
  outfile [file]
    Output FITS file name.
     
  irfs = P6_V3_DIFFUSE [string]
    Instrument response functions.
     
  optimizer = DRMNGB <(DRMNFB|NEWMINUIT|MINUIT|DRMNGB|LBFGS)> [string]
   

Optimizer package to use. (See gtlike documentation.)

Note: gttsmap calls the same routines as gtlike to obtain the TS of the detection at each analyzed position; therefore, this package should be the same as the ones used for the gtlike tool.

     
  ftol = 1e-5 [double]
    Relative fit tolerance. This is the fit tolerance for the likelihood analysis, and is the same parameter used for gtlike. (default: 1e-5).
     
 
(toltype = ABS) <ABS|REL>
    Fit tolerance convergence type (absolute vs relative). This is a hidden parameter.
     
 

nxpix <2 - 200> [int]

    Number of X axis pixels.
     
  nypix <2 - 200> [int]
    Number of Y axis pixels.
     
  binsz [double]
    Image scale (in degrees/pixel).
     
  coordsys = CEL <CEL|GAL> [string]
    Coordinate system to use (CEL=J2000 celestial, GAL=Galactic).
     
  xref [double]
    X-coordinate of image center in degrees (RA or 1).
     
  yref [double]
    Y-coordinate of image center in degrees (DEC or b).
     
 

proj = STG [string: AIT|ZEA|ARC|CAR|GLS|MER|NCP|SIN|STG|TAN]

   

Coordinate projection (AIT|ZEA|ARC|CAR|GLS|MER|NCP|SIN|STG|TAN); see Calabretta & Greisen 2002, A&A, 395, 1077 for definitions of the projections.

Must be AIT, ZEA, or CAR for auto full sky.

     
  (chatter = 2)
    This parameter fixes the output verbosity: no screen output (0), nominal screen output (2), maximum verbosity (4). (default: 2)
     
  (clobber = yes)
    Overwrite or do not overwrite existing output files. This is a hidden parameter. (default: yes)
     
  (debug = no)
   

Activate debugging mode. This is a hidden parameter. (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)
    Graphical user Interface (GUI) mode activated if "yes" is specified. 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 04/05/2011