gtselect

See gtselect:

Help | Example

Also see:

Synopsis: Performs sub-selections of event data.

Usage: gtselect infile outfile ra dec rad tmin tmax
emin emax eventClass

Links:

General Parameters

  infile [file]
    Input event data FITS file; contains the event data.
     
  outfile [file]
    Output event FITS file; contains events that satisfy the selection performed.
     
  ra [double]
    Right ascension of acceptance cone (J2000) in decimal degrees.
    If the parameter is set to INDEF, the ra will be read from the header of the input file.
     
  dec [double]
    Declination of acceptance cone (J2000) in decimal degrees.
    If the parameter is set to INDEF, the dec will be read from the header of the input file.
     
  rad = 180 [double]
    Radius of acceptance cone (decimal degrees). A value of 180 indicates that no acceptance cone cut will be applied. If the parameter is set to INDEF, the rad will be read from the header of the input file.
     
     
  tmin = 0 [double]
   

Event arrival time lower limit (MET seconds).

All the events in the output FITS file will have "event arrival time" larger than this value. The reference time used for MET is midnight (0h:0m:0s) on January 1, 2001, in Coordinated Universal Time (UTC). The GLAST convention is that MJDREF=51910 (UTC)=51910.0007428703703703703 (TT); the fractional part of MJDREF in the TT system compensates for the use of midnight in the UTC system as the reference time. MJDREF is divided into two keywords:
MJDREFI=51910, the integer part; and MJDREFF=7.428703703703703D-4, the
fractional part.

     
  tmax = 0 [double]
   

Event arrival time upper limit (MET seconds).

All the events in the output FITS file will have "event arrival time" smaller than this value. NB: A value of zero in this context means that no upper limit will be applied.

     
  emin = 30 [double]
   

Minimum event energy (MeV).

All the events in the output FITS file will have "event energy" larger than this value.

     
  emax = 3e5 [double]
   

Maximum event energy (MeV).

All the events in the output FITS file will have "event energy" smaller than this value.

     
  zmax = 180 [double]
    Maximum measured zenith angle. A value of 180 means that no cut will be applied. The Earth's limb is at about 113 degrees with respect to the zenith, so a cut of 100 degrees would roughly correspond to 4 sigma at 100 MeV.
     

Hidden Parameters

  (evclsmin = 0) [integer]
    Mininum event class ID to include. Each set of IRFs will define a set of event classes numbered 0 to n, where n+1 is the number of event classes. These numbers will be ordered such that the more inclusive classes are numbered lowest. See Event Classes and Instrument Response Functions (IRFs); also see gtselect Help File: evclsmin and evclsmax.
     
  (evclsmax = 10) [integer]
   

Maximum event class ID to include.

See Event Classes and Instrument Response Functions (IRFs); also see gtselect Help File: evclsmin and evclsmax.

     
  (evtable = EVENTS) [string]
    Event data extension.
     
  (convtype = -1) [integer]
    Conversion type. 0=Front, 1=Back, -1=both
     
  (phasemin = 0) [double]
    Minimum pulsar phase to include. This cut is only applied if the PULSE_PHASE column has been added to the FT1 file by the gtpphase tool.
     
  (phasemax = 1) [double]
    Maximum pulsar phase to include.
     
  (chatter = 2)
    Output verbosity: no screen output (0), nominal screen output (2), maximum verbosity (4). This is a hidden parameter. (default: 2)
     
  (clobber = yes)
    Overwrite or do not overwrite existing output files. 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 (based on original implementation of T. Stephens)

Last updated by: Chuck Patterson 12/16/2010