3.3.2 Runnig the boa_build script

Before runnig the boa_build installation script you have to make sure that you fulfill following prerequisites:

First, in case of the allBoA.tgz archive, you need a connection to the internet, because all software packages are retrieved with wget, which you therefore will need, too. This is typically installed with every Linux-distribution. You won't need this if you use the allBoaOff.tgz archive. Second, an intel fortran compiler, named ifc, and the Gnu C-compiler gcc must be available. The Intel fortran compiler can be download from the Intel homepage and it is free for scientific and educational purpose. The Gnu C-compiler comes with Linux. Third need to have swig installed, the C-Python wrapper. It usually comes with the default python installation on your system.

Now go to the directory where you have stored the allBoA.tgz or the allBoaOff.tgz archive and run

  tar -xvzf allBoA.tgz

or

  tar -xvzf allBoaOff.tgz

In case of the allBoA.tgz archive this will create a directory called allBoA and in this the following files:

  allBoA/BOA.MES1
  allBoA/BoA.tgz
  allBoA/README
  allBoA/boa\_build
  allBoA/exFits.tgz
  allBoA/init
  allBoA/p_cfitsio.tgz
  allBoA/pySLALIB-0.4.tgz

And in case of the allBoaOff.tgz archive this will create a directory called allBoaOff and in this the following files:

  boa_build_offline
  BoaExtPkg.tgz
  BoA.tgz
  build.stat
  ExtPkg
  init
  README

Change into the allBoA or allBoaOff directory and extract the archive BoaExtPkg.tgz:

  cd allBoaOff
  tar -xvzf BoaExtPkg.tgz

If you have also downloaded the example data exFits.tgz then you can now copy them here:

  cp exFits.tgz allBoaOff/

Then run the script boa_build or boa_build_offline, respectively, by typing:

  ./boa_build

or

  ./boa_build_offline

You will be prompted to enter yes or no for the installation of each single software package.

If you want to intall everything you can also enter

  ./boa_build_offline -all

At the beginning, the script will ask you in which directory you want to install the BoA software:

allBoaOff> ./boa_build_offline -all
  ...boa_build> In which directory do you want to install the BoA software?
  ...boa_build> (default: /home/smueller)

If you don't want to use the default installation path, then please enter the complete path, e.g. /home/smueller/BoA/, and don't forget to create this directory if not already present.

The script will create in this installation directory six sub-directories, bin, BoA, include, lib, man and tmp where all necessary files will be installed. The required disk space is about 161MB.

In case of the on-line installation you will need for the installation of F2PY to enter the password "guest":

  Getting and installing F2PY
  Press Enter for password
  Logging in to :pserver:anonymous@scipy.org:2401/home/cvsroot
  CVS password: guest

If one or more of the servers providing the software sources is down or cannot be reached you can alternativly download all needed software packages from the LABOCA web page at the AIRUB. Just copy all archives into the directory boa_build and run the script ./boa_build again.

The latest release of f2py contained a bug that prevented wrapping the BoA f95 modules. Pearu Peterson fixed it and Frank has downloaded f2py from CVS and made a tarball which is included here (f2py2e.tar.gz). Untar and install as usual. Note that the scipy distutils must be installed separately.

During the installation some environment variables are set. To have these available in a later session or different window you have to set these in your .cshrc, .tcshrc or .bashrc file.

Example for the .bashrc ($HOME is your home directory):

  # Creating an alias to start BoA
  alias boa='python -i $HOME/BoA/bin/BoA/BoaStart.py'
  # Creating the MBFITSXML environment variable
  export MBFITSXML=$HOME/BoA/bin/BoA/MBFits.xml
  # Updating variables PATH and PYTHONPATH
  export PATH=$HOME/BoA/bin:$PATH
  export newPYTHON=$HOME/BoA/lib/python2.3/site-packages
  export PYTHONPATH=$newPYTHON
  export PYTHONPATH=$newPYTHON/Numeric:$PYTHONPATH
  export LD_LIBRARY_PATH=$HOME/BoA/lib:$LD_LIBRARY_PATH
  # Defining the PGPLOT_DIR variable
  export PGPLOT_DIR=$HOME/BoA/lib/pgplot/
  export LD_LIBRARY_PATH=$PGPLOT_DIR:$LD_LIBRARY_PATH
  export PGPLOT_DEV=/XWINDOW

