Installing HEASoft - Cygwin (32-bit Only)

  • SOURCE CODE INSTALLATION:
    • Installations from the source code are generally recommended over the pre-compiled binaries to avoid any potential portability issues. Note also that source code builds are required for users who wish to load local models in Xspec or use the Xspec Python interface (PyXspec).

    • Prerequisite packages:

      In order to build HEASoft from the source code distribution, you will need to install additional software when setting up Cygwin. HEASoft is currently supported in 32-bit Cygwin only (we hope to support 64-bit Cygwin in a future release), so when installing from cygwin.com, download and run the 32-bit installation executable "setup-x86.exe". When selecting packages during the setup process, you will need to include the following:

      • Devel:

        • gcc-core
        • gcc-g++
        • gcc-fortran
        • libncurses-devel
        • make
        • readline

      • Interpreters:

        • perl
        • python

      • X11:

        • libXt-devel
        • xinit

      NOTE: The Perl modules included in HEASoft require you to perform an additional step in order to build correctly:
        cd /usr/bin
        ln -s gcc gcc-4
        ln -s g++ g++-4
      

    • Building the software:

      After installing the prerequisite packages above, most users should just follow the basic GNU-like build procedure outlined in the HEASoft installation guide, i.e.:
          % cd heasoft-6.16/BUILD_DIR/
          % ./configure
          % make
          % make install
      
      Note that it is a good idea to capture the output from these steps in the manner appropriate for your shell, for example:
           In C-shell variants (tcsh/csh):      In Bourne Shell variants (bash/sh):
        
               ./configure >& config.out &        ./configure > config.out 2>&1 &
           and
               make >& build.log &                make > build.log 2>&1 &
           etc.
      
      Note that you should let each step finish before proceeding to the next. The installation guide contains descriptions of optional configuration flags that more advanced users may wish to utilize.

    • Initialization:

      To initialize the software, do the following:
         For users of C Shell variants (csh, tcsh):
      
          setenv HEADAS /path/to/your/installed/heasoft-6.16/i686-pc-cygwin
          source $HEADAS/headas-init.csh
      
         For users of Bourne Shell (sh, ash, ksh, and bash):
      
          export HEADAS=/path/to/your/installed/heasoft-6.16/i686-pc-cygwin
          . $HEADAS/headas-init.sh
      


  • PRE-COMPILED BINARY INSTALLATION:
    • Note that users who wish to load local models in Xspec or use the Xspec Python interface (PyXspec) must install HEASoft from the source code distribution instead of the pre-compiled binaries.

    • Prerequisite packages:

      When using the pre-compiled HEASoft binaries, users will need to install additional software when setting up Cygwin. HEASoft is currently supported in 32-bit Cygwin only (we hope to support 64-bit Cygwin in a future release), so when installing from cygwin.com, download and run the 32-bit installation executable "setup-x86.exe". When selecting packages during the setup process, you will need to include the following:

      • Devel:

        • libncurses-devel
        • readline

      • Interpreters:

        • perl
        • python

      • X11:

        • libXt-devel
        • xinit

    • Configuring the software:

      After installing the above packages, most users should just follow the basic binary installation procedure outlined in the HEASoft installation guide, i.e.:
          % cd heasoft-6.16/i686-pc-cygwin/BUILD_DIR/
          % ./configure
      
      If the configure script yields a message about a "Perl mismatch", you will either need to install HEASoft from the source code distribution, or install a version of Perl which matches that listed for your platform in our Perl reference.

    • Initialization:

      To initialize the software, do the following:
         For users of C Shell variants (csh, tcsh):
      
          setenv HEADAS=/path/to/your/installed/heasoft-6.16/i686-pc-cygwin
          source $HEADAS/headas-init.csh
      
         For users of Bourne Shell (sh, ash, ksh, and bash):
      
          export HEADAS=/path/to/your/installed/heasoft-6.16/i686-pc-cygwin
          . $HEADAS/headas-init.sh
      



  • 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: Wednesday, 02-Jul-2014 16:37:26 EDT