home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 2 / DATAFILE_PDCD2.iso / utilities2 / _spotter / !Spotter / Docs / User_Notes < prev   
Text File  |  1993-07-18  |  20KB  |  351 lines
  1.  
  2. Notes for Users of the !Spotter Application, version 1.06
  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.
  18.  
  19.    The !Spotter package comprises two Wimp applications. The first of these
  20. is the front end, which installs itself on the Icon bar when the application
  21. is first run. This program controls the contents of the configuration file
  22. (details later), and also launches any number of instances of the second type
  23. of application. These are the satellite tasks. Each satellite task controls all
  24. the functions (i.e. position displays and WIMPY (*) generation) for a
  25. particular satellite, and any number of satellite tasks may be running
  26. simultaneously. In addition, when a satellite task is running, the front end
  27. task is no longer required and so may be cancelled.
  28.  
  29.    The following sections describe the two types of task in more detail. These
  30. notes are by no means exhaustive, but I hope that they will eventually evolve
  31. into a complete user guide in the future. In the meantime, please do not
  32. hesitate to contact me in the event of queries, bug reports, suggestions etc.
  33.  
  34. (*) Within ESOC, a spacecraft visibility printout is known as a WIMPY for
  35.     historical reasons. (The best explanation that I have heard is that it is
  36.     colloquial expansion of the initials W.M.P., from World Map Prediction).
  37.     The reason I have used this accronym in !Spotter is that WIMPY is a lot
  38.     easier to fit in a menu list than any alternative I could think of !!
  39.  
  40.  
  41. The !Spotter Frontend
  42. =====================
  43.  
  44.    When the !Spotter application is first run (i.e. a double-click on the
  45. !Spotter icon from within a filer window has occurred), the !FrontEnd task is
  46. started, and the icon installs itself on the icon bar. Clicking SELECT over the
  47. iconbar icon will display a welcome window, but the main functions are reached
  48. 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. I may or may not include the
  73.              facility for predicting motions of other solar system bodies
  74.              in a future release of !Spotter.
  75.  
  76.          Change Setup: This option enables the user to edit the configuration
  77.              file. Clicking on this option displays the configuration control
  78.              panel, and the contents of the file can be edited from here. More
  79.              information on the configuration file can be found below.
  80.  
  81.          Quit: Quits the application. Any satellite tasks started by the task
  82.              now being cancelled will, however, remain active.
  83.  
  84.  
  85.      Files Read By !Frontend 
  86.      -----------------------
  87.  
  88.         The Elements File
  89.         -----------------
  90.  
  91.               The names of satellites along with the two line elements are read
  92.         from the file 'elements', which should reside in the !Spotter directory.
  93.  
  94.           Updating The Elements File
  95.           --------------------------
  96.  
  97.                  To use a different elements file, drag the new file to the
  98.           !Spotter icon on the icon bar. The FrontEnd task will then read in
  99.           the contents of the new file, and then open a window above the icon
  100.           bar. This window displays the total number of element sets in the new
  101.           file, how many of these sets are more recent elements for satellites
  102.           already in the database, and how many of them are for satellites not
  103.           presently defined. The user can update the elements currently loaded
  104.           by clicking on the OK icon, but the nature of the update is determined
  105.           by the status of the radio icons as follows:
  106.  
  107.              "Replace old data": If this option is selected, the data from the 
  108.                   new file will completely overwrite the data currently loaded.
  109.                   The currently defined "User List" will be lost.
  110.  
  111.              "Merge data": If this option is selected, the new data will be merged
  112.                   with the old data, with the manner of the merging being determined
  113.                   by the following radio icons:
  114.  
  115.                     "New": All satellites in the new file that do not appear in the 
  116.                            currently loaded satellite database will be appended to
  117.                            the database.
  118.  
  119.                     "Updated": All satellites for which newer elements have been 
  120.                            received will be updated in the loaded database.
  121.  
  122.                     "Selection": Satellites explicitly selected from the list of 
  123.                            elements in the new file (list obtained by clicking
  124.                            menu) will be updated. Useful if you need to load old
  125.                            elements for some reason.
  126.  
  127.               In order that the updated elements are available to !Spotter the next
  128.         time the application is started, the elements should be saved. To do this,  
  129.         simply Click OK in the "Save Elements" submenu.
  130.  
  131.           
  132.         The Configuration File
  133.         ----------------------
  134.  
  135.               This file is intended to hold any user configurable parameters.
  136.         Currently, this file contains only two types of information. The first
  137.         of these is the local time offset from Coordinated Universal Time
  138.         (UTC, or, more often GMT). All orbit work is done in UTC, and the 
  139.         offset is needed to relate this time to the time read from the computer
  140.         clock. If your computer is running in GMT, then the offset should be
  141.         set to 0 hours, 0 minutes, 0 seconds. If your computer uses British
  142.         Summer Time (1 hour ahead of GMT), set the offset to 1 hour, 0 minutes
  143.         and 0 seconds, and similarly for other locations. It is worth noting
  144.         that the sign of the time offset applies to all three fields, i.e.
  145.         - 02 hours 30 minutes means -2.5 hours, and not -1.5 hours. 
  146.  
  147.               The second type of information currently contained in the
  148.         configuration file is the list of observation stations set up by the
  149.         user. The list comprises names and coordinates of any number of
  150.         stations, where the coordinates are given as longitude, geodetic
  151.         latitu