******************************************************************************
*                                                                            *
*                                 TPMATH1.ZIP                                *
*                                                                            *
*                      MATHEMATICAL LIBRARY IN PASCAL                        *
*                               PART 1 : UNITS                               *
*                          Last updated : May 2000                           *
*                                                                            *
******************************************************************************



                            AUTHOR : Dr Jean DEBORD

               Laboratoire de Pharmacologie, Faculte de Medecine
               2 Rue du Docteur Marcland, 87025 Limoges (France)
                               debord@.unilim.fr
                            JDebord@compuserve.com


******************************************************************************
 This library is distributed as freeware. You may use it any way you like, as
 long as you don't charge money for it, remove the copyright notices, or hold
 anyone liable for its results.
******************************************************************************



CONTENTS
========

Main directory
--------------

  FMATH.PAS    : Mathematical functions, complex numbers
  MATRICES.PAS : Vector and matrix operations
  MATCOMP.PAS  : Complex matrices
  EIGEN.PAS    : Eigensystems
  OPTIM.PAS    : Function minimization
  POLYNOM.PAS  : Polynomials and rational fractions
  FOURIER.PAS  : Fast Fourier transform
                 (modified from Don Cross, with permission)
  RANDOM.PAS   : Random numbers
  MCMC.PAS     : Simulation by Markov Chain Monte Carlo
  STAT.PAS     : Statistical functions
  REGRESS.PAS  : Linear and nonlinear regressions
  PASTRING.PAS : Turbo Pascal string routines
  PLOT.PAS     : Plotting routines for DOS
  WINPLOT.PAS  : Plotting routines for Windows (Delphi)

  MATHCONS.INC : Mathematical constants
  MATHFUNC.INC : Mathematical functions: Pascal version
  MATH387.INC  : Mathematical functions: Assembler version for 387+ coprocessors
                 (modified from J.D. Gayrard, with permission)
  COMMON.INC   : Contains code common to MATHFUNC.INC and MATH387.INC
  MATHSPEC.INC : Special functions
  PROBA.INC    : Probability functions
  COMPLEX.INC  : Complex numbers and functions
                 (modified from E.F. Glynn, with permission)
  PLOT.INC     : Plotting routines (common to DOS and Windows)

  TPMATH1.TXT  : This file

Subdirectory REG
----------------

  MODELS.PAS   : Library of predefined regression models
  FIT*.PAS     : Individual regression models (used by MODELS.PAS)


SYSTEM REQUIREMENTS
===================

- PC or compatible

- Math coprocessor recommended

- Pascal compiler: Turbo Pascal 5.0+ (DOS)
                   Delphi 1.0+ (Windows)
                   Free Pascal (FPC) 0.99.14+ (DOS / Linux)

Notes:

(1) MATH387.INC can be compiled only with TP 6.0+ or Delphi 1.0
(2) PLOT.PAS can be compiled with FPC under Linux but the programs
    which call it do not work! This seems to be due to limitations
    in the FPC Graph unit.


INSTALLATION
============

- Extract the archive in a given directory. Be sure to preserve the
  subdirectory structure of the archive (if you use PKUNZIP, be sure to
  use the -d option to create subdirectories, i.e. pkunzip -d tpmath1.zip)

- Add the names of the main directory and the REG subdirectory to the
  search path of the units (e.g "Options/Directories/Unit directories"
  dialog box in Turbo Pascal).

- Add the name of the main directory to the search path of the include
  files (e.g "Options/Directories/Include directories" dialog box in
  Turbo Pascal).

The use of the routines is explained in the comment part of each file.


REFERENCES
==========

(1) D. CROSS
    Fast Fourier Transforms
    http://www.intersrv.com/~dcross/fft.html

(2) J. D. GAYRARD
    MATHLIB2.ZIP on Compuserve's BPASCAL forum
    Also available at the Delphi Super Page:
    http://wcarchive.cdrom.com/pub/delphi_www/
    in the Delphi 1.0 Freeware section.

(3) E. F. GLYNN
    CMPLX.ZIP at ftp://cloudlab.larc.nasa.gov/pnumsrc.htm

(4) D. W. MARQUARDT
    An algorithm for least squares estimation of nonlinear parameters.
    J. Soc. Indust. Appl. Math., 1963, 11, 431-441

(5) G. MARSAGLIA
    The Diehard Battery of Tests of Randomness.
    Available at http://www.cs.hku.hk or http://www.stat.fsu.edu

(6) A. R. MILLER
    Basic Programs for Scientists and Engineers.
    Sybex, 1981

(7) J. A. NELDER & R. MEAD
    A simplex method for function minimization.
    Comput. J., 1964, 7, 308-313

(8) W. H. PRESS, S. A. TEUKOLSKY, W. T. VETTERLING & B. P. FLANNERY
    Numerical Recipes. The Art of Scientific Computing.
    Cambridge University Press, 2nd edition 1992

(9) Turbo Pascal Numerical Methods Toolbox.
    Borland International, 1986


