HEAsoft v6.21 - Known Issues
If you are using HEASOFT v6.20 and don't want to upgrade to v6.21 just yet,
see the HEASOFT 6.20 Issues List.
Several packages track issues separately from this page:
The following is a list of known issues in v6.21 of HEAsoft not covered
by the above pages.
Last modified Wednesday, 07-Jun-2017 11:53:38 EDT
- nucalcsaa:
The NuSTAR task "nucalcsaa" may experience a memory fault when using
saacalc=2. To fix your source installation, download an updated version (0.1.5) of nucalcsaa.c
and copy it into
heasoft-6.21/nustar/tasks/nucalcsaa
then, initialize your HEASoft installation and rebuild nucalcsaa:
$ cd heasoft-6.21/nustar/tasks/nucalcsaa
$ hmake clean
$ hmake all
$ hmake install
- Mac "configure failed..." Fortran compiler issue:
We're starting to see a number of reports of configure failures that
result from a MacPorts assembler (as) under /opt/local/bin
being ahead of the default Apple /usr/bin/as in a user's PATH (which
may result from an automated change made to .profile during a MacPorts
installation). To get past this issue, try putting /usr/bin at the
front of your PATH:
export PATH="/usr/bin:$PATH"
- FV and Apple XCode 8.3.x:
The FITSViewer utility (FV) suffers a fatal "Abort trap: 6" error
when compiled using Apple XCode versions 8.3.1 or 8.3.2. This appears to
be an issue with the XCode command line tools, so we recommend that users
avoid updating their XCode to 8.3.x until further notice. The pre-compiled
binaries for Mac/Darwin were built using earlier versions of XCode and do
not suffer the abort, so users may wish to consider using those instead.
- Ubuntu 16.10 & 17.04:
Several HEASoft tasks (including extractor, ximage, et al.)
suffer memory faults under newer Ubuntu OS, so until further notice,
please avoid updating beyond 16.04 (LTS) if possible.
- Apple XCode vs. MacPorts gcc/g++:
Some HEASoft tasks may fail with memory errors on Mac OS X when compiled
with the MacPorts gcc/g++, so we continue to recommend that users build
HEASoft only with the Apple XCode (Clang/LLVM) gcc/g++ compilers (and the
XCode perl and python interpreters as well). This may be ensured by setting
the relevant environment variables prior to running the configure script:
In C-shell variants (tcsh/csh): In Bourne shell variants (bash/sh):
% setenv CC /usr/bin/gcc % export CC=/usr/bin/gcc
% setenv CXX /usr/bin/g++ % export CXX=/usr/bin/g++
% setenv PERL /usr/bin/perl % export PERL=/usr/bin/perl
% setenv PYTHON /usr/bin/python % export PYTHON=/usr/bin/python
As Apple does not provide a Fortran compiler, you will need to use one
installed from MacPorts (or elsewhere), so for example:
% setenv FC /opt/local/bin/g95 % export FC=/opt/local/bin/g95
or
% setenv FC /opt/local/bin/gfortran-mp-5 % export % FC=/opt/local/bin/gfortran-mp-5
or
% setenv FC /usr/local/bin/gfortran % export FC=/usr/local/bin/gfortran
We stress that you avoid using /opt/local/bin/gcc-* and /opt/local/bin/g++-*
when building HEASoft from the source code distribution.
- "relocation R_X86_64_32 against `.rodata' can not be used when making a shared object":
Users building HEASoft from the source code distribution may run into this
error which refers to a "Bad value" in the file heacore/wcslib/C/cel.o, from
which the linker "could not read symbols". It also suggests that you
"recompile with -fPIC". This situation most likely occurrs when users perform
a re-build after a previously unsuccessful build attempt. To get past this
issue, try the following:
$ cd heasoft-6.21/BUILD_DIR
$ make distclean
When that finishes, restart the build procedure beginning with "./configure",
then "make", and let us know if this does not resolve the problem.
- fv - XPA_METHOD:
Some users of the fv GUI may experience long delays at startup, or error
messages of the type "XPA$ERROR: invalid host name specified: $host:$port"
when using the ds9 display device. These issues tend to occur on Macs
with customized firewall settings, or on machines without valid IP addresses.
This can be resolved by setting the XPA_METHOD environment variable to the
value "local" (to use local/UNIX sockets instead of inet sockets):
export XPA_METHOD=local # Bourne shell (bash/sh)
or
setenv XPA_METHOD local # C-shell (csh/tcsh)
- nuexpomap (PC Cygwin):
The NuSTAR task "nuexpomap" may fail with a segmentation fault in
the Cygwin environment for Windows. To get past the error, users
may increase the stack size for that task in the following way:
Edit the file
heasoft-6.21/nustar/BUILD_DIR/hmakerc
to add "-Wl,--stack,10000000" to the CFLAGS and LDFLAGS_C
variables (on lines 81 and 107, respectively), then:
% cd heasoft-6.21/nustar/tasks/nuexpomap
% hmake clean
% hmake all install
- ximage:
HEASoft includes Tcl/Tk version 8.5.15, which may result 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:
If you have any questions about the information above, please write to
us at the FTOOLS help desk.
FTOOLS HELP DESK
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
|