Preparation for Mac OS X (Lion)

Installing GIPSY on Mac OS X may be complicated by the fact that software can be obtained from various places. E.g., Fink, MacPorts, etc. The approach that worked for us is largely derived from the information on the web page Installing Python, ... (on "This is the Green Room"). For more information and hints, please visit that page.

Steps to take

For a freshly installed Mac OS system, do the following:

Install Xcode 4.2 from the App Store (Apple ID required)
Install Homebrew ("The missing package manager for OS X"). From Terminal execute the following lines:
```
/usr/bin/ruby -e "$(curl -fsSL https://raw.github.com/gist/323731)"
brew update
brew doctor
```
To add the Homebrew directory to your system path, edit .bash_profile and add the line
```
export PATH=/usr/local/bin:$PATH
```
Then restart Terminal to make this effective.
Install gfortran. The following should work but in our case it failed due to an Xcode version problem:
```
brew install gfortran
```
So we obtained it from http://gcc.gnu.org/wiki/GFortranBinaries and installed from gfortran-4.6.2-x86_64-Lion.dmg we found there.
Install Xaw3d:
```
brew install xaw3d
```
Install an "own" Python. This is necessary because the system's Python is incompatible with NumPy and/or Matplotlib and possibly other packages. From the terminal:
```
brew install python --framework --universal
```
Then add the following to .bash_profile:
```
export PATH=/usr/local/share/python:$PATH
```
Again, restart Terminal to make this effective. Finally change OS X's symlink to point at your new Python install. Run the following three lines in sequence:
```
cd /System/Library/Frameworks/Python.framework/Versions
sudo rm Current
ln -s /usr/local/Cellar/python/2.7.2/Frameworks/Python.framework/Versions/Current
```
Install pip, a Python package manager:
```
easy_install pip
```
Install NumPy:
```
pip install numpy
```
Install PyFITS:
```
pip install pyfits
```

Install matplotlib:

pip install matplotlib
     or, if this fails:
pip install -e git+https://github.com/scipy/scipy#egg=scipy-dev

Install PyQt4:
```
brew install pyqt
```
After installing pyqt, brew will prompt you to add the following to your python path in .bash_profile:
```
export PYTHONPATH=/usr/local/lib/python:$PYTHONPATH
```
Install wget:
```
brew install wget
```
(only required when the all-in-one installation script gipsy_install.csh is used)

This setup will allow you to install most of GIPSY. Parts that don't work or don't work properly are:

GIDS, GIPSY's old display server. The Mac OS implementation of the X11 PseudoColor visual makes it useless for our purposes: changes to the colormap only become effective after minimizing the window. Tasks that depend on GIDS, e.g. VIEW, BLOT, etc., cannot be run.
VTK. There are issues with the compilation of the libraries and options used in X11 programs. Due to this, the task VTKVOLUME will not be available.

December 12, 2011