NOTE: This task is not supported for scientific analysis. Please use the 'batbinevt' task to sum survey DPHs.
This tool sums up detector by detector and energy bin by energy bin, the user specified rows in an input BAT Detector Plane Histogram (DPH) to produce a single summed DPH. The user can specify any set of rows in the input DPH to be summed. The GTI extension of the output DPH contains the times of the rows that were actually summed.
The number of rows in the corresponding GTI extension of the new FITS file depends on the number of rows specified. The GTI START value of each GTI extension row is the start time of the corresponding selected row. The stop time of that row is the start time + the EXPOSURE value of the corresponding row in the original BAT_DPH extension. The EBOUNDS extension is copied "as is" to the new file.
Any specified rows not in the infile BAT_DPH extension are ignored.
The generation of the output file will fail if the file is too large to fit the available memory.
The following examples illustrate how the program can be executed to generate a new FITS file as described above.
1. Add DPH_COUNTS in rows 1 and 3 and generate a new BAT_DPH extension with a single row and a corresponding GTI extension with two rows and new START and STOP values. The new FITS file also contains the entire EBOUNDS extension from the infile.
batsumdph infile.dph sumfile.dph rows="1,3" clobber="Yes" chatter=12. Add DPH_COUNTS in row ranges 1-3, 5-7 and generate a new BAT_DPH extension with a single row and a corresponding GTI extension with the total number of rows within the specified ranges. Any rows not in the original infile are ignored in the summing of the DPH_COUNTS and in the GTI extension. The START and STOP values are computed from the specified rows existing in the original infile. As in example one the new FITS file also contains the entire EBOUNDS extension from the infile.
batsumdph infile.dph sumfile.dph rows="1-3,5-7" clobber="Yes" chatter=1