HEAsoft v6.0 Bug List

---

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

Several packages track bugs separately from this page:

• Swift
• CALDB
• fv
• XSPEC
• XRONOS
• XIMAGE

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

• FV on Scientific Linux 4.0:
  
  The FV GUI displays "washed out" (no black color) images in POW when built using the default compilers (gcc 3.4.3). To fix this problem, we recommend any of the following:

     (a) Build FV / HEASoft with a different GNU compiler (e.g. gcc 3.4.6).
     (b) Download the standalone FV executable
     (c) Download the pre-compiled Linux FV/GUI binaries
     
  

• Linux Fedora Core 4:
  
  (For users of the source code distribution)
  
  This operating system ships with the GNU 4.0.x compilers, which include the new GNU fortran compiler gfortran. For the forseeable future, we will not be able to support gfortran, but users of Fedora Core 4 should have g77 (v3.2.3) available as an easily-installed alternative (see below).
  
  We recommend that users of Fedora Core 4 install the GNU 3.2.3 compilers (gcc32, g++32, and g77) to build HEASoft. These compilers are included with the Fedora Core 4 CDs or DVD, or are easily installed using yum as follows:

          yum install compat-gcc-32
          yum install compat-gcc-32-c++
          yum install compat-gcc-32-g77
    
  

  Before configuring and building HEASoft, you should set the relevant environment variables to use this set of compilers:

          setenv CC gcc32
          setenv CXX g++32
          setenv FC g77
    
  

• sec2time & time2sec:
  The time-related task sec2time returns incorrect results when the computed (output) date is near the end of a leap year (e.g. 12/29/04). Additionally, sec2time and its counterpart time2sec both generate a seg fault when CALDB is input for the leapfile parameter.
  
  A source code patch which fixes all of these problems is available HERE. The patch requires rebuilding one library (libftools) and both tasks. To build and install the new library and tools, users of the source distribution may do the following (which assumes C-shell):

     (1) setenv HEADAS /path/to/your/installed/headas/<PLATFORM>
     (2) source $HEADAS/headas-init.csh
     (3) cd /path/to/your/ headas source tree
         Unpack the tar file on top of your existing headas/ source tree.
  
     (4) cd headas/ftools/ftoolslib/
     (5) hmake
     (6) hmake install
  
     (7) cd ../time/src/sec2time
     (8) hmake
     (9) hmake install
  
    (10) cd ../time2sec
    (11) hmake
    (12) hmake install
     
  

  Pre-compiled binary patches are also available for the following distributions:
  
  Linux/PC
  Linux/Mac
  Darwin/Mac
  OSF/Alpha
  SunOS/Solaris
  
  To install the binary patches, simply unpack the appropriate tar file on top of your existing headas/ binary distribution.

• fcollect (RXTE):
  There is a minor bug in the currently released version (v5.5) of the RXTE tool fcollect that causes xtefilt to fail for data taken on 29 February 2000. Data from all other dates are properly handled by v5.5, so the new version of fcollect (v5.6) is only required for users who need to run xtefilt for data taken on that date. If you have need of this updated version of fcollect, please contact the RXTE help desk via the HEASARC Feedback page.

• fmosaic (ASCA):
  The ASCA tool fmosaic version 2.6.3 has a problem with the way the exposure maps were computed, which led to a spurious pixeled map of the mosaic-ed exposure map. This problem has been fixed in fmosaic 2.7, and a patch is available HERE. To build and install the new fmosaic, users of the source distribution may do the following (which assumes C-shell):

     (1) setenv HEADAS /path/to/your/installed/headas/<PLATFORM>
     (2) source $HEADAS/headas-init.csh
     (3) cd /path/to/your/ headas source tree
         Unpack the tar file on top of your existing headas/ source tree.
     (4) cd headas/ftools/asca/src/fmosaic/
     (5) hmake
     (6) hmake install
     
  

