home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / misc / sci / StarCollapse.lha / README < prev    next >
Text File  |  1995-11-14  |  3KB  |  125 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                  ----------------------------------------
  12.  
  13.                GRAV : THE COLLAPSING STAR CLUSTER SIMULATION
  14.  
  15.                  ----------------------------------------
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                    Hello all you budding cosmologists !
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41. This is a very short description of what you just downloaded/got on a disk.
  42.  
  43.  
  44. 1. What ?
  45. ---------
  46.  
  47. GRAV Is a simple program that generates an animation data file (but won't
  48. actually display it ! See below for how to display) of a collapsing cluster
  49. of stars (OK. masses..).
  50.  
  51.  
  52. 2. Usage
  53. --------
  54.  
  55. Invoke the program as follows:
  56.  
  57. GRAV <numframes> <nummasses>
  58.  
  59. For example:  GRAV 500 100 >RAM:GRAV.DAT
  60.  
  61. This would start GRAV using a mass cloud numbering 100 masses and would loop
  62. through the gravitation physics 500 times, outputting a temporal snapshot for
  63. every loop (ie. a frame) to the file GRAV.DAT in your RAM: disk.
  64.  
  65. Note that the program needs the redirection because it simple writes to stdout!
  66.  
  67. In fact, GRAV can take more parameters, so check them out by calling up its
  68. standard AmigaDOS usage template by giving "?" as the sole argument.
  69.  
  70. At the time of writing, GRAV's arguments template is
  71.  
  72.     FRAMES/K,MASSES/K,DELAY/K,AUDIT/S,NODISPLAY/S
  73.  
  74. As you will see when you run the program, it does actually open a screen to
  75. display the simulation, but only in 2-D (orthogonal projection).
  76. To see the IMPRESSIVE simulation in full 3-D, see further down..
  77.  
  78.  
  79. 3. Displaying the animation
  80. ---------------------------
  81.  
  82. For this you either:
  83.  
  84.  a) E-Mail me, and I'll send you my display program
  85.  
  86.  b) write a file converter to convert the simulation data to some 3D 
  87.     application's standard, and then display it using that program.
  88.  
  89.  c) write your own renderer/animation replay software.
  90.  
  91.  
  92. The file format is dead simple (number of frames, then number of vertices
  93. for this frame, then list of x,y,z triplets per vertex...).
  94. If you can't figure it out, E-Mail me and I'll send you a "formal"
  95. description.
  96.  
  97.  
  98. A plea for information
  99. ----------------------
  100.  
  101. I would love to hear from 68040/60 owners how long the simulation takes
  102. for the following simulation runs:
  103.  
  104. a) GRAV 500 250
  105. b) GRAV 500 500
  106. c) GRAV 500 1000
  107.  
  108. I think even c) will have your machine on its knees... and FYI the program's
  109. bottleneck is optimized FPU assembler !!
  110.  
  111. 4. Afraid of Virusses ?
  112. -----------------------
  113.  
  114. Source code included: so just recompile/assemble/link.
  115.  
  116.  
  117.  
  118. 5. Author's name/address
  119. ------------------------
  120.  
  121.                             Laurence Vnahelsuwe
  122.  
  123.                             E-Mail: LVA@PING.BE
  124.  
  125.