home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff250.lzh / Gravity-Well / GW-User-Guide < prev    next >
Text File  |  1989-09-16  |  5KB  |  109 lines
  1.  
  2.       Gravity Well
  3.                 
  4.       Celestial Motion Simulator
  5.  
  6.       by Gary Teachout
  7.  
  8.       Freeware Copyright 1989
  9.  
  10.    Gravity Well simulates the motion of up to twenty bodies in Newtons
  11. universe. Distance, time and mass are in canonical units (UGC=1). The
  12. position, velocity and mass of each body may be entered with the mouse or
  13. by typing the numbers into the boxes in the data window and clicking the
  14. enter button. The view of the simulation may be scaled, rotated in three
  15. dimensions or repositioned using the buttons in the view control window.
  16. When two bodies collide one absorbs the other in a way that mass and
  17. momentum are conserved.
  18.  
  19.    Continuous motion is aproximated by a sequence of discrete steps. At
  20. each step the acceleration of each body is added to its velocity then the
  21. velocity of each body is added to its position and the new position is
  22. displayed. The variable Time Step controls the maximum amount of time
  23. covered by each step. During close encounters the actual step size is
  24. reduced to minimize errors. 
  25.  
  26. Menus:
  27.    QUIT           Exits the program.
  28.    Open Window    Opens the window or moves it to the front.
  29.    Control
  30.       Start       Starts or continues the simulation.
  31.       Stop        Halts the simulation.
  32.       Set         Makes start settings equal current settings.
  33.       Reset       Makes current settings equal start settings.
  34.  
  35. View Control buttons:
  36.    Follow         Causes the display to be centered on the selected body.
  37.    Center         Allows you to use the mouse to reposition the display.
  38.    Trails         Starts or stops the red trails.
  39.    -Rotate-       These buttons change the orientation of the view.
  40.    -Zoom-         These buttons change the scale of the view.
  41.  
  42. Data window buttons:
  43.    Load           Loads a simulation from a file.
  44.    Save           Saves a simulation to a file.
  45.    New            Clears all data.
  46.    1,2...20       Buttons numbered 1 - 20 select the current body. All
  47.                   input goes to the selected body.
  48.    Position       After clicking this button you may use the mouse to
  49.                   reposition the selected body in the view windows.
  50.    Velocity       After clicking this button you may use the mouse to
  51.                   change the velocity of the selected body in the view
  52.                   windows.
  53.    Mass           After clicking this button you may use the mouse to
  54.                   change the mass of the selected body in the view windows.
  55.    Delete         Removes the selected body from the simulation.
  56.    Zero M         Zero Momentum. Adjusts the velocity of all bodies in the
  57.                   simulation so that the totel momentum is zero. This
  58.                   prevents the system from drifting out of the display.
  59.    Start          Starts or continues the simulation (Same as Start menu
  60.                   item).
  61.    Create         Input mode. This allows bodies not yet part of the
  62.                   simulation to be selected.
  63.    Enter          Records data in from the input boxes.
  64.  
  65. Data window input boxes:
  66.    File Name      AmigaDOS file name for loads and saves.
  67.    Comment        Space for anything you want to say about this simuation.
  68.    Time Step      Maximum step size in canonical units (press RETURN to
  69.                   enter).
  70.    Magic          Magic controls how the program handels close encounters.
  71.                   The program is more acurate with large numbers but will
  72.                   run more slowly. Numbers from 50 to 200 are typical.
  73.    Name           The name or a comment for the selected body.
  74.    Mass           Mass of selected body. Each body may have zero or more
  75.                   mass.
  76.    Radius         Size of selected body. This is used only to test for
  77.                   collisions. 
  78.    Start Position Inital position vector components of selected body.
  79.    Start Velocity Inital velocity vector components of selected body.
  80.  
  81. The Gravity-Well directory contains the following example simulation files.
  82.  
  83.    System         Sol and the planets. To view just the outer planets
  84.                   use a larger Time Step and small Magic. To view just the
  85.                   inner planets use a smaller Time Step.
  86.    Lagrange       The Earth the Moon and their stable Lagrange points
  87.                   (trojan points). 
  88.    Neighborhood   Sol and some stars from the local neighborhood.
  89.  
  90.  
  91. Gravity Well may be copied and distributed on a not for profit basis.
  92.  
  93.    Please send any coments, suggestions, bug reports, donations (accepted
  94. but not required) or outstanding simulations to:
  95.  
  96.                Gary Teachout
  97.                10532  66 place, W
  98.                Everett, Wa, 98204
  99.  
  100.                USA
  101.                North America
  102.                Earth
  103.                Sol
  104.                Carina Cygnus
  105.                Milky Way
  106.  
  107.    Support The National Space Society
  108.  
  109.