NAME
ixpefilemerge -- Merges a list of IXPE FITS files together
USAGE
ixpefilemerge.py infiles outfile [conflict_method] [clobber]
DESCRIPTION
ixpefilemerge merges 2 or more IXPE FITS files together into a single output file containing the same list of HDU names and types as the inputs. All input files must have the same FILETYPE, and binary tables with matching HDU names must have the same number of columns with the same set of column names. These matching binary tables will be concatenated and sorted in time in the output file. All header keywords and most keyword values are taken from the input file identified by conflict_method, "first" indicating the first file in the infile list, "last" indicating the last file in the list, and "ontime" (applicable only to event files) indicating the file with the largest "ONTIME" value. The values for keywords TSTART, TSTOP, DATE-OBS, DATE-END, ONTIME, LIVETIME, and DEADC are recalculated to represent the merged data.
The accepted filetypes are IXPE evt1, evt2, gti, all HK types, and expmap2. Any other files will be rejected.
PARAMETERS
- infiles* (str)
- A comma-separated list of filenames (command-line), a list of filenames (Python function call), or the name of a file containing the filenames to be merged (one file per line) preceded by the "@" symbol.
- outfile* (str)
- Output fits file name.
- conflict_method (str)
- The method for selecting which file will be used to resolve conficts in keywords or values that differ between input files. Available options are "first", "last", or "ontime".
- clobber (Boolean)
- Overwrite existing output file? (default: no)
EXAMPLES
BUGS
SEE ALSO
LAST MODIFIED
June 2026