home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / science / gravity / gravity.doc < prev    next >
Text File  |  1990-12-31  |  4KB  |  97 lines
  1.  
  2.  
  3.     Gravity V1.0
  4.     ------------
  5.     a nice toy to simulate the movements of astronomic objects
  6.     written in 1990 by Guido Burkard
  7.  
  8.  
  9. 1. How to start Gravity
  10. -----------------------
  11. Start Gravity by typing its name followed by the path/name of the object 
  12. description file. The object description file is an ASCII format file
  13. containing the information about the objects which you want to simulate
  14. (see also chapt.3). There should be at least three demonstration object
  15. description files on this disk:    - "sun_earth"
  16.                 - "sun_inner_planets"
  17.                 - "sun_outer_planets"
  18. These are file that I made using the data of our solar system. So you
  19. can try to start Gravity by typing "Gravity sun_earth".
  20.  
  21. Note: - Gravity cannot be started by clicking on an icon on the Workbench,
  22.     because it uses the CLI-window as a data screen. So if you want to
  23.     start it anyway from the Workbench, click at the CLI-icon and start
  24.     it from there.
  25.       - Gravity can only be started when an object file is indicated.
  26.     That's because you can't edit object data using the program itself.
  27.     (see also chapt.3)
  28.  
  29. 2. How to control Gravity
  30. -------------------------
  31. The Gravity data screen shows you following informations:
  32. - the name of the object file you've chosen
  33. - how many objects the file contains
  34. - the gravity constant (which you can change in this program!!)
  35. - the time-interval (delta-time) from one computing step to another (sec)
  36. - the absolute simulating time (seconds)
  37. - the distance from the center of the screen to the borders (zoom)
  38. - whether the tracks of the objects are deleted or not
  39.  
  40. And you can choose following functions:
  41. - r   runs the simulation on a different screen
  42.       (hit backspace to return)
  43. - rt  shows you the simulation time while running the simulation
  44. - w   watch the simulation screen without running the simulation
  45. - g   change the gravity constant !!
  46. - G   set the gravity constant back to the "real" value
  47. - t   change time interval (larger number->simulation becomes faster)
  48.       note: - if you enter too small time intervals, you won't see
  49.           any movement, because the animation is too slow;
  50.         - if you enter too large time intervals, the calculation
  51.           gets more and more inaccurate;
  52. - m   change margins - with this function you can change the zoom
  53.       factor by entering the distance represented by the line from
  54.       the center to every of the borders
  55. - a   auto-set margins; after this operation every object is inside the
  56.       margins
  57. - d   toggle delete mode on/off
  58. - l   show a list of the object data
  59. - x   terminate the program
  60.  
  61. Note: Numbers are always entered as man*10^exp (or manEexp)
  62.       The computer asks you e.g. for G.man and G.exp when you want
  63.       to change gravity constant. Just enter them as scientific numbers!
  64.  
  65. 3. How to write own object files
  66. --------------------------------
  67. To write an object file you need a usual text-editor like the ed from
  68. the Workbench. Further you must know all the coordinates, starting
  69. speeds and masses of the objects.
  70.  
  71. The first line of the file has to look as follows:
  72. GRAVITY n
  73. where n is the number of objects.
  74. Then there should be an empty line. After that you enumerate the object
  75. data as scientific numbers:
  76.  
  77. 1.3    6            <-- x position: 1.3E6 m (1.3*10^6 m)
  78. -8.5    3            <-- y position: -8.5E3 m
  79. 0    0            <-- velocity in x-direction: 0
  80. 2.5    -1            <-- velocity in y-direction: 2.5E-1 m/s
  81. 1    25            <-- mass: 1E25 kg
  82.  
  83. 2.1    9            <-- next object
  84. 1    7
  85. ...    ...
  86.  
  87.  ^   ^   ^
  88.  |   |   |_________exponent
  89.  |   |_______1 tabulator   
  90.  |_______number (normally between 1 and 9.999)
  91.  
  92.  
  93. I hope you have fun with Gravity!
  94. If you have any questions or contributions, write to:
  95. Guido Burkard, Stockfeldstr. 230, CH-5243 Muelligen, Switzerland (Europe)
  96.  
  97.