Program pvmjulia version 0.1.0

Dmitry V. Khmelev

Initial revision 2003-08-27; Last revision 2003-10-21

1  Download

2  File readme

                         pvmjulia

Copyright (c) 2003 Dmitry Khmelev. 

This software is available under GNU Public License, 
see enclosed file LICENSE.


1. GENERAL DESCRIPTION

This program can produce blowups of Julia set for quadratic
polynomials z^2+c (c being a complex number). The pictures are proper,
which means that each pixel is marked by yellow color if and only if
the circle of radius 0.72 (=thickness) centered at the center of the
pixel intersects Julia set. A distance estimator, suggested by
J.Milnor is used. 

The code is based on the program 'xbmp' (previously, 'yabmp') by
Eugene Zaustinsky, but is significantly modified, with added multiple
precision and distributed computing facilities.

If you wish to publish a picture obtained from this program, please
provide correct citation of the program and its author, including the
following reference to the site of the program:
http://www.math.toronto.edu/dkhmelev/PROGS/bmp/

Also please email your paper to me, since I wish to be aware of your
research. My e-mail can be found at my homepage 

http://www.math.toronto.edu/dkhmelev/

If you fail, search Google for my name: "Dmitry Khmelev"

2. CONFIGURATION AND COMPILING

The program requires PVM (Parallel Virtual Machine) software to be
installed on your computer (even if you wish to run the program on
one computer only):
http://www.csm.ornl.gov/pvm/pvm_home.html

Also please install GNU multiple precision library:
http://www.swox.com/gmp/

(if you do not wish to use multiple precision for speed or other reasons,
it is enough to comment out inclusion of <gmp.h> at global.h
header file.)

In makefile please set PVM_ROOT and PVM_ARCH values to proper values
(see documentation for PVM) and run make.


3. RUNNING

Program uses PVM in order to take advantage of two-processor systems
or networks of computers. Configuration of PVM for networks is beyond
this manual, try to find some instruction on the web.

For stand-alone one- (or two-) processor computer it is enough to run 
'pvm' (in command line). Next, run ./pvmjulia (assuming that pvmjulia
executable file is located in current directory).

The default output file is test.gif (have a look). Further options of
the program can be displayed with

./pvmjulia --man

3  Usage and options summary

user@computer$ ./pvmjulia --help
Usage: pvmjulia [OPTION]... [FILE.cmd]
  -q, --quiet                  do not send any messages to stderr
  -h, --help                   display this help and exit
  -m, --man                    display complete man
  -v, --version                display version and exit
  -p, --process_number N       spawn N process 
  -o, --output file.gif        Output results if file.gif (def. "test.gif")
  -c, --continue=file.gif      continue calculation of file.gif

  --pvm_hosts host1,...,hostN  hosts separated by comma, where N processes
                               (from -p N option) are cyclically distributed
  --working_dir PATH           set working directory PATH (default `pwd`)
Notices:
1) You should probably install and run PVM before starting this program.
2) Pressing Ctrl-C (or using kill -2) output current computation to file.gif
3) The interrupted computation can be continued via option -c
4) Using --pvm_hosts don't forget to specify the number of process with -p
5) FILE.cmd contain parameters for drawing Julia set in the form
<name> = <numerical value>
wheresign '=' has to be surrounded by spaces, and each parameter
occupy one line. In order to display the possible values, use -m option
6) the outputted .gif file contains information on the image, which
can be extracted using some modification of gifinfo program.

4  Description

user@computer$ ./pvmjulia --man
<Usage information from the previous section is omitted>

pvmjulia 0.1.0
Copyright (c) 2003 Dmitry Khmelev. 
This software is available under GNU Public License, see enclosed file LICENSE.txt

Possible parameters in .cmd file and their default values:
c_real = -1.749980257925091757012654091468778624549
c_imag = 0
x_center = 0.000018334476334
y_center = 0
height = 0.001756442832797974206876713403445766013921
thickness = 0.72
maxiter = 1000000
max_jcycle_period = 10000
minrecur = 2
Dist_Algorithm = 1
Color_Scheme = 0
Iwid = 640
Iht = 480
Precision = 96
Notice that the parameters are assigned in the following order:
default values, .cmd file (if specified), .gif file (if specified)

5  Project revision history

2003-08-27

2003-10-20

2003-10-21

6  License

Available at http://www.math.toronto.edu/dkhmelev/PROGS/dynamics/pvmjulia-eng.html

Author:

Dmitry V. Khmelev dkhmelev((at))math.toronto.edu [change ((at)) to @ in order to get proper address - antispam]

University of Toronto, Department of Mathematics, 100 St George Street, M5S 3G3 ON, Canada

LICENSING TERMS

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. You should obtain GNU GPL with file COPYING in this distribution.

Scientific results produced using the software provided shall acknowledge the use of this software. The proper reference is:

D. Khmelev, http://www.math.toronto.edu/dkhmelev/PROGS/dynamics/

Moreover shall the author of the software should be informed about the publication.

By using this program you agree to the licensing terms.

NO WARRANTY

BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM ÄS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.