Dumps information about an observation container into log file or on screen.
This script provides detailed information about a given observation container. For IACT observations usually several observations with different configurations are combined. The script computes e.g. the overall energy range which could be an important input for ctbin to create a suitable energy range. In addition the script prints the pointing attributes like the average zenith/azimuth angle. If the hidden boolean parameter “offset” is specified to “yes”, the script queries for the target position and computes the run-by-run offset as well as its average. In the observation summary, the time range of the observations including total ontime and (dead-time corrected) livetime is shown.
The script further contains the hidden parameter “ds9file”. If specified with a file name, the tool writes out a ds9 region file including a cross for each pointing position in the sky.
When executed from within python, the script provides methods to return arrays containing observation-wise parameters. This might be useful for graphical display within a script. The following methods are implemented: - zeniths (returning all zenith angles) - azimuths (returning all azimuth angles) - offsets (returning all offset angles, provided the hidden parameter offset=yes) - ebounds (returning energy boundaries) - gtis (returning good time intervals)
chatter = 0: no information will be logged
chatter = 1: only errors will be logged
chatter = 2: errors and actions will be logged
chatter = 3: report about the task execution
chatter = 4: detailed report about the task execution