~~NOTOC~~

===== Downloading and installing SPAM =====

Here are some instructions on how to install SPAM on your Linux 64-bit system. If you want to install it on some other Unix-based system, you're on your own :-).

-----

==== Download SPAM and dependencies ====

An installation of SPAM on Linux requires at least the following items:
   * The latest SPAM package, found [[https://ftp.strw.leidenuniv.nl/intema/spam/spam_20240308.tgz|here]]
   * SPAM support files, found [[https://ftp.strw.leidenuniv.nl/intema/spam/spam_etc_20181208.tgz|here]]
   * AIPS version 31DEC13 (LNX64 binary tarball with extras), found [[https://ftp.strw.leidenuniv.nl/intema/spam/AIPS_31DEC13.tgz|here]]
   * ParselTongue version 2.3 (with changes), found [[https://ftp.strw.leidenuniv.nl/intema/spam/parseltongue-2.3e.tgz|here]]
   * Obit core (LNX64 binary with changes), found [[https://ftp.strw.leidenuniv.nl/intema/spam/obit_20160115.tgz|here]] 

The following necessary items are often already available on a standard scientific Linux installation:
   * Python version 2.7 (plus C include files)
   * Python packages: pylab / matplotlib, numpy, scipy, astropy
   * gcc
   * make
   * swig
   * optional: mencoder / mplayer (for making phase screen movies)
   * optional: ImageMagick convert (for making phase screen movies) 

-----

==== Install SPAM ====

Make a new directory that will hold all spam software

In your Linux shell, type
<code bash>
cd <local software path>
mkdir spam
cd spam
</code>
Move the downloaded tarballs to here.

In your Linux shell, type
<code bash>
mv <download path>/AIPS_<version>.tgz .
mv <download path>/parseltongue-<version>.tgz .
mv <download path>/obit_<version>.tgz .
mv <download path>/spam_<version>.tgz .
mv <download path>/spam_etc_<version>.tgz .
</code>

-----

==== Install SPAM support files ====

<code bash>
> tar xzf spam_etc_<version>.tgz
</code>

Edit setup file(s) and modify SPAM_PATH to point to <local software path>/spam, SPAM_HOST to your machine name in capitals, and PYTHON to point to your python2.7 executable
<code bash>
gedit setup.*sh
</code>

Next, run the setup file. In Linux bash (sh) this is done through:
<code bash>
source setup.sh
</code>
In Linux C-shell ([t]csh) this is done through:
<code bash>
source setup.csh
</code>

-----

==== Install AIPS ====

In your Linux shell, type
<code bash>
tar xzf AIPS_31DEC13.tgz
cd AIPS
</code>
These next two steps may not apply to you, but must be executed when you have installed and/or run AIPS locally.
<code bash>
mv ~/.AIPSRC ~/.AIPSRC_previous
mv ~/.dadevs ~/.dadevs_previous
</code>
Then start the actual install
<code bash>
perl install.pl -n
</code>

Here's how to quickly get through the AIPS installation
<code bash>
screen 0: <enter>
screen 4: <enter>
screen 4b: <enter>
screen 5: <e.g., your institute name in capitals (no spaces), and enter>
screen 5a: <enter>
screen 5b: <check that this is set to LNX64, and enter>
screen 6: <enter>
screen 7: <copy/paste suggested path and enter>
screen 8: <2x enter>
screen 9: <enter>
screen 9B: <enter>
screen 11: <2x enter>
</code>
And during installation: <3x/4x enter>
This should run without errors (see [[huibintema:spam:faq|SPAM FAQ]] if it can't find libncurses.so).

Now we need to increase number of interactive AIPS sessions to 32. In your Linux shell, type in the Linux shell
<code bash>
source LOGIN.(C)SH
</code>
Then
<code bash>
RUN SETPAR
</code>
In SETPAR go through the following menus
<code bash>
2 <enter>
10 <enter>
32 <enter>
-1 <enter>
AMANAGER <enter>
4 <enter>
</code>

Test AIPS by entering
<code bash>
aips tv=local
</code>
In AIPS POPS terminal, enter
<code bash>
11 <enter>
print 2+2 <enter>
kleenex <enter>
</code>

Exit AIPS directory
<code bash>
cd ..
</code>

-----

==== Install Obit core ====

In your Linux shell, type
<code bash>
tar xzf obit_<version>.tgz
</code>
And that's it.

-----

==== Install ParselTongue ====

In your Linux shell, type
<code bash>
tar xzf parseltongue-<version>.tgz
cd parseltongue-<version>
sh ./configure --prefix=${SPAM_PATH}/ParselTongue --with-obit=${SPAM_PATH}/Obit
</code>
This should return without errors (see [[huibintema:spam:faq|SPAM FAQ]] if it can't find obit). Then type:
<code bash>
make install
cd ..
</code>

-----

==== Install SPAM package ====

In your Linux shell, type
<code bash>
tar xzf spam_<version>.tgz
cd python/spam
</code>
Edit the makefile so that the SWIGFLAGS and CCFLAGS point to the correct Python C header file directory (will contain Python.h; typically something like /usr/include/python2.7).
<code bash>
gedit makefile
make
cd ../..
</code>

And that's all folks!

-----

<html>
<!-- Start of StatCounter Code for Default Guide -->
<script type="text/javascript">
var sc_project=11352095; 
var sc_invisible=1; 
var sc_security="a84eef88"; 
var sc_text=2; 
var scJsHost = (("https:" == document.location.protocol) ?
"https://secure." : "http://www.");
document.write("<sc"+"ript type='text/javascript' src='" +
scJsHost+
"statcounter.com/counter/counter.js'></"+"script>");
</script>
<noscript><div class="statcounter"><a title="free hit
counter" href="http://statcounter.com/" target="_blank"><img
class="statcounter"
src="//c.statcounter.com/11352095/0/a84eef88/0/" alt="free
hit counter"></a></div></noscript>
<!-- End of StatCounter Code for Default Guide -->
</html>

Feedback: [[intema@strw.leidenuniv.nl|Click here]]