home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / s / sop9311u.zip / STSPLUS.NEW < prev   
Text File  |  1993-03-11  |  13KB  |  212 lines
  1. STSORBIT PLUS Revision History
  2. ------------------------------
  3.  
  4.       Each released version of STSPLUS uses a four digit revision code such 
  5. as 9311. The first two digits indicate the year and the second two digits 
  6. indicate the week of the year. In some cases, an additional letter suffix 
  7. is added to distinguish changes occurring within the same week or to 
  8. identify special versions. A partial week at the beginning or end of the 
  9. year is counted as a full week. Using this method, a year will typically 
  10. have 53 weeks although it is possible to have 54 weeks in a leap year (1972 
  11. is an example). The current year-week revision code is shown on the Julian 
  12. Date display, Display Mode 7, in my program ASTROCLK.
  13.      This file records the revision history of program STSPLUS through all 
  14. of the minor twists and turns that usually accompany the evolution of such 
  15. a complex program. It illustrates the tortuous process of maintaining and 
  16. refining a program as ideas and problems are reported from every quarter. 
  17. These notes may also be helpful to users who are upgrading from one version 
  18. to another to find out what has changed.
  19.  
  20.                                               David H. Ransom, Jr.
  21.  
  22.  
  23. Version 9311 -- March 1993
  24. --------------------------
  25. -This is a FULL RELEASE with updated documentation, and includes all 
  26. changes listed here as well as those made in Preliminary Versions 9307 
  27. through 9310. Please see the update notes below for details.
  28. -Added F1 to the Main Menu, Convert Keplerian Elements to 2-Line Format, 
  29. which incorporates the features formerly provided separately in my program 
  30. MAK2LINE. See new text for discussion and for a form which may be used to 
  31. transcribe data received by voice or modem.
  32. -Repaired a bug which caused the Location Map isocontours to be drawn at 
  33. the wrong location when a second location was enabled in orthographic mode. 
  34. Thanks to Paul Ferrante for reporting the problem!
  35. -Added Function Key F9 to the Time and Date Menu (F8 from the Main Menu) to 
  36. show the last system TIMESET and the current RIGHTIME corrections. This 
  37. menu item will not appear if program RIGHTIME is not detected.
  38. -Added additional code to maintain the prior state of RIGHTIME per Tom 
  39. Becker. Thanks, Tom!
  40. -Various minor cosmetic changes.
  41. -Documentation updated.
  42.  
  43.  
  44. Version 9310 -- March 1993
  45. --------------------------
  46. -This is a MAINTENANCE UPDATE and also includes several improvements to 
  47. Version 9309. Users updating from Version 9250 should also read the notes 
  48. for Version 9309 below.
  49. -In my rush to release Version 9309 of STSPLUS prior to STS-55, I neglected 
  50. to finish updating the code for F2 (Read 2-line elements). Hopefully, that 
  51. code has now been repaired correctly ... sorry!
  52. -STSPLUS is now "aware" of program RighTime by Tom Becker. Audible alarms 
  53. in prior versions would perform unpredictably when RighTime was active 
  54. because MS BASIC uses the hardware clock's timer functions for "music" 
  55. (which RighTime also uses). STSPLUS now detects RighTime and temporarily 
  56. disables RighTime while an audible alarm is being generated and then re-
  57. enables RighTime after the alarm has completed, restoring precise 
  58. timekeeping. With RighTime active, alarms are generated in foreground, 
  59. which may cause a slight delay in screen updating.
  60. -CAUTION: STSPLUS expects RighTime Version 2.5+; performance with prior 
  61. versions of RighTime may yield unpredictable results. If using a prior 
  62. version of RighTime, do NOT enable audible alarms!
  63. -If RighTime is not present or is not detected, the audible alarms are 
  64. generated in background as in prior versions. This usually causes the loss 
  65. of several clock ticks in the DOS software clock for each audible alarm. 
  66. Although the time loss per audible alarm is very small, the cumulative 
  67. error may become significant over extended time periods.
  68. -Added the flashing message "calculating ..." during Pass Prediction 
  69. calculations so that users with slow computers (especially those without a 
  70. math coprocessor) will know that the process is continuing. Users with 286 
  71. computers and no math coprocessor report delays up to tens of minutes for 
  72. satellites with low mean motions!
  73.  
  74.  
  75. Version 9309 -- February 1993
  76. -----------------------------
  77. -This is a PRELIMINARY RELEASE of a major update for STSPLUS and the first 
  78. public release since Version 9250. This version is being released as an 
  79. UPDATE ONLY for Versions 9250 and 9307; the full version will be released 
  80. shortly, complete with full documentation, pending the results of testing 
  81. for this preliminary release. See also the update notes for Version 9307 
  82. below. Comments and suggestions are invited, particularly with respect to 
  83. the new Data Output and Pass Prediction features.
  84. -Function Key F3 on the Main Menu, Pass Predictions and Data Output, has 
  85. been rewritten and improved.
  86. -Added Line-of-Sight Pass Predictions for the current satellite. Use F3 
  87. from the Main Menu and select Data Format 9. Pass predictions are made for 
  88. 48-hour blocks and for up to 99 passes. Users may immediately display a 
  89. listed pass by entering the pass number. STSPLUS then automatically sets 
  90. SIMULATED TIME to the middle of the pass and switches to the ground track 
  91. display. See the section "Pass Predictions and Data Output" for additional 
  92. information. The capability to use TRAKSTAR or other external tabular pass 
  93. prediction software has been retained for those who prefer that technique.
  94. -Improved and refined the Data Output capabilities introduced in Beta 
  95. Version 9307. Added FILE Data Output to file STSPLUS.LOG, and PRINTER Data 
  96. Output to printer LPT1:.
  97. -Modified F2 on the Main Menu (Read 2-line Elements) to require the "#" 
  98. symbol when entering the NORAD number; enter the NORAD number as "#20580". 
  99. This now permits satellite names such as "1993 012A" to be found correctly; 
  100. prior versions would treat such an entry as a NORAD number and the search 
  101. would fail.
  102. -Entering a full drive and path specification in addition to a filename 
  103. with F2 on the Main Menu (Read 2-line Elements) will now correctly set the 
  104. path without the need to use F7 (Set Paths and Filenames). Root directories 
  105. ("C:\") are now processed correctly. Press ESC to cancel.
  106. -Added text section titled "Time and the Personal Computer" which offers 
  107. information on setting and maintaining the PC clocks over long periods of 
  108. time. Includes information on programs TIMESET and RIGHTIME.
  109.  
  110.  
  111. Version 9307 -- February 1993
  112. -----------------------------
  113. -This is a BETA TEST VERSION, not released publicly.
  114. -Added Function Key F3 to the Main Menu. This provides data output on the 
  115. selected COM port with specified data items. Three different data formats 
  116. have been implemented so far.
  117. -Removed the original Function Key F3 (Read .INI file) from the Main Menu. 
  118. Use F2 to read 2-line elements and/or set file names. In Version 9250, the 
  119. satellite data was not being read when the .INI file was changed. This was 
  120. caused by logic changes to speed up initialization of the program. Also, 
  121. reading "foreign" .INI files sometimes caused problems.
  122. -Corrected a bug which caused a new launch time/date NOT to be added to 
  123. file STSPLUS.LTD if the curret satellite's NORAD number was less than the 
  124. last NORAD number in the file.
  125. -In response to a request by Maj. T.S. Kelso, USAF, who prepares the 2-line 
  126. orbital elements which I post on my RPV ASTRONOMY BBS, I have changed the 
  127. name of that file from "NASAnnn.TXT" to "TLEnnn.TXT". The default file 
  128. which STSPLUS looks for has been similarly changed. Since the orbital data 
  129. in the file does NOT come from NASA but from US Space Command, the use of 
  130. "NASA" in the filename was confusing and did not give credit where it was 
  131. due.
  132. -Corrected a minor bug which caused five pixels to be restored incorrectly 
  133. under the starbord (right) wing of the space shuttle icon.
  134. -Modified the operation of Function Key F5 from the Main Menu to ADD or 
  135. UPDATE new launch time and date in file STSPLUS.LTD rather than to append 
  136. the new data at the end of the file. This assures that the satellite is 
  137. included only once in the file and that the new or updated information is 
  138. always read correctly. Prior versions required the user to manually edit 
  139. the file to remove multiple entries.
  140. -Adjusted the maximum angle displayed for the isocontours (concentric 
  141. circles of satellite visibility) on the Location Map in orthographic mode 
  142. to take satellite altitude into account.
  143. -Corrected the STSPLUS.OBS file format for use with TRAKSTAR. The data was 
  144. correct but the spacing caused TRAKSTAR to sometimes read the data 
  145. incorrectly. Thanks to Michael Simmons for reporting the problem!
  146. -Corrected the latitude of Sao Paulo, Brazil in file STSPLUS.LOC. It was 
  147. one degree off to the South and wound up in the Atlantic Ocean ...
  148.  
  149.  
  150. Version 9250 -- December 1992
  151. -----------------------------
  152. -This is a MAINTENANCE AND FEATURES UPDATE.
  153. -In response to numerous suggestions, I have redesigned and enlarged the 
  154. space shuttle icon and switched from a profile to a plan view to make the 
  155. icon easier to find on the screen. The new icon has almost three times as 
  156. many pixels and takes more time to draw. Comments are invited!
  157. -In response to many user requests, I have improved file selection logic 
  158. for 2-line elements using F7 from the Main Menu to "remember" the path and 
  159. save it in file STSPLUS.INI. Users may now keep all 2-line elements files 
  160. for STSPLUS and other tracking programs in a separate directory.
  161. -While the default filetype for 2-line elements is still ".TXT", the 
  162. program now also searches for filetype ".TLE".
  163. -Event timers (showing AOS and LOS for the local station, TDRS, etc.) are 
  164. now enabled by F10+F7 from the Main Menu.
  165. -I have added the Location Map in orthographic mode; press "L" while an 
  166. orthographic map is displayed. The projection used for the Location Map is 
  167. now based upon the current projection, rectangular or orthographic, when 
  168. "L" is pressed.
  169. -Improved resolution of spacecraft lighting from 10 seconds to 1 second and 
  170. the Sun's position is now calculated every 10 seconds instead of every 60 
  171. seconds.
  172. -Spacecraft lighting icon and symbol (to the right of "Orbit #:" in the 
  173. data block) now indicate the full range of solar illumination:
  174.      *    Bright White   Full sunlight
  175.      +    Yellow         Partial sunlight (penumbra)
  176.      -    Light Red      Refracted sunlight
  177.           White          Full shadow (umbra)
  178. Note that LIGHT RED and the "+" and "-" symbols have been added to 
  179. distinguish refracted sunlight from partial sunlight.
  180. -In response to several user requests, I have added AOS and LOS event 
  181. timers for orbital sunrise and sunset, displayed when the solar features 
  182. are enabled. In order to avoid excessive delays during the ground track 
  183. plotting (when the timers are set up), I have used a simpler algorithm for 
  184. orbital sunrise and sunset than that used during program operation. The 
  185. simpler algorithm is usually accurate to about plus or minus 15 seconds. 
  186. The actual spacecraft lighting is calculated dynamically and is both more 
  187. accurate and takes into account the non-spherical shape of the Earth.
  188. -After several user comments about the "big clocks", I have again tweaked 
  189. the shape of the large digit "5" (back to what I started with) and modified 
  190. the "6" to better distinguish it from the "5".
  191. -In order to free a display line in orthographic mode, the map drawing time 
  192. and map database file information have been combined on a single line (e.g. 
  193. "EARTH4  10.91") at the bottom of the display block.
  194. -STSPLUS now automatically detects the type of processor and math 
  195. coprocessor; if no math coprocessor chip is detected, the program displays 
  196. a caution message at startup. The SLOW MODE is now automatically set or 
  197. reset depending upon the presence or absence of the math coprocessor and 
  198. the menu selection for the SLOW MODE has been removed.
  199. -Performance may be improved if a memory manager such as EMM386, QEMM386 or 
  200. 386MAX is NOT used! See the section "PROGRAM SETUP AND USAGE NOTES" for 
  201. specific information.
  202. -Changed the grid spacing in orthographic mode, MAG=200, to 10 degrees from 
  203. 5 degrees to make the display a bit less cluttered.
  204. -STSPLUS is now compiled using Microsoft Visual Basic for DOS.
  205. -Updated this documentation. Added the sections "SUN and Solar Features", 
  206. "Event Timers and Audible Alarms", and "F5  Display Ground Track: 
  207. DOTS/LINE". Moved the section "F5  Show Ascending & Descending Node Data" 
  208. to the proper place in the text.
  209. -Corrected a bug which caused a minus sign (if present on Y or Z) to 
  210. persist when changing from XYZ to Alt/Az or RA/DEC satellite coordinates.
  211. -Various minor cosmetic changes.
  212.