Personal tools

Hmatrix on Mac OS X

From HaskellWiki

(Difference between revisions)
Jump to: navigation, search
m (GSLHaskell on MacOS X moved to Hmatrix on Mac OS X)
(name changed to hmatrix)
Line 1: Line 1:
 
[[Category:How to]]
 
[[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.
+
Here are some notes on getting [http://www.hmatrix.googlepages.com/ hmatrix] 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 or even incorrect, but should point you in the right direction. The latest version of ''hmatrix'' considered here is 0.5.2.2.
   
 
Please update this page with anything you discover along the way.
 
Please update this page with anything you discover along the way.
Line 6: Line 6:
 
== Installing GHC using MacPorts ==
 
== 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:
+
First, you will want to install GHC using MacPorts, not the standalone installers. ''No sure why?'' Assuming that you have uninstalled any other versions of ghc, type:
   
 
sudo port install ghc
 
sudo port install ghc
Line 14: Line 14:
 
== Required libraries ==
 
== Required libraries ==
   
GSLHaskell requires working versions of GSL, BLAS and LAPACK. You can get GSL and BLAS from DarwinPorts:
+
The ''hmatrix'' package requires working versions of GSL, BLAS and LAPACK.
  +
  +
You can get GSL and BLAS from DarwinPorts:
   
 
sudo port install gsl
 
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.
+
LAPACK, however, is already installed on MacOS X 10.4/10.5, namely in the ''vecLib'' (10.4) or ''Accelerate'' (10.5) frameworks. They appear to work fine with ''hmatrix'', though I didn't test very much.
   
== Installing GSLHaskell ==
+
== Installing ''hmatrix'' ==
   
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:
+
The [http://hackage.haskell.org/cgi-bin/hackage-scripts/package/hmatrix most recent version] of ''hmatrix'' is available on [http://hackage.haskell.org/ HackageDB]. You can also download it from the darcs repository as follows:
   
 
darcs get http://perception.inf.um.es/~aruiz/darcs/hmatrix --partial
 
darcs get http://perception.inf.um.es/~aruiz/darcs/hmatrix --partial
  +
  +
''The following steps seem obsolete to me. -- Apfelmus''
   
 
Next, edit hmatrix.cabal to refer to the appropriate versions of BLAS and LAPACK:
 
Next, edit hmatrix.cabal to refer to the appropriate versions of BLAS and LAPACK:
Line 41: Line 43:
 
sudo runhaskell Setup.lhs install
 
sudo runhaskell Setup.lhs install
   
== Using GSLHaskell ==
+
== Using ''hmatrix'' ==
   
To load GSLHaskell using GHCI, you need to add the directory containing the gsl shared library to your LD_LIBRARY_PATH:
+
To load ''hmatrix'' using GHCI, you need to add the directory containing the gsl shared library to your LD_LIBRARY_PATH:
   
 
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/local/lib
 
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/local/lib
   
The LAPACK implementation is contained in the vecLib framework. For interactive use, type
+
On Mac OS X 10.4, the LAPACK implementation is contained in the vecLib framework. For interactive use, type
   
 
ghci -framework vecLib
 
ghci -framework vecLib

Revision as of 17:11, 28 October 2009

Here are some notes on getting hmatrix running under Mac OS X 10.4 or 10.5 using MacPorts or fink.

These notes may be incomplete or even incorrect, but should point you in the right direction. The latest version of hmatrix considered here is 0.5.2.2.

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

Contents

1 Installing GHC using MacPorts

First, you will want to install GHC using MacPorts, not the standalone installers. No sure why? 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.

2 Required libraries

The hmatrix package requires working versions of GSL, BLAS and LAPACK.

You can get GSL and BLAS from DarwinPorts:

sudo port install gsl

LAPACK, however, is already installed on MacOS X 10.4/10.5, namely in the vecLib (10.4) or Accelerate (10.5) frameworks. They appear to work fine with hmatrix, though I didn't test very much.

3 Installing hmatrix

The most recent version of hmatrix is available on HackageDB. You can also download it from the darcs repository as follows:

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

The following steps seem obsolete to me. -- Apfelmus

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

4 Using hmatrix

To load hmatrix using GHCI, you need to add the directory containing the gsl shared library to your LD_LIBRARY_PATH:

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/local/lib

On Mac OS X 10.4, the LAPACK implementation is contained in the vecLib framework. For interactive use, type

ghci -framework vecLib

To build an example program using GHC, type:

cd examples
ghc --make -framework vecLib plot.hs

5 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.

6 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.