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 additional steps 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.:
       First, make sure that the configure script will choose the
       correct set of compatible compilers for the build (and note that
       a python interpreter is only required if you plan to use PyXspec):
      
       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 FC /usr/bin/gfortran         $ export FC=/usr/bin/gfortran
          $ setenv PERL /usr/bin/perl           $ export PERL=/usr/bin/perl
          $ setenv PYTHON /usr/bin/python       $ export PYTHON=/usr/bin/python
      
       Next:
      
          $ cd heasoft-6.17/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.17/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.17/i686-pc-cygwin
          $ . $HEADAS/headas-init.sh
      
    • Post-installation (rebaseall, etc.):

      There is a known issue with Perl modules under Cygwin which requires users to perform an additional step after installing HEASOFT. More detailed explanations of the problem can be found at the Cygwin Wiki or at the Perl Cygwin page.
      After you have finished the HEASOFT installation, run
      
         $ /bin/perlrebase
      
      while still in the Cygwin shell, then *exit* Cygwin and start up the "ash"
      shell, either by opening Start Menu -> Run and typing "C:/cygwin/bin/ash",
      or by double-clicking on it under C:\cygwin\bin\ in an explorer window.
      Inside the ash terminal, run the following command:
      
         $ /bin/rebaseall
      
         or, optionally:
      
         $ cd $HEADAS
         $ chmod +wx lib/lib*.dll
         $ find lib -name '*.dll' > dlls.txt
         $ /bin/rebaseall -T dlls.txt
      
      If these tasks run without error, the tools utilizing perl modules
      (perldemo or perldemo2, for example) should now work.
      

      To start X-Windows, simply type "startx". You MUST be in X-Windows to use the plotting capabilities of e.g. XIMAGE, XSPEC, or FPLOT.

      While Tcl/Tk compiles under Cygwin, we have encountered problems with Tk functionality in the HEASOFT tools which use Tk. As a result, the Tk capabilities of XIMAGE and XSELTK are not available under Cygwin. Additionally, the FV GUI is not available via a source build, but users may download a stand-alone version of FV for Windows



  • 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.17/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.17/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.17/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, 29-Jul-2015 16:13:19 EDT