• fmaskfilt:
  Improper handling of sky coordinate wrap-arounds in the fimage tool fmaskfilt may result in removal of all events with DETX >= 182, not just those which were masked. A fixed version of the fmaskfilt.f code is available HERE. To build and install the new fmaskfilt, users of the source distribution may do the following (which assumes C-shell):

     (1) setenv HEADAS /path/to/your/installed/headas/<PLATFORM>
     (2) source $HEADAS/headas-init.csh
     (3) cd /path/to/your/headas/ftools/fimage/src/fmaskfilt/
         Copy the new fmaskfilt.f code to this directory, then:
     (4) hmake
     (5) hmake install
     
  

• Mac OS 10.4.x / Darwin 8.x.x (Tiger):
  Tiger users will need to use the Disk Utility to repair permissions on the Tiger startup volume in order for HEASOFT to build correctly. Double-click on Disk Utility, select the appropriate volume under First Aid, then click the repair permissions button. Or, use the command-line version, diskutil: for example, "diskutil repairPermissions /".
  
  Please note that the existing pre-compiled Darwin binaries (built in Darwin 7.9.0) seem to work okay in Darwin 8.1.x.

• cmppha (Mac OS X only):
  A Darwin-specific bug in the caltool cmppha generates a fault when running in "expand" mode. A fixed version of the cmppha.f code is available HERE. To build and install the new cmppha, users of the source distribution may do the following (which assumes C-shell):

     (1) setenv HEADAS /path/to/your/installed/headas/<PLATFORM>
     (2) source $HEADAS/headas-init.csh
     (3) cd /path/to/your/headas/ftools/caltools/src/cmppha/
         Copy the new cmppha.f code to this directory, then:
     (4) hmake
     (5) hmake install
     
  

• Solaris tar & build problems:
  The Native Solaris tar (typically /usr/bin/tar) is known to have problems unpacking some pre-compiled binary distribution tar files downloaded from the HEASOFT download page, due to a fundamental incompatibility (relating to how long pathnames are encoded) with GNU tar (with which the tar files are created). If you do not already have GNU tar installed (typically /usr/local/bin/tar), we recommend installing and using it instead (distributed freely from GNU here).
  
  The Workshop 6.2 compilers are not supported, and are known to fail in compilation of the makefilter task and generate run-time problems in xspec v12. We recommend upgrading to the Workshop 7 compilers.
  
  The default Solaris sed (usually /usr/bin/sed) has a line-length limitation (approximately 4000-characters) which may cause a build failure in the fitsTcl library. The best solution is to install the GNU sed, which has no such limitations. If you install the package from www.sunfreeware.com, it will put GNU sed in /usr/local. Be sure that 'make' can find the GNU sed before it finds Sun's sed by putting /usr/local/bin before /usr/bin in your $PATH. Alternately, you may be able to circumvent the build problem by keeping the directory path to the HEASOFT source code tree as short as possible.

• bod2rmf:
  There is a bug in the CGRO tool bod2rmf. For at least every tjd between 10179 and 10464, the energy edges for channel 15 are wrong. A corrected version of the bod2rmf.f code is available HERE. To build and install the new bod2rmf, users of the source distribution may do the following (which assumes C-shell):

     (1) setenv HEADAS /path/to/your/installed/headas/<PLATFORM>
     (2) source $HEADAS/headas-init.csh
     (3) cd /path/to/your/headas/ftools/gro/src/bod2rmf/
         Copy the new bod2rmf.f code to this directory, then:
     (4) hmake
     (5) hmake install
     
  

• fovdsp:
  There is a typo in the .par file for the heasarc tool fovdsp. Please edit $HEADAS/syspfiles/fovdsp.par and change the file name in the catalog parameter to read:

           gnrl_refr_cat_0020.fits
  
               instead of
  
           gnrl_refr_cat_0014.fits
  
        (i.e. change the catalog number from 14 to 20)