NAME

    gtltsumsun - Adds together livetime cubes produced by gtltcubesun.

USAGE

    gtltsumsun infile1 infile2 outfile

DESCRIPTION

    This tool facilitates multi-epoch analyses by summing the livetime
    contributions from each of two or more user specific input files
    and merges their GTI extensions. It checks to ensure that the
    input data sets are based on compatible HEALPix projection before
    they are summed. HEALPix is an acronym for Hierarchical Equal Area
    isoLatitude Pixelization (http://healpix.jpl.nasa.gov/). This is
    the only consistency check that is made between files. The input
    livetime cube files could be generated by gtltcubesun (see the
    gtltcubesun help).

PARAMETERS

    infile1 [filename]
    This is the name of the first livetime cube file or an ASCII file
    containing a list of livetime cube files, prepended with an "@"
    sign.  The livetime cube file could be generated by gtltcubesun (see
    the gtltcubesun help).

    infile2 [filename]
    This is the name of the second livetime cube file. It will be prompted
    for only if the first file is also a livetime cube file (i.e., not a
    list of files).

    (table = EXPOSURE) [string]
    Name of the extension containing the livetime.

    (table2 = WEIGHTED_EXPOSURE) [string]
    Name of extension containing livetime.

    outfile [filename]
    Output FITS file name.

    (chatter = 2) [integer]
    This parameter fixes the output verbosity: no screen output (0),
    nominal screen output (2), maximum verbosity (4).


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

    (debug = no) [boolean]
    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) [boolean]
    Graphical user Interface (GUI) mode activated if "yes" is specified.

    (mode = ql) [string]
    Mode of automatic parameters: "h" for batch, "ql" for interactive.

EXAMPLES

    Parameters are passed following the FTOOLS model. They could be passed
    answering from a prompt, as a list in a command line, or by editing
    the parameter file.

    To be prompted for gtltsumsun simply type in the command line:

    > gtltsumsun

    You will be prompted for parameter values. Beware that not all
    parameters are prompted for; some of them are "hidden".  If you want to
    change one of the "hidden" parameters you should specify the value on
    the command line. For example if you do not want to overwrite an
    existing file you should type in the command line:

    > gtltsumsun clobber=no

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

    > gtltsumsun
    Livetime cube 1 or list of files [] : expCubeSun_000001.fits
    Livetime cube 2 [none] : expCubeSun_000002.fits
    Output file [] : expCube.fits

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

    >gtltsumsun infile1=expCubeSun_000001.fits infile2=expCubeSun_000002.fits \
     outfile= expCube.fits

SEE ALSO

     gtltcubesun

     gtexphpsun

     gtsuntemp
