Return to README CVS log

Up to [Repository ATC2] / QuadraticMandel

Annotation of QuadraticMandel/README, revision 1.1

1.1     ! cvsmgr      1: 
        !             2: 0. PURPOSE
        !             3: ----------
        !             4:    In this directory, you will find a collection of programs intended at
        !             5:  the generation of fractal sets for quadratic homogeneous maps in two variables.
        !             6: 
        !             7: 1. INSTALLATION
        !             8: ---------------
        !             9:    Prerequirements: since this software generates PNG files, you will need an
        !            10:  installation of the PNG library, which (in unix-like systems) usually means to
        !            11:  have at least two files: "png.h", and "libpng.a".
        !            12: 
        !            13:    The programs are developed in C language, standard C99.
        !            14: 
        !            15:    To generate the executables, simply copy all the files in this folder to a
        !            16:  single folder and run "make".
        !            17: 
        !            18: 
        !            19: 2. USAGE
        !            20: --------
        !            21:    Since the generation depends on the region for which one is willing to
        !            22:  generate the fractal, there is a number of different programs, each one having
        !            23:  its own set of input arguments.
        !            24: 
        !            25:    We will explain the usage based on the first, general program, fractal. When
        !            26:  typed with no arguments, the programs responds:
        !            27: 
        !            28: Usage: fractal <output base filename> <itermax> <xi> <eta> <side_length> <offset x> <offset y>
        !            29: 
        !            30:  Each argument means the following:
        !            31:  <output base filename>: name for the output graphic file
        !            32:  <itermax>:      maximum number of iterations before declaring a point inside the
        !            33:                  fractal set
        !            34:   <xi>:          value for the first invariant
        !            35:   <eta>:         value for the second invariant
        !            36:   <side_length>: side length in the complex plane for the intended fractal
        !            37:   <offset x>:    x coordinate for the middle point of the figure in the complex
        !            38:                  plane
        !            39:   <offset y>:    y coordinate for the middle point of the figure in the complex
        !            40:                  plane
        !            41: 
        !            42:    So the users picks a pair of invariants (xi,eta) and the zone s/he wants to
        !            43:  depict. The latter is achieved by selected the center point of the figure and
        !            44:  the side length of the figure. The longest the side-length, the smallest the
        !            45:  figure, normally.
        !            46: 
        !            47:    This first program generates the fractal sets for the $\Delta^+$ and
        !            48:  $\Delta^-$ zones.
        !            49: 
        !            50:    The same idea runs for the rest of the programs, which generate fractals for
        !            51:  the rest of the zones.
        !            52: 
        !            53: fractalalpha
        !            54: ------------
        !            55:    Generation of fractals for the X axis (except the origin).
        !            56: 
        !            57: fractal_l
        !            58: ---------
        !            59:    Generation of fractals for the "linear" zone, $C^+$ and $C^-$.
        !            60: 
        !            61: fractal_00
        !            62: ----------
        !            63:    Generation of fractals in the origin (0,0) of the complex plane.
        !            64: 
        !            65: 
        !            66:   The rest of the programs simply take into account "special" cases.
        !            67: 
        !            68: fractal_esp1: For the case $F^+_c$ when $c = 0$.
        !            69: fractal_esp2: For the case $F^-_c$ when $c = 0$.
        !            70: fractal_esp3: For the case $G^_c$ when $c = 0$.
        !            71: fractal_esp5: For the case $F^+_{00}$.
        !            72: fractal_esp6: For the case $F^-_{00}$.
        !            73: fractal_esp7: For the case $F^+_{bc}$ when $c=\pm 2b$.
        !            74: 
        !            75: ReadPNGHdr
        !            76: ---------
        !            77:    This program extracts the info associated to each PNG file that consists of
        !            78:  several fields: values for xi, eta, offset-x, offset-y, side-length, generation
        !            79:  date, and maximum number of iterations.