home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / s1 / spotter / !Spotter / Docs / User_Notes < prev   
Text File  |  1993-12-07  |  22KB  |  396 lines
  1.  
  2. Notes for Users of the !Spotter Application, version 1.10
  3. =========================================================
  4.  
  5. Introduction
  6. ============
  7.  
  8.    To my knowledge, !Spotter is the first satellite orbit prediction utility
  9. implemented on the Archimedes, although many similar programs exist on other
  10. platforms. !Spotter reads in a set of NORAD two line elements (from the
  11. elements file provided), and allows the user to perform real time analysis
  12. on these elements. This means that the user can display the location of the
  13. satellite in any of three ways, and/or the position of the satellite as
  14. viewed from any number of locations on the Earth's surface, all in real time.
  15. In addition to this, it is possible to create a printout, (or WIMPY *) for any
  16. time period, detailing the visibility coverage for up to five stations within
  17. that period, and plots in the form of !Draw files showing the path of a
  18. satellite during a given interval.
  19.  
  20.    The !Spotter package comprises two Wimp applications. The first of these
  21. is the front end, which installs itself on the Icon bar when the application
  22. is first run. This program controls the contents of the configuration file
  23. (details later), and also launches any number of instances of the second type
  24. of application. These are the satellite tasks. Each satellite task controls all
  25. the functions (i.e. position displays and WIMPY (*) generation) for a
  26. particular satellite, and any number of satellite tasks may be running
  27. simultaneously. In addition, when a satellite task is running, the front end
  28. task is no longer required and so may be cancelled.
  29.  
  30.    The following sections describe the two types of task in more detail. These
  31. notes are by no means exhaustive, but I hope that they will eventually evolve
  32. into a complete user guide. In the meantime, please do not hesitate to contact
  33. me in the event of queries, bug reports, suggestions etc.
  34.  
  35. (*) Within ESOC, a spacecraft visibility printout is known as a WIMPY for
  36.     historical reasons. (The best explanation that I have heard is that it is
  37.     colloquial expansion of the initials W.M.P., from World Map Prediction).
  38.     The reason I have used this accronym in !Spotter is that WIMPY is a lot
  39.     easier to fit in a menu list than any alternative I could think of !!
  40.  
  41.  
  42. The !Spotter Frontend
  43. =====================
  44.  
  45.    Double-clicking on the !Spotter icon from within a filer window will start
  46. the application, and the icon will then appear on the icon bar. Clicking SELECT
  47. over the iconbar icon will display a welcome window, but the main functions are
  48. reached via the MENU button. The items in this menu are presented in order below:
  49.  
  50.          Info: Leads to window containing standard application info
  51.  
  52.          Load Satellite: This item leads to a menu structure from where any 
  53.              satellite currently known to !Spotter can be loaded. Clicking on
  54.              a satellite name from a list will start a satellite task for
  55.              that satellite. Clicking with the 'Alt' key pressed on any menu
  56.              other than the 'User List' submenu will toggle inclusion of that 
  57.              satellite in the user list menu. The 'Find Sat' option leads to
  58.              a writable menu. Entering a string in this field will initiate a
  59.              search for this string in the satellite list, and a menu of matches
  60.              (if any) will be displayed.
  61.  
  62.          Add Satellite: Not currently implemented. Presently, to add to the
  63.              list of available satellites, a set of NORAD format elements  
  64.              must be preprepared, and then dragged to the icon bar icon.
  65.  
  66.          Save Elements: This menu item leads to a "save_as" dialogue for storing
  67.              the currently loaded element sets, including the information on the
  68.              satellite user list contents. The default save file is the !Spotter
  69.              internal file, so to update the elements loaded by !Spotter on
  70.              start up, simply click on the OK icon.
  71.  
  72.          Load Planet: Not currently implemented. This is something I intend   
  73.              to add in the near future, as it has been requested.
  74.  
  75.          Change Setup: This option enables the user to edit the configuration
  76.              file. Clicking on this option displays the configuration control
  77.              panel, and the contents of the file can be edited from here. More
  78.              information on the configuration file can be found below.
  79.  
  80.          Quit: Quits the application. Any satellite tasks started by the task
  81.              now being cancelled will, however, remain active.
  82.  
  83.  
  84.      Files Read By !Frontend 
  85.      -----------------------
  86.  
  87.         The Elements File
  88.         -----------------
  89.  
  90.               The names of satellites along with the two line elements are read
  91.         from the file 'elements', which should reside in the !Spotter directory.
  92.  
  93.           Updating The Elements File
  94.           --------------------------
  95.  
  96.                  To use a different elements file, drag the new file to the
  97.           !Spotter icon on the icon bar. The FrontEnd task will then read in
  98.           the contents of the new file, and then open a window above the icon
  99.           bar. This window displays the total number of element sets in the new
  100.           file, how many of these sets are more recent elements for satellites
  101.           already in the database, and how many of them are for satellites not
  102.           presently defined. The user can update the elements currently loaded
  103.           by clicking on the OK icon, but the nature of the update is determined
  104.           by the status of the radio icons as follows:
  105.  
  106.              "Replace old data": If this option is selected, the data from the 
  107.                   new file will completely overwrite the data currently loaded.
  108.                   The currently defined "User List" will be lost.
  109.  
  110.              "Merge data": If this option is selected, the new data will be
  111.                   merged with the old data, with the manner of the merging
  112.                   being determined by the following radio icons:
  113.  
  114.                     "New": All satellites in the new file that do not appear in
  115.                          the currently loaded satellite database will be
  116.                          appended to the database.
  117.  
  118.                     "Updated": All satellites for which newer elements have
  119.                          been received will be updated in the loaded database.
  120.  
  121.                     "Selection": Satellites explicitly selected from the list
  122.                          of elements in the new file (list obtained by clicking
  123.                          menu) will be updated. Useful if you need to load old
  124.                          elements for some reason.
  125.  
  126.               In order that the updated elements are available to !Spotter the
  127.         next time the application is started, the elements should be saved. To
  128.         do this, simply Click OK in the "Save Elements" submenu.
  129.  
  130.           
  131.         The Configuration File
  132.         ----------------------
  133.  
  134.               This file is intended to hold any user configurable parameters.
  135.         Currently, this file contains only two types of information. The first
  136.         of these is the local time offset from Coordinated Universal Time
  137.         (UTC, or, more often GMT). All orbit work is done in UTC, and the 
  138.         offset is needed to relate this time to the time read from the computer
  139.         clock. If your computer is running in GMT, then the offset should be
  140.         set to 0 hours, 0 minutes, 0 seconds. If your computer uses British
  141.         Summer Time (1 hour ahead of GMT), set the offset to 1 hour, 0 minutes
  142.         and 0 seconds, and similarly for other locations. It is worth noting
  143.         that the sign of the time offset applies to all three fields, i.e.
  144.         - 02 hours 30 minutes means -2.5 hours, and not -1.5 hours. 
  145.  
  146.               The second type of information currently contained in the
  147.         configuration file is the list of observation stations set up by the
  148.         user. The list comprises names and coordinates of any number of
  149.         stations, where the coordinates are given as longitude, geodetic
  150.         latitude and altitude relative to the WGS 72 geoid. The stati