List of Suzaku FTOOLS Version 9
Available as part of HEAsoft 6.5
Updated 2008 July 31
NOTES:
- Version 9 includes a bug fix for
xispi.
- Version 8 includes an update of
ray-tracing library, compatible with an upcoming release of
new CALDB files, and bug fixes.
- Version 7 includes new tools
xisnxbgen, xis5x5to3x3, and aemkpinudhk,
and bug fixes, notably for hxdpi and xissimarfgen
- Version 6 includes bug fixes for
aeattcor, xissimarfgen, xistime,
and hxdtime. Otherwise, it is identical with
Version 5.
- New in Version 5: All tasks support direct
CALDB query - that is, calibration data can be retrieved from the
CALDB without specifying the explicit path to the specific calibration
file, by typing "CALDB."
All general tasks (aeaspect, aeattcor, aebarycen, aecoordcalc, aemkehk, and aetimecalc) search the leap second file in the Heasoft data directory if leapfile=AUTO
- Updated in Version 5: HXD well event file
format has been updated in Version 2 processing. Several tools
require this new format. A script is available for converting
Version 1.X processed HXD event data to Version 2 format.
General tools
- aeattcor (New in Version 5; bug fix in Version 6)
- Corrects Euler angles in attitude file for the "thermal wobbling." A bug in calculating the SGM_YOFF keyword was corrected in Version 6.
- aebarycen (Updated in Version 8)
- Applies Barycenter correction to Suzaku EVENT and/or HK files; now ignores TIME=0.0.
- aeaspect (Updated in Version 5)
- Calculates mean satellite Euler angles for Suzaku. Now copies the NOM_PNT keyword from attitude file.
- aecoordcalc
- Coordinate Calculator for Suzaku.
- aemkehk (Updated in Version 5)
- Creates an extended HK file from attitude and orbit files. Now adds "COR2" column in output .ehk file (new ridigity CALDB file required, to be specified via the new parameter "rigidty"); quits immediately if no orbit or attitude information is available;
- aemkreg
- Generates a ds9 format region file for given satellite Euler angles. Rough XIS and HXD fields of view are drawn by default.
- aetimecalc
- Mission Time Calculator for Suzaku.
- mkphlist
- Photon list generator - to be used as first stage of ray-tracing simulations. Output file now includes a GEOMAREA keyword.
- suzakuversion
- Reports the version string for headas/suzaku package.
HXD specific tools
Tools used in processing of WELL data
- hxdgrade (Updated in Version 7)
- Fills the GRADE column for the WELL FITS; works on Version 2 format files and adds a new DET_TYPE definition since Version 5. Bug fix in Version 7 for when an input file has no NEVENTS keyword in the GTI extension.
- hxdpi (Updated in Version 7)
- Fills the HXD PI columns for the WELL FITS; works on Version 2 format files and uses GSO GHT calibration file since Version 5. Version 7 fixes a critical bug in calculating the PI values of GSO data at the 2-3% level.
- hxdscltime
- Fills the TIME column for the HXD HK FITS (using SCLTIME and TI)
- hxdtime
- Fills the TIME column for the WELL FITS (using WELTIME and TI); works on Version 2 format files since Version 5. Bug in the treatment of DP clock wraparound was fixed in Version 6.
- hxdmkgainhist
- Creates the FITS gain history files using outputs from hxdmkgainhist_gso and hxdmkgainhist_pin; works on Version 2 format files since Version 5.
- hxdmkgainhist_gso
- Calculates gain history for HXD WELL_GSO; used with hxdmkgainhist
- hxdmkgainhist_pin
- Calculates gain history for HXD WELL_PIN; used with hxdmkgainhist
Tools used in processing of WAM data
- hxdwambstid
- Fixes the time information and saves the burst ID information into a file.
- hxdbsttime
- Fills the BST_FRZD_TM keyword in the header of the BURST FITS; reads bstidt file and uses Version 2 format.
- hxdmkwamgainhist
- Produces a gain history file for the TRANSIENT FITS
- hxdwamgrade
- Fills the GRADE column for the WAM FITS
- hxdwampi
- Applies gain correction to the WAM FITS.
- hxdwamtime
- Fills the TIME column for the WAM FITS
- hxdmkbstlc
- Makes light curves of burs events detected by WAM.
- hxdmkbstspec
- Calculates spectra from the burst data.
- hxdmkwamlc
- Makes light curves of WAM events
- hxdmkwamspec (Bug fix in Version 8)
- Makes spectra of WAM events; Version 8 corrected a bug in how exposure was calculated when TIME_MODE=0.
HXD Analysis Tools
- aemkpinudhk (New in Version 7)
- Calculate PINUD count used for non X-ray backgroung estimation from HXD HK files.
- hxdarfgen (Bug fix in Version 8)
- Generates the HXD "arf" files of PINs that correct for off-axis response. The parameter file (hxdarfgen.par) was corrected in Version 8, which previously lacked some parameters.
- hxddtcor
- Applies dead-time correction to the EXPOSURE keywords of PHA files. Now supports multiple files via the @filename syntax.
- hxdgtigen (Updated in version 7)
- Provides GTI to avoid telemetry saturation. Now also excludes time intervals when data transfer from HXD Analog Electronics (HXD-AE) to Digital Electronics (HXD-DE) is saturated. In version 7, a new parameter fifo_full was added.
XIS specific tools
Processing Tools
- xiscoord (Updated in Version 5)
- Calculates the ACT, DEC, FOC and sky X/Y for XIS event files. Starting with Version 4, this tool supports query to CALDB files, can handle cleaned event files. Now fills with blanks if coordinate conversion fails; uses ACTY=511 for PSUM mode data; and has a new parameter, ignore_frames.
- xisgtigen (Updated in Version 5)
- Checks for XIS telemetry saturation and jumps in the frame time and writes a GTI file. Now supports PSUM mode event files and has a new paramter, ignore_frames.
- xispi (Bug fix in Versions 9 and 8; Updated in Version 5)
- Calculates the XIS PI and grade values from PHAS. Now supports data taken with Spaced-row Charge Injection (SCI), when combined with an appropriate calibration file, as well as PSUM mode data. Note there are new and removed parameters starting with Version 5. Bug fix in Version 8 now allows xispi to retrieve appripriate CALDB file when processing files contain long time periods. This bug did not affect normal science data, but affected the processing of NXB event files. Bug fix in Version 9 eliminates the excessive overhead (earlier version was accessing the CALDB many times unnecessarily).
- xisputpixelquality (Updated in Version 5)
- Puts pixel quality code (PIXEL_QUALITY or STATUS) for each XIS event, now including additional bits for SCI and window boundary. Note that there are two new parameters, ignore_frames and enable_scipixq.
- xistime (Updated in Version 5; bug fix in Version 6)
- Time assignment for Burst mode, PSUM mode or Window Option. The time assignment for Window option has been updated in Version 5. Now updates columns in GTI, FRAMES, EXPOSURES, and LOSTAREAS extensions, and time related keywords. Note that there are two new parameters, ignore_frames and gapsec. Bugs in the treatment of DP clock wraparound and in the PSUM mode time assignment were fixed in Version 6.
- xisucode (Updated in Version 5)
- Assigns the micro-code related keywords. Now writes SCI related keywords when used with new ucodelst calibration file. This tool has been rewritten in C and there is no longer an associated .par file.
Analysis Tools
- xis5x5to3x3 (New in version 7)
- Converts XIS 5x5 mode event files (EDITMODE='5x5') into 3x3 mode format (EDITMODE='3x3').
- xiscontamicalc (updated in version 3)
- Calculates the carbon column density and transmission of the XIS OBF contaminant at specified time, detector position, and energy. Starting with version 3, users can multiply an input ARF file by the time-variable transmission of the XIS OBF. Read more about this tool
- xisexpmapgen (New in Version 5)
- Calculates a detector mask image that can be used by xissimarfgen, as well asn an exposure map in sky coordinates.
- xisnxbgen (Update in Version 8;New in version 7)
- XIS non-Xray background generator. Version 8 update allows this tool to use WMAP images as regfile (when regino_mode is DETFITS or SKYFITS).
- xisrmfgen (Updated in Version 5)
- Generates time-variable XIS responses. Now supports RMF generation for data taken with SCI (requires new calibration file). Now reads EDITMODE, WINOPT, and CI keywords from the pha file. Note that there are new parameters, editmode, winopt, ci, and enable_scirmf.
- xissim (Updated in Version 8; Updated Version 5)
- Generates a simulated XIS event file for input photon file(s) made by the mkphlist task, by the XRT ray-tracing and the XIS RMF. Version 3 includes a bug fix for the parallax/aberration correction. Also include an on-the-fly photon generation capability. Now fills STATUS column appropriately. It is now (Version 8) compatible with the forthcoming release of CALDB (including the now discontinued June 2 release). The XRT misalignment and scattering parameters have been removed from the parameter file.
- xissimarfgen (Updated in Version 8; Bug fix in Version 7; bug fix in Version 6; updated in Version 5)
- Calculates the ARF by the XRT ray-tracing simulation. Additional parameters (common to those used in xisexpmapgen) have been included. The incorrect behavior for large number (>232) of events was fixed in Version 6. In Version 7, a bug when executed with source_mode=DETFITS option was fixed. It is now (Version 8) compatible with the forthcoming release of CALDB (including the now discontinued June 2 release). The XRT misalignment and scattering parameters have been removed from the parameter file. WMAP image can now be used as source_image (source_mode=DETFITS) and as regfileN (region_mode+DETFITS or SKYFITS).
Other Relevant Software
- addascaspec (Updated in Version 9)
- In the ASCA package; it has been generalized to handle cases with a single .rsp files (previously, it assumed the presence of separate .rmf and .arf files).
- cleansis
- In the ASCA package; it has been generalized to handle Suzaku XIS data as well.
- xselect (Updated in Version 8)
- Sets defaults for Suzaku data via entries in the xselect.mdb file. Starting with Version 8, if the input files are a mixture of 5x5 and 3x3 mode data, the former is converted to latter when running extract on Suzaku XIS event files. This ensures that any output event file is a correct 3x3 file.
If you have any questions concerning Suzaku, visit the Feedback form.