• Download HEASOFT
  • ********************************************************************************
                             RELEASE NOTES FOR HEASOFT 6.28
                                    August 14, 2020
    The HEASoft 6.28 release is driven primarily by updates to mission-
    specific data analysis software (NuSTAR, Swift), but includes other
    enhancements and fixes.
    As before, configuration-related changes throughout the package mean that
    users who already have HEASoft 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.
    Version 3.49:
    - Fix to imcompress.c.  It now turns off quantization if ZSCALE
      and ZZERO columns are missing.  Treatment will be the same as
      if ZQUANTIZ were set to 'NONE', even if ZQUANTIZ is present
      and set to something else.
    - Added mutex to fits_execute_template() function so that the
      creation of files using ASCII templates will be thread safe.
    - In fpack when using -table flag, replaced warning message with
      a more detailed description mentioning FITS format update.
    - Added flag to CMake builds to disable curl dependency.  Also
      only add CURL_LIBRARIES to CMake link target if curl is found.
    - Minor adjustment to download progress output.
    - Added support for Haiku OS.
    - Bug fix in setLimits functions needed to create objects of
      type ColumnVectorData<unsigned short>
    - Fixed a bug which could cause pha files to have both a keyword and
      column with the same name.
    - Changed read column methods so that they check for a keyword if the
      column is not found rather than the other way round. This avoids a
      possible problem if the extension has both.
    - Efficiency improvements.
    - Added options for start and end channel to grouping::loadOptimal.
    - Fixed a bug in grouping::GroupBin which was not taking into account the
      quality flag.
    - In arf::read check for an EBOUNDS extension to read ENERG_LO and ENERG_HI
      which might occur in a type II file
    - Fixed a bug in rmf::check which incorrectly flagged an error
      if the F_CHAN column had the maximum channel value and the first
      channel was non-zero.
    - Modified the rmf and rmft classes to change from vectors to
      vectors of vectors for the first channel in group, number of
      channels in group, order of group, and matrix elements. This leads
      to a simplification in the code.
     - Added a new version of rmf::addRow which takes the channel group
       information. Added a rmf::substituteRow method which takes a
       compressed format row as input.
    - Changed rmf::normalize to return the vector of normalization
    - Added an rmf::changeFirstChannel method to change the first channel
      value used (usually switching between 0 and 1.
    - Trapped case in table::getValues of there being no overlap between
      the input energy range and the tabulated energy range.
    - addarf: Fixed bug preventing clobber parameter from working
    - dmprmf: Replaced with a wrapper to ftdmprmf (heasptools)
    - fverify: Synchronized with ftverify (improved checking for
      duplicate HIERARCH keywords)
    - addspec: Updated to use ftmarfrmf and ftaddrmf (heasptools)
      instead of marfrmf and addrmf
    - extractor: Fixed bug writing a region extension if the region
      contains shapes with different numbers of points
    - Changes for new internal structure of rmf class.
    - ftaddrmf: Slight efficiency improvement: reduces number of rmf
      object copies by one.
    - ftflx2xsp: Added a first parameter to let the user control the first
      channel number.
    - ftgrouppha: Added option to use minchannel and maxchannel
      parameters with the opt method; modified so if the backfile or
      respfile parameters are set then it writes the appropriate
      keyword values to the output spectrum; added reading background
      and/or response file from the input file if the parameters are
      set to %; also, do not reset the ANCRFILE in the output file.
    - ftrbnrmf: Improved testing and diagnostic information for user
      setting inconsistent input
    - ftrgsrmfsmooth: Fixed bug in reading the image description file.
      Slight efficiency improvement from not copying an rmf object.
    - ftjoin: Minor pattern matching improvements
    - ftmerge: Added support for tables with variable-length arrays
    - ftsort: Changed way that variable columns are checked for
    - Fixed problem with the gisclean command if a filename included an
      environment variable.
    HEASoft 6.28 includes Xspec 12.11.1, a patch release:
    All fixes and enhancements contained in 12.11.0 patches (a-m) are
    included. The following are also included:
    - Added new "show bayes" option to display all non-constant Bayesian
      prior assignments to individual parameters.
    - All Bayesian prior assignments are now properly stored in files
      generated by 'save' command.
    - Added new tclout(r) modnames option to write out model names.
      Added new tclout(r) pfree option to give T/F on whether a parameter
      is free.
      Added new tclout(r) option "tclout modgroups <modname>" which returns
      the data groups associated with a particular model.
    - Modified tclout(r) so it only writes out each model once, not one
      time for each data group to which the model applies.
    - Removed the requirement of a valid fit to perform a "flux error"
      calculation, provided that a proper chain file for the model is
    - Improved the generation of parameters using simpars when parameters
      have widely varying sizes. It is still better in this case to define
      a new model using mdefine which scales the parameter values appropriately.
    - Trapped problem in table models if there is no overlap between the
      response energies and the tabulated energies.
    - Fixed problem that if two different response matrices with the same
      name but in different directories are used then xspec assumes that
      they are the same.
    - Fixed problem that generated an error if the response F_CHAN had
      the maximum channel value and the first channel was non-zero.
    - Fixed bug for corner-case of attempting to fit when response
      parameters are assigned to inactive models.
    See also:
    NuSTARDAS v2.0.0:
    Requirements: NuSTAR CALDB 20200813
    This NuSTARDAS implements a new temperature-dependence during the ARF
    generation that should improve performance in a small number of cases
    for FPMA. The software change is required to account for cases where
    the optic for FPMA is "cold", implying a decrease in the effectiveness
    of the thermal blanketing (MLI) and a corresponding increase in the
    low-energy transmission. This primarily affects observations after 2018.
    This builds on the long-term ARF changes for FPMA documented here:
    The accompany CALDB patch 20200813 contains the temperature-dependent
    corrections and is required for this software version.
    Details on the issue can be found in this paper:
    More details about the MLI correction can also be found here:
    :: Note ::
    This patch requires access to the optics bench housekeeping file
    (obebhkfile). This file is distributed for each observation in the
    "hk" subdirectory from the HEASARC. If an observation is downloaded
    from the HEASARC, as always, we recommend running nupipeline to
    recalibrated the data using the latest CALDB files. This will copy
    the OBEB HK file into the output directory (commonly the "event_cl"
    directory). No further action is required by the user as these input
    files are automatically detected by nuproducts during later analysis
    if they are present in the event_cl directory.
    To call nuproducts directly on the data downloaded from HEASARC
    requires the use of new input keyword: `inobebhkfile'. Details of
    this are described in the software user's guide
    and in the quickstart guide:
    :: Software changes ::
    The major changes introduced in this version are:
    - numkarf: 1) Added temperature dependency for ARF files CALDB query;
      2) Added new 'obebhkfile' input parameter and computation of
      "OPT0_5TEMP" average value.
    - nuproducts: 1) Modified call of numkarf task; 2) Added new
      'obebhkfile' input parameter.
    - nupipeline: 1) Modified call of nuproducts task; 2) Added new
      `inobebhkfile' and `obebhkfile' input parameters.
    - nu_highfits: Modified to support TFORM values '1PD(X)/1PI(X)'.
    - (batgrbproduct) bat-burst-advocate: minor typo fix in filtering
    - (uvotimage) uvotrawevtimg: BUG FIX: update attitude for each new
      event time. The primary impact of this bug was star trails in
      settling images.
    - XRTDAS v3.6.0 (build 36): Modifications to support variable-
      length arrays (TFORM '1PD(X)/1PI(X))' (as are now generated by
    - xrtlccorr: Corrected minor bug in a few error messages
    - xrtgrblcspec: Minor correction to avoid empty channels with small
      gap intervals
    - xenon2fits: Fixed crash
    - pcarsp: Fixed call to ftrbnrmf (no chatter parameter)
    - Miscellaneous updates to support GCC 10 (previously included with
      HEASoft v6.27.2a)


    If FTOOLS has been useful in your research, please reference this site (http://heasarc.gsfc.nasa.gov/ftools) and use the ASCL reference for HEASoft [ascl:1408.004] or the ASCL reference for the original FTOOLs paper [ascl:9912.002]:

    Blackburn, J. K. 1995, in ASP Conf. Ser., Vol. 77, Astronomical Data Analysis Software and Systems IV, ed. R. A. Shaw, H. E. Payne, and J. J. E. Hayes (San Francisco: ASP), 367.

    Web page maintained by: Bryan K. Irby

    HEASARC Home | Observatories | Archive | Calibration | Software | Tools | Students/Teachers/Public

    Last modified: Friday, 14-Aug-2020 11:56:07 EDT