forked from fermi-lat/fermitools-fhelp
-
Notifications
You must be signed in to change notification settings - Fork 0
/
gtltsumsun.txt
104 lines (73 loc) · 3.51 KB
/
gtltsumsun.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
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