PLEASE!

Drop me a line to let me know whether you were able to install FLENS or not: michael.lehn@uni-ulm.de

Requirements: What you need before you install FLENS

FLENS requires a working BLAS and LAPACK implementation on your system. You also need CBLAS a C interface for BLAS on your system. This should not be a problem as for all Unix systems there are either pre-compiled packages or it is easy to compile and install these libraries by your self.

FLENS should compile with:

There a different BLAS and LAPACK implementations you can use:

Platforms I am using myself and where FLENS should work without any problems:

I also use FLENS on an SUSE Opteron cluster. But I guess the paths and packages there are not quite standard.


Download the latest CVS-Snapshot

The latest snapshot from CVS is available at SOURCEFORGE.NET.


Configure FLENS

  1. Setup configuration for FLENS:
    In the FLENS-lite directory are several config.* files. Among these are: 
      config.macosx  (for Mac OS X users)
  config.ubuntu  (for Ubuntu users)
  config.sun_ulm (for OUR students!)
    • If you belong to a listed user group rename your config.* to config.
    • Otherwise take the config-template that is closest to your system and adapt it to your system. Here the config.ubuntu file: 
        CXX         = g++
  CXXFLAGS   += -Wall -g -O3 -fPIC
  INCDIRS    += -I.
  DYLIB_EXT   = so
  CXXDYLIB    = -shared
  LDFLAGS    += -llapack -latlas -lblas
      You see: just specify
      • your compiler and compiler flags ,
      • the BLAS and LAPACK libraries you wish to link against.
    • If you can provide me configure files for other systems I would appreciate it.
    • If you have problems let me know or join and contact the mailing list!
  2. Compile FLENS:
    Type 
      make
  3. Install FLENS:
    • You can either install FLENS system wide (if you have root privileges) or install FLENS in a subdirectory of your home directory (that allows you to test FLENS quick and easy).
    • Install FLENS in a local directory inside your home directory
      Setup your environment such that the linker can find FLENS. Of course you should adapt the path to your needs:
      • On Linux 
          export LD_LIBRARY=/home/lehn/FLENS-lite/:$LD_LIBRARY
      • On Mac OS X 
          export DYLD_LIBRARY_PATH=/Users/lehn/FLENS-lite/:$DYLD_LIBRARY_PATH
      Now check whether you can run the programs in the examples and tutorials directory (both are subdirectories inside the FLENS directory). If that works you can start to write your first C++ program using FLENS:
      • The Makefile in examples and tutorials will translate all files with ending *.cc. This Makefile is kept very simple. It is supposed to be convenient if you implement small examples where everything is in one source file.
    • Install FLENS system wide
      Doing 
        make install
      with root privileges will install FLENS system wide:
      • Headers will be copied into /usr/local/include/flens
      • Shared libraries (or dynamic libraries) will be copied into /usr/local/lib
      If you want to install FLENS in a different directory add a PREFIX variable to you config file. Here an example based on config.ubuntu: 
        PREFIX = /opt/local/

  CXX         = g++
  CXXFLAGS   += -Wall -g -O3 -fPIC
  INCDIRS    += -I.
  DYLIB_EXT   = so
  CXXDYLIB    = -shared
  LDFLAGS    += -llapack -L /usr/lib/atlas -lblas
      Now
      • Headers will be copied into /opt/local/include/flens
      • Shared libraries (or dynamic libraries) will be copied into /opt/local/lib

Obtain FLENS from CVS

If you want a bleeding edge version of FLENS obtain it via CVS: 

  export CVSROOT=:pserver:anonymous@flens.cvs.sourceforge.net:/cvsroot/flens
  export CVS_RSH=ssh
  cvs login
  cvs -z3 co -P FLENS-lite
If you are asked for a password just hit 'return'.