home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsr / solun25 / SOLUN.TXT < prev    next >
Text File  |  1994-06-21  |  6KB  |  164 lines
  1. SOLUN - A Pocket Planetarium
  2.  
  3. Solun is planetarium application for Psion Series 3 computers, calculating
  4. and displaying the positions of the sun, moon and all nine planets.
  5.  
  6. In addition to star charts, Solun can display a world day/night map, the
  7. moon phase, and an orrery. Information about the major objects in the solar
  8. system can be obtained, including the approximate rise and set times.
  9.  
  10. Solun was written on a Series 3 machine in OPL. In order to keep the size
  11. down, and the speed up, Solun might not be very accurate. However, I think
  12. it might prove useful to the amateur astronomer, even if only in partnership
  13. with a good star atlas. Not being a very accomplished one myself, it has
  14. allowed me to predict good times to locate some interesting naked-eye
  15. objects, and identify a particularly bright object as Jupiter.
  16.  
  17. Solun includes the approximate positions of 2000 stars, ~150 messier objects
  18. and outlines and names of all 88 constellations.
  19.  
  20. CONDITIONS OF USE
  21.  
  22. Solun is `freeware' and is copyright. The author gives permission for the
  23. software to be freely used and distributed, provided that:
  24.  
  25. o no part of the distribution is altered in any way;
  26.  
  27. o no commercial transaction is involved (distribution via commercial
  28. libraries, magazine cover-disks, etc is prohibited);
  29.  
  30. o the user accepts all responsibility for any loss or damage incurred.
  31.  
  32. The distant object files, Stars.sol and Messier.sol, were derived from the
  33. public domain Yale star database. As such these files are not considered
  34. copyright and are exempt from these conditions.
  35.  
  36. WHAT'S NEW?
  37.  
  38. Solun 2.5 includes a number of improvements over the older version. The most
  39. significant of these include:
  40.  
  41. o uses the `World' database server to choose observer locations by city;
  42.  
  43. o automatic detection of the home city and time-zone;
  44.  
  45. o a `save settings' option for most of the other options;
  46.  
  47. o chart labels from `Data' files;
  48.  
  49. o calculation of planet magnitudes;
  50.  
  51. o plotting of the galactic equator, showing the approximate position of the
  52. Milky-way;
  53.  
  54. o flashing city marker on world map displays;
  55.  
  56. o many other cosmetic improvements and small bug fixes.
  57.  
  58. INSTALLATION
  59.  
  60. The Solun distribution contains the following files:
  61.  
  62. Solun2.opa - OPL application executable;
  63.  
  64. Flutils.fl0 - shared application library;
  65.  
  66. Solun.pic - bit-mapped graphics;
  67.  
  68. Solun.map - world map outline vectors;
  69.  
  70. Solchart.opo - star chart plotting module;
  71.  
  72. Const.sol - Flossy's constellation outlines;
  73.  
  74. Stars.sol - Yale star positions;
  75.  
  76. Messier.sol - messier object positions;
  77.  
  78. Solun.fon - a small font, used for labels;
  79.  
  80. Const.lab - constellation labels;
  81.  
  82. Scale.lab - right ascension and declination labels;
  83.  
  84. Solun.hlp - online help file;
  85.  
  86. Solun.txt or Solun.wrd - this documentation file.
  87.  
  88. To install Solun, simply copy Solon2.opa to any \APP directory, Flutils.fl0
  89. into any \OPO and the all other files to any \APP\SOLUN directory. Solun can
  90. then be installed onto the systems screen and run. Solun is quite a big
  91. application. Here are some hints about how to get the best out of it.
  92.  
  93. o All files except Solun2.opa, Solun.pic and Flutils.fl0 are optional, and
  94. need not be installed if you are short of space. If Solun fails to locate a
  95. file it needs for an operation, a message will be displayed and the
  96. operation aborted. It should be fairly obvious which files might be needed
  97. by the various operations.
  98.  
  99. o Flutils.fl0 is a shared application library used by some other software I
  100. have written. You only need one copy installed so if you already have one,
  101. delete the older version. The version number can be seen by running a
  102. Flutils.fl0 from the `RunOPL' icon on the system screen.
  103.  
  104. o All the files may be freely divided between any local drives. Place them
  105. on which ever drive you have space on and Solun will search for each file
  106. individually, each time it needs them.
  107.  
  108. o The object position, *.sol, files store each object in a 3-byte record. If
  109. you wish to shorten them you may do so using any suitable binary editor
  110. (make a backup first). Delete bytes from the end of the file, ensuring the
  111. final file length is a multiple of three.
  112.  
  113. o Since some of Solun's displays can take some time to draw, you may find it
  114. useful to assign a button to the application to allow you to switch directly
  115. backwards and forwards. If it is currently free, Control-World world seem a
  116. suitable choice.
  117.  
  118. GETTING STARTED
  119.  
  120. When run, Solun displays a title screen and performs some initial
  121. calculations. Once this is finished press `Space' and Solun will draw a map
  122. of the world, shading in the dark side.
  123.  
  124. Solun responds to letter key presses with the same operation as its
  125. equivalent Psion-letter combinations. Use the `Menu' key to display the
  126. available options. Keys 0-4 correspond the available displays, which can
  127. also be selected from the `Options' dialog: 0-None, 1-Day/Night, 2-World
  128. map, 3-Sky, 4-Orrery.
  129.  
  130. Notice that before a star chart, `Sky', can be plotted, Solun has to
  131. precalculated a table. This takes a few minutes but it is then stored in
  132. memory it is available for the next to be chart plotted. The table will be
  133. lost when you quit the program. You might, therefore, like to leave Solun
  134. running when you have enough memory.
  135.  
  136. If Solun.hlp is present in a local \APP\SOLUN directory, the `Help' key
  137. provides online help. More information about how to use the application can
  138. be found there.
  139.  
  140. Solun stores its settings in a small configuration file M:\OPD\Solun.cfg. If
  141. this file is not present Solun will create it and select some default
  142. settings.
  143.  
  144. AND FINALLY
  145.  
  146. If you have any problems or suggestions with this software, I'd welcome your
  147. comments. You may contact me at the following Email address (until Sept
  148. 1994):
  149.  
  150. drushall@cs.man.ac.uk
  151.  
  152. Alternatively you can contact me by post:
  153.  
  154. David Rushall, `Markers End', Mounts Lane, Newnham, Northants, UK. NN11 6ES.  
  155.  
  156. One more thing: Sorry there is no specific S3a version of Solun yet. There
  157. may be one day, as I'd like to have a go, but don't hold your breath. Time
  158. is short and for now, I think you'll agree, that this is better than
  159. nothing...
  160.  
  161. Have fun!
  162.  
  163. David Rushall - June 1994
  164.