gtsrcmaps Help File

Convolves source model components with instrument response.

Usage: gtsrcmaps scfile expcube cmap srcmdl bexpmap outfile irfs

gtsrcmaps convolves the components of the specified source model with the instrument response for a given observation. This tool is used as part of the Fermi binned likelihood analysis. (See gtlike and gtlike Help.)

The geometry in sky coordinates and energy binning of the output maps match that of the input maps:

• A counts map, created using gtbin.
• A binned exposure map generated by gtexpcube2.

Note: This exposure map can be reused for subsequent analyses of regions that cover the same time range and that use the same energy binning.

Since the source map generation for point sources is fairly quick, and maps for many point sources may use a lot of disk space, it may be preferable to disable the generation of the source maps for point sources at this stage. If a source in the xml model is missing from the input source map file, gtlike will compute the maps on the fly. Note, however, that relying on this mechanism is recommended only for point sources.

To skip generating source maps for point sources, specify "ptsrc=no" on the command line when running gtsrcmaps.

Example: gtsrcmaps

Parameters are passed following the FTOOLs model: by answering from a prompt; as a list in a command line; or by editing the parameter file.

To be interactively prompted for gtsrcmaps parameters, enter (at the command line prompt):
> gtsrcmaps

Note: Not all parameters are prompted: some of the parameter are "hidden". If you want to change one of the "hidden" parameter you should specify its value in the command line. For example, if you want to skip generating source maps for point sources, enter (at the command line): gtsrcmaps ptsrc=no

An example of how to run the tool is shown below:

This example above could also be run from the command line as follows:

> gtsrcmaps scfile=spacecraft_data_file.fits expcube=expCube.fits
cmap= ps_counts.fits srcmdl=src_model.xml bexpmap=bexposure.fits
outfile=srcMaps.fits irfs=P6_V3_DIFFUSE