home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / sat / sat_11 / amsoft.iii next >
Text File  |  1997-02-01  |  10KB  |  226 lines
  1.  
  2.                 SEESATS.DOC
  3.  
  4.                  Vers 0.9
  5.  
  6.                  30-Sep-87
  7.  
  8.                   Rich Bono, NM1D
  9.                  7 Redfield Circle
  10.              Derry, New Hampshire 03038
  11.  
  12.     Seesats and its companion files is being distributed as SHAREWARE.
  13. This means that it is may be freely distributed to others as long as
  14. there are NO CHARGES incurred.  The author retains ALL COMMERCIAL
  15. rights to all included programs and concepts involved.  There is no
  16. charge for this package, but in the spirit of the SHAREWARE concept, if
  17. an end user finds this package useful, and would like to help fund
  18. development of enhancements to this package, any amount that the end
  19. user feels is appropriate for the value received in using this package
  20. will be gladly accepted (ie: $25).
  21.  
  22. Please send all correspondence to the author at the above address.  The
  23. author also would also like to hear from end users about their use of
  24. this program, including any ideas for enhancements.
  25.  
  26.     If anyone makes changes to anypart of this program, they may
  27. include their name, in the package as adding enhancements, but they
  28. MUST send all changes to the author who will incorporate the changes into
  29. the master archive copy.  The author retains ALL RIGHTS to this code in
  30. whole, or in parts.
  31.  
  32.     The current version can be generated for MS-DOS, OS/2 or UNIX
  33. systems.
  34.  
  35.     This document describes the operation of 'SEESATS.EXE' and its 
  36. companion file, 'SEESATS.DAT'.  Seesats grew out of a program
  37. originally written for the IBM-PC in BASICA called 'orbits2' by W0SL. 
  38. This original software was VERY machine dependent.  It was a very
  39. 'slick' program, as it used color and a lot of graphics.  I tend to
  40. think of software like this as a tool.  Not something to impress my
  41. friends, but something that is useful in different ways to different
  42. persons.  I converted the original 'slick' BASIC source code to the
  43. language 'C'.  In doing so, I also removed ALL traces of machine
  44. specifics that I could find.  This tended to change the flavor of the
  45. original program from a 'slick' flashy graphics program, to a 'boring'
  46. useful tool.  Now you will find that this program should run on ANY
  47. MS-DOS machine.  This means that it should run on ANY machine that has
  48. MS-DOS (version 2.0 or newer), not just the IBM family and its clones. 
  49. The only portibility problems that may come up is with the format of
  50. your disks.  But this can be solved by tranfering this software through
  51. modems or a serial port (with the proper software).
  52.  
  53.     The program (SEESATS.EXE) requires one companion file 
  54. (SEESATS.DAT) to operate.  This file contains the raw data that varies
  55. from time to time about the satelites you wish to track.  This data is
  56. usually refered to as KEPLERIAN ELEMENTS.  The more acurate and up to
  57. date this data is, the more acurate the outputs of seesats will be. 
  58. The file (seesats.dat) also contains some information about your earth
  59. location, ie: latitude, longitude, altitude, identifier, and UTC
  60. offset.  This information should also be reasonably accurate if you
  61. expect accurate predictions from seesats.
  62.  
  63.     Remember that distances in this program are in METERS and 
  64. that time is in UTC (AKA GMT, and ZULU time).  When you run this
  65. program in 'realtime' mode, be sure that your DOS DATE and TIME is set
  66. to UTC and that UTC offset is set to 0 or that your DOS DATE and TIME
  67. is set to LOCAL time with UTC offset set to the difference between UTC
  68. time and your local time zone.  Remember that UTC offset needs to be
  69. adjusted for local variations in seasonal Daylight Savings Time etc. 
  70. For prediction mode, you will enter the date and time desired.  Again,
  71. remember to enter UTC, not local time.
  72.  
  73.     The program has an optional command line argument which 
  74. specifies the number of times it should calculate the positions of the
  75. sateltites.  For instance, if you start the program by typing:
  76.  
  77.             SEESATS 2
  78.  
  79. The program will go through its calculations twice, and then exit to
  80. DOS.  This serves serveral purposes.  First, if you just want a quick
  81. update of new data, you would specify 1 (inplace of the 2 in the
  82. example).  This can serve a greater purpose in harmony with the MS-DOS
  83. redirection facilities.  For instance:
  84.  
  85.     SEESATS >PRN        Would send data to the printer in real 
  86.                 time until commanded to stop (with
  87.                 CTRL-C).
  88.  
  89.     SEESATS 1 >PRN        Would send 1 calculation for each 
  90.                 satelite in realtime to the printer.
  91.  
  92.     If the file PREDICT.SCR contained the following:
  93.  
  94.         <--- Note: First line is blank!!! To get to menu.
  95. 1        <--- Select prediction mode from menu.
  96. 01/05/87    <--- Enter start date as DD/MM/YY.
  97. 13:00        <--- Enter start time as HH:MM (note no seconds allowed).
  98. 1        <--- Enter increment time in minutes
  99. 5        <--- Select continuous mode from menu.
  100.         <--- Note: Last line is blank!! To exit from menu.
  101.  
  102.     Then the following would:
  103.  
  104.  
  105.     SEESATS <PREDICT.SCR        Run in prediction mode (note: 
  106.                      this will have to be stopped 
  107.                      with a CTRL-C!)
  108.  
  109.     SEESATS 1 <PREDICT.SCR        Run in prediction mode for 1 set
  110.                      of calculations.
  111.  
  112.     SEESATS 1 <PREDICT.SCR >PRN    As above, but send the results 
  113.                      the the printer.
  114.  
  115.     SEESATS 100 <PREDICT.SCR >FILE    Run in prediction mode for 100 
  116.                      calculations, sending the 
  117.                      output to 'FILE'.  FILE could 
  118.                      be any legal MS-DOS file name. 
  119.                      This could be later printed, or 
  120.                      sent to another user via disk 
  121.                      or modem.
  122.  
  123.     As you can see there are many things that could be accomplished 
  124. via the MS-DOS redirection facilities.  Anything that can be done via 
  125. the menus can be done by placing the same keystrokes in a file and then 
  126. redirecting that file to take the place of the console input.
  127.  
  128.     Of course this program could be started by another program that 
  129. waits for some event to occur.  For instance: a CBBS could have this
  130. program wait for a user to call the CBBS, upon the phone ringing,
  131. another program could start 'SEESATS 1 >SATFILE.DAT'.  This file
  132. 'satfile.dat' could then be made available to the user for downloading,
  133. enabling the user to have the latest predictions for the satelites in
  134. the SEESATS.DAT file!
  135.  
  136.     The normal, day to day usage of SEESATS.EXE is not as 
  137. complicated as all this sounds!  Just start seesats at your prompt by 
  138. typing:
  139.  
  140. SEESATS        (hit RETURN)
  141.  
  142.     If your DOS date and time is accuratly set and the UTC offset
  143. is correct, you will see the locations of the satelites in the file
  144. SEESATS.DAT at the very moment! To change some of the operational
  145. characteristics of the program, hit ENTER (RETURN on some machines) and
  146. a menu will be displayed on the screen that looks something like this:
  147.  
  148.         Current Selections:
  149.  
  150. Mode is...realtime       Print...all calculations    Select...all satelites
  151. Output is.paged
  152.  
  153.         Seesats menu -
  154.  
  155.     1  - Mode is prediction
  156.     2  - Print only when in view
  157.     3  - Select satelite of interest
  158.     4  - Print current element data for satelites
  159.     5  - Change output mode to continuous
  160.  
  161.     0 - Quit.
  162.  
  163. Enter number for desired function ([ENTER] to continue) : 
  164.  
  165.  
  166.     The line under current selections is showing that the 
  167. current calculations are being done in realtime (with the DOS date and 
  168. time), as opposed to prediction mode. All calculations will be printed, 
  169. as opposed to only when the satelite is in view from your location.  All 
  170. satelites contained in the SEESATS.DAT database will be calculated, as 
  171. opposed to just one satelite chosen from the list of satelites in the 
  172. database.
  173.  
  174.     The 1, 2, 3, & 5 entries in the menu will be the opposite of what 
  175. is being displayed in the current selection line.  These will allow you 
  176. to toggle the modes of operation.  The number 4 entry will allow you to 
  177. view the data in the ELEMENTS.DAT without stopping the program to print 
  178. out the file.  Number 0 will cause the program to stop and return you to 
  179. MS-DOS.  If you don't want to change anything, just hit return without 
  180. entering any selection, you will be returned to the same operating mode 
  181. that you were in.
  182.  
  183.     The prediction mode will first ask you for a starting date and 
  184. time.  Again, remember to enter UTC time!  It will also ask for an 
  185. increment amount.  This is the number of minutes to increment the clock 
  186. from the starting time for each batch of calculations.  This is useful 
  187. to see when a satelite will be visable in the future.  Remember that you 
  188. will get data for the current mode.  If the program is set to show only 
  189. when in view, you will receive prediction data for only when the 
  190. satelite is in view from your location.  Also, if the program is set to 
  191. show data from only one satelite, then you will receive predictions only 
  192. for the selected satelite.  These modes can be changed while the program 
  193. is running to select various conditions as the needs arise.
  194.  
  195.     Once the program is running, if you desire the data coming to 
  196. the screen to go to the printer, you could (if your machine supports 
  197. these features) hit the 'print screen' key to get a snapshot of the data 
  198. that is currently on the screen, or hit CTRL-P (toggle printer echo) to 
  199. have the data go to the printer at the same time as it goes to the 
  200. screen.
  201.  
  202.     If you have the program 'SEESATS.EXE' and it's companion file 
  203. 'SEESATS.DAT' in a directory that is pointed to by the MS-DOS PATH, then 
  204. the current directory will not have to contain a copy of these files.
  205.  
  206.     The file SEESATS.DAT must be in a specific order and sequence.  
  207. Note that the earth station location must be before the satelite data.  
  208. There may be comments in the file as long as they start with either a 
  209. semicolen ';' or a vertical bar '|' in the first column.  A line that 
  210. starts with a semicolen will be ignored.  A line that starts with a 
  211. vertical bar will be output.  This is used to send reminders to the user 
  212. of the program.
  213.  
  214.     This program may be copied and distributed without charge to 
  215. others as long as all the files are intact and unchanged.  The files
  216. currently are SEESATS.EXE, SEESATS.DAT, PREDICT.SCR, and this file
  217. SEESATS.DOC.
  218. xxxx seesats.doc
  219.  
  220.     Please keep me informed as to your progress
  221.  
  222.  /**************************************************************************\
  223.  * Rich Bono (NM1D)                                     rbono@necis.nec.com * 
  224.  * (508) 635-6303      NEC Information Systems    These are my own opinions * 
  225.  \**************************************************************************/
  226.