0README

xtoys
|-- 0NOTE			obvious
|-- 0README			this file
|-- 0-Old			directory -- old distribution, compiles
|-- 0-Distribution-15-Mar-2002	directory -- distribution for these sources
|-- Makefile			obvious
|-- xtoys.1			man page (sketchy) for all xtoys
|-- xtoys.1.tty			nroff of man page - ascii
|-- xtoys.1.ps			troff of man page - postscript
|-- demo_lattice		tutorial - by jar: 
|					xburn, xising, xautomalab, xsand
|-- xburn-seq.txt		file referenced in demo_lattice
|-- schrodinger			executable
|-- xautomalab			executable
|-- xautomalab.gif		pattern to be read by xautomalab
|-- xburn			executable
|-- xburn-jar			executable
|-- xfires			executable
|-- xising			executable
|-- xpotts			executable
|-- xsand			executable
|-- xwaves			executable
|-- schrodinger.c		source file for ....
|-- xautomalab.c		source file for ....
|-- xburn-jar.c			source file for ....
|-- xburn.c			source file for ....
|-- xfires.c			source file for ....
|-- xising.c			source file for ....
|-- xpotts.c			source file for ....
|-- xsand.c			source file for ....
|-- xwaves.c			source file for ....
|-- Doc				directory - information on xtoys
|   |-- Xtoys.html			webpage 2/2001 - mike creutz xtoys site
|   |-- readme.txt			distribution readme file (Mike Creutz)
|   |-- xautomalab.txt			documentation for ....
|   |-- xburn-jar.txt			documentation for ....
|   |-- xburn.txt			documentation for ....
|   |-- xfires.txt			documentation for ....
|   |-- xising.txt			documentation for ....
|   |-- xpotts.txt			documentation for ....
|   |-- xsand.txt			documentation for ....
|   `-- xwaves.txt			documentation for ....
`-- xtoys-patterns		directory - 
    |-- fiveguns.gif 			gifs = patterns for xautomalab
    |-- fiveguns.png			png format not read
    |-- glidergun.gif
    |-- glidergun.png
    |-- puffertrain.png
    |-- sixguns.gif
    |-- sixguns.png
    |-- xautomalab.gif
    `-- xautomalab.png

XTOYS
	xtoys - X window simulators for phase transitions (Ising, Potts,
	and percolation models); self-organized criticality (sandpile
	model); cellular automata; and wave equations.

SYNOPSIS AND DESCRIPTION

xburn  tree_density  [block_size]
	simulates a forest fire with a two-dimensional percolation model.
		tree_density = 0 to 1; try 0.592, the critical point
			for 2-d percolation
		block_size = 1 to 4; try 4 for a full screen view

xburn-jar  tree_density  propagation_probability  [block_size]
	simulates a forest fire with a two-dimensional percolation model,
	with inclusion of a propagation probability parameter.
		propagation_probability = 0 to 1; try .5 to see reduction
			in burn rate and extent
		tree_density and block_size as for xburn

xising
       implements a simulation of the two dimensional Ising model with
       both local and cluster algorithms.

xpotts
       for the q state Potts with a magnetic field.

xautomalab
       a totalistic cellular automaton simulator; Conway's Game of Life
       is a special case.

xsand
       implements the Bak, Tang, Wiesenfeld sandpile model,  illustrat-
       ing self-organized criticality.

xfires
       a simple forest fire model of self-organized critiality.

xwaves
       simulates three different wave equations, representing light,
       massive mesons, and water.

schrodinger
       evolves a wave function with the Schrodinger equation.  The
       potential can be modified with the mouse.


For programs run without command-line parameters, adjustment of
parameter values, if appropriate, is done within the X-window display.



This is a (fairly recent: 2002) version of the xtoys distribution
created by Mike Creutz at BNL <creutz@bnl.gov>.

It focuses mostly on lattice physics, i.e.,
the illustration of critical behavior and phase transitions.
The latest versions are kept at:
	http://thy.phy.bnl.gov/www/xtoys.html


0NOTE		notes on compilation, etc.;
		one program and a modification were added from an
		old xtoys distribution: xburn, xburn-jar.

Xtoys.html	the web page (picked up October, 2004) for the package.

demo_lattice	gives some suggestions for working with the toys;
		used as class handout.

x*.c		source code, with corresponding executable.
schrodinger.c

x*.txt		comments/instructions for the toys, from the author,
		mike creutz

xtoys.1		a minimal man page( edited slightly by jar).

*.{gif|png}	images for use with xautomalab, as starting patterns for
		Conway's life: the gif files work; the png files may not.

readme.txt	readme file for the distribution.



John Rupley
 rupley@u.arizona.edu -or- jar@rupley.com
 30 Calle Belleza, Tucson AZ 85716 - (520) 325-4533; fax - (520) 325-4991
 Dept. Biochemistry & Molecular Biophysics, Univ. Arizona, Tucson AZ 85721
