home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume23 / lyapunov / part01 / README < prev   
Encoding:
Text File  |  1991-09-27  |  3.4 KB  |  123 lines
  1. =====
  2. What it is
  3. =====
  4.  
  5. Lyapunov is a program to calculate maps of Lyapunov space, using a
  6. function originally posted to alt.fractals by Ed Kubaitis.  For more
  7. information on Lyapunov space, see the September 1991 issue of
  8. Scientific American.  While I don't have any way of checking whether
  9. or not the output of this program is, in fact, mathematically correct,
  10. it does *look* reasonable; if you discover any errors in this program,
  11. please send corrections to me.
  12.  
  13. ====
  14. Terms and Conditions
  15. ====
  16.  
  17. This program and documentation are Copyright 1991, Garrett A. Wollman.
  18. This program may be modified and distributed for any purpose and
  19. without fee, provided that this notice remains on all such copies
  20. unaltered.  Binary distributions not including this document are
  21. prohibited.  Modified versions must be marked with the name of the
  22. modifier and the date of modification.
  23.  
  24. Under no circumstances shall Garrett A. Wollman or the University of
  25. Vermont and State Agricultural College be held liable for any damages
  26. resulting from the use or misuse of this program, whether the author
  27. is aware of such possibility or not.  This program is warranted solely
  28. to occupy disk space.
  29.  
  30. ====
  31. How to use it
  32. ====
  33.  
  34. lyapunov generates your choice of PGM or PBM files.  If you want to
  35. actually *look* at the output, you will need a program which can deal
  36. with this file format; such programs include `xv' (which is the
  37. program that I use) and Jef Poskanzer's PBMPLUS toolkit.
  38.  
  39. lyapunov's command line syntax is as follows:
  40.  
  41. lyapunov [-r rows] [-c cols] [-v program] [-p] [-t]
  42.          [-# processors] [-o file] [-m minLya] [-d Dwell] [-s Settle]
  43.          [-g initGuess] [-5] amin amax bmin bmax bits
  44.  
  45. where:
  46.  
  47. [-r rows]
  48. [-c cols]
  49. These two flags set the shape of the output image (default 512x512).
  50.  
  51. [-v program]
  52. When this flag is specified, output is piped through `program'.
  53.  
  54. [-p]
  55. This flag tells the coloring function that you are interested in the
  56. positive, rather than negative, lyapunov exponents.
  57.  
  58. [-t]
  59. This flag turns off the RAWBITS format in the output; it is only
  60. really useflu for debugging.
  61.  
  62. [-# processors]
  63. This flag, on versions that support it, causes the calculation to run
  64. row-parallel on processors processors.  Currently, only Silicon
  65. Graphics machines are supported.
  66.  
  67. [-o file]
  68. Sends the output to `file' instead of standard output.  This option
  69. and `-v' are mutually exclusive.
  70.  
  71. [-l colormap]
  72. Use the specified Fractint-style `.map' file instead of the default
  73. grey.
  74.  
  75. [-m minLya]
  76. Tell the coloring routine that minLya is the minimum expected Lyapunov
  77. exponent (default -5).  Values below minLya are clamped to minLya.
  78.  
  79. [-d Dwell]
  80. Set the Dwell value (default 2000).
  81.  
  82. [-s Settle]
  83. Set the Settle value (default 600).
  84.  
  85. [-g initGuess]
  86. Set the starting value for `x'.
  87.  
  88. [-5]
  89. This flag turns on PGM (as opposed to PPM) output format; any
  90. colormap loaded with `-l' is ignored.
  91.  
  92. amin
  93. amax
  94. bmin
  95. bmax
  96. The range for `a' and `b' to be calculated.  This region is mapped
  97. onto the *first* quadrant (opposite from the way the rows and columns
  98. are numbered).  See the code for more details.
  99.  
  100. bits
  101. A string of 'a's and 'b's to be used as the seed for the Markus
  102. vector.
  103.  
  104. ====
  105. Compiling
  106. ====
  107.  
  108. Just look through the Makefile; it's quite self-explanatory.  If you
  109. add support for another CPU or make the program faster, please send me
  110. the changes!
  111.  
  112. ====
  113. Author
  114. ====
  115.  
  116. Garrett A. Wollman
  117. wollman@UVM.EDU
  118. uvm-gen!wollman
  119.  
  120. University of Vermont, Division of Engineering, Mathematics, and
  121. Business Administration, Computer Facility.
  122.  
  123.