home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1995 December / SOFM_Dec1995.bin / pc / dos / edu / stsplus / stsplus.new < prev    next >
Text File  |  1995-10-31  |  22KB  |  363 lines
  1. STSORBIT PLUS Revision History
  2. ------------------------------
  3.  
  4.       Each released version of STSPLUS uses a four digit revision code such 
  5. as 9540. 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 9540 -- September 1995
  24. ------------------------------
  25. -This is a MINOR UPDATE, correcting what are hopefully the last minor bugs 
  26. introduced with the recent releases (9537 thru 9539).
  27. -Corrected a bug which caused the Inclination to appear as 0.000000 after 
  28. using F2 to update TLEs. Thanks to Ray Grace for the report!
  29. -Corrected a bug which caused the screen to scroll in rectangular 
  30. projection when statute miles were the unit of measure and XYZ coordinates 
  31. were displayed. Thanks to John Szalay for the report!
  32. -Corrected a cosmetic bug which caused the Time Since Epoch ("T+Epoch"), 
  33. which was increased by one digit to the left to accommodate up to 99999 
  34. days, to erase the last letter of "Epoch" in rectangular projection.
  35.  
  36.  
  37. Version 9539 -- September 1995
  38. ------------------------------
  39. -This is a MAINTENANCE UPDATE, correcting a number of problems which were 
  40. detected in Versions 9537 and 9538. As sometimes happens, incorporating new 
  41. or changed features introduces bugs which aren't found during initial 
  42. testing. My apologies and thanks to everyone who reported the problems.
  43. -A number of problems were found which resulted in a corrupt initialization 
  44. file (STSPLUS.INI). Some problems were traced to program bugs and some to 
  45. problems with TLE files. Every effort has been made to eliminate the 
  46. internal bugs and to improve "bullet proofing" for TLE files. However, 
  47. users are reminded that STSPLUS assumes that the TLE files are free from 
  48. major structural errors and do not include plain text. Use my program 
  49. ORBITEL or an ASCII editor to check TLE files prior to use with STSPLUS. 
  50. TLE files obtained from my RPV Astronomy BBS have been checked.
  51. -After too many attempts, I finally was able to get Windows 95 running on 
  52. one of my test systems. (My primary test system was unable to run Win95!) 
  53. Initial tests indicate STSPLUS performs adequately, although not as fast as 
  54. under DOS 6.2. However, users should operate STSPLUS in a full window!
  55.  
  56.  
  57. Version 9538 -- September 1995
  58. ------------------------------
  59. -This is a MINOR UPDATE, adding minor enhancements, correcting several 
  60. minor bugs, and adding setup features.
  61. -Several users have reported a problem with Version 9537 which causes the 
  62. program NOT to return to the Main Menu from the map when ENTER is pressed. 
  63. This is apparently caused by file STSPLUS.INI becoming corrupt. However, I 
  64. have been unable to duplicate the problem. As a workaround, copy a good 
  65. version of file STSPLUS.INI (the distribution version of STSPLUS.INI, for 
  66. example) to another file named STSPLUS.OK. Then, if you must reboot your 
  67. computer to exit STSPLUS, execute the following DOS command before again 
  68. running STSPLUS:
  69.  
  70.      COPY STSPLUS.OK STSPLUS.INI
  71.  
  72. -STSPLUS now requests the first time user to set certain features before 
  73. the program starts normal operation. This setup feature is automatically 
  74. selected when the distribution version of file STSPLUS.INI is used and may 
  75. be requested at any time by including the "/NEW" command line option when 
  76. the program is started:
  77.  
  78.      STSPLUS /NEW
  79.  
  80. This feature requests the user to select the location, allows STSPLUS to 
  81. calculate an estimated UTCOffset so the user may select the correct UTC 
  82. Offset (below), and displays the current files and paths for user approval. 
  83. A new text section, INITIAL STSPLUS SETUP, describes this feature in more 
  84. detail.
  85. -When the "/NEW" command line option is used (and when the distribution 
  86. version of file STSPLUS.INI is used), STSPLUS now calculates an estimated 
  87. UTCOffset based upon Primary Location longitude. Since the estimate does 
  88. not take into account the political "adjustments" made to time zones, it 
  89. may be off by one hour. Users whose time zone is set to other than the 
  90. exact hour must enter the correct UTCOffset. (Prior versions simply 
  91. displayed "(not set)" when the UTCOffset had not been set.)
  92. -Corrected a minor bug which caused the Time Zone Abbreviation not to be 
  93. set when first initializing the program.
  94. -Added Latitude, Longitude and Elevation data for all locations when 
  95. setting local coordinates (F10+F2). Example:
  96.  
  97.      Current PRIMARY Location:      Palos Verdes, CA
  98.                                     Latitude:     33.7632 degrees
  99.                                     Longitude:  -118.4057 degrees
  100.                                     Elevation:   186      meters
  101.  
  102. -Added backspace processing for SCF filename entry, F6+F2 and F6+F3 from 
  103. the Main Menu. All characters in the SCF filename are now capitalized, even 
  104. if entered in lower case. Thanks to Russ Nelson for the "catch"!
  105. -I have added ALT-F1 to the Main Menu to display the primary satellite's 
  106. orbital data along with various times of interest. The command is NOT 
  107. displayed on the Main Menu! (This is experimental ONLY ... comments 
  108. invited.)
  109. -Corrected a cosmetic problem with node data and "/CLK" command line option 
  110. in rectangular projection. The node data now appears within the box.
  111. -Modified large digit MET with the "/CLK" command line option in 
  112. rectangular projection to show full MET with up to 5 digits of days.
  113. -Added file VBERRORS.TXT to the distribution package. This file lists the 
  114. Visual Basic for DOS errors which can terminate STSPLUS (extracted from 
  115. Microsoft documentation).
  116.  
  117.  
  118. Version 9537 -- September 1995
  119. ------------------------------
  120. -This is a MAINTENANCE UPDATE, adding several enhancements, correcting 
  121. several relatively minor bugs, and various cosmetic changes.
  122. -By popular request, the current Satellite Configuration File (SCF) 
  123. filename is now saved in file STSPLUS.INI. Pressing ENTER when using either 
  124. SCF Save (F6+F2) or SCF Read (F6+F3) will now select the current SCF 
  125. filename. Use ESC to quit without reading/saving the SCF file. See text 
  126. for additional details.
  127. -NOTE: Users upgrading from a prior version (Version 9517 or older) and 
  128. using their old .INI file must save the current satellite configuration 
  129. (F6+F2) using the appropriate filename before the correct filename will be 
  130. saved; the default SCF filename is otherwise set to STSPLUS.SCF.
  131. -Various code and cosmetic changes have been made to the Satellite 
  132. Configuration section (F6 from the Main Menu) to improve performance and 
  133. error checking. One significant change is that STSPLUS will no longer 
  134. attempt to process the skeletal TLEs generated when a new satellite is 
  135. added to the SCF list; the satellite will be skipped with no message until 
  136. real TLEs are present.
  137. -In response to many questions, I have added STATUTE MILES for all distance 
  138. calculations. Use F9 while the map is displayed to switch between 
  139. kilometers (km), nautical miles (nm), and statute miles (sm). Prior 
  140. versions of STSPLUS only calculated distances in kilometers and nautical 
  141. miles. NASA has contributed to the "confusion" by using STATUTE MILES in 
  142. most public statements (especially for orbital altitude) while using 
  143. NAUTICAL MILES internally.
  144. -Added additional information to file STSPLUS.LOG for Pass Predictions (F3 
  145. from the Main Menu, Data Mode = 9) so that data may be more readily 
  146. identified at a later time. The additional information is:
  147.  
  148.      Location:          Palos Verdes, CA
  149.      Prepared:          Saturday, 09 Sep 1995  17:02:42
  150.  
  151.      Satellite Name:    STS-69
  152.      Catalog Number:    23667  95048A  
  153.      TLE Filename:      STS69R04.TXT
  154.  
  155. Where: "Location" is the current primary location; "Prepared" is the 
  156. (computer) date and time of preparation; "Satellite Name" is the common 
  157. name of the satellite; "Catalog Number" is the NORAD Number followed by the 
  158. International Designation of the satellite; and, "TLE Filename" is the name 
  159. of the 2-line elements file used.
  160. -File STSMIR.ICN, now included with the distribution package, provides an
  161. icon of the Space Shuttle docked on the Mir Space Station. See file 
  162. STSMIR.NOT for instructions on using the icon during upcoming rendezvous 
  163. missions. The icon was first prepared for the STS-71 mission.
  164. -Corrected a minor bug which required the 2-line elements file to be read 
  165. when resuming a prior mission (the command line option "/R" is included). 
  166. STSPLUS now reads the INI file for the TLEs when resuming a prior mission. 
  167. This modification also eliminates occasional TLE problems when selecting a 
  168. new Primary Satellite from the list of Secondary Satellites (F6+F4 from the 
  169. Main Menu); the LTD and XRF files are now checked when a new Primary 
  170. Satellite is selected.
  171. -Corrected a problem with the "ZOE" (Zone of Exclusion) label when other 
  172. than TDRS-East and TDRS-West are used as the communications satellites in 
  173. secondary satellite slots 1 and 2. The location of the label was hard-coded 
  174. for the TDRS satellites. The location (longitude) of the "ZOE" label is now 
  175. calculated dynamically and will appear in the correct location for other 
  176. communications satellite configurations such as the two Russian ALTAIR 
  177. satellites #20391 (Cosmos 2054/ALTAIR-1) and #23426 (Luch/ALTAIR-2) being 
  178. used for communications with the MIR spacecraft.
  179. -Corrected a minor bug which caused only four digits of MET days to be 
  180. displayed. Older satellites, such as Vangard 1 (NORAD #00005) have MET 
  181. greater than 9999 days. Note that the large MET display in the orthographic 
  182. display always displays MET MOD 10000 because of space limitations.
  183. -Corrected a long standing bug which sometimes caused the "BASIC Error = 
  184. 76" (path error) message and returned the user to DOS when attempting to 
  185. execute TRAKSTAR (F4 from the Main Menu). The initial default path was 
  186. missing a trailing backslash ("\") unless the path was manually entered. 
  187. Thanks to James Gundrey and others for continuing to report the error until 
  188. I finally spotted the cause!
  189. -Modified the AOS/LOS algorithm which caused the AOS/LOS times to be 
  190. slightly processor dependent. The variation among various processors (386, 
  191. 486 and Pentium) was usually on the order of plus or minus five seconds. 
  192. There may still be small differences (several seconds) between very fast 
  193. and very slow processors and systems with and without a math coprocessor 
  194. due to a simpler and slightly less accurate algorithm when the coprocessor 
  195. is absent (to minimize calculation times).
  196. -Corrected a bug which caused the local time zone abbreviation to be blank 
  197. after changing the status of the Daylight Flag (F8+F10). In prior versions 
  198. the user had to exit STSPLUS and restart the program before the local time 
  199. zone abbreviation was correct.
  200. -Replaced the three lines labeled "Launch Year", "Launch Number", and 
  201. "Launch Piece" with the single line "Int'l Designation" in the display for 
  202. data approval when reading new TLEs from a file (F2 from Main Menu). Also, 
  203. the 2nd Derivitave of the Mean Motion (dx/dt2) has been added.
  204. -The use of a RAM disk has been deleted from the suggested system setup 
  205. instructions. Although a RAM disk is still an effective technique 
  206. (especially with a "vanilla" setup), use of disk read caching with 
  207. Microsoft's SMARTDRV or an equivalent disk caching program is now 
  208. recommended as a more general solution applicable to many applications. 
  209. (Disk write caching is NOT recommended; loss of power with write caching 
  210. enabled can result in inadvertent data loss.)
  211.  
  212.  
  213. Version 9517 -- April 1995
  214. --------------------------
  215. -This is a MAJOR UPGRADE, adding several important new features and 
  216. enhancements. User feedback and requests have been a key factor in the 
  217. choice of those features to add. My thanks to everyone who has taken the 
  218. time to offer suggestions and submit bug reports. This version has been 
  219. preceeded by a number of Beta Test Versions which have been of great help 
  220. in working out the bugs. Among the new features are: visible Pass 
  221. Predictions, Launch Simulation for the Space Shuttle, and new Sun and 
  222. satellite icons.
  223. -Several sections of the documentation have been added or materially 
  224. revised to reflect the new features and changes documented below.
  225. -Added VISIBLE Pass Predictions so that users may now see at a glance when 
  226. potential viewing opportunities are in the offing. Visibility conditions 
  227. are tested at AOS, MAX altitude, and LOS. The feature is automatic with 
  228. line-of-sight Pass Predictions (F3 from the Main Menu, Function 9, with Sun 
  229. features are ENABLED). This has been one of the most frequently asked for 
  230. enhancements to STSPLUS! This feature is still somewhat experimental, and 
  231. comments are invited!
  232. -Changed the displayed date format in Pass Predictions from "04/24/1995" to 
  233. "24 APR 95" to avoid confusion with various date formats and to allow two 
  234. extra columns for the "V" (visibility) flag. The new format is "dd MMM yy" 
  235. where "dd" is the current day of the month, "MMM" is the alphabetic 
  236. abbreviation for the month, and "yy" is the last two digits of the year.
  237. -Added Launch Simulation (for Space Shuttle launches ONLY), enabled when 
  238. entering launch time and date using F5 from the Main Menu. See the section 
  239. "Launch Simulation for the Space Shuttle" for details. Thanks to Willie 
  240. Musty of Rockwell Mission Support for providing ascent data, as well as to 
  241. Ken Ernandes, Paul Traufler, and Dave Simonson for their assistance.
  242. -Changed the Sun icon to filled -- for the second time. Hopefully, this 
  243. time will prove error-free! Thanks to Russ Nelson and Don Nicholson for 
  244. keeping after me on this enhancement.
  245. -Corrected the coordinates for Cape Canaveral (from several miles offshore 
  246. to onshore) in files STSPLUS.CTY and STSPLUS.LOC. Added coordinates for 
  247. Launch Pads 39A and 39B at Cape Canaveral to file STSPLUS.LOC and 
  248. internally; because of their close proximity to Cape Canaveral, the two 
  249. launch pads are unlabeled and appear at MAG=2000 or greater in orthographic 
  250. projection only. Launch pad coordinate data courtesy Dave Simonson, DOD C-
  251. Band Radar Network.
  252. -After numerous requests for special and/or different satellite icons, I 
  253. have rewritten the code to use three default icons in two different sizes. 
  254. The three icon shapes are: Space Shuttle (used whenever the satellite name 
  255. begins with "STS"); MIR Space Station (used with NORAD Number 16609 only); 
  256. and, Hubble Space Telescope (default selection). The icon size may be 
  257. selected using "Set Display Features", F10+F3+F1. The default icon size is 
  258. 15x15 pixels, approximately the same size as the satellite icons in prior 
  259. versions. The larger 21x21 pixel icon size is more easily seen when the 
  260. program is converted to NTSC or PAL television format. The command line 
  261. option "/21" may also be used when the program is executed to force the 
  262. icon size to 21x21 pixels. As usual, however, there is no free lunch; these 
  263. new icons take less code but slightly more time to draw and erase. 
  264.  
  265.      *** SPECIAL NOTE *** 
  266.  
  267.      Users who register or re-register STSPLUS Version 9517 and higher will 
  268.      receive a copy of STSICON, the custom icon drawing program used to 
  269.      create and modify STSPLUS icons. STSICON is ONLY available with 
  270.      registration, see file README.
  271.  
  272. -As a companion feature to the new satellite icon code, STSPLUS will now 
  273. search for a file "#nnnnn.ICN" (where "nnnnn" is the satellite NORAD 
  274. Number) to use as the icon data for that specific satellite in place of the 
  275. internal icons. These "#nnnnn.ICN" files are produced by program STSICON 
  276. and are limited to a maximum size of 21x21 pixels.
  277. -Corrected BASIC ERROR = 5 in Version 9515 when satellite icon moved 
  278. offscreen in full world rectangular projection (Auto-Redraw OFF).
  279. -Function Key F6 for Display Features (F10+F3+F6) now controls the local 
  280. and satellite circles of visibility. Successive keypresses cycle through 
  281. OFF, LCL, SAT, and BOTH. (The local circle(s) of visibility were assigned 
  282. to Function Key F1 in prior versions.)
  283. -By request, increased the maximum number of Tracking Stations permitted in 
  284. ".TRK" files from 25 to 50. For the convenience of users making their own 
  285. Tracking Station files, the format for ".TRK" files is now included in the 
  286. main documentation and below:
  287.  
  288.      "Maui, Hawaii",-156.7,20.9,396,"HAW"
  289.       ------+-----  ---+-- --+- -+-  -+-
  290.             |          |     |   |    |
  291.             |          |     |   |    +---  Three-letter Abbreviation
  292.             |          |     |   |
  293.             |          |     |   +--------  Elevation in meters
  294.             |          |     |
  295.             |          |     +------------  Latitude in degrees
  296.             |          |
  297.             |          +------------------  Longitude in degrees
  298.             |
  299.             +-----------------------------  Station Name  
  300.  
  301. Note: Station Names are limited to 20 characters and Station Abbreviations 
  302. are limited to 3 characters.
  303. -Users may now select as the user location any of the tracking stations in 
  304. the tracking station file (default file is STSPLUS.TRK) using F10+F2+F6 
  305. from the Main Menu. This feature has been requested by several users.
  306. -Changed the error message when reading a TLE file to correctly indicate 
  307. the cause of an error. When TLE data is formatted incorrectly (as with TLE 
  308. data from a UNIX system with each line terminated with LF instead of 
  309. CR+LF as required by DOS), STSPLUS incorrectly reported "File <filename> 
  310. not found!". The error message now reports "Data problems with file 
  311. <filename>, check data format!". To correct UNIX formatted TLE files, use 
  312. an ASCII editor such as the shareware program QEDIT; QEDIT will reformat 
  313. each line with the CR+LF termination. I also have posted program TOMS.ZIP 
  314. on my RPV Astronomy BBS which reformats UNIX text files for DOS. TLE data 
  315. downloaded from NASA Spacelink may exhibit this data format problem.
  316. -Repaired a bug which sometimes caused STSPLUS to fail with BASIC ERROR = 5 
  317. when using the "/R" command line option. Whether or not the error occurred 
  318. appears to have been data dependent and has now been resolved. (A call to 
  319. the DOS clock was not being made with the "/R" command line option and this 
  320. sometimes resulted in an illegal function call.) Thanks to Rudy Appel for 
  321. reporting the problem!
  322. -Repaired a bug which sometimes caused STSPLUS not to find the correct 
  323. satellite in the TLE file when the "/R" command line option was used. The 
  324. problem occurred only when the satellite was included in file STSPLUS.XRF 
  325. and the satellite name was modified. Note that the default satellite when 
  326. using F2 is now the satellite NORAD Number ("#16609" for MIR, for example) 
  327. rather than an abbreviated satellite name. This change will also reduce 
  328. problems and errors when multiple satellites have similar names like "MIR" 
  329. and "MIR DEB" (MIR debris).
  330. -Corrected a bug in the ZOOM feature. The PgUp and PgDn keys now operate 
  331. correctly for zoom functions in rectangular projections. My apologies for 
  332. not spotting this bug sooner ... I seldom use the rectangular projections 
  333. in conjunction with Doppler data. The bug appeared when Doppler data was 
  334. added in early 1994 (Version 9406) and only then after Doppler data was 
  335. first enabled using F8 while the map was displayed in orthographic modes.
  336. -Corrected a bug that caused Doppler data to appear on rectangular maps 
  337. if PgDn or PgUp keys were pressed when Doppler data was enabled.
  338. -I removed the detection for Pentium chips that was present in some Beta 
  339. Test Versions. Due to a flaw in the detection algorithm, some 486DX2 and 
  340. 486DX4 chips were incorrectly detected as a Pentium. STSPLUS now simply 
  341. indicates "486DX+" for 486 and higher chips.
  342. -Modified the TARGET logic to show relative velocity betwen the Primary and 
  343. Target satellites when the relative range is less than 10,000 km. Users 
  344. should note that these are "line of sight" calculations and may be 
  345. misleading if the satellites are at large relative range. (Prior versions 
  346. limited display to low velocities and close approaches.)
  347. -Changed date input subroutine (used with F8 from the Main Menu) to use the 
  348. current year as the default when a partial date is entered. For example, 
  349. the date may now be entered as "1/15" or "15.01" and the current year will 
  350. be used. Prior versions were hard coded to a specific year. Thanks to Russ 
  351. Nelson for the suggestion.
  352. -Changed launch date/time input code (F5 from Main Menu) to automatically 
  353. enable MET when data is accepted.
  354. -Corrected a problem with Pass Predictions (Altitude and Azimuth wrong!) 
  355. which crept into the Beta Test Versions. A position vector was not being 
  356. initialized. Thanks to George Sells for spotting and reporting the problem!
  357. -Corrected a data misalignment with AOS/LOS data in rectangular mode when 
  358. "/CLK" command line option used and TDRS satellites set OFF. Thanks to Don 
  359. Nicholson for reporting the problem (several times).
  360. -Updated current BBS information at the end of the documentation.
  361. -By popular request, added the Bibliography of Astronomy and Space 
  362. Subjects, extracted from the documentation for my program ASTROCLK.
  363.