coral

Calculate and display an aggregating particle

Authored and Contributed by

Ronald Joe Record

Restrictions

Copyright 1993, 1994 Ronald Joe Record

Availability

The mathrec source code is freely redistributable. The author maintains binary distributions for Caldera OpenLinux 3.1, OpenServer, UnixWare 7 and Open UNIX 8. These distributions and the source code are available via:

Binary Distributions
OpenLinux/Open UNIX	ftp://ftp2.sco.com/pub/.../RPMS/mathrec-1.1c-1col.i586.rpm (no longer available)
UnixWare 7	ftp://ftp2.sco.com/pub/skunkware/uw7/Packages/mathrec-1.1b.pkg
OpenServer	ftp://ftp2.sco.com/pub/skunkware/osr5/vols/mathrec-1.1c-VOLS.tar

Source Code Distributions
Source RPM	ftp://ftp2.sco.com/pub/.../SRPMS/mathrec-1.1c-1col.src.rpm (no longer available)
Gzip'd tar archive	ftp://ftp2.sco.com/pub/skunkware/src/x11/misc/mathrec-1.1c.tar.gz

Description

The idea here is to calculate and display aggregating particles. In order to accomplish this, a modified random walk algorithm is used. Initial particles are "seeded" at the "bottom" or the "sea". Particles are then "dropped" randomly from above. When a particle comes within a pixel of an already existent particle, it "sticks". After N particles have "stuck", the color is incremented. Thus, color indicates "age".

Acknowledgements

The algorithm was derived from lectures given by Dietmar Saupe at the University of California at Santa Cruz. Assistance with colormaps and spinning color wheels and X was gleaned from Hiram Clawson and Stacey Campbell.

Build

To build the coral binary, either use the Imakefile or the sample makefile, Makefile.std. If your system doesn't support prototypes, uncomment the PROTODEFINE line of the Imakefile.

After modifying the Imakefile appropriately, either use "xmkmf" or "imake" to create a Makefile. Then just type "make" to compile coral.

The manual page can be formatted by typing "nroff -man coral.man > coral.6X".

Install

To install coral, copy the coral binary to the desired location (the sample makefile puts it in /usr/games/X11) Copy the formatted man page to wherever you keep your local doc (i use /usr/games/X11/doc for games and imaging software), then add that location to your MANPATH.

Productivity

None

Safety

I have used this for years without harm.

Work Planned

None

Documentation

manual page.

Verification

You can test coral by just invoking it with no arguments. It should display a 512x480 image. Some workstations may be slow to calculate and display the coral growth as there are many calculations involved.

Some "interesting" ways to run coral are as follows :
% coral -F -n 10 -d
(use the full screen, calculate 10 maps in demo mode)
% coral -R
(display on the root window)
% coral -o coralgrowth.ppm
(calculate and display with default parameters and save the resulting image as a PPM file called coralgrowth.ppm. this can be viewed later using xv or any PPM viewing utility)

Feedback

Ideas, comments, additions, deletions, suggestions, bug reports, code review,... e-mail Ronald Record at rr@ronrecord.com