%
%   what hfloat is (good for)
%   -------------------------
%

hfloat (for huge floats) is a library package for doing
calculations with floating point numbers of extreme precision.
It is optimised for computations with 1000...several million digits. 
The computations can be done in (almost) arbitrary radix.

The library contains routines for 
addition, subtraction, multiplication, division,
n-th power, square root, n-th root, logarithm, exponentiation
and many more.

There are implementations of several superlinear converging 
algorithms for the computation of pi=3.14159265... (in src/pi/).
The computation of 1 million decimal digits of pi takes about 
2 minutes on an AMD Athlon/800.

Code examples for the usage of the library are in examples/.

Code for a binary that collects the pi algorithms
can be found in calcpi/.

Included is the fxt-library, containing many FFT-implementations, 
code for convolution, correlation, spectrum and much more.

High precision computations test your systems reliability
(hardware and compiler): every little error results in 
garbage digits.

Digits of appropriate constants can be used as high quality
random numbers eg. for cryptographic stuff.

You may (and are encouraged to) use the fast multiplication
in your own noncommercial bignum software.

hfloat (and the accompanying texts) may help you to
learn about fast arithmetical algorithms.
