********************************************************************************
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.