EMAN autoconf System

Introduction

EMAN autoconf system is to compile EMAN source code without user manual intervention. It is a configuration tool to make EMAN portable in many UNIX-like systems. Its functions include, but not limited to: 1) determine the right compiler and compiler options; 2) search the required libraries and header files. 3) give user options to enable/disable optional features.

Tested Platforms

SGI, IRIX 6.5
Linux x86, Mandrake 8.2, 9.0, RedHat 7.2, 7.3, 8.0
Cygwin B20.1

Libraries

Library search orders are:
1) user specified dir, e.g., user can set fftw directory with configure --with-fftw-dir=/home/lpeng/fftw.
2) $HOME/EMAN/lib
2) /usr/lib32
3) /usr/lib
4) /usr/local/lib
5) /usr/X11R6/lib
6) $HOME/lib

Header Files

1) user specified dir.
2) $HOME/EMAN/include
3) $HOME/EMAN/src
4) /usr/include
5) /usr/local/include

QT

The following possible qt versions are searched: "3 3.00 3.0.1 3.0.2 3.1.0 3.1.1 3.2.0 3.2.1 3.2.2 3.2.3 3.2.4 3.3.0 3.3.1 3.3.2 2 2.00 2.0.1 2.0.2 2.1.0 2.1.1 2.2.0 2.2.1 2.2.2 2.2.3 2.2.4 2.3.0 2.3.1 2.3.2". The searched base directories are /opt/qt /usr/lib/qt /usr/local/qt /usr/qt /usr/X11R6 /usr /usr/local. Any combinations of the base directory and the versions are searched.
It will search for higher version of Qt first.
If a user set up 'QTDIR' environment variable, use QTDIR.

Optional Feature: boost python

python version of EMAN. to enable this feature, run configure with --enable-python. Then the following libraries and header files will be searched:
- python interpreter
- python header file: Python.h
- Boost Python header: boost/python.hpp.
- Boost Python library: libboost_python.so.
On SGI, the following flags must be put in compiler flags: -I/usr/local/include/boost/compatibility/cpp_c_headers -LANG:std -mips4
on SGI, 'libpyEM' linker must be the compiler 'CC' instead of 'LD'. To make this happen, in 'configure.in', AM_PROG_LIBTOOL must be put before any CXX flags is set. And a user must run 'setenv LD CC' before he/she runs 'configure; make; make install'.

Large File Support

enable large file support when an off_t is bigger than a long and long long is available and at least as big as an off_t.
add -D_FILE_OFFSET_BITS=64 -D_LARGEFILE_SOURCE to compiler flags. They are required on some systems for large file support, e.g., LINUX.
check functions: fseek64 fseeko ftell64 ftello
check size of long and long long.
check size of off_t, which is used in fseek() and ftell() etc

Optional Features and Packages

 
   The following are optional features you can enable/disable when
   running 'configure':

      --enable-py                   enable EMAN Python support default=no
      --enable-cluster              enable parallel support default=no
      --enable-openiv               enable Open Inventor support default=no
      --enable-openmp               enable OpenMP support default=no
      --enable-opengl               enable OpenGL support default=no

      --disable-dependency-tracking Speeds up one-time builds
      --enable-dependency-tracking  Do not reject slow dependency extractors
      --enable-static[=PKGS]        build static libraries [default=no]
      --enable-shared[=PKGS]        build shared libraries [default=yes]
      
   For example, to enable static library, do
     ./configure --enable-static

     
   The following are optional packages you can use when running
   'configure':
   
      --with-gsl-inc=DIR      GSL include files are in DIR
      --with-gsl-lib=DIR      GSL library files are in DIR
      
      --with-fftw-lib=DIR     FFTW library files are in DIR
            
      --with-python=FILE      Python executable is FILE
      
      --with-qt-dir=DIR       Qt root directory is DIR
      --with-qt-inc=DIR       Qt include files are in DIR
      --with-qt-lib=DIR       Qt library files are in DIR
      
      --with-boostpy-inc=DIR  Boost Python include files are in DIR
      --with-boostpy-lib=DIR  Boost Python library files are in DIR
      
      --with-openiv-inc=DIR   Open Inventor include files are in DIR
      --with-openiv-lib=DIR   Open Inventor library files are in DIR

      --with-openmp-inc=DIR   OpenMP include files are in DIR
      --with-openmp-lib=DIR   OpenMP library files are in DIR
      
      --with-opengl-inc=DIR   OpenGL include files are in DIR
      --with-opengl-lib=DIR   OpenGL library files are in DIR

      
   For example, to use fftw library under /home/foo/fftw, you can run
     ./configure --with-fftw-lib=/home/foo/fftw

     
   The following are other options for 'configure':
   
     --help          to list the help information for configuration
     --with-debug            compile debuggable version of programs

Autoconf tools used

aclocal
automak
autoconf
libtool.

Platform-specific issues

IRIX. use 'CC' instead of 'ld' as the linker. 'CC' can solve symbols like STL.
Cygwin. Use static libraries only. Run configure like ./configure --enable-shared=no --enable-static=yes




	



lpeng@bcm.tmc.edu

Last modified: Thu Jun 27 11:06:39 CDT 2002