home *** CD-ROM | disk | FTP | other *** search
/ Hacker Chronicles 2 / HACKER2.BIN / 790.QUICK.DOC < prev    next >
Text File  |  1993-08-18  |  12KB  |  246 lines
  1.    Program STSORBIT PLUS Satellite Orbit Simulation                   Page 1
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                               Program STSORBIT PLUS
  8.  
  9.                   Space Shuttle and Satellite Orbit Simulation
  10.  
  11.                   (Enhanced Version for 286/386/486 Computers)
  12.  
  13.  
  14.                                   Version  9334
  15.                                  August 18, 1993
  16.  
  17.  
  18.  
  19.  
  20.                              by David H. Ransom, Jr.
  21.                           Rancho Palos Verdes, CA  USA
  22.  
  23.  
  24.                              Bulletin Board Systems
  25.                              ----------------------
  26.  
  27.                                 RPV ASTRONOMY BBS
  28.                       (310) 541-7299 @ 14400/9600/2400 Baud
  29.  
  30.                                  RPV HOTLINE BBS
  31.                          (310) 544-8977 @ 2400/1200 Baud
  32.  
  33.  
  34.  
  35.    IMPORTANT NOTE REGARDING VERSION 9334
  36.    -------------------------------------
  37.  
  38.         STSORBIT PLUS Version 9333 (and later) is a major upgrade to the 
  39.    program and adds multi-satellite tracking capability. See the documentation 
  40.    and file STSPLUS.NEW for a full description of the changes. As part of this 
  41.    upgrade, the format of file STSPLUS.INI has been completely reworked and 
  42.    any prior version of the file will be ignored. ALL PROGRAM OPTIONS MUST BE 
  43.    RESET! The distribution package includes a sample STSPLUS.INI file 
  44.    configured to suit my own preferences and which defaults all paths to the 
  45.    directory from which the program is started. If you are upgrading, use F7 
  46.    from the Main Menu to set all paths and filenames if your system is 
  47.    organized differently.
  48.  
  49.  
  50.    BRIEF PROGRAM INSTRUCTIONS
  51.    --------------------------
  52.  
  53.         This file is intended to help the experienced user get started with 
  54.    program STSORBIT PLUS (referred to as STSPLUS hereafter). It is NOT 
  55.    intended to be a substitute for the full program documentation!
  56.         STSPLUS is a program to track the NASA Space Shuttle and other 
  57.    satellites. The program requires NASA/NORAD 2-line elements for orbital 
  58.    data and may be used with any satellite for which 2-line data is available.
  59.    Program STSORBIT PLUS Satellite Orbit Simulation                   Page 2
  60.  
  61.  
  62.         The following steps should get the program "up and running" with as 
  63.    little fuss and bother as practical.
  64.  
  65.    1.   A hard disk is required. It is recommended that all files be placed in 
  66.         a subdirectory called STSPLUS. If you do not have a directory for the 
  67.         program, make one with the following commands:
  68.  
  69.              C:
  70.              CD \
  71.              MD STSPLUS
  72.  
  73.         These commands assume drive C:. If you are using another drive or a 
  74.         different directory name, make the appropriate changes.
  75.  
  76.    2.   If you have modified or customized support files such as STSPLUS.CTY, 
  77.         STSPLUS.LOC, and STSPLUS.LTD, make backup copies of these files NOW! 
  78.         The installation process may overwrite these files!
  79.  
  80.    3.   Log into the STSPLUS subdirectory using the following commands (which 
  81.         assume drive C:):
  82.  
  83.              C:
  84.              CD \STSPLUS
  85.  
  86.         If the program has been received as a set of self-extracting archive 
  87.         files with names like SOP9334A.EXE, SOP9334B.EXE and EARTH3.EXE, 
  88.         execute each of these programs in turn; this will extract the actual 
  89.         program and data files. If you are replacing an existing installation, 
  90.         you will be asked to approve each file that may be overwritten. (The 
  91.         self-extracting archive files may be deleted if they have been saved 
  92.         on a floppy disk.)
  93.  
  94.    4.   If you have used a previous version of STSPLUS, note that STSPLUS may
  95.         not read data from file STSPLUS.INI if it was written by a program 
  96.         version prior to 9332. The format of the file has changed and this 
  97.         will reset all features to their default conditions. If difficulties 
  98.         are encountered, DELETE FILE STSPLUS.INI AND RESET ALL OPTIONS 
  99.         MANUALLY!
  100.  
  101.    5.   Enter the following command to start the program:
  102.  
  103.              STSPLUS            (for all CGA/EGA/VGA color systems)
  104.  
  105.              STSPLUS /M         (for all EGA/VGA monochrome systems)
  106.  
  107.    6.   The STSPLUS.EXE file is stored on disk in compressed form. It is 
  108.         decompressed at load time; this may cause a brief delay depending upon 
  109.         the computer type used. Once the program is properly loaded, a screen 
  110.         will appear which requests that you set the UTC Offset for your time 
  111.         zone. Follow the on-screen instructions and enter the UTC Offset and 
  112.         the Daylight Flag.
  113.  
  114.    7.   Once the Main Menu is displayed, press F7 and set all paths and 
  115.         filenames. STSPLUS will default to the directory from which it was 
  116.         executed.
  117.    Program STSORBIT PLUS Satellite Orbit Simulation                   Page 3
  118.  
  119.  
  120.  
  121.    8.   The distribution package includes a set of US Space Command 2-line 
  122.         elements with a name like TLE232.TXT. This contains orbital data on 
  123.         over 170 different satellites. Press F2 to load orbital information. 
  124.         The screen will display a list of files having the extension .TXT. The 
  125.         TLEnnn.TXT file should be one of them. Enter the file name at the 
  126.         prompt and press ENTER.
  127.  
  128.    9.   The program will ask what satellite you wish to view with a default 
  129.         response of "HST" (meaning the Hubble Space Telescope). Press ENTER to 
  130.         accept the default or enter another satellite name (such as "MIR" or 
  131.         "UARS"). If the name of the data file begins with the letters "STS", 
  132.         the default satellite name will be "STS". You may also enter the 
  133.         satellite's NORAD Number, such as "#16609" for MIR.
  134.  
  135.    10.  The program will search the data file for the requested satellite and 
  136.         display its orbital data if found. If this is the satellite you wish, 
  137.         press ENTER when asked. Press SPACE to continue searching.
  138.  
  139.    11.  After the satellite has been selected, STSPLUS will display a map of 
  140.         the world and the ground track of the satellite. The satellite itself 
  141.         will be a white symbol along the ground track. EGA and VGA systems 
  142.         will display in color; CGA and HGC systems will display in monochrome. 
  143.  
  144.    12.  Press ENTER any time the map is displayed to return to the Main Menu.
  145.  
  146.    13.  STSPLUS has many features which are fully described in the program 
  147.         documentation. Please read that documentation!
  148.  
  149.    14.  The latest version of STSPLUS and current US Space Command 2-line 
  150.         elements are always available on my bulletin board systems (BBS) noted 
  151.         at the beginning of this document. Eash BBS uses a power controller; 
  152.         if it hasn't answered after the THIRD RING, hang up and call back in 
  153.         two minutes. The systems are often busy, so please be patient.
  154.  
  155.  
  156.    USING MISSION ELAPSED TIME WITH 2-LINE ELEMENTS
  157.    -----------------------------------------------
  158.  
  159.         The standard NASA/NORAD 2-line orbital element format does NOT include 
  160.    the launch time or launch date. However, this information is obviously 
  161.    required if Mission Elapsed Time (MET) is to be displayed. That information 
  162.    must therefore be obtained independently and manually entered into the 
  163.    program. The following steps are required:
  164.  
  165.    1.   Start program STSPLUS (see above).
  166.  
  167.    2.   Load the 2-line elements for the desired satellite using Function Key 
  168.         F2 on the Main Menu. Press ENTER to return from the ground track 
  169.         display to the Main Menu.
  170.  
  171.    3.   Press Function Key F5 to enter Launch Time and Launch Date. Enter the 
  172.         appropriate information. Note that if you enter UTC or GMT Launch Time 
  173.         (by adding the letter "U" or "G" at the end of the time, upper or 
  174.         lower case), STSPLUS assumes that the date you enter will also be the 
  175.    Program STSORBIT PLUS Satellite Orbit Simulation                   Page 4
  176.  
  177.  
  178.         UTC/GMT Launch Date.
  179.  
  180.    4.   The information will be displayed for approval. Press ENTER to accept 
  181.         the data, or press SPACE BAR to repeat the process.
  182.  
  183.    5.   Once the data have been accepted, press Function Key F5 while the map 
  184.         is on screen to display Mission Elapsed Time. Press F5 again to return 
  185.         to Time Elapsed Since Epoch. (Press Function Key F1 for help when the 
  186.         map is displayed with rectangular projection.) If a launch time and 
  187.         date have not been entered, the F5 command will have no effect and 
  188.         Time Since Epoch will always be displayed.
  189.  
  190.    6.   The launch time and launch date will be saved in file STSPLUS.LTD and 
  191.         need only be entered once unless it must be changed for some reason.
  192.  
  193.         NOTE: Estimated Pre-Launch 2-Line Elements for the Space Shuttle 
  194.         always use a "dummy" NORAD Number (such as "00051" for STS-51). Once 
  195.         US Space Command has assigned the actual NORAD Number, the launch time 
  196.         and date must be re-entered using the correct NORAD number.
  197.  
  198.         The simulated time, taking into account any fast time that may have 
  199.    been in effect up to that point, is shown on the screen. 
  200.    For reference, the local and UTC time (as determined by the computer's 
  201.    internal DOS clock) are displayed. The MET (Mission Elapsed Time) or 
  202.    T+Epoch shows the current elapsed time in the mission or the time since the 
  203.    epoch of the orbital elements.
  204.  
  205.         The combination of the Pass Prediction feature (F3 from the Main Menu) 
  206.    and the FAST and PAUSE modes will let you "look ahead" and then freeze the 
  207.    display at a time of interest -- such as when the satellite enters your 
  208.    circle of visibility. You can then use the "+" and "-" keys to move the 
  209.    satellite position back and forward in time (using Function Key F6 to 
  210.    select the time step interval, 1, 10 or 60 seconds) to determine the times 
  211.    and positions throughout a pass.
  212.  
  213.  
  214.    USERS WITHOUT A MATH COPROCESSOR CHIP
  215.    -------------------------------------
  216.  
  217.         Operation of STSPLUS on systems not equipped with a math coprocessor 
  218.    chip may not provide acceptable performance. STSPLUS makes very complex 
  219.    calculations to determine the position of the Earth, one or more 
  220.    Satellites, and the Sun. In addition, graphics operations required to 
  221.    display the maps and satellite tracks and positions also require many 
  222.    calculations. Slow computers or computers not equipped with a math 
  223.    coprocessor chip (8087, 80287, 80387, etc.) may not be able to perform all 
  224.    of the required calculations in an acceptable time
  225.         Note that the Sun terminator feature is NOT automatically disabled; 
  226.    however, slower computers without a math coprocessor chip may be unable to 
  227.    keep up with real time if this feature is enabled. From the Main Menu, use 
  228.    F10+F3+F8 to disable this feature if necessary.
  229.  
  230.  
  231.    PROGRAM REGISTRATION
  232.    --------------------
  233.    Program STSORBIT PLUS Satellite Orbit Simulation                   Page 5
  234.  
  235.  
  236.  
  237.         See the file README for information on registering STSPLUS. While I 
  238.    do not require registration of STSPLUS, I've put a great deal of time and 
  239.    effort into the program for more than two years. Registering your copy and 
  240.    including the very modest donation of $10.00 is a real software bargain, 
  241.    and will encourage me to continue maintaining and improving the program.
  242.  
  243.                                            David H. Ransom, Jr.
  244.                                            7130 Avenida Altisima
  245.                                            Rancho Palos Verdes, CA 90274 USA
  246.