User login

How do I install PASSOFT?

Getting PASSOFT

The first step to getting PASSOFT installed on your system is to download the correct installer/package.

Mac OS X

Navigate to: http://www.passcal.nmt.edu/ftp/software/passoft/osx/

There the latest stable .dmg images are posted.  PASSOFT is currently built against Tiger and Leopard on PPC as well as Intel machines.  Make sure to download the one that matches your architecture.  The packages are labelled like so:
PASSOFT-MAJORVERSION(year)-MINORVERSION(Day of Year).OSXVERSION.PROCESSORTYPE.dmg

Linux (Fedora 10)

Navigate to: http://www.passcal.nmt.edu/ftp/software/passoft/linux/

There the latest stable .rpm packages are posted.  PASSOFT is currently built against Fedora 10 i386.  The packages are labelled like so:
PASSOFT-MAJORVERSION(Year)-MINORVERSION(Day of Year).i386.rpm

Solaris (10)

Navigate to: http://www.passcal.nmt.edu/ftp/software/passoft/solaris/

There the latest stable .tar.gz packages are posted.  PASSOFT is currently built against Solaris 10 sparc.  The packages are labelled like so:
PASSOFT-MAJORVERSION(Year)-MINORVERSION(Day of Year)-solaris10-sparc.rpm

Get the source code

Use svn to download the latest source like this: svn export https://svn.passcal.nmt.edu/svn/passoft

login: field, password: passcal

NOTE: This source code only includes PASSOFT software.  To install from source you will need:

gcc

Python 2.5 or 2.6 - http://www.python.org

SciPy with MatplotLib, and basemap - http://www.scipy.org

PIL - http://www.pythonware.com/products/pil

Pmw - http://pmw.sourceforge.net

Pyserial - http://pyserial.wiki.sourceforge.net/pySerial

Numpy - http://numpy.scipy.org

Pytables - http://www.pytables.org/moin

Installing PASSOFT

Installing PASSOFT is a highly platform-dependent process.  All of the pre-built packages are binary packages. Full source code is also included with the pre-built packages and gets installed in /opt/passcal/src.

Mac OS X

  1. Mount the installer image
    Clover+click on the .dmg image you downloaded and click on "Open" from the selector.  This will mount the .dmg and make it available in Finder.  Navigate to the newly mounted image (usually under "Devices" in the left-hand navigation for Finder).

  2. Run the installer script

    Now double click the .pkg installer.  It will be labelled like so: PASSOFT-MAJORVERSION-MINORVERSION.OSXVERSION.PROCESSORTYPE.pkg (NOTE: the .pkg extension may be hidden depending on your user preferences).  Follow all of the instructions given by the installer program.  This will require administrative access to install.

  3. Run the "Configure" script
    In order to configure your environment to correctly find PASSOFT and make it available, double-click on the "Configure" script.  It is included in the .dmg image and should be in the same directory as the .pkg installer was.  A dialogue will appear to confirm that your environment has been updated, or it will notify you that your environment was already correctly configured (likely if you have previously installed PASSOFT).

  4. You're done!
    A new folder with "Application Launchers" for included PASSOFT software should now be available in your /Applications directory.  This directory is named "PASSOFT."

Linux (Fedora 10)

  1. Install the rpm
    Install the newly downloaded rpm with the following command: rpm -ivh --nodeps **RPMFILE**
    The --nodeps flag is important because PASSOFT contains all of its own dependent libraries and if rpm believes the package to be dependent on another package, then it will not install unless the other package is there.

NOTE for non-Fedora users:  While the PASSOFT package is not built against anything but Fedora 10, the package contains all of PASSOFT's dependencies, and therefore should install just fine on many other linuxes.  Previous versions of the PASSOFT package have been known to work Ubuntu with the use of the "alien" rpm-to-deb conversion tool.  While IRIS PASSCAL does not test PASSOFT on anything but Fedora, you may have luck installing it on your system none-the-less.  Let us know how well it works!

Solaris (10)

  1. Unpack the tarball
    The contents of the .tar.gz are expected to unpack to /opt/passcal.  Create a folder there and unpack the contents of the tarball into it.
  2. Configure your environment
    After unpacking, you should now have setup.sh (for bash) and a setup.csh (for tcsh) in your /opt/passcal/setup/ directory.  Configure your rc files for you shell to source the correct one of these scripts for your environment.

Building from source (not for the faint of heart)

First of all, it is good to mention that this assumes that you already have all of the dependent packages and their development packages installed.  The binaries include these dependencies, and may be easier to install.  Here are the instructions assuming you already have a working Python 2.6 with SciPy, basemap and MatplotLib etc.:

NOTE: More instructions are included with the source code in the file named "instructions"

  1. Edit and source the setup_passoft file
    This file is located in the "src" directory in the downloaded source.  It has specific instructions on what variables may need to be configured.  Now change into tcsh and source the setup_passoft file you just edited.
  2. Make and install
    With proper user privileges, run: make all, check the output for errors, and then make install