HEASoft Supported Architectures & Operating Systems




Quick Links:




PC (x86 / x86_64)

  • OS: LINUX

    Compilers: For a detailed guide to installing HEASoft under Linux, please see our Linux installation pages:


    Known Issues:

    • Users who wish to get the HEAsoft pre-compiled Linux binaries should see our note about Perl library portability.

    • (Fedora) Transparent windows in FV (POW display): When using POW as your display device in the FV GUI, windows may appear transparent. To get around this issue, the graphics "Forced Fallback Mode" should be turned ON (in System Tools -> System Settings -> Details -> Graphics).

    • (Ubuntu) Transparent windows in FV (POW display): When using POW as your display device in the FV GUI, windows may appear transparent. KDE users should consider switching to GNOME, and when in GNOME, visual effects should be turned off (in System -> Preferences -> Appearance -> Visual Effects).


  • OS: CYGWIN

    Compilers: Please see our Cygwin installation page for a detailed guide to installing HEASoft under Cygwin.

    Known Issues:

    • Anti-virus software: Some users may run into build problems as a result of anti-virus software, manifesting as "no such file..." errors referring to Perl scripts or conftest files, or "permission denied" errors referring to the hd_install program. The former problem occurs when the anti-virus program locks a new file temporarily while it scans it at the same time the build is trying to move or remove it, and the latter is a result of a known virus with the unfortunate name hd_install. Unfortunately the only solution for the first problem is to turn off your virus protection temporarily while the software builds; the second problem may be addressed by renaming the hd_install program (please contact us at the FTOOLS help desk for more information about how to do this).

    • FAT32 disks: Users trying to install HEASOFT on a FAT32 disk under Cygwin may run into various problems and should either try their build on an NTFS disk instead, or write the FTOOLS help desk for assistance.

    • Fork: Some users may encounter problems with forked processes when building HEASoft under Cygwin, for example:
              24 [main] sh 7280 C:\cygwin\bin\sh.exe: *** fatal error - couldn't
         allocate heap, Win32 error 487, base 0x680000, top 0x6E0000,
         reserve_size 389120, allocsize 393216, page_const 4096
         Stack trace:
         Frame     Function  Args
         XXXXXXXX  XXXXXXXX  (XXXXXXXX, XXXXXXXX, XXXXXXXX, XXXXXXXX)
         XXXXXXXX  XXXXXXXX  (XXXXXXXX, XXXXXXXX, XXXXXXXX, XXXXXXXX)
         XXXXXXXX  XXXXXXXX  (XXXXXXXX, XXXXXXXX, XXXXXXXX, XXXXXXXX)
         XXXXXXXX  XXXXXXXX  (XXXXXXXX, XXXXXXXX, XXXXXXXX, XXXXXXXX)
         XXXXXXXX  XXXXXXXX  (XXXXXXXX, XXXXXXXX, XXXXXXXX, XXXXXXXX)
         ...
         ...
         End of stack trace
              12 [main] sh 5068 fork: child -1 - died waiting for longjmp before
         initialization, retry 0, exit code 0x100, errno 11
         /bin/sh: fork: retry: Resource temporarily unavailable
        
      If you run into this problem, please contact the FTOOLS help desk for further assistance.


Apple/Mac

  • OS: Intel OS X / Darwin

    OS Versions:

    • Darwin 18.x (macOS 10.14.x [Mojave])
    • Darwin 17.x (macOS 10.13.x [High Sierra])

    Compilers: Please see our Mac installation page for a detailed guide to installing HEASoft on a Mac.

    Known Issues:

    • Perl & C:

      It is recommended that users avoid mixing Perl and C compilers from different sources (e.g. Perl from MacPorts paired with the XCode C compilers) as Perl has underlying dependencies on the C compiler it was built with and may be incompatible with a C compiler from another source. We encourage you to always use the XCode Perl and C/C++ for any build. To ensure that your HEASoft build makes the correct choices for these compilers, we recommend setting the appropriate environment variables:
             setenv CC /usr/bin/clang     (or /usr/bin/gcc)
             setenv CXX /usr/bin/clang++  (or /usr/bin/g++)
             setenv PERL /usr/bin/perl
             setenv PYTHON /usr/bin/python
      
           or, in bash:
      
             export CC=/usr/bin/gcc     (or /usr/bin/gcc)
             export CXX=/usr/bin/g++    (or /usr/bin/g++)
             export PERL=/usr/bin/perl
             export PYTHON=/usr/bin/python
           
    • Perl architecture flags vs. XCode:

      Some users may run into build errors in the CFITSIO Perl module (referencing the file CFITSIO.xs) when pairing newer XCode distributions whose compilers no longer support the PowerPC architecture (designated by the "-arch ppc" compiler flag) with a Perl built using an older XCode compiler:
              ... assembler (...) for architecture ppc not installed
           
      Perl installations built with older XCode gcc will attempt to insert the "-arch ppc" flag into Makefiles for the Perl modules, causing the error above. Users may choose to either rebuild their version of Perl with the newer XCode, or alternatively force Perl to leave out the "-arch ppc" flag by editing
             /System/Library/Perl/5.X.X/darwin-thread-multi-2level/Config_heavy.pl
           
      to remove "-arch ppc" from the $archflags setting near the end of the file:
             $archflags = exists($ENV{ARCHFLAGS}) ? $ENV{ARCHFLAGS} : '-arch x86_64 -arch i386 -arch ppc';
           
      After making this edit, remove the problematic Makefile and restart the build:
               rm heasoft-6.22.1/heacore/Astro-FITS-CFITSIO/Makefile
               cd heasoft-6.22.1/BUILD_DIR/
               make >& build.log2 &
               etc.
           




UNSUPPORTED:

Use of HEASOFT is no longer supported under the following:

  • Sparc/SunOS (dropped in HEASOFT 6.13)
  • PPC/Darwin (dropped in HEASOFT 6.11.1)
  • PPC/Linux (dropped in HEASOFT 6.5)
  • Alpha/OSF (dropped in HEASOFT 6.1.2)
  • SGI/IRIX (dropped in HEASOFT 6.0)
  • AIX
  • IRAF
  • VMS

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: Monday, 07-Dec-2020 11:37:47 EST