home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 05B / SATEQ74.ZIP / SATEQ.DOC < prev    next >
Encoding:
Text File  |  1990-04-03  |  10.7 KB  |  189 lines
  1. ┌─────────┐
  2. │ PREFACE │
  3. └─────────┘
  4.  
  5. This writeup is by no means a complete manual, it is intended however to give
  6. all the information needed to run the program.  Some advice given sounds like
  7. motherhood, problems that have led to assistance calls in the past are the
  8. background for the advice given in this short document.  SATEQ is a new
  9. program, it is a migration from SATG, the keplerian elements and groundstation
  10. data are represented in IEEE-binary format.  The calculations are a somewhat
  11. more accurate with this new format.
  12.  
  13. NOTE:  The files SATKEP and SATBOD (SATGRD) used with previous versions, will
  14. not produce correct results with this program, because of the number format
  15. change, consequently the new files have been given different names, they are
  16. now named SATKEPN.DAT and SATBODN.DAT.  SATEQ is written in QUICKBASIC 4.5
  17. and compiled, it has been tested with IBM-PC, XT, AT, PS/2 Mod 30,50,60,70 and
  18. 80.  Any problems should be reported to the author, whereby the two numbers
  19. displayed on the screen above the text "STOP in LINE 10000" are most essential
  20. to pin down the cause of a problem.
  21.  
  22. Activation of CTRL-BREAK as an inherent feature to abort a QUICKBASIC program,
  23. should always terminate the program execution if pressed as an answer to a
  24. prompt. It may be necessary to hit CR after CTL-BREAK.
  25.  
  26.                                                               ++ OE1HSI ++
  27.  
  28. ┌──────────────────────────────────────────────────────────┐
  29. │ Instructions for SATEQ.EXE Version 7.4 of April 3rd 1990 │
  30. └──────────────────────────────────────────────────────────┘
  31.  
  32. Hardware requirements:  IBM-PC or PS2.Mod.30-80  minimum. 256k
  33.                         CGA,MCGA,EGA or VGA-adapter with COLOR-display
  34.               optional: printer if printouts of predictions are requested.
  35.                   NOTE: some options of the program can run on a system with
  36.                         a monochrome adapter, however the graphic display mode
  37.                         may not be selected.
  38. Software requirements : DOS 2.0 or higher, GRAFTABL (and if the PRTSCREEN
  39.                         function is to be used also GRAPHICS) have to be
  40.                         loaded prior to the invocation of this program.
  41. Other files required  : SATBODN.DAT .. binary file holding geogr. data of the
  42.                         groundstation (observer).
  43.                         SATMAP.DAT ... binary file with worldmap.
  44.                         SATKEPN.DAT .. binary file holding the keplerian
  45.                         elements of the satellites.
  46.  
  47. If SATKEPN.DAT AND SATBODN.DAT are not present, this files can be easily
  48. created.  All one has to do is to create a short files (just a few bytes) with
  49. an EDITOR or with DEBUG, that have this names.  The options to update the data
  50. of this files may then be used to build up the files with correct data.  The
  51. "PREDICTION" option can handle up to 20 satellites, however the
  52. "REALTIMETRACKING" option will not work correctly if called with more then 15
  53. entries.  The last entry in the SATKEPN file shoud be named "END" with all
  54. data set to zero, this will accelerate the calculation.  Satellite names
  55. should contain only capital letters and no spaces, starting with version 7.0
  56. all names entered with the utility options are converted to capital letters.
  57. If files with satellite names from other sources are to be used, the names
  58. should be edited to this rules with a fileeditor, otherwise it will not be
  59. possible to call this satellites or delete them from within the utility
  60. options of this program.
  61.  
  62. To invoke the program just enter "SATEQ", the files SATKEPN.DAT, SATBODN.DAT
  63. and SATMAP.DAT have to be in the default drive, otherwise the program will
  64. terminate with an error message.
  65.  
  66. ┌───────────────────────────┐
  67. │ Change groundstation data │
  68. └───────────────────────────┘
  69.  
  70. With this option the geographical data of the groundstation may be updated, in
  71. the graphic display option, the groundstation is represented by a small circle
  72. on the screen.  Antenna azimuth and eleveation are calculated for the ground
  73. position.  Name and callsign of the groundstation may be 10 characters long,
  74. 20 characters are available for the location.  Spaces and some special
  75. charcters may be used but no commas (BASIC convention).  Any changes made are
  76. saved in the file "SATBODN.DAT" (remove the writeprotect tab from the
  77. diskette).
  78.  
  79. ┌──────────────────────────────────┐
  80. │ Option UPDATE satellite elements │
  81. └──────────────────────────────────┘
  82.  
  83. With this option the keplerian elements may be updated.  It is most essential
  84. to work always with the most recent data available, otherwise the calculations
  85. will produce incorrect results.  Up to date data is available from AMSAT
  86. publications, it is available on many HAM bulletin boards and packet radio
  87. mailboxes.  The program has an internal check for the age of the reference
  88. element data, if old reference data is encountered in SATKEPN.DAT, the program
  89. will abort with an error message.  If for any reason valid data is not
  90. obtainable for a certain satellite, this entry should be removed from the file
  91. to avoid error conditions.  Note that the name of the satellite may not
  92. contain mor then 10 charcters and no commas.  Any changes made are saved in
  93. the file "SATKEPN.DAT" (remove the writeprotect tab from the diskette).
  94.  
  95. ┌────────────────────────────┐
  96. │ Option "REALTIME TRACKING" │
  97. └────────────────────────────┘
  98.  
  99. Immediately after the start of this option, a chance to change the time and
  100. date is offered, since the calculations are based on UTC.  Depending on the
  101. hardware and softwareversion used, any changes may also affect the system
  102. clock and even realtime clock.  You will have to determine the effects on your
  103. own system and eventually take corrective action to set your loacl time after
  104. the program has terminated.  Next the satellite positions will be displayed in
  105. a table, satellites above the horizon are displayed in red, satellites just
  106. rising or going below the horizon will be redblinking and activate a beep.
  107. The program execution can be terminated at any time by pressing ESC.  With F9
  108. the program will switch into and out of the graphics mode.  While running in
  109. graphics mode the keys F10, F9, F8 and F7 may be activated.  "PHASE"
  110. calculation and display has been added to this option, in order to enable the
  111. determination of the operating modes of the Radio Amateur Satellites.
  112.  
  113. "F10" will permit selection of a single satellite, if a CR (or the ENTER key)
  114. is pressed at the satellite name prompt, the program will display all
  115. satellites.  The selection of a satellite has to be made with the exact name
  116. including any special characters.
  117.  
  118. "F7" will control the speed of the display, this option has been built into
  119. the program to adopt to the different clock speed of various systems.  Ten
  120. speeds are available, the aktive speed is displayed in the top line of the
  121. display.  Every activation of F7 switches to a higher speed, the start
  122. defaultvalue is "3".  After the fastest gear (0) the program switches to
  123. lowest speed (9) upon the next activation of F7.
  124.  
  125. With "F8" pressed, the program will toggle a "sound" mode on and off, a beep
  126. will be generated with every display of a next satellite.  This option is
  127. most helpfull to adjust to a suitable speed for observation.
  128.  
  129. ┌──────────────────────┐
  130. │ Option "PREDICTION"  │
  131. └──────────────────────┘
  132.  
  133. With this option, a prediction of satellite orbits may be produced.  A listing
  134. can be displayed on the screen, routed to the printer or routed to a file.  If
  135. routing to a file is selected, the listing will be saved in a file named
  136. SATDATA.TXT in straightforward ASCII-text format.  The drive identifier on
  137. which this file is to be saved will be prompted.  If the file "SATDATA.TXT
  138. already exists on the specified drive, the new data will be appended to the
  139. existing file.  Output to the printer is always routed to LPT1:, error
  140. detection routines prevent operation with an inactive printer, an out of paper
  141. condition or no printer on LPT1, if the printer option was selected.  The
  142. starting time, duration and timestep for the listing have to be selected as
  143. well as a minimum antenna elevation.  However, if a minimum elevation angle of
  144. 10 or 15 degrees is choosen, this will not reduce calculation time, it will
  145. only shorten the output listing.  If no minimum elevation angle is selcted the
  146. programm defaults to 0 degrees.  Listings of the satellite positions below the
  147. horizon may be obtained by selection of a negative elevation, entering -360
  148. will produce a full listing of the orbits.  The "day of the year" is
  149. calculated from the year of the reference elements, numbers higher then 365
  150. (or 366) indicate previous years reference elements.  Calculation may be
  151. timeconsuming, depending on the power of the system and the selected timestep,
  152. quite substantial times may pass without any visible option while the
  153. satellite is below the horizon of the observing station.
  154.  
  155. "PHASE", also called MA in AMSAT bulletins is the 256th part of an orbit,
  156. every new orbit starts with a perigee, that is a phase of 0, apogee is at
  157. phase 128 of an orbit.  Operating modes are switched on some satellites in
  158. dependence of the phase.
  159.  
  160. ┌─────────┐
  161. │ GENERAL │
  162. └─────────┘
  163.  
  164. The program has evolved from calculations and code published in the AMSAT
  165. JOURNAL "ORBIT" published in 1981 and written by W3IWI, W0SL has adopted the
  166. program for the IBM-PC and added the graphics display features.  DB6ZH has
  167. contributed improved features to the element updating utility, the autor of
  168. this version (OE1HSI) has added numerous features, the user interface the
  169. groundstation utilities and has finally compiled the programs to one neat
  170. package.  The current version 7.4 (April 3rd 1990) is written in and
  171. compiled with QUICKBASIC 4.5 (TM MICROSOFT), with the objective to produce a
  172. PS/2 compatible version.  The sideral timetables stored in this version have
  173. been provided by friends at NASA and are good until the year 1999.  Quite some
  174. time could still be invested in further enhancements and more complete error
  175. handling, however this version is a good compromise between time spent and
  176. runtime comfort.  Other derivates of the basic programms are available from
  177. AMSAT in the US.  This package does not contain basic source code, negative
  178. experience with previous versions have influenced this limitation.  Anyone
  179. interested in the (little and german language commented) QUICKBASIC source may
  180. drop a line to the author at the address given below.
  181.  
  182.  
  183. ┌──────────────────────────────────────┐
  184. │ Author:                              │
  185. │ OE1HSI Ing. Herbert F. STRASSER      └───────────────────┐
  186. │        Slatingasse 6-B-5           A1130 VIENNA/AUSTRIA  │
  187. │   or via Packetradio @OE1XIB.WIEN.AUT.EU                 │
  188. └──────────────────────────────────────────────────────────┘
  189.