install

数学公式库--非常不错 The GNU Scientific Library (GSL) is a collection of routines for numerical computing. T

GSL - GNU Scientific Library
============================

Installation Instructions
=========================

GSL follows the standard GNU installation procedure.  To compile GSL
you will need an ANSI C-compiler.  After unpacking the distribution
the Makefiles can be prepared using the configure command,

  ./configure

You can then build the library by typing,

  make

Both static and shared versions of the libraries will be compiled by
default.  Compilation of shared libraries can be turned off by
specifying the `--disable-shared' option to `configure', e.g.
  
  ./configure --disable-shared

If you encounter problems building the library try using the above
option, because some platforms do not support shared libraries.

For notes about problems with specific platforms and compilers see the
next section of this file (below).

An extensive test suite is available.  After compiling the library
with "make", it can be invoked with "make check" at the top level.
The test output should be directed to a file rather than a terminal,
with the command,

   make check > log 2>&1

to allow any errors to be examined in detail.  By default, only test
failures are shown.  To see the complete output, set the environment
variable GSL_TEST_VERBOSE=1.

If you run the tests and get some failures, please see the notes on
platform specific problems below.  If you find failures that are not
mentioned, please report them to [e-mail].

The library can be installed using the command,

  make install

The default installation directory prefix is /usr/local.  Consult the
"Further Information" section below for instructions on installing the
library in another location or changing other default compilation
options.

                    ------------------------------

Platform Specific Compilation Notes
===================================

This section documents any known issues with installing GSL on
specific platforms.

  * General hints for all platforms
  * AIX
  * Compaq/DEC Alpha
  * HP-UX
  * IRIX
  * MacOS X / PowerPC
  * Microsoft Windows
  * OpenBSD
  * OS/2
  * Solaris

Hints for any platform
======================

1) If there are problems building the library try using

        ./configure --disable-shared

This will turn off the compilation of shared libraries and may allow
the build process to complete successfully.  

If you get any problems try this first.

2) With gcc-2.95/2.96 the tests fail in the eigen/ directory.  This is
due to a compiler optimization bug which causes errors in the
manipulation of complex numbers.  

This is fixed in more recent versions of gcc.  Do not use the library
if you encounter this problem---install a newer version of gcc.

3) Attempts to run 'strip' on the static library libgsl.a will probably
produce a broken library (it is known to happen with GNU binutils
strip, and probably affects others too). The libgsl.a ar archive made
by libtool contains files with the same filenames from different
directories, and this causes the strip program to overwrite these
archive entries.  If you need to produce a compact version of the
library compile without -g instead of using strip.

make install-strip does not work, due to a minor problem with autoconf
which is fixed in the 2.5 development version of autoconf.  In the
meantime compile without -g instead if you need to reduce the file size.

4) The configure script can fail with a segmentation fault on bash-2.01

    $ ./configure
    Segmentation fault

This is due to a bug in bash, related to the MAIL environment
variable.  To work around it use 

    $ unset ENV MAIL MAILPATH
    $ ./configure

which should avoid the problem.

Hints for AIX
=============

For compilation problems with the native compiler xlc, try disabling
shared libraries,

    setenv CC 'xlc'
    setenv CFLAGS '-O -qmaxmem=8192'
    ./configure --disable-shared
    make

If you get the error,

   ld: 0711-781 ERROR: TOC overflow. 

you can try building the library with a larger linker
table-of-contents by setting LDFLAGS before compilation,

   LDFLAGS="-Wl,-bbigtoc" ./configure

On older versions of AIX (e.g. 4.2) the size of the command-line is
limited to 24kb, which causes linking to fail (due to the large number
of files to be linked). Unfortunately this limit cannot be increased.
To link the library you may need to use a manual approach of
incrementally combining the object files in smaller groups.

Hints for Compaq/DEC Alpha
==========================

When comping with GCC use the -mieee and -mfp-rounding-mode options 
as appropriate, e.g.

    ./configure CFLAGS="-mieee -mfp-rounding-mode=d -g -O2"

The library should compile successfully with Compaq's C compiler on
Tru64 Unix 'cc' using the -std, -ieee and -fprm options.  Use

    ./configure CC=cc 
    make CFLAGS="-std -ieee -fprm d"

to build the library this way.

Use GNU tar to unpack the tar file, as Tru64 tar gives an error
halfway through.

Hints for HP-UX
===============

The default mode of the HP-UX C compiler does not use ANSI C.

To compile GSL you need to select ANSI C mode with the following
configuration option:

      CFLAGS="-Ae"  ./configure

To switch on optimization use CFLAGS="-Ae -O".

Hints for IRIX (SGI)
====================

The library should be compiled with the CFLAGS option
-OPT:IEEE_NaN_inf=ON to ensure correct IEEE arithmetic.  The tests in
sys/ will fail without this option.  The older deprecated option
-OPT:IEEE_comparisons=ON will also work.

The 32 bit IRIX compiler gives warnings about "long double" not being
supported. These can be ignored or turned off with,

   CFLAGS="-woff 728" ./configure

or 

   make CFLAGS="-woff 728"

The compiler also gives warnings about certain libraries that are "not
used for resolving any symbol". This is harmless and the warnings can
be ignored.

You may get warnings about " /usr/bin/ld: arg list too long" when
building shared libraries.  If so, try increasing the ncargs kernel
parameter with the systune(1m) command.

For 64-bit compilation use the following options,

  CC=cc CFLAGS="-64" LDFLAGS="-64" ./configure

or for gcc

  CFLAGS="-mabi-64" LDFLAGS="-mabi=64 -mips4 -L/usr/local/lib/mabi=64"

Hints for MacOS X and PowerPC
=============================

Note that GSL contains files with filenames of 32 characters or more.
Therefore you need to be careful in unpacking the tar file, as some
MacOS applications such as Stuffit Expander will truncate filenames to
31 characters.  Using GNU tar and gunzip directly is the safe way to
unpack the distribution.

There are problems with dynamic linker, so the library should be
compiled with,

  ./configure --disable-shared

It has been reported that shared libraries can be built if MacOS X
specific versions of libtool, automake and autoconf from
http://fink.sourceforge.net/ are installed, and the GSL source is
reconfigured from scratch (./autogen.sh; ./configure; make)

To avoid warnings about long-double, use the flag

  CFLAGS="-Wno-long-double ....(other options here)"

in addition to the normal compilation options.

The GCC 3.3 compiler shipped by Apple contains a bug which causes the
wavelet tests to fail on "data untouched" tests at optimisation level
-O2. You can compile with CFLAGS="-O1 ..."  to work around this.

F J Frankin <[e-mail]> reported that some early
versions of GCC-2.95 have a problem with long argument lists on PPC
architecture, and this prevents GSL from compiling correctly (e.g. the
test program in the blas directory gives a segmentation fault when
run).  This problem is fixed in more recent versions of GCC.