gtobssim

See gtobssim:

Help | Examples

Also see:

Synopsis:

Observation simulator. Generate photon events from astrophysical sources and process those photons according to the specified instrument response functions.

Usage: gtobssim infile srclist scfile evroot simtime startdate use_ac ra dec radius irfs seed

Links

General Parameters

  infile [file]
   

File of flux-style source definitions. This is the file that defines the source content of the simulation to be performed, including names, sky locations, spectral and flux parameters.

     
  srclist [file]
    ASCII file containing the names of source names to be simulated.
     
  scfile [file]
   

Spacecraft data file containing information such as the spacecraft pointing as a function of time. This file can be generated by gtorbsim for simulated observations, or it can be obtained from the SLAC Data Portal.

If "none" is specified, the default internal orbit and pointing calculation for a scanning mode observation will be used.

     
  (sctable = SC_DATA) [string]
    Spacecraft data extension. This is a hidden parameter. (default: SC_DATA)
     
  evroot [string]
    Prefix (text string), which will be applied to all output files.
     
  (evtable = EVENTS) [string]
    Event extension name. This is a hidden parameter. (default: EVENTS)
     
  simtime [double]
    This is the total elapsed time over which simulated data are generated (in seconds). The total time that gtobssim allows you to simulate is limited by another parameter, maxtime, which is a hidden parameter with default value of 3.155e8 seconds. This corresponds to ~10 years of data, which is the expected lifetime of Fermi.
     
  (ltfrac = 0.9) [double]
    Livetime fraction. Fraction of each 30 second interval during which photon events can be accumulated. This does not include the effect of SAA passages. This is a hidden parameter. (default: 0.9)
     
  (tstart = 0) [double]
    Simulation start time in seconds since the start date. This is a hidden parameter. (default: 0)
     
  (nevents = no) [bool]
    Use simulation time as number of events. This parameter allows one to specify the number of events to be simulated, rather than the simulation time. If "yes" is specified, the integer portion of the simulation time is taken to be the number of events. This is a hidden parameter. (default: no)
     
  (maxtime = 3.155e8) [double]
    Maximum simulation time (seconds). The maximum simulated time can be changed by this parameter. This is a hidden parameter. The default value is: 3.155e8 sec, which is approximately 10 years.
     
  startdate = 2001-01-01 00:00:00 [string]
    Simulation start date. This is the start date for the simulation. The spacecraft data file should include the range of time of your simulation. For help creating the spacecraft data file, see gtorbsim and gtorbsim Help.
     
  (offset = 0)
    Constant offset to be added to MC_SRC_ID values. This is an integer offset that is applied to the MC_SRC_ID column for identifying events from specific sources in the input model. This is a hidden parameter. (default: 0)
     
  use_ac = no [bool]
    Acceptance cone. This parameter allows you to use (or not) acceptance cone. If the value is "yes", gtobssim prompts the user for information specifying the central coordinates of the cone (RA,DEC), as well as its radius.
     
  ra [double]
    Right ascension of cone center (degrees). If use_acceptance_cone was set to "yes", you should give the coordinates. This is RA of the center of the cone in degrees.
     
  dec [double]
    Declination of cone center (degrees).
     
  radius [double]
    This is the radius in degrees of the acceptance cone if the acceptance
cone was set to "yes".
     
  (emin = 30) [double]
    Minimum event energy (in MeV) to include in the simulation. This is a hidden parameter. (default: 30 MeV)
     
  (emax = 2e5) [double]
    Maximum event energy (in MeV). This is a hidden parameter.
(default: 200000 MeV)
     
  (edisp = yes)
    Energy dispersion. If this flag is set to "yes", the energy dispersion will be applied to the incoming photons. If this flag is set to "no", a diagonal response is applied, and the ENERGY column equals the input or simulation value. This is a hidden parameter. (default: yes)
     
  irfs [string]
    Instrument response functions. To turn off the irfs (i.e., to use infinite angular and energy resolution), set this parameter to "none". The effective area will be independent of energy and will be given by the area parameter.
     
  (area = 1) [double]
    Effective area (square meters) used for simulations without irfs.
     
  (maxrows = 200000) [int]
    Maximum number of rows that each file generated by gtobssim will contain. This is a hidden parameter. (default: 200000)
     
  seed [int]
    Random number seed for the simulation.
     
  (chatter)
    This parameter fixes the 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. 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)
    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)
     

Last updated by: Chuck Patterson 06/09/2011