This file describes the Mathematica Package "CirclePack". 

PURPOSE:

To calculate and display circle packings. Given a triangulation of
a closed orientable surface it computes the corresponding circle
packing. It will do this in whichever geometry is appropriate
depending on the genus of the surface and can compute packings with
specified overlaps as well as the special case in which all circles
are tangential.

REQUIREMENTS:

Requires Mathematica version 2. to be installed. 

USAGE:

The simplest way to use the package is to copy all its .m files
to a new directory and work there.  To create readable copies
of the manual pages type "make man"; this will create the files
cpintro.man, circlepack.man, and triangulation.man.

INSTALLATION:

If you want to install the package and its documentation
on your system in some permanent location, follow the instructions
in the Makefile.

FILES:

This package consists of the following files:

README		- This file. 
DrawPacking.m	- Package containing functions to draw a packing. 
cpexamples.m	- Example triangulations on which to try the package.
demo.ma		- A demo in the form of a notebook (for the NeXT).
CirclePack.m	- Package to calculate circle packings. 
circlepack.1    - Manual page for the above. 
Triangulation.m	- Package to support triangulations. 
triangulation.1 - Manual page for the above. 
cpintro.1       - General introductory manual page

 - CirclePack makes use of a hyperbolic geometry package 
   written by Silvio Levy. The package is STILL UNDER DEVELOPMENT
   and no claims are made whatever for its completeness or
   usefulness in its present state. 

Hyperbolic.m	- Package to do hyperbolic geometry (including drawing). 
Minkowski.m	- Required by Hyperbolic.m
Normalize.m	- - as above - 
Circle3D.m      - - as above - 
Makefile	- the makefile
