home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / sat / sat_08 / amsoft.iii next >
Text File  |  1997-02-01  |  8KB  |  163 lines
  1.       "QUIK-KEP" KEPLERIAN ELEMENTS TRANSLATION PROGRAM
  2.         JON PEARCE, WB2MNF
  3.            Version 2.2
  4.     
  5. The QUIK-KEP program translates the text versions of the keplerian
  6. elements as distributed by AMSAT into the format of the QUIKTRAK
  7. 3.1 program written by N4HY.  It avoids the need to manually
  8. update the elements table every time that the elements are
  9. updated.  These elements are kept in a file with the default
  10. filename of KEPC.DAT.  This program was previously called KEPLER
  11. but was changed to QUIK-KEP to be more compatible with the
  12. QUIKTRAK name.
  13.  
  14. Note that version 3.1 of QUIKTRAK takes a different format of
  15. Keplerian data than earlier versions.  Don't confuse the two -
  16. using the QUIK-KEP program on earlier data files will really mess
  17. them up.
  18.  
  19. This version of the program will retain the beacon frequency and
  20. other data in your current KEPC.DAT file (previous versions of
  21. QUIK-KEP did not).  Thus, you no longer have to reenter this data
  22. when you update the file.  You will be asked to specify the
  23. name of this file when you run QK.
  24.  
  25. Version 2.0 and later of the program will also allow you to use
  26. the NASA three-line format, which is available on the ASTROFORUM
  27. SIG in Compuserve, as well as other sources.   This format is
  28. more conducive to computer-reading, since it takes less space.
  29. It also generally includes many more satellites, so you'll have
  30. access to some of the visible satellites, as well as the weather
  31. satellites and larger objects like MIR.  Use whichever format is
  32. available to you and meets your needs.
  33.  
  34. A sample of each of the files is included in the ARC
  35. distribution file.  The ELEMENTS file in the AMSAT format; the
  36. NASAEL.310 file is in NASA format.
  37.  
  38. The program will ask you for the following file names:
  39.  
  40.      1. the input file name containing the new elements,
  41.      2. the file that you want to create (default KEPC.NEW)
  42.      3. your current keplerian file (default KEPC.DAT)
  43.      4. the QTH file (default is QTHC.DAT)
  44.     
  45. You can specify these file names on the command line, as:
  46.  
  47.     QUIK-KEP ELEMENTS.DAT KEPC.NEW KEPC.DAT
  48.  
  49. If you omit these on the command line you will be prompted for
  50. them.  The input file name has no default value - you must enter
  51. it.  The other two file names default to the names used above if
  52. not entered on the command line.  Thus, if you enter only the
  53. elements file name on the command line, the program will use the
  54. defaults for the other two file names and will not prompt you
  55. for them.  You can select the default names by simply pressing
  56. ENTER at the prompt.
  57.  
  58. You have two options for processing keplerian data - you can
  59. Update your current keplerian file with the data in the new
  60. elements set, or you can Reload the entire keplerian file with
  61. different satellites.  
  62.  
  63. Update is good if you have the satellites that you want in your
  64. current KEPC.DAT file and you just want to get the most recent
  65. data.  This will not allow you to select any new satellites - it
  66. will read the elements set and check each satellite contained
  67. therein to see if it's in your current list.  If so, it adds it
  68. to the new list; if not it ignores it.  This happens quite
  69. quickly - within about three seconds.  
  70.  
  71. The program will then ask if the data is in the NASA or AMSAT
  72. format.  Answer N or A as appropriate.  You can also Q for QUIT.
  73.  
  74. The program will then read the current keplerian file and list
  75. all of the satellites contained therein.  If you selected Reload
  76. you will then be prompted with the name of each satellite in the
  77. input file.  If you enter a Y or y that satellite will be
  78. written to the new file.  If you press any other key that
  79. satellite will be skipped.  As you select the satellites that
  80. are in the old keplerian file, they will be highlighted in that
  81. list.  The new list will written in the column on the right side
  82. of the screen.
  83.  
  84. That's about it.  Hope you enjoy this update - I have a couple
  85. of other things that I'm working on to improve it.
  86.  
  87. By the way - this was written in Turbo Pascal 4.0, which is a
  88. great improvement over 3.1.  If you're interested in a neat,
  89. inexpensive programing language, check it out.
  90.  
  91. ----------------------------------------------------------------
  92. Version 2.1 update:
  93.  
  94. At N4HY's request I have modified the QUIK-KEP program to handle
  95. a difference between the year of the epoch date in the Keplerian
  96. file and the year in the QTH.DAT file.  The QUIKTRAK program
  97. saves the epoch date as the number of days past the beginning of
  98. the year in the QTH.DAT file.  Thus, if the epoch date is JAN
  99. 11, the KEPC.DAT file stores it as "11".  
  100.  
  101. The problem occurs when the year in the QTH file is different
  102. than the year in the Keplerian file.  Then you have to adjust
  103. the date going into the KEPC file.  For example, if the epoch
  104. date in the Keplerian file is 1988 and the date in the QTH file
  105. is 1987, then you have to add 365 to the days going into the
  106. KEPC.DAT file; i.e., Jan 11 would be 371, not 11.  You CAN'T go
  107. the other way (with a 1987 element file and a 1988 date in the
  108. QTHC.DAT file), though - QUIKTRAK can't handle it.
  109.  
  110. Anyway, Bob asked me to handle this, and so the QUIK-KEP program
  111. will now read your QTH.DAT file (which must be in the same
  112. directory as the QUIK-KEP program) and see what the date is, and
  113. will automatically correct for it.  
  114. ------------------------------------------------------------------
  115. Version 2.2 update:
  116.  
  117. This version contains two major changes over 2.1:
  118.  
  119. 1.    It checks the satellite ID rather than the satellite name.
  120. This eliminates the problem of moving between the NASA and AMSAT
  121. element set types, and also the problem of inconsistency between
  122. versions of the AMSAT elements.  The output file (default
  123. KEPC.NEW) will be written with the satellite names in the
  124. original file (default KEPC.DAT) rather than the names in the
  125. keplerian update file so as to preserve consistancy.   This is
  126. important for the Kansas City Tracker/Tuner program which keys
  127. off of the satellite name.  Allowing the name to change with
  128. each update would mess things up.
  129.  
  130. 2.    This version also fills in the satellites that were in
  131. the KEPC.DAT file but not in the update file.  Thus, if you have
  132. OSCAR 10 and OSCAR 11 in your KEPC file, but only OSCAR 11 is in
  133. the update file, then the original elements for OSCAR 10 will be
  134. written into the new file.  Thus, you update any satellites that
  135. are in the update file but don't lose any that aren't in the
  136. update file.
  137.  
  138. Several other minor changes were made to the screen colors to
  139. make it easier to see what's going on.  The file name prompts
  140. were changed such that an error is noted immediately, rather
  141. than after you've entered all of the file names, and you're
  142. given a chance to correct it rather than having the program
  143. halt.  It also prompts for the file containing the QTH data
  144. (default QTHC.DAT) rather than assuming that you want to use
  145. that file name.  Note that you can press the ENTER key to select
  146. the defaults instead of having to enter them.
  147.  
  148. Several people have suggested that I rewrite the KEPC.DAT file
  149. (rather than KEPC.NEW) to avoid the user having to change it.  I
  150. hate to mess with a user's original file so I haven't done that.
  151. However, you can do that yourself with a simple batch file as follows:
  152.  
  153.     QK %1
  154.     COPY KEPC.NEW KEPC.DAT
  155.  
  156. which will copy the .NEW file over the .DAT file after it's done.
  157.  
  158. I don't have any other ideas for improving QK. If you think of
  159. anything, please send me a note on packet (@ WB2MNF), Compuserve
  160. (70206,421) or FO-12.
  161.  
  162. 73 de Jon, WB2MNF
  163.