home *** CD-ROM | disk | FTP | other *** search
/ Collection of Education / collectionofeducationcarat1997.iso / SCIENCE / GRAVITY2.ZIP / GRAVITY.DOC < prev    next >
Text File  |  1990-04-12  |  28KB  |  647 lines
  1. Documentation for GRAVITY.EXE
  2. Version 2.0
  3. Program and Documentation (C)opyright Steve Safarik
  4. Shareware Registration $30.00/$15.00 ($40.00/$20.00)
  5. ----------------------------------------------------
  6.  
  7.  
  8.  
  9.                        The Gravitational Simulator
  10.                        ===========================
  11.  
  12. Introduction
  13. ------------
  14.  
  15. Gravity version 2.0 is a powerful tool designed to simulate the
  16. motions of planetary bodies in space.  You may specify the
  17. following parameters for up to 16 bodies:  Mass, Density, Initial
  18. position, and Initial velocity.  The bodies are then plotted as
  19. they move according to the laws of gravitation.  You can view any
  20. location in space at any magnification.  You can also watch the
  21. motion of a single planet via a "tracking" feature.  Set up systems
  22. and play "what if..."  Elapsed time is optionally displayed, and
  23. nearly every variable is available for user adjustment.
  24.  
  25. The primary design philosophy of this program was that it had to
  26. be easy to learn and use by "mere humans".  Sometimes that's hard
  27. to do for a complex program, and I hope this version is as easy to
  28. operate as version 1.0.
  29.  
  30. This program was first designed as a tool for people to use to view
  31. the laws of motion and of gravity in action.  After the first
  32. release, users said that the main capability they desired was to
  33. be able to enter actual planetary systems into the simulator.
  34. Well, the reason no one could figure out how to do it, was because
  35. "it just wasn't possible."  So here we have version 2.0, a much
  36. more powerful program with a number of added functions.
  37.  
  38.  
  39. This documentation is organized as follows:
  40. -------------------------------------------
  41.  
  42.     Introduction
  43.     Equipment Required
  44.     How to Register
  45.     Files you should have
  46.     Changes New to version 2.0
  47.     Beginners
  48.     Advanced
  49.     File
  50.       Saving/Restoring Setups
  51.     Planet Editor
  52.       Planet Editor
  53.       16 Random Planets
  54.       Clear all Planets
  55.     Go
  56.       Orbits
  57.       Status Line
  58.       Central Planet Tracking
  59.       Zoom Box
  60.     Examples
  61.     Misc
  62.       Show Orbits On/Off
  63.       Display Grid On/Off
  64.       Elapsed Time On/Off
  65.        Dynamic Time Interval
  66.       Screen Write Method
  67.     Util - Adjust Constants
  68.       Zoom Power
  69.       Screen Center X/Y
  70.       Time Interval
  71.       Gravitational Constant
  72.       Calculations per Plot
  73.       Central Planet Tracking
  74.     Util - Change Video Mode
  75.     Format for Numbers
  76.     Accuracy Notes
  77.     Help with Setups
  78.     Technical Specifications
  79.  
  80.  
  81.  
  82. Equipment Required:
  83. -------------------
  84.  
  85. IBM compatible personal computer
  86. Graphics display (Hercules, CGA, EGA, VGA, At&t, 8514/a)
  87. Disk drive (Floppy or Hard)
  88. At least 384K free memory after boot-up
  89.  
  90. note1:  While this program will run in 384K free memory, some
  91. functions may not be available, and you may run out of memory in
  92. mid-simulation.  I recommend having a machine with the maximum 640K
  93. installed.  
  94.  
  95. note2:  A math coprocessor (80x87) will greatly increase the speed
  96. of the running simulations.
  97.  
  98.  
  99. How to Register
  100. ---------------
  101.  
  102. License registration fee is $15.00 for individuals, $30.00 for
  103. government, corporate, and educational users (cheap).  License fee
  104. of $20.00/$40.00 entitles you to receive the next version by mail. 
  105. Only one registration per address is necessary and registers you
  106. for future versions.  Registered users of version 1.0 are
  107. registered for version 2.0.  This is shareware and as such may be
  108. freely copied and given to others for trial use.  Please help
  109. support shareware authors.
  110.  
  111. Payment and other correspondence may be addressed to:
  112.         Steve Safarik
  113.         P.O. Box 45072
  114.         Seattle, WA  98145-0072
  115.  
  116. Let me know if there are any features you would like to see in
  117. future versions.  Suggestions from current users of version 1.0
  118. were included in version 2.0, and I'm sure that there are many more
  119. things people can think up.  If you have any problems with the
  120. program, remember: It's a feature, not a bug!  If you find any
  121. "features" that I didn't know about when the program was released,
  122. please let me know.
  123.  
  124.  
  125. Files You Should Have
  126. ---------------------
  127.  
  128. GRAVITY.EXE    The main executable file.
  129. GRAVITY.DOC    The documentation file.
  130. GRAVITY.HLP    Data file for on-line help.
  131.       *.GRV    Miscellaneous saved setups (may or may not be
  132.                included with your copy)
  133.  
  134.  
  135.  
  136.  
  137. Changes new to Version 2.0
  138. --------------------------
  139.  
  140. 1.    Version 2.0 operates "True to Life".  It is now possible to
  141.      enter actual systems and watch them execute. 
  142. 2.   A status line has been added to the running simulation.
  143. 3.   Elapsed time has also been added to the running simulation.
  144. 4.    Zoom capabilities have been added, making it possible to enter
  145.      systems which span small and large distances.  For example,
  146.      our own solar system has distances as small as Earth-Moon and
  147.      as large as Sun-Pluto occurring at the same time.  You may now
  148.      zoom-in and watch the inner three planets for example, or
  149.      zoom-out to see the whole system.
  150. 5.   The maximum number of defined planets has been increased from
  151.      eight to 16.
  152. 6.   You may view the simulation from either a fixed position in
  153.      space, or from the perspective of any one of the planets.
  154. 7.   Context-sensitive help has been added for each data input
  155.      field by pressing F1.
  156. 8.   Option added to automatically adjust the Time Interval
  157.      variable.
  158. 9.    The inaccuracy that existed in version 1.0 in the calculation
  159.      of planet movements has been removed to a large extent.
  160. 10.  Planets of zero mass, and single planets, now move properly.
  161. 11.  Planet radius is smaller than the size of version 1.0 to more
  162.      truly reflect the actual size in relation to distances. 
  163. 12.  Planets created out of collisions now have velocity of a mass-
  164.      weighted average of the two previous planet's velocities (sum
  165.      of their momentums), rather than just an average of their
  166.      velocities.
  167. 13.  A planet density variable has been added for each planet.
  168. 14.  You may now overwrite existing ".GRV" files.
  169.  
  170.  
  171.  
  172. BEGINNERS:
  173. ==========
  174.  
  175. When you first start the program, you will see the opening screen,
  176. and then a row of choices at the top of the screen with these
  177. words:
  178.  
  179. FILE    EDITOR    GO    EXAMPLES    MISC    UTIL
  180.  
  181. Move the menu-bar left and right and up and down with the arrow
  182. keys, and select a choice with the ENTER key.  The first thing to
  183. do is select one of the examples such as "Moon" and watch it run. 
  184.  
  185. Pressing Esc while it is running will stop the run and bring you
  186. back to the menus.  You can restart the simulation by selecting
  187. "Watch it Running" under the "Go" menu.  If you want to change any
  188. values for planets, select "Planet Editor" under the "Editor" menu.
  189.  
  190. Context-sensitive help is available at any of the data-entry fields
  191. by pressing F1.  This will display text describing the values that
  192. can be entered for that field.
  193.  
  194.  
  195.  
  196. ADVANCED USERS:
  197. ===============
  198.  
  199.  
  200. File - Saving/Restoring Setups
  201. ------------------------------
  202.  
  203. Under the "File" menu, select "Save" or "Restore".  Enter the full
  204. path and filename of the file.  If you do not specify a path, the
  205. current directory is assumed.  If you do not specify an extension,
  206. .GRV is appended.  Beginning with version 2.0 you can overwrite
  207. save files.  If the file already exists a prompt will appear on
  208. whether or not you want to overwrite the existing file.
  209.  
  210. Unfortunately, .GRV files from version 1.0 are not compatible with
  211. version 2.0.  Many variables have changed and functionality has
  212. been added so that even if the capability to read version 1.0 files
  213. were included, the setups would no longer operate the same.  This
  214. program now operates "True to Life" and systems you enter should
  215. be compatible with future versions.
  216.  
  217.  
  218. Planet Editor
  219. -------------
  220.  
  221. --- Planet Editor:  Values which can be changed individually for
  222. each planet are:  Mass, Density (new to 2.0), X position, Y
  223. position, X velocity, Y velocity, Orbits on/off, and Stationary
  224. on/off.  Orbits enables the dots that mark the path of the planet,
  225. while Stationary, when set to Yes, fixes the planet firmly in
  226. place.  Planets do not need to be entered