******************************************************************************** RELEASE NOTES FOR HEASOFT 6.19 May 11, 2016 ******************************************************************************** The HEASoft 6.19 release is primarily driven by updates to the NuSTAR software and the first public release of analysis software for the Hitomi mission, but also includes updates to other packages which have been revised to mirror the current development versions in use at the HEASARC. As before, configuration-related changes thoughout the package means that users who already have HEASoft v6.x.x installed will need to completely replace their software installation; there is no clean way to simply overlay this new release or to update an existing installation. ******************************************************************************** CFITSIO ******************************************************************************** HEACORE: - CFITSIO: Version 3.39: - Added new routines suggested by Eric Mandel (CFA): 1) ffhisto3 is similar to ffhisto2, except that it does not close the original file. 2) fits_open_extlist is similar to fits_open_data except that it opens the FITS file and then moves to the first extension in the user-input list of 'good' extensions. - In ffpsvc and ffprec, it is necessary to treat CONTINUE, COMMENT, HISTORY, and blank name keywords as a special case which must be treated differently from other keywords because they have no value field and, by definition, have keyword names that are strictly limited in length. - Added the Fortran wrapper routines for the 2 new string keyword reading routines (FTGSKY and FTGKSL), and documented all the routines in the FITSIO and CFITSIO users guides. - In ffinttyp, added explicit initialization of the input 'negative' argument to 0. - Added new routine to return the length of the keyword value string: fits_get_key_strlen / ffgksl This is primarily intended for use with string keywords that use the CONTINUE convention to continue the value over multiple header records, but this routine can be used to get the length of the value string for any type keyword. - Added new routine to read string-valued keywords: fits_read_string_key / ffgsky This routine supports normal string keywords as well as long string keywords that use the CONTINUE convention. In many cases this routine may be more convenient to use then the older fits_read_key_longstr routine. - Changed the prototype of fits_register_driver in fitsio2.h so that the pointer definition argument does not have the same name as the pointer itself (to work around a bug in the pgcc compiler). - Added the missing FTDTDM fortran wrapper definition to f77_wrap3.c. - Modified Makefile.in and configure.in to add LDFLAGS_BIN for task linker flags, which will be the same as LDFLAGS except on newer Mac OS X where an rpath flag is added. - Modified Makefile.in to add a new "make utils" command which will build fpack, funpack, cookbook, fitscopy, imcopy, smem, speed, and testprog. These programs will be installed into $prfix/bin. - Fixed a bug when attempting to modify the values in a variable- length bit ("X") column in a binary table. - Reinstated the ability to write HIERARCH keywords that contain characters that would not be allowed in a normal 8-character keyword name, which had been disabled in the previous release. ******************************************************************************** FUTILS ******************************************************************************** - fverify: Fixed one-line summary in batch (file list) mode. fverify was erroneously reporting one-line summary success for files which actually should have failed. ******************************************************************************** HEASARC ******************************************************************************** - extractor: Read in the DETNAM keyword from the input event files and include in the keywords written out. Added copying of keywords from the EVENTS extension in the input file into the SPECTRUM extension of the output file. Remove duplicate TELESCOP etc keywords. Fixed bug when writing an event file from multiple input event files using the "slow" method when there are vector columns. ******************************************************************************** HEATOOLS ******************************************************************************** - ftverify: Fixed one-line summary in batch (file list) mode. ftverify was erroneously reporting one-line summary success for files which actually should have failed. ******************************************************************************** XIMAGE ******************************************************************************** - Fixed memory fault that occurred when remapping images with a wide pixel FOV (on the order of 864x864 pixels) and a dense photon distribution (i.e. something such as a 1536x1536 image with a rebin scale of 16). - ximage.mdb: Added instrument definition for Hitomi. ******************************************************************************** XSELECT ******************************************************************************** - Improved diagnostic output and changed to handle tabs in xselect.mdb. Modified so that select chip will work for any mission and instrument which has ccol set in the xselect.mdb. Only in the case of Chandra and XMM will it check for the chip(s) selected to be within the valid range. Added HITOMI entries to xselect.mdb. ******************************************************************************** XSPEC ******************************************************************************** HEASoft 6.19 includes Xspec v12.9.0n (patch level "n"): http://heasarc.gsfc.nasa.gov/xanadu/xspec/issues/issues.html ******************************************************************************** XSTAR ******************************************************************************** Version 2.31 - updates since v221bn26 (HEASOFT 6.18) include: An error affecting the use of the optical depths and escape probabilities in the continuum escape from 2-sided models was fixed. An error in the atomic data (statistical weights) for the upper levels of N VI n=1-2 lines was fixed. Change to pprint to make line labels for inward and outward emission consistent. Updates to version 2.3 which fix the compton heating error found in 10/2015. ******************************************************************************** NUSTAR ******************************************************************************** - Updates for NuSTARDAS 1.6.0: Please note that this version requires NuSTAR CALDB dated 2016 03/15 or newer and will not work with older versions of the CALDB. Major changes introduced in this version: nusplitsc (NEW TASK): When the primary star tracker (also known as a camera head unit, or CHU) is blinded by the Earth limb or glint from the Sun the data is recorded in 'Mode 06' by the pipeline. In this mode the pipeline uses the spacecraft start rackers (CHUs 1, 2, and 3) to determine the sky position of each count. This sky position can be subtly different when different combinations of star trackers are guiding the observatory pointing, resulting in blurring of the output image. nusplitsc allows the user to generate separate independent output files for each CHU combination, each of which should have reduced blurring and higher fidelity. We note that the absolute position of these images may still be different than the Mode 01 data set and do not recommend using RA/DEC coordinates when extracting produces in these modes without first inspecting the images. See the Observatory Guide as well as Walton et al. (2016) and Grefenstette et al. (2016) for more details. - nucalcsaa: The SOC has optimized new algorithms to automatically generate GTIs that exclude regions of the orbit that produce enhanced background counts in the detector. See the Observatory Guide for a full description of these new modes and their effects. - nupipeline: New options to accomodate the nusplitsc and nucalcsaa tasks. Added optional call to the new 'nusplitsc' module (parameter 'runsplitsc', set to 'no' by default) and modified the call to 'nucalcsaa' from nupipeline. - nuflagbad: Minor bug fix to exclude hot pixels in the output badpixel file (nu*_bp.fits) in case of reprocessed files; - nuscreen: Addition of a new keyword (OBSMODE) storing the NuSTAR observing mode to the output cleaned event files; - nufilter: Addition of the keywords MJDREFI and MJDREFF in the output filter (nu*.mkf) file; - nucoord: Value update of the RA_NOM and DEC_NOM keywords in the +0 and +6 extension of unfiltered event files. ******************************************************************************** SWIFT ******************************************************************************** UVOT: - uvotcentroid: Allow sexigesimal position in region file. Correct typo in variable name (was mixing ccord (wrong) and coord. - uvotproduct: Modified to use swifttime when converting between MET and UTC and updated labels to reflect that. - uvotscreen: Update GTI and WINDOW extensions to reflect screening.