• Download HEASOFT
  • ********************************************************************************
                            RELEASE NOTES FOR HEASOFT 6.11
                                      June 7, 2011
    The HEASoft 6.11 release is primarily driven by updates to the Swift and
    Suzaku mission software, but also includes updates to several 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.
       - In imcompress.c, removed attempt to free memory that had not been
    Version 3.27 - 3 March 2011
        - added new routines fits_read_str and fits_delete_str which read or
          delete, respectively, a header keyword record that contains a specified 
          character string.
        - added a new routine call fits_free_key_longstr which frees the memory
          that fits_read_key_longstr allocated for the long string keyword value.
        - enhanced the ffmkky routine in fitscore.c to not put a space before the
          equals sign when writing long string-valued keywords using the ESO
          HIERARCH keyword convension, if that extra character is needed to
          fit the length of the keyword name + value string within the 80-character
          FITS keyword record.
        - made small change to fits_translate_keyword to support translation of
          blank keywords (where the name = 8 blank chracters)
        - modified fpack so that it uses the minimum of the 2nd, 3rd, and 5th order
          MAD noise values when quantizing and compressing a floating point image.
          This is more conservative than just using the 3rd order MAD value alone.
        - added new routine imcomp_copy_prime2img to imcompress.c that is used by
          funpack to copy any keywords that may have been added to the primary
          array of the compressed image file (a null image) back into the header of 
          the uncompressed image.
        - enhanced the fits_quantize_float and fits_quantize_double routines in
          quantize.c to also compress the tile if it is completely filled with
          null values.  Previously, this type of tile would have been written 
          to the output compressed image without any compression.
        - enhanced imcomp_decompress_tile to support implicit datatype conversion
          when reading a losslessly compressed (with gzip) real*4 image into an
          array of real*8 values.  
    Version 3.26 - 30 December 2010
       - defined 2 new macros in fitsio.h:  
           #define CFITSIO_MAJOR 3
           #define CFITSIO_MINOR 26
         These may be used within other macros to detect the CFITSIO
         version number at compile time.
       - modified group.c to initialize the output URL to a null string in 
         fits_url2relurl.  Also added more robust tests to see if 2 file
         pointers point to the same file.
       - enhanced the template keyword parsing code in grparser.c to support
         the 'D' exponent character in the ASCII representation of floating
         point keyword values (as in TVAL = 1.23D03).  Previously, the parser
         would have writen this keyword with a string value (TVAL = '1.23D03').
       - modified the low-level routines that write a keyword record to a FITS 
         header so that they silently replace any illegal characters (ASCII 
         values less than 32 or greater than 126) with an ASCII space character.
         Previously, these routines would have returned with an error when
         encountering these illegal characters in the keyword record (most commonly 
         tab, carriage return, and line feed characters).
       - made substantial internal changes to imcompress.c in preparation for
         possible future support for compression methods for FITS tables analogous
         to the tiled image compression method.
       - replaced all the source code in CFITSIO that was distributed under the
         GNU General Public License with freely available code.  In particular,
         the  gzip file compression and uncompression code was replaced by the
         zlib compression library.  Thus, beginning with this version 3.26 of
         CFITSIO, other software applications may freely use CFITSIO without
         necessarily incurring any GNU licensing requirement.  See the
         License.txt file for the CFITSIO licensing requirements.
       - added support for using cfitsio in different 'locales' which use a
         comma, not a period, as the decimal point character in ASCII 
         representation of a floating point number (e.g., France).  This
         affects how floating point keyword values and floating point numbers
         in ASCII tables are read and written with the 'printf' and 'strtod'
       - added a new utility routine called fits_copy_rows/ffcprw that copies
         a specified range of rows from one table to another.
       - enhanced the test for illegal ASCII characters in a header (fftrec) to
         print out the name of the offending character (e.g TAB or Line Feed) as
         well as the Hex value of the chracter.
       - modified ffgtbc (in fitscore.c) to support nonstandard vector variable
         length array columns in binary tables (e.g. with TFORMn = 2000PE(500)').
       - modified the configure file to add "-lm" when linking CFITSIO on
         Solaris machines.
       - added new routine, fits_get_inttype, to parse an integer keyword value
         string and return the minimum integer datatype (TBYTE, TSHORT, TLONG, 
         TLONGLONG) required to store the integer value.
       - added new routine, fits_convert_hdr2str, which is similar to fits_hdr2str
         except that if the input HDU is a tile compressed image (stored 
         in a binary table) then it will first convert that header back to 
         that of a normal uncompressed FITS image before concatenating the header
         keyword records.
       - modified the file template reading routine (ngp_line_from_file in 
         grparser.c) so that it ignores any carriage return characters (\r)
         in the line, that might be present, e.g. if the file was created on a 
         Windows machine that uses \r\n as end of line characters.
       - modified the ffoptplt routine in cfileio.c to check if the PCOUNT
         keyword in the template file has a non-zero value, and if so, resets
         it to zero in the newly created file.
       Bug Fixes
       - fixed a bug when uncompressing floating-point images that contain Nan
         values on some 64-bit platforms.
       - fixed a bug when updating the value of the CRPIXn world coordinate
         system keywords when extracting a subimage from larger FITS image,
         using the extended CFITSIO syntax (e.g.  myimage[1:500:2, 1:500:2]).
         This bug only affects casee where the pixel increment value is not
         equal to 1, and caused the coordinate grid to be shifted by between
         0.25 pixels (in the case of a pixel increment of 2) and 0.5 pixels
         (for large pixel increment values).
       - fixed a potential string buffer overflow error in the ffmkls routine
         that modifies the value and comment strings in a keyword that uses
         the HEASARC long string keyword convention. 
       - fixed a bug in imcompress.c that could cause programs to abort on
         64-bit machines when using gzip to tile-compress images.  Changed
         the declaration of clen in imcomp_compress_tile from int to size_t.
    - Add parsing support for + and - at end of parameter names. These are
      interpreted as yes and no, i.e. parameter+ means the same as parameter=yes.
    - Fix bug in which a default parameter value of " " (single space) was
      truncated when the par file was saved (ftlist).
    - Check for ambiguity in parameters entered on the command line: allow
      partial matching when there is no ambiguity, or return a non-zero status
      when there is.
    - Update the lookup table for converting Ape error codes to PIL codes.
    - Fixes from Allyn Tennant for the SCR command so that it doesn't close
      then reopen the plot device. This allows multipage PS plots when calling
      PLT repeatedly with SCR included in the command list.
    - Bug fix from Allyn Tennant for SET LENGTH command - was incorrectly
      limiting the length to 80 characters.
    - tristarid: Fixed an error in the ordering of values transferred from
      columns in the input file to the output.
    - genrsp: Fixed a bug when energies are read from resp_file: the
      first ENERG_LO value was erroneously set to the highest energy,
      not the lowest.  Added improved diagnostics for user error.
    - rbnrmf: Added check for THRESH=0 in RBN_ERMF to avoid memory fault.
    - fverify: Modified to conform to latest version 3 of the FITS Standard.
      updated the list of error and warning conditions in the help file
    - Fix WCS projection for vector image column.
    - barycorr: Updated fkeypar -> ftkeypar; fkeyprint -> ftlist;
      fparkey / fmodhead -> fthedit to get around path length restrictions
      in the old futils. Also fixed a bug that was preventing the copying
      of RA_NOM, DEC_NOM, and PLEPHEM from the axBary temporary outfile.
    - rebingausslc: BUG FIX: time filtering was not working properly,
      now fixed. BUG FIX: now works when INDEF specified for only one of
      tstart/tstop. BUG FIX: first input time bin was sometimes lost, now kept.
    - swco.dat: valid through 2011Apr28 at 12:13:45.995UTC
    - extractor: Added new parameter adjustgti which can be used to
      line up the output GTIs with CCD frame boundaries.  Fixed bug
      when creating WMAP in image coordinates when combining event
      files with different image WCS.  The correction to a single WCS
      was not being made for the WMAP.
    - getocctimes [NEW]: Calculate the occultation times of a
      source as seen from an orbiting observatory due to the Earth
      blocking the source.  This task presently functions with
      orbit files only from the Suzaku mission.
    - mathpha: Changed the defaults for properr and errmeth to 'no'
      and 'POISS-0' for best practice with modern spectra.  Modified
      description of calculation and propagation of errors in the
      help file so that best practice is recommended.
    - pileest [NEW]: Creates an estimated pileup fraction image from
      an event file.
    - ftcoco: Allow infile='' to mean infile=NONE  (for WebHERA); Default
      chatter=2 to enable console output.
    - ftimgcalc: BUG FIX: subtle memory access bug fixed.
    - ftkeypar: Modified to not return an error if the keyword does not exist,
      to more closely mimic the behavior of the fkeypar task.
    - ftstat: Removed NULLs before computing median, and added median to
      parameter file output.
    - ftverify: Modified to conform to latest version 3 of the FITS Standard.
    - Added an adjustgti=yes entry for Swift XRT so that extractor
      output GTIs will be aligned to frame boundaries.  Added code to
      pass to extractor the setting of the adjustgti parameter.
    This release includes Xspec 12.7.0.  
    Please see the Xspec Issues/Patches web page for updates beyond v12.7.0:
    * New features in v12.7.0:
      The primary new feature of 12.7.0 is the addition of the Python
      module, PyXspec v0.9 beta.  PyXspec is built and installed by default
      on most platforms along with the regular XSPEC build, and simply
      requires an "import xspec" statement to load into Python. XSPEC can
      now be run from object-oriented Python scripts, or interactively
      from a Python shell prompt. Detailed instructions can be found in 
      While most features of standard XSPEC are already supported in this
      beta release, some still remain to be implemented.  Please let us know
      if any missing feature is of particular importance to you, or if you
      have suggestions and ideas for improvement.
    * Other new features:
      - New models:
          cplinear: Piecewise linear non-physical background model for
             low-count spectra developed for Chandra by Patrick Broos.
          eqpair, eqtherm, compth: Paolo Coppi's hybrid hot plasma emission
          vvapec, bvvapec: APEC models allowing all 30 elemental abundances
             to vary (for use with AtomDB 2.0).
          zigm: Multiplicative model, computes the mean attenuation of the
             optical/UV spectrum by the intergalactic medium.
          zashift, zmshift: Convolution models for applying redshifts to
             additive and multiplicative models respectively.
          Also note that the default APEC model data files have been updated
             to AtomDB 2.0. This version of AtomDB includes contributions
             from more elements than earlier versions. When using the apec
             and vapec models these extra elements have Solar abundance by
             default. To change this use "xset APEC_TRACE_ABUND".
      - The 'statistic' command may now be applied to individual spectra.
        This makes it possible to simultaneously fit spectra which require
        different fit statistics.
      - Added the 'pgstat' option to the statistic command. This is similar
        to using 'cstat' with a background file except that the background
        is assumed to have Gaussian statistics (not Poisson) read from a
        STAT_ERR (and optionally SYS_ERR) column.
      - Modified the pileup model for consistency with Sherpa and ISIS.  A
        new parameter 'fracexpo' is added which should be set to the FRACEXPO
        keyword value in the ARF.
      - It is now possible to choose proportional or fixed fit deltas from
        the startup Xspec.init file.  The initial default setting is now
        proportional deltas rather than fixed deltas.
      - Improvements made to the output generated during a fit.  The
        parameter names are listed at the top of columns, not just their
        numbers.  Column alignment has been improved, and is no longer 
        limited to a maximum width of 5 columns.
      - Added reporting of the Bayesian contribution (if any) to the fit
        statistic output.
    * Enhancements previously released as patches to 12.6.0:
      - Initpackage now recognizes and builds files with .f03 extensions for
        Fortran 2003, and .f90 extensions for Fortran 90.
      - Added a new 'fakeit' option for setting the fake background exposure
      - Added a new 'tclout version' option for returning the XSPEC version
      - Improved XSPEC's internal update mechanism to reduce the number of
        model calculations.
    * All bug fixes to v12.6.0 released as patches a - ab are included in
      v12.7.0.  In addition the following problems have been corrected:
      - A crash occurred if 'tclout notice energies' was performed on a
        spectrum containing only a dummy response with no channels.
      - The 5 redundant 'xset' options (those which merely duplicate other
        existing XSPEC commands) weren't passing their arguments to the
        command handlers correctly.
      - Fit error messages were misleading for the case where the data was
        missing a suitable response, or when the only existing models were
      - A fatal error could occur in 'fakeit' when attempting to generate a
        background file while only a dummy was used for the response.
      - The 'bayes' command handler was not properly handling the case where
        the prior type option string was abbreviated.
      - A crash occurred when 'flux' was run in error mode and the specified
        energy was entirely outside the range of one or more spectra.
    Version 2.2.1bg - updates since HEASOFT 6.10 include:
      * Changes committed to reflect new atomic data from Mike Witthoeft
        for K shells of Ne, Mg, Si, S, Ca, Ar, plus modifications to code
        to allow better xstarv1 comparisons.
      * Changes to database to include DR from metastable levels of 3rd
        row iron ions.
      * Fixes errors in data file for indexing of k vacancy levels in
        iron l shell ions.
    ========================== MISSION-SPECIFIC SOFTWARE: ==========================
    - faxbary: Fixed bug with timezero not being added to tstart/tstop.
    - xpcaarf: (v3.9) Revision to geometric areas in parameter file.
    Version 18 - Changes since HEASoft v6.10:
    - aeattcor2 [NEW]: Creates a corrected Suzaku attitude file based on
      mean event positions as a function of time. The output is to be used
      in pileest.
    - hxdwampipeline [NEW]: HXD-WAM reprocessing and product generation tool.
    - hxdbstjudge [UPDATE]:
      * Implemented new method of burst detection based on HETE-2 trigger method.
      * Implemented method to detect source occultation signature (step method).
      * Added the output burst table in FITS.
      * Added new parameters:
        bgd_early_gap [int] : Gap in seconds between 'early' background interval
           and foreground interval.
        bgd_late_gap [int] : Gap in seconds between foreground interval and
           'late' background interval.
        det_alg [string] : Burst detection algorithm. Allowed values are HETE2,
           GINGA, and STEP. The default is GINGA.
        outtype [int] : Output file type. 0 = FITS table, 1 = ASCII text table.
        use_trigger_set [bool] : Whether to use "trigger set" or not. If set,
           a predefined set of input triggers are used.
        trigger_set [string] (SHORT|MEDIUM|LONG) : HETE2 type trigger set:
           short, medium and long
    - hxdmkwamlc [UPDATE]:
      * Fix several keyword in the header of the lightcurves
      * Added support for GTI in input event file
      * Added FRACEXP and DEADC columns in the output file
    - hxdarfgen: Fix the help file.
    - xiscontamicalc: Added support for new contamination file.
    - batbinevt: Primary extension is labeled with EXTENAME instead of
      HDUNAME, now allowed by FITS 3.0 standard.
    - batcelldetect: BUG FIX: no longer reports spurious fluxes for sources
      just outside the partial coding field of view; BUG FIX: no longer
      does error-box size check if position fitting is disabled; BUG FIX:
      potential memory corruption during error-box check potential now fixed.
    - batclean: BUG FIX: Poisson rate data now weighted properly during fit;
      BUG FIX: ordering of balancing and weighting now fixed; Small sensitivity
      improvement expected from these bug fixes, depending on number of sources,
      background and source spectrum.
    - batfftimage: BUG FIX: memory corruption in rare uses of 'aperture'
      parameter now fixed; Primary extension is labeled with EXTENAME instead
      of HDUNAME, now allowed by FITS 3.0 standard.
    - batimgstatpos: BUG FIX: do not compute position for image table rows
      which do not have matching attitude data.
    - batmaskwtimg: BUG FIX: memory corruption in rare uses of 'aperture'
      parameter now fixed; Primary extension is labeled with EXTENAME instead
      of HDUNAME, now allowed by FITS 3.0 standard.
    - batoccultmap: Primary extension is labeled with EXTENAME instead of
      HDUNAME, now allowed by FITS 3.0 standard.
    - batphasimerr: BUG FIX: correct exposure time now written for output
      simulated spectrum
    - batsurvey-catmux: * Allow transformations to be specified with
      @filename.txt, in addition to directly on the command line
    - batsurvey-gti: BUG FIX: garbage rows of output GTI file might survive,
      now fixed.
    - battblocks: documentation improvements.
    - uvotsource, uvotmaghist, uvotproduct: Added support for the AB magnitude
      system. The column names for the UVOT Vega system remain unchanged.
      There is a second set of columns prefixed AB_ for the AB system.
    - uvotdetect: Support for LSS corrections.  When running uvotdetect
      on an unsummed image (that contains WCS D keywords which can be
      used to determine detector positions for sky positions), you can pass
      lssfile=CALDB.  When running uvotdetect on a summed image, you can pass
      lssfile=SKY:<fitsimgext> where <fitsimgext> is a merged sky LSS correction
      (e.g., from uvotskylss).
    - uvotgcn: Prepare a flag image which identifies unexposed pixels and
      provide it to uvotdetect to avoid bogus detections.
    - uvotimsum: Fixed error summing images at the discontinuity in RA from
      360 to 0 or at extreme Decs. Was not accepting parameter method=FLAG.
      Added support for excluding images which do not overlap (see tool help-
      exclude parameter). If the input images contain WINDOW* and BIN*
      keywords, then they will be written to the output (and correspond to
      the smallest containing WINDOW and largest binning).
    - uvotlss: When processing a table, prefer the FILTER column to the
      FILTER keyword.
    - uvotoptsum: Added parameter timezero so user can specify the time
      relative to which exponential decay is calculated (see tool help-
      timezero parameter).
    - uvotproduct: Use the nsigma parameter for plots.  Determine whether
      detections are significant based on uvotsource photometry NSIGMA
      (instead of MAG_LIM).
    - uvotskylss: Fixed error if lssfile=<path> where <path> did not include
      an extension.
    - xrtcalcpi: Handle new gain CALDB file format; Modified PI calculation
      for charge traps correction; New input parameters: 'userctipar',
      'beta1','beta2','ecti','offsetniter' and 'savepioffset'.
    - xrtmkarf: Handle new psf CALDB file format.
    - xrtlccorr: Handle new psf CALDB file format; Modified selection of
      appropriate frames while reading hkfile.
    - xrtinstrmap: Modified selection of appropriate frames while reading

    Help lines: FTOOLS or xanprob@athena.gsfc.nasa.gov

    Web page maintained by Bryan K. Irby

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

    Last modified: Tuesday, 22-Nov-2011 14:58:56 EST

    The HEASARC welcomes your participation in a brief survey to capture how users access and utilize HEASARC data, software, and services. The outcome(s) of this survey will be used to guide, prioritize, and plan our activities and development in the coming years. It contains 18 questions, generally takes just a few minutes to complete, and your answers will remain totally anonymous. We thank you in advance for your valuable feedback.