NAME

    gtmodel - Creates a model counts map based on a binned likelihood fit.

USAGE
    
    gtmodel srcmaps srcmdl outfile irfs expcube bexpmap


DESCRIPTION

This tool is used to facilitate comparisons between the data and model
predictions. It is recommended to read the gtlike help for more
explanations. gtmodel creates a model map of a region based on the fit
parameters. This map is effectively an infinite-statistics counts map
of the region-of-interest based on your model fit.  The gtmodel
application reads in the fitted model, applies the proper scaling to
the source maps, and adds them together to get the final map.  Before
running this tool you should run gtsrcmaps (see the gtsrcmaps help for
more information).


PARAMETERS

srcmaps [file]
FITS file containing the individual source model components that have
been convolved through the instrument response using gtsrcmaps.
 	 	 
srcmdl [file]
XML file containing the source model definitions. The format of this
file is the same used by gtlike (see the gtlike help). The source
model could be generated by the ModelEditor utility (recommended) or
by following source model templates. See the ModelEditor help for
further explanation.
 	  	 	 
outfile [file]
Name of the output FITS file that will contain the generated counts map.
 	 	 
irfs [string]
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 event class. Since the LAT
will usually survey the sky, a source will be observed at different
inclination angles. Each count will therefore be characterized by a
different instrument response function (IRF).
 	 		 	 
expcube = none [file]
Livetime cube used for computing source maps "on-the-fly", i.e., when
using a counts map that has not been processed by gtsrcmaps as the
srcmaps file.  This file should be generated by gtltcube. See the
gtltcube help for further explanation.
 
bexpmap = none [file]
Binned exposure map for on-the-fly source map calculations. If the
existing file is specified, that file will be used as the exposure
map. Otherwise, a map with that name will be computed based on the
energy bands in the srcmaps file. If "none" is given, the map will be
called "binned_exposure.fits".
 
(convol = yes) [bool]
Perform the convolution of the model maps with the PSF. This is
applies only for on-the-fly source map calculations.
 
(resample = yes) [bool]
Resample input counts map for convolution.

(rfactor = 2) [integer]
Resampling factor.

(binsz = 0.25) [double]
Fixed pixel size of internal model map.

(chatter = 2)    
Output verbosity. This is a hidden parameter. The default value is 2.

(clobber = yes) 
If true, an existing file of the same name will be overwritten.

(debug = no)
Activate debugging mode. This is a hidden parameter. The default value
is "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. The default value is "no".

(mode = ql) 
Mode of automatic parameters. This is a hidden parameter. The default
value is "ql".


EXAMPLES

Parameters are passed following the FTOOLs model. They can be passed
answering from a prompt, as a list in a command line, or by editing
the parameter file.
 
To be prompted interactively by gtmodel simply type in the command line: 

> gtmodel

You will be prompted for parameter values. Beware that not all
parameter are prompted. Some of them are "hidden".  If you want to
change one of the "hidden" parameter you should specify the values in
the command line. For example, to prevent a file from being overwritten
set the parameter "clobber=no", e.g.:
 
>gtmodel clobber=no

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

> gtmodel
Source maps (or counts map) file[]  srcMaps.fits
Source model file[] src_model.xml
Output file[] model_map.fits
Response functions[] P6_V3_DIFFUSE
Exposure cube[] expCube.fits
Binned exposure map[none] bexposure.fits

That last example could be also run in the command line as follows:

>gtmodel srcmaps=srcMaps.fits srcmdl=src_model.xml outfile=model_map.fits
 irfs=P6_V3_DIFFUSE expcube=expCube.fits bexpmap=bexposure.fits


KNOWN BUGS

SEE ALSO

* gtlike

* gtsrcmaps