NAME

bugsx - display and evolve biomorphs

DESCRIPTION

bugsx runs under MIT's X11 window system. It was written under UNIX but should be easily portable. It is a program which draws the biomorphs based on parametric plots of Fourier sine and cosine series and let's you play with them using the genetic algorithm.

The original version which ran under Suntools and XViews was written by Joshua R. Smith sometime 1990. See the 'credits' section for more details.

For more information about the theoretic backgrounds of bugsx consult Joshua R. Smith's paper distributed with this program (in postscript format). It can also be gotten from: http://physics.www.media.mit.edu/~jrs/biomorphs.ps

COMMAND LINE PARAMETERS

bugsx accepts the following command line options:

        +rv                     reverse video (use to override xrdb entry)
        +synchronous            syncronous mode (use to override xrdb entry)
        -?                      help
        -background <arg>       backgound color
        -batch                  run program in batch mode
        -bg <arg>               same as -background
        -bordercolor <arg>      border color
        -borderwidth <arg>      border width
        -display                display
        -extend_print           show extended reproduction info while running
        -fg <arg>               same as -forground
        -font <arg>             font
        -foreground <arg>       forground color (also file system bar color)
        -geometry <arg>         geometry (will override extreme window sizes to
                                apply reasonable settings)
        -help                   help
        -iconic                 iconic
        -interval <arg>         interval used per turn
        -mb                     show menu border
        -name <arg>             run bugsx under this name
        -nobreed                do not breed when running in bactch mode
        -number <arg>           number of biomorphs to draw (must be a square #)
        -printpop               print the population when breeding
        -rv                     reverse video
        -seed <arg>             use this seed for random number generator
        -segments <arg>         use this many segments to draw an organism
        -showbreed              show breeding subpopulation when in batch mode
	-showgenes		show a graphic representation of the genes
        -synchronous            synchronous mode
        -v                      verbose
        -xrm                    make no entry in resrouce database
        help                    help

RESOURCES

bugsx can be controlled via the following resources:

        background              universal backgound color
        batch                   run program in batch mode
        batchbreed              do not breed when running in bactch mode
        borderColor             border color
        borderWidth             border width
        display                 display
        extend_print            show extended reproduction info while running
        font                    font
        foreground              universal foreground color
        help                    show help
        mainWin.geometry        main window geometry
        iconic                  start program in iconic mode
        interval                interval used per turn
        minimize                minimize window size
        menuborder              draw menu borders
        name                    run bugsxunder this name
        number                  number of biomorphs to draw (must be a square #)
        printpop                print the population when breeding
        reverseVideo            reverse video
        seed                    use this seed for random number generator
        segments                use this many segments to draw an organism
        showbreed               show breeding subpopulation when in batch mode
	showgenes		show a graphic representation of the genes
        synchronous             syncronous mode
        verbose                 verbose mode

BRIEF USER'S GUIDE

Once you have started bugsx you will get a window containing the drawing windows and 3 menus. The Menus are:

	Initialize - Initializes the gene pool
	Breed	   - Breed the selected organisms
	Quit       - exits bugsx

Once you have chosen "Initialize" and the first set of drawings is shown, you can select the ones you wish to be included in the cross-breeding by clicking (with the left button) on a drawing window. The selected organisms will be drawn inverse.

Clicking on Breed will cross breed the selected organisms using the genetic algorithm. If you have not selected at least two organisms, a set of at least two will be randomly chosen and used for the breeding.

The following keys can be used to control bugsx:

	q - quit bugsx
	i - initialize population
	b - breed

AUTHOR

bugsx was written by Joshua R. Smith (jrs@media.mit.edu) and ported to XWindows by Robert Gasch (Robert_Gasch@peoplesoft.com) and is copyright by the author(s).

CREDITS

The strstr() used for DYNIX ports is a slightly modified version of the GNU source.