HEAsoft v6.15.1 - Known Issues

If you are using HEASOFT v6.15 and don't want to upgrade to v6.15.1 just yet, see the HEASOFT 6.15 Issues List.

Please visit the HEASOFT Supported Platforms page for current information about supported operating systems and compilers.

Several packages track issues separately from this page:

The following is a list of known issues in v6.15.1 of HEAsoft not covered by the above pages.


Last modified Friday, 21-Mar-2014 15:58:11 EDT
  • Swift/XRT (v2.9.3):

    The XRTDAS v2.9.3 patch introduces support for the non-standard numeric format of the 'ATTFLAG' keyword of input attitude files. The patch was required by the presence in the Swift archive of a subset of observations containing this format. The tasks affected by this patch are xrttam, xrtfilter, xrttdrss2, xrtpccorr, xrthkproc, xrtlccorr, xrtexpomap, xrtinstrmap, xrttimetag and xrtpipeline.

    The XRTDAS v2.9.3 patch has been applied to all HEASoft 6.15.1 downloads (source code and pre-compiled binaries) as of 2014 March 03 13:30 EST. If you installed HEASoft 6.15.1 prior to this time, you may patch your installation following the instructions below:

    • Patch for HEASoft 6.15.1 source code distribution:
    • To apply the XRTDAS v2.9.3 source code patch to your existing HEASoft 6.15.1 source code distribution, download the patch tar file:

      XRTDAS v2.9.3 (source code patch)

      Change to the directory above your pre-existing heasoft-6.15.1 directory and unpack the tar file there (i.e. on top of heasoft-6.15.1):

        tar zxf heasoft-6.15.1swift_xrt2.9.3-src.tar.gz
        
      Then:
        cd heasoft-6.15.1/swift/xrt
        ../BUILD_DIR/hmake clean
        
        Wait for this to finish, and if there are no errors, then type:
      
        ../BUILD_DIR/hmake local install
        
      When this step finishes successfully, the XRTDAS v2.9.3 patch is installed and ready to use.

    • Patch for HEASoft 6.15.1 pre-compiled binary distributions:
    • To apply the XRTDAS v2.9.3 patch to your existing HEASoft 6.15.1 pre-compiled binary distribution, download the tar file below appropriate for your architecture & operating system:

      PC Linux

      PC Linux 64-bit

      PC Cygwin

      Mac Intel Darwin 13.x (OS X 10.9.x)

      Mac Intel Darwin 12.x (OS X 10.8.x)

      Mac Intel Darwin 11.x (OS X 10.7.x)

      Mac Intel Darwin 10.x (OS X 10.6.x)

      Then change to the directory above your pre-existing heasoft-6.15.1 directory and unpack the tar file there (i.e. on top of heasoft-6.15.1). When it finishes unpacking, the XRTDAS v2.9.3 patch is installed and ready to use.



  • flx2xsp (Mac OS X 10.9 Mavericks):

    The flx2xsp task may crash with a bus error under Mac OS X 10.9 when input energy bins are non-contiguous. An update to flx2xsp.cxx fixes this bug. To patch your 6.15.1 source code installation:
      1) Initialize your environment to use HEASoft.
    
      2) Download the update to flx2xsp.cxx: flx2xsp.cxx
    
      3) Copy the new flx2xsp.cxx into your heasoft-6.15.1/heagen/flx2xsp/
         directory, overwriting the previous version:
    
         heasoft-6.15.1/heagen/flx2xsp/flx2xsp.cxx
    
      4) cd heasoft-6.15.1/heagen/flx2xsp/
    
      5) hmake all install
    


  • ximage (AST):

    A bug in the AST library may cause ximage to crash when loading images without world coordinates. An update to heasoft-6.15.1/heacore/ast/fitschan.c resolves this issue. To patch your 6.15.1 source code installation:
      1) Initialize your environment to use HEASoft.
    
      2) Download the update to fitschan.c: fitschan.c
    
      3) Copy the new fitschan.c into your heasoft-6.15.1/heacore/ast/
         directory, overwriting the previous version:
    
         heasoft-6.15.1/heacore/ast/fitschan.c
    
      4) cd heasoft-6.15.1/heacore/BUILD_DIR/
    
      5) hmake all-ast install-ast
    
      6) cd ../../ftools/image/ximage/src (i.e. now in heasoft-6.15.1/ftools/image/ximage/src)
    
      7) rm ximage
    
      8) hmake ximage
    
      9) hmake install
    
  • ximage:

    HEASoft 6.15.1 incorporates Tcl/Tk version 8.5.13, which has resulted in a known but apparently harmless issue on some platforms. After using the /XTK plot device, the following message may be displayed upon exit:
        [XIMAGE> quit
        X Error of failed request:  RenderBadPicture (invalid Picture parameter)
          Major opcode of failed request:  ### (RENDER)
          Minor opcode of failed request:  # (RenderFreePicture)
          Picture id in failed request: #########
          Serial number of failed request:  ####
          Current serial number in output stream:  ####
    
  • Perl version mismatch::

    Pre-compiled Perl libraries used extensively by mission software (Swift, Suzaku, NuSTAR) and other packages are not especially portable, so we generally recommend building HEASoft from the source code distribution.


  • uvotgrplot:

    This Swift/UVOT task may fail with a Fortran runtime error while generating a postscript plot when compiled using certain versions of gfortran (e.g. v4.6.2 installed via fink) on Mac OS X. At present we suspect a compiler bug and recommend using an alternate compiler from the options on our support page.


  • xspec / PLT - wenv, whead, wdata:

    Some GNU Fortran compilers (gfortran 4.4.x, 4.0.x, 4.1.x) appear to have internal issues which prevent the PLT commands wenv, whead and wdata from working unless an output file is specified; i.e. attempts at producing terminal output may fail with "Fortran runtime error: Invalid argument". To get around this, provide an output file name when using these commands, for example:
         wenv myFile1.qdp
         whead myFile2.qdp
         wdata myFile3.qdp
    


  • HEASoft and other software packages (CIAO, XMM-SAS):

    Please note:

    Users may wish to download and run our hwrap script to create an alternate runtime environment for HEASOFT to help avoid conflicts with other software packages, but if not, please take note of the potential pitfalls below:

    • CIAO:

      Please see the following notes at the CXC website regarding the potential dangers of using CIAO and HEASOFT together in the same session:



    • XMM:

      When the XMM-SAS is initialized after HEASoft (when both are used in the same session), the SAS setup changes the value of the environment variable PGPLOT_FONT with the result that plots in e.g. Xspec may (or may not, depending on the software distributions in use) have no axis labels or values. Users can fix this by resetting PGPLOT_FONT to point to the HEASoft location:
           C-shell:
      
               setenv PGPLOT_FONT $HEADAS/lib/grfont.dat
      
           Bourne shell:
      
               export PGPLOT_FONT=$HEADAS/lib/grfont.dat
      
        
      or by simply re-initializing HEASoft:
           C-shell:
      
               source $HEADAS/headas-init.csh
      
           Bourne shell:
      
               . $HEADAS/headas-init.sh
        
      This may in turn have consequences for plotting in XMM-SAS, in which case users may need to return PGPLOT_FONT to the SAS setting when using it for data analysis.


If you have any questions about the information above, please write to us at the FTOOLS help desk.
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: Friday, 21-Mar-2014 15:58:11 EDT