home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / sat / sat_15 / amsoft.iii next >
Text File  |  1997-02-01  |  9KB  |  242 lines
  1. Documentation for SATELLIT.EXE
  2. -------------------------------
  3. DISTRIBUTION/COPYRIGHT
  4. -----------------------
  5. The present program is designed for evaluation purposes only. It provides
  6. full functionality until the date which is presented on the starting screen.
  7. After this date the calculation procedure does not work correctly!!!
  8. The software package with all necessary files is freely distributable. It is
  9. not allowed to change this short documentation.
  10.  
  11. ATTENTION:
  12.  
  13. This is the first version with integrated rotator control. It supports the
  14. IF-100 (AMSAT) interface. Please refer to the file ROTOR.INI first!
  15.  
  16. 1. Program Parameters
  17.  
  18. * up to 700 different satellites
  19. * using AMSAT and NASA format
  20. * optional calculation of AOS (Appearance Of Satellite) and maximum elevation
  21. * optional acustic signal triggered by AOS/LOS
  22. * prediction protocol to textfile
  23. * prediction also for two sites
  24. * select the second observer from up to 2000 locations
  25. * locator-coordinate-distance computation
  26. * worldmap with spotlight
  27. * azimuth-/elevation graphic with optional presentation of horizon
  28. * information system for particular satellites
  29. * bi-lingual (English and German)
  30. * all data files are text-type files
  31. * selecticve update of element sets when using NASA format
  32. * display of the sun terminator
  33.  
  34. * minimum configuration:
  35.             * PC-AT 286 and above
  36.             * abt. 200kByte disc capacity
  37.             * abt. 400kByte free memory when using graphics
  38.             * EGA/VGA-graphic
  39.  
  40. * optional:
  41.             * Arithmeticprocessor
  42.             * Mouse
  43.  
  44. 2. Program Description
  45.  
  46. The program allows to track up to 700 satellites. The tracking is done
  47. eigther in real-time or in the delta-t mode. 16 satellites are presented
  48. simultaneously in the real time table.
  49.  
  50. The program is controlled by means of the following keys:
  51.  
  52.  
  53. <Esc>
  54.             The Escape-key is the most important key in the program, for it
  55.             helps (almost) every time to abort the working function.
  56.  
  57. <ENTER>
  58.             <ENTER> confirms the selected menu items and starts the corres-
  59.             ponding actions.
  60.  
  61. <CNTRL><ENTER>
  62.             This key combination starts the azimuth-/elevation-diagram for
  63.             the selected satellite.
  64.  
  65. <CNTRL>S
  66.             ^s activates the satellite search function. Its quite useful if
  67.             a large number of satellites was loaded. It is not necessary to
  68.             use the full name.
  69.  
  70. Page up/down
  71.             Browses through the satellite list.
  72.  
  73. Cursor-Keys
  74.             Selects satellites or menu items, respectively.
  75.  
  76. The following keys help to control the graphic displays:
  77.  
  78. <TAB>       Toggles between the world map and the horizon display.
  79.  
  80. Page up/down
  81.             Browses through the satellites.
  82.  
  83. Cursor-Keys
  84.             Control the mouse pointer.
  85.  
  86.  
  87. It is possible to activate menu items with "hotkeys". Menu items which
  88. require a satellite as parameter, refer to the selected satellite.
  89.  
  90. Nevertheless we have tried to design the program interface as easy as
  91. possible so that you simply should test it out.
  92.  
  93. Files:
  94.  
  95. SATELLIT.EXE uses several data files. All these files can be changed by
  96. the user.
  97.  
  98. SATELLIT.EXE
  99.             The program itself.
  100. SATELLIT.INI
  101.             Setup file. It is self-explaining. If this file does not exist
  102.             it is automatically generated by the program.
  103.             One new feature was added - multi satellite tracking. If a
  104.             sequence of satellites is specified the program browses through
  105.             this sequence, if you are in world map mode.
  106. ELEMENTE.DAT
  107.             This file contains the Keplerian data sets of the particular
  108.             satellites. If it contains more than 255 satellites it ignores
  109.             the remaining ones.
  110.             It is possible to use the NASA-format as well as the
  111.             AMSAT-format. If you get your files from a BBS it is not
  112.             necessary to edit. The program ignores any stuff which does
  113.             not look like data.
  114.  
  115.             IMPORTANT:
  116.         We added a new feature. It is now possible to update element sets
  117.         automatically. To do this use the following procedure:
  118.  
  119.              - choose the 'Information' item for the particular satellite
  120.              - choose 'Update'
  121.              - type the name of the file which contains the new elment set
  122.                for the particular satellite
  123.              - hope that all is ok :-)
  124.  
  125.             NOTE:
  126.             To use the above described feature it is necessary to use 
  127.             NASA format for element sets for the specified satellite.
  128.             It does NOT work with AMSAT-format.
  129.             You can only update but not add new ones. For an update of all
  130.             satellites it is more convinient to replace the whole file but
  131.             for tracking STS or MIR the selective update obviously has some
  132.             advantages. 
  133.  
  134.  
  135. WELT.MAP
  136.             This file contains data for the world map. Its not quite detailed
  137.             yet but everybody can improve it. (128 objects are allowed)
  138. SATMODE.DAT
  139.             This file is used for mode control. Please see the example.
  140. UMGEBUNG.DAT
  141.             In this file everybody can put his horizon-shape. So you know
  142.             the reason why you do not hear the satellite although it has
  143.             a 50° elevation...
  144.  
  145. SATINFO.TXT/SATINFO.ENG
  146.             Here you can store all information about particular satellites.
  147.             The involved editor is Wordstar-compatible.
  148.         When using English output SATINFO.ENG is involved otherwise
  149.             SATINFO.TXT.
  150.  
  151. ROTOR.INI
  152.             Initial data for rotator control.
  153.  
  154.  
  155. Rotator control
  156.  
  157. Rotator control is activated by pressing <CNTRL><R>. There is a manual mode
  158. in the azimuth-elevation diagram. When activated move the mouse pointer and
  159. press <CR> to move the rotator.
  160.  
  161.  
  162. 3. Additional advices - Forecast
  163.  
  164. If the program seems to be slow then try a Coprocessor. It improves the
  165. performance quite a lot.
  166.  
  167. We did not implement a print-out function yet. If someone wants to print the
  168. results of a prediction he can do that be using the text file protocolling. 
  169. The text file can be printed out be the normal DOS print-command.
  170.  
  171. There are two several sounds to signal the appearance or the loose of a
  172. satellit. Morse code "K" -.- means a satellite just appeared and Morse code
  173. "SK" ...-.- that it disappeared.
  174.  
  175. On the graphics displays the doppler shift is computed. Thats the shift in
  176. frequency caused by the relativ velocity between ground station and satellite.
  177. Its useful to find your downlink signal quickly. But you have to take into
  178. account whether you are using an inverting or a non inverting transponder.
  179.  
  180.  noninverting: downlink frequency :=    downlink frequency (theoretical)
  181.                                        + uplink shift
  182.                                        + downlink shift
  183.  
  184.  inverting   : downlink frequency :=    downlink frequency (theoretical)
  185.                                        + uplink shift
  186.                                        - downlink shift
  187.  
  188. Inverting transponders compensate the Doppler shift a bit. OSCAR 13 uses
  189. an inverting transponder, RS-10 and RS-12 use non inverting transponders.
  190.  
  191.  
  192. What brings the future?
  193.  
  194. The AOS-computation will be done semi-analytically in the next versions.
  195.  
  196. We spent a lot (some hundreds) of hours designing this program. Nevertheless
  197. it certainly will contain some bugs. So if you fix any problems it would be
  198. very kind of you to give us a message.
  199.  
  200. If you like the program and want to get a full version then simply contact
  201. us for further information. The fastest way is e-mail...
  202.  
  203. Here are the ways to contact us:
  204.  
  205. 1.) DL3HRT                  AX25:         DL3HRT@DB0LPZ-15.#SAX.DEU.EU
  206.     Karsten Hansky         
  207.     August-Bebel-Str.14           
  208.     06712 Kretzschau
  209.     GERMANY
  210.  
  211. 2.) DL3HZM              AX25:         DL3HZM@DB0MER-15.#SAA.DEU.EU
  212.     Matthias Mitte          e-mail:       e3daq@mlucom.urz.uni-halle.de
  213.     Wiesenstraße 3
  214.     06712 Zeitz
  215.     GERMANY
  216.  
  217. Due to the high banking fees in Germany we had to increase the price for 
  218. foreign customers.
  219.  
  220. The price for a full version is US $20 now. If someone has ftp-Internet access
  221. the price is $15. The price in Germany is DM20,- + DM8,- for shipping or
  222. DM30,- with rotator control + DM8,- for shipping respectively.
  223.  
  224. This includes a registered version of the program, one free of charge update 
  225. including shipping.
  226.  
  227. The best way is to transfer the money to the following account:
  228.  
  229. DEUTSCHE BANK Filiale Zeitz
  230. BLZ: (code of the bank)    86070000
  231. Kto-Nr.: (code of account) 6715296
  232.  
  233.  
  234. Have a lot of fun!!!
  235.  
  236. DL3HRT & DL3HZM.
  237.  
  238.  
  239. PS: The latest version is always available via Internet by anonymous ftp to:
  240.     ftp.tu-clausthal.de
  241.  
  242.