Example for the .cshrc and .tcshrc (\$HOME is your home directory):

  # Creating an alias to start BoA
  alias boa 'python -i $HOME/BoA/bin/BoA/BoaStart.py'
  # Creating the MBFITSXML environment variable
  setenv MBFITSXML $HOME/BoA/bin/BoA/MBFits.xml
  # Updating variables PATH and PYTHONPATH
  setenv PATH $HOME/BoA/bin:$PATH
  setenv newPYTHON $HOME/BoA/lib/python2.3/site-packages
  setenv PYTHONPATH $newPYTHON
  setenv PYTHONPATH $newPYTHON/Numeric:$PYTHONPATH
  if ($?LD_LIBRARY_PATH) then
    setenv LD_LIBRARY_PATH $HOME/BoA/lib:$LD_LIBRARY_PATH
  else
    setenv LD_LIBRARY_PATH $HOME/BoA/lib
  endif
  # Defining the PGPLOT_DIR variable
  setenv PGPLOT_DIR $HOME/BoA/lib/pgplot/
  setenv PGPLOT_DEV /XWINDOW

Here is what Frank actually put into his .cshrc :

#=================================================================
# System variables, paths, and alias needed for python and BoA
#
if (-e /opt/intel/compiler60/ia32/bin/iccvars.csh) then
  source /opt/intel/compiler60/ia32/bin/iccvars.csh
endif
#
set boahome = '/aux/pc191b/bertoldi/boa'
#------------------------------------------------------------------
setenv PYTHONPATH .:/opt:/opt/intel/compiler60/ia32/lib/
setenv PYTHONPATH {$PYTHONPATH}:/usr/lib
setenv PYTHONPATH {$PYTHONPATH}:$boahome/lib/python2.3
setenv PYTHONPATH {$PYTHONPATH}:$boahome/lib/python2.3/site-packages
setenv PYTHONPATH {$PYTHONPATH}:$boahome/lib/python2.3/site-packages/Numeric
# -----------------------------------------------------------------
alias  boa "python -i BoaStart.py"
alias  cleanboa "/bin/rm -f BOA.MES* *.pyc"
setenv MBFITSXML $boahome/openboa/BoA/MBFits.xml
setenv PGPLOT_DIR $boahome/lib/pgplot/
setenv LD_LIBRARY_PATH {$PGPLOT_DIR}:{$LD_LIBRARY_PATH}
set path=( $boahome/bin $path )
# -----------------------------------------------------------------
setenv PYTHONSTARTUP /homes/dmuders/bin.python/interactive.py
setenv PGPLOT_DEV    /xserve
# -----------------------------------------------------------------
setenv CVSROOT :ext:openboa@glx-brazil.ias.u-psud.fr:/home/openboa/
setenv CVS_RSH ssh
alias  cvsupdate "cvs -q update -d"
alias  cvscommit "cvs commit -m "
# -----------------------------------------------------------------

The default ppgplot installation will have numarray support, but currently BoA uses Numeric. You will need to reinstall ppgplot now, else BoA will fail! To do this, enter allBoA/ppgplot-1.3 and edit the file setup.py such that it looks like:

    ...
    #from numarray.numarrayext import NumarrayExtension
    # comment-out the previous line ("from numarray ..."),
    # and comment-in the following to force the use of "Numeric"
    raise ImportError
    ...

Then from the ppgplot-1.3 directory, clean the installation:

make clean

and reinstall:

python setup.py install --prefix=/aux/pc191b/bertoldi/boa

where you put in the path you installed to earlier.