View source for Hmatrix on Mac OS X

[[Category:How to]]
Here are some notes on getting [http://dis.um.es/~alberto/GSLHaskell/ GSLHaskell] running under [[Mac OS X]] 10.4 or 10.5 using [http://www.macports.org/ MacPorts] or [http://finkproject.org/ fink]. These notes may be incomplete, and the details may change slightly in the future.

Please update this page with anything you discover along the way.

== Installing GHC using MacPorts ==

First, you will want to install GHC using MacPorts, not the standalone installers. Assuming that you have uninstalled any other versions of ghc, type:

 sudo port install ghc

This may take several hours to bootstrap on a slow machine.

== Required libraries ==

GSLHaskell requires working versions of GSL, BLAS and LAPACK. You can get GSL and BLAS from DarwinPorts:

 sudo port install gsl

The accelerated version of LAPACK bundled with MacOS X 10.4/10.5 appears to link with GSLHaskell, though I haven't tested it extensively.

== Installing GSLHaskell ==

The [http://hackage.haskell.org/cgi-bin/hackage-scripts/package/hmatrix  most recent version] of GSLHaskell is available on [http://hackage.haskell.org/ HackageDB] with the name ''hmatrix''. You can also download it from the darcs repository as follows:

darcs get http://perception.inf.um.es/~aruiz/darcs/hmatrix --partial

Next, edit hmatrix.cabal to refer to the appropriate versions of BLAS and LAPACK:

 extra-libraries:    gsl gslcblas LAPACK

you might also have to edit cc-options and ld-options to look in your ports directory:

 cc-options:         -O4 -I/opt/local/include
 ld-options:         -L/opt/local/lib

To build and install the package, type:

 runhaskell Setup.lhs configure
 runhaskell Setup.lhs build
 sudo runhaskell Setup.lhs install

== Using GSLHaskell ==

These instructions are awkward, and can probably be improved with better knowledge of GHC and/or Cabal.

To load GSLHaskell using GHCI, you need to add two directories to your LD_LIBRARY_PATH:

 export LD_LIBRARY_PATH=/System/Library/Frameworks/Accelerate.framework/Versions/A/Frameworks/vecLib.framework/Versions/A/:/opt/local/lib

To build an example program using GHC, type:

 cd examples
 ghc --make -optl-L/System/Library/Frameworks/Accelerate.framework/Versions/A/Frameworks/vecLib.framework/Versions/A/ plot.hs

== Plotting with gnuplot and Aquaterm ==

Install gnuplot using MacPorts:

 sudo port install gnuplot

If Aquaterm fails to compile, upgrade to the latest version of XCode. Tell gnuplot what terminal to use:

 export GNUTERM=aqua

You should now be able to build and run examples/plot.hs, and see three nicely anti-aliased plots.  If you're using an xterm, you can also choose to leave GNUTERM unset to use gnuplot's built-in X11 support, which is uglier, but apparently allows rotation of 3D plots using the mouse.

== Using fink ==

With minor changes the instructions work for fink. (I have already had the ghc and ghc-bin packages) In short:

  fink install gsl
  fink install atlas
  fink install darcs
  darcs get http://perception.inf.um.es/~aruiz/darcs/hmatrix --partial
  (fink instal gnuplot)

  runhaskell Setup.lhs configure
  runhaskell Setup.lhs build
  su
  runhaskell Setup.lhs install
  exit  
  cd examples
  export LD_LIBRARY_PATH=/sw/lib/
  runhaskell tests
  OK, passed 100 tests.
  OK, passed 100 tests.
  etc.

Note that the latest version requires cabal 1.2 and the present fink version of ghc (6.6) has lower version. Nevertheless after installing cabal (which itself requires zlib and filepath) hmatrix installs without problems.