• Download HEASOFT
  • ********************************************************************************
                            RELEASE NOTES FOR HEASOFT 6.33
                                   February 23, 2024
    ********************************************************************************
    
    The HEASoft 6.33 release is driven by new and updated mission-specific
    data analysis software (IXPE and NICER), but as usual includes other
    enhancements and fixes.
    
    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.
    
    ********************************************************************************
                                        CFITSIO
    ********************************************************************************
    
    - Reorganization of helper utility code; added fitsverify
    
    - CMakeLists.txt: Changed install location of cfitsio-targets.cmake
      to conform with the one listed in cfitsio-config.cmake.in (i.e.
      including the extra "cfitsio" subdir of lib/cmake).
    
    - Updated Perl wrappers (Astro-FITS-CFITSIO) to v1.18
    
    - Can now write internal memory files of size > 2^32 directly to a
      gzip-compressed output file.
    
    - Added support for unsigned long long types to fits_update_key.
    
    - Added ability for Windows builds to handle UTF-8 needed for reading
      filenames with non-ASCII characters.
    
    - Calculator functions that read GTIs do more correct validity
      checking of GTI input files
    
    - fits_insert_rows now works if input table starts with both no rows
      and no columns
    
    - Added 2-byte int test to speed.c utility.
    
    - Made fix to http file handler to expand the allowed URL length.
    
    - Fix for modify and delete keyword functions to fully conform with
      v4.3.0 long string keyword read/write enhancements.
    
    ********************************************************************************
                                        FIMAGE
    ********************************************************************************
    
    - fimgmerge: Allow for outfile names with longer directory paths
    
    ********************************************************************************
                                        FUTILS
    ********************************************************************************
    
    - ffilecat: Increased length of infile and message variables to allow
      for longer file paths.
    
    ********************************************************************************
                                        HEAGEN
    ********************************************************************************
    
    - burstfinder: Separated code into subroutine files; added POLYERR and
      POLYXOFF for error estimate and fit x offset to FITS output; corrected
      errors in handling missing FRACEXP column in input LC
    
    ********************************************************************************
                                        HEASARC
    ********************************************************************************
    
    - extractor: Fixed an error message, and reworked handling of warning
      messages to fix a corner-case crash
    
    ********************************************************************************
                                      HEASPTOOLS
    ********************************************************************************
    
    - ftchkpha: Addressed confusion caused by the presence of DETECTOR extensions
      which have HDUCLAS1 set to SPECTRUM.
    
    - ftgcorpha: Ensure that the output spectrum uses a RATE column to avoid
      problem of fractional counts being written as integers to a COUNT column.
    
    - ftgrouppha: Improved diagnostic output if checking the output spectrum
      generates messages.
    
    ********************************************************************************
                                       HEATOOLS
    ********************************************************************************
    
    - fkeypar (wrapper to ftkeypar): When the keyword doesn't exist, put
      an empty string for 'value' to prevent par file corruption;
      Changes to output string values to match old fkeypar behavior
    
    - ftcreate: When no units are given, send a null 'tunit' (rather than
      an empty string " ") to match behavior of the old Fortran 'fcreate'
      task.  Otherwise the created table has empty TUNIT keywords that
      serve no purpose.
    
    - ftmgtime: Print number of files at chatter>=3
    
    ********************************************************************************
                                         TIME
    ********************************************************************************
    
    - maketime: Increase path size from 512 to 2048; expr size from 2048 to 4096
    
    ********************************************************************************
                                        XIMAGE
    ********************************************************************************
    
    - Addressed crash when asking for command parameters (e.g. "circle/?")
    
    - ra_dec_to_pixel: Fixed error with celestial/equatorial coordinate
      input at prompt
    
    ********************************************************************************
                                        XSELECT
    ********************************************************************************
    
    - Fixed an uninitialized variable which could leave the program confused
      about whether or not it created stokes parameter spectra.
    
    ********************************************************************************
                                         XSPEC
    ********************************************************************************
    
    Xspec version 12.14.0:
    
    For details, please visit this page.
    
    For patches beyond 12.14.0, please visit the Xspec issues page.
    
    ********************************************************************************
                                         XSTAR
    ********************************************************************************
    
    Version 2.59ch:
    
    - Faster execution of the routine writespectra by not calculating
      voigt profile for every line.
    
    - Change to nrank to not miss weaker features for important cases.
    
    - New atomic data file which has Ca XIV K shell photoionization cross
      section error fixed
    
    - Fixed PARAM to have larger nrank value to ensure that more features
      are included in synthetic spectrum.
    
    - Changes to bookkeeping of rates which allows the heating-cooling
      in the photon and electron pov to agree, and fixed printing of
      these rates
    
    - New argument for ucalc, echar, which is a characteristic energy
      describing the heating and cooling rates for that process.
    
    - Changes which allow densities less than 1.
    
    - Unbinned threshold energy in phint53
    
    - Higher threshold for line binning in binemis to allow faster execution.
    
    - Accurate electron POV heating and cooling.
    
    - Fixed type 51 data (Ralf)
    
    - Added diagnostics and printout code for NLTE workshop.
    
    ********************************************************************************
                                         ASCA
    ********************************************************************************
    
    - addascaspec: Fixed mathpha command for background files when errmeth
      is specified.
    
    ********************************************************************************
                                         IXPE
    ********************************************************************************
    
    - ixpeaspcorr:
    
      * Added "outfile" and "attfile_out" string parameters for the path
        names of the  output event file and output attitude file (both
        previously overwrote the input).
    
      * Added "clobber" Boolean parameter to support the new "outfile"
        and "attfile_out" usage.
    
      * Changed "n" parameter to type integer and storage hidden, with
        default of 300 and min of 1.
    
      * Changed "att_path" to "attfile_in" to indicate it is now an input-
        only attitude file.  This parameter is now required, rather than
        optional.
    
      * Output event file adds two new keywords: "XPIXMEAN" and "YPIXMEAN",
        which are set to the values of the "x_pix_mean" and "y_pix_mean"
        parameters to enable users to reproduce event files.
    
      * Since "attfile_in" is now a required parameter, the module always
        uses the attitude data to differentiate between the star tracker
        optical heads and independently calculate the aspect solutions by
        time.  If no valid attitude solutions are found within the time
        bounds of the event file, a warning is logged, and no attfile_out
        is produced.
    
      * The module now attempts to capture most errors raised in the code.
        Instead of breaking at the Python line when an error is raised,
        the module now logs an error string and returns a value of "1" to
        the command line.
    
    - ixpeboomdriftcorr:
    
      * Added "outfile" and "attfile_out" string parameters for the path
        names of  both the  output event file and the output attitude
        file (both previously overwrote the input).
    
      * Added "clobber" Boolean parameter to support the new "outfile"
        and "attfile_out" usage.
    
      * Changed "n" parameter to type integer and hidden, with default
        of 300 and min of 1.
    
      * Changed "att_path" to "attfile_in" to indicate it is now an input-
        only attitude file.  This parameter is optional, as is "attfile_out".
    
      * Deleted "modify_attfile", as the addition of "attfile_out" removes
        the modification the input attitude file.
    
      * Changed default value of "params_file" to "caldb" to look up the
        value in the CALDB.
    
      * Added "teldef" parameter, which defaults to "caldb" to look up the
        value in the CALDB, to allow users to provide their own telescope
        definition CADB file.
    
      * The module now attempts to capture most errors raised in the code.
        Instead of breaking at the Python line when an error is raised,
        the module now logs an error string and returns a value of "1" to
        the command line.
    
    - ixpecalcarf:
    
      * Changed "attfile" parameter to be optional (required if new
        "offarcmin" parameter is not used).
    
      * Changed default value for "vignfile" and "reeffile" default values
        to "caldb" to look up the value in the CALDB.
    
      * Added "uvfile", "grfile", "axeffa", "modfact", and "qefile"
        filename parameters (which all default to "caldb" to look up the
        values in the CALDB) to allow users to specify the path to their
        versions of these files.
    
      * Changed "specfile" parameter to be a required parameter.
    
      * Added "offarcmin" parameter, which is an optional floating point
        parameter that defaults to -1 to disable its use.  If the value
        is set >= 0.0, the attitude solution in the "attfile" will be
        ignored, and the output response function will be calculated for
        this single off-axis angle only.
    
      * Use of on-axis "arf" and "mrf" files from the CALDB is now
        discouraged.  These files should now be calculated for each
        observation using this tool.
    
      * A new mode for visualizing the effects of off-axis angle on
        response has been added.  By setting "offarcmin" to >= 0.0, the
        attitude solution of the target will be ignored, and the output
        response function will be calculated for the user-selected off-
        axis angle only.  This will not produce a valid solution for any
        given target, rather, it is intended for the purpose of
        facilitating understanding of the effects of off-axis angle.
    
      * Attitude off-axis angles that exceed the maximum value in the
        vignetting CALDB file are now masked out of the final response
        function.  If this occurs, the user is notified of the fraction
        of the total GTI time that has been removed.
    
      * Interpolation between the energies in the radial encircled
        energy function called "reef" in the CALDB (which occurs when
        "radius" > 0.0) is now accomplished in log-reef/log-energy space
        and is now extrapolated below 2.4 keV and above 6 keV.  These
        remove order 1% artifacts in the resulting response functions
        due to slope discontinuities in the reef interpolation.  In
        addition, the user will be warned if the radius is set outside
        the 0.5 < radius < 6 arc min range, as such values are outside
        the range of well-defined reef measurements.
    
      * The user will also be warned if the attitude file start time
        is > 50 ksec after the start of the event GTI, or if the attitude
        file end time is > 50 ksecs before the end of the event GTI.
    
      * This can occur if a multi-segment Level 2 event file is used with
        a single-segment Level 1 attitude file.
    
    - ixpedet2j2000:
    
      * Changed name of "attitude" parameter to "attfile_in" to make it
        consistent with the rest of the ixpe tool suite.
    
      * Changed default values of "teldef" and "align" parameters to
        "caldb" to look up the values in the CALDB.
    
      * The module now attempts to capture most errors raised in the code.
        Instead of breaking at the Python line when an error is raised,
        the module now logs an error string and returns a value of "1" to
        the command line.
    
      * Changed the column types of "X" and "Y" in the "outfile" from "D"
        to "E", as double-precision is not required.
    
    - ixpeeventviewer:
    
      * This module has been added to allow users to visualize the
        individual tracks of the raw events in the Level 1 event files.
    
      * This module is a minor interface change and functional update of
        the "xpevtviewer" program developed by Luca Baldini (INAF) and
        the ixpeobssim team.
    
    - ixpegaincorrtemp:
    
      * Fixed a bug in which small (~2 second) time gaps were being
        incorrectly introduced into the temperature data every ~1000
        seconds or so.
    
      * Fixed bugs in which a few output messages were being logged
        without a carriage return to indicate a line break.
    
    - ixpeinterptemp:
    
      * Removed the default value of the "infile" parameter.  Previously
        had inadvertently been set to the name of a testing file.
    
      * Fixed a bug in which the ixpeinterptemp.py file was not
        executable from the shell command line.
    
    - Ixpemkevt2gti:
    
      * Changed name of "attfile" to "attfile_in" to make it consistent
        with the rest of the ixpe tool suite.
    
      * Fixed a bug in which missing parameter keywords in "infile"
        caused the program to crash.
    
    ********************************************************************************
                                         MAXI
    ********************************************************************************
    
    - mxextract: Fixed crash that occurs when the USER environment
      variable is not set
    
    ********************************************************************************
                                         NICER
    ********************************************************************************
    
    This NICERDAS release focuses on delivering improved NICER modeling of
    backgrounds and responses during the NICER optical light leak of May
    2023.  The response generation tool (nicerrmf) and SCORPEON background
    model now can generate products that have adjusted low energy responses
    due to the threshold changes between day and night.
    
    The SCORPEON model can now estimate backgrounds for light curves of any
    time binning via the niscorplc tool.  The nicerl3-lc tool can use this model
    to attach backgrounds to light curve products.
    
    NICERDAS v012:
    
     - nicerrmf now calculates variable threshold based on in-flight setting
    
     - nicerl3-lc now can estimate SCORPEON light curve backgrounds with
       niscorplc, but the default is still no background estimate
    
     - nicerl2 / nimaketime have new parameter threshfilter which allow
       users to select day-only or night-only thresholds, useful after the
       optical light leak of May 2023
    
     - nibackgen3C50 adds new gainepoch (2022) for that year's gain solution
    
     - NICER SCORPEON model adds background version v23 (bkgver=v23) which
       includes a low energy threshold parameter (nxb),
       as well as parameters of the detailed nxb variant to better fit the
       high energy shape of the prel component.
    
     - niautoscreen has a new parameter lowmemscr to do per-MPU LOWMEM screening
    
     - nimaketime disables max_lowmem by default, in favor of niautoscreen
    
     - nicerl3-spect and niphasyserr have new parameter syserrfactor so user
       can scale systematic error by desired factor
    
     - new task niprelflarecalc can estimate precipitating electron
       ("PREL") flares.
    
     - new task nigti allows uers to make GTI from text file or command line
    
     - new task niscorplc which computes background estimates for light curves
    
     - small changes and bug fixes:
        * SCORPEON cosmic_ray calculation handles NaN values correctly
        * niscorpspectmod uses correct background response file name
        * nicerrmf updates DETCHANS keywords in both response extensions
        * niextract-events bug fix to handle case of entire MPU off/disable
        * internal library fix to expand_item_list prevents niextract-events
          infinite loop
        * nicerl3-lc avoids emitting extraneous file named "1"
        * internal tool niscorpcalc now emits TIMEDEL/TIMEPIXR keywords
        * niscorpcalc correctly computes noise peak centroid when
          noise_enom != 0 (which is rare)
        * nicertimecal has slight verbosity changes
        * nimpucal now uses timebiascalfile=CALDB instead of NONE, but
          most users will not see this since nimpucal enforced that behavior
          anyway
        * nicerl3-lc, nicerpi, nicerrmf, nicertimecal use internal NicerTime
          libraries for consistent behavior
        * nicerl3-spect adds gainepoch3c50 parameter so user can manually
          set gain epoch if desired
        * nimaketime bug fix to restore outexprfile functionality lost in
          NICERDAS v011
    
    ********************************************************************************
                                         SWIFT
    ********************************************************************************
    
    UVOT:
    
    - Updated PGPLOT Perl wrappers to fix a build error with newer GCC
    
    ********************************************************************************
                                          XTE
    ********************************************************************************
    
    - hxtback: fix fkeypar (ftkeypar) fragility regarding retrieval of
      DATAMODE keyword
    
    ********************************************************************************
                                       HEASoftPy
    ********************************************************************************
    
    - Broke the tools into submodules (heasoftpy.nustar, heasoftpy.heatools,
      etc.) to speed up module imports, such that users needing only one
      package aren't burdened by an import of other packages and their
      dependencies.  The old 'fcn' behavior is still available, but will
      generate a warning.
    
    ********************************************************************************
                                         MISC.
    ********************************************************************************
    
    - Updated third-party packages WCSLIB (v8.2.1) and GNU readline (v8.2)
    
    - Added configure test to check whether linking with "-lpthreads" is
      necessary for the Xspec functions library
    
    

    HEASoft / FTOOLS Help Desk

    If FTOOLS has been useful in your research, please reference this site (https://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, 22-Mar-2024 14:22:21 EDT