MANDEL

Section: Misc. Reference Manual Pages (LOCAL)
Index Return to Main Contents

NAME

mandel - calculate and graphically display a Mandelbrot set

SYNOPSIS

mandel [-Lps][-W width][-H height][-o filename][-a n ] [-b n ] [-w n ] [-h n ] [-M n ] [-R p ] [-S n ] [-T n ] [-D r ] [-r n ] [-O n ] [-c n ] [-x x_center] [-y y_center]

DESCRIPTION

mandel generates and graphically displays a Mandelbrot set according to the parameters and window specified.

OPTIONS

-D n: Specifies the delta within which an iterate must fall in order to be considered as having "returned" to a previous point in periodic orbit detection. Default value is 0.01.
-H n: Specifies the height of the window. Default is 512.
-M n: Specifies the escape detection radius. The default value is 100.
-O n: Specifies the minimum color index to be used for iteration counts.
-S: Indicates to not look for periodic cycles (default action).
-T: Indicates to look for periodic cycles within the Mandelbrot set.
-W n: Specifies the width of the window. Default is 512.
-a r: Specifies the real value to use as the minimum parameter value of the horizontal axis. Default is -1.5.
-b n: Specifies the real value to use as the minimum parameter value of the vertical axis. Default is -1.5.
-c n: Selects one of twelve different color wheels to use. The default color wheel is a rainbow palette.
-h r: Specifies the real value to be used as the range over which the vertical parameter values vary. The default is 3.0.
-o filename: Specifies the output filename to be used. If the -o option is given, this file will automatically be written out at the completion of the drawing. If it is not specified, a default filename of mandel.out is used and only written if the 'f' or 'F' keys are pressed during a run. The format of the output file is PPM for color and PGM for monochrom. The parameters used to calculate the picture are included as comments at the beginning of the output file.
-p: Switches color indices for negative and positive iteration counts. Generally, causes negative iteration counts to be displayed in more detail while darkening and narrowing the color range for positive iteration counts. This can be toggled during runtime by pressing the 'p' key.
-r n: Specifies the maximum rgb value to be used. Default is 35000.
-u: Produces a usage message.
-v: Prints out the various values to be used and exits.
-w r: Specifies the real value to be used as the range over which the horizontal parameter values vary. The default is 3.0.
-x n: Specifies the center x value of the window in the Complex plane. Default is -0.75.
-y n: Specifies the center y value of the window in the Complex plane. Default is 0.0.

NOTES

During display, pressing the left mouse button allows you to select the area to be investigated with the mouse. The upper left hand corner of the desired area is the location of the cursor when the button is pressed. The lower right hand corner is specified by the cursor when the button is released. Pressing and releasing the middle mouse button will cause the Julia set corresponding to the parameter value at the crosshairs of the cursor to be displayed. See julia(LOCAL) for information on run-time interactivity with the julia program.

Use of the keys bBeEfFkKjJmnrRsSwWxXqQ indicates:

           (<) Halve the maximum iteration limit.
           (>) Double the maximum iteration limit.
           (-) Halve the escape detection radius.
           (+) Double the escape detection radius.
           (0) Zoom out doubling the window on the Complex plane.
           (9) Zoom into the center quarter of the window on the Complex plane.
           (E or e) Recalculate the indices into the color wheel using a different method
           (F or f) Save current screen to ouput file (not yet implemented)
           (H or h or ?) Display brief help message
           (i) Decrement the interval between stripes for the striped color map.
           (I) Increment the interval between stripes for the striped color map.
           (P or p) Toggle positive/negative iteration count display.
           (r) Redraw the window using previously calculated iteration counts.
           (R) Redraw the window using the newly set parameter and window values.
           (s) Spin the color wheel in one direction
           (t) Spin the color wheel in the other direction
           (S or T) Stop spinning of the color wheel
           (u) Go up to the window just prior to the most recent zoom.
           (U) Go all the way up to the original window.
           (V or v) Display values of various parameters currently in use
           (W or w) Use next color map.
           (<ctrl>-W) Use color map in $HOME/.mandelmap
           (X or x) Clear window
           (Q or q) quit

FILES

/usr/local/lib/mandel/colormaps/* - samples for use as $HOME/.mandelmap
/usr/local/lib/mandel/params/* - scripts with interesting parameters

AUTHOR

        Ronald Joe Record
         212 Owen Street
       Santa Cruz, CA 95062
            rr@sco.com

ACKNOWLEDGEMENTS

Algorithms and coloring schemes were introduced to me in course work under Heinz Otto Peitgen and Dietmar Saupe at the University of California at Santa Cruz. Assistance with colormaps and spinning color wheels and X was gleaned from Hiram Clawson. Rubber banding code was adapted from an existing Mandelbrot program written by Stacey Campbell.

This document was created by man2html, using the manual pages.
Time: 04:15:50 GMT, December 02, 2024