home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / graphics / micropl.zip / ASTRO.DOC next >
Text File  |  1992-07-21  |  79KB  |  1,314 lines

  1.  
  2.                                        ASTRO Version 2.02
  3.  
  4.  
  5.                              Athabasca University Micro-Planetarium
  6.  
  7.  
  8.                                        User Documentation
  9.  
  10.  
  11.                                           Revision 1.11
  12.  
  13.  
  14.                                          Malcolm Reeves
  15.  
  16.  
  17.                                            8 July 1992
  18.  
  19.  
  20.  
  21. Documentation Conventions
  22. < > are used to indicate keystrokes. For example, <Alt_X> means hold down the <Alt> key and
  23. press <X>. Multiple keystrokes are separated by commas, for example <Alt_P>, <Shift P>.
  24.  
  25. [ ] are used to indicate menu selections. For example, [Plot] means the [Plot] selection from a
  26. menu. Multiple menu levels are indicated by adjacent selections, for example [Options] [General]
  27. means the [General] selection from the [Options] menu.
  28.  
  29. { } are used to indicate button icons. For example, {Planets} means the planets icon in the
  30. graphical user interface.
  31.  
  32. GIF(tm) and Graphical Interchange Format (tm) are trademarks CompuServe Inc, an H&R Block
  33. Company. 
  34.  
  35. MS-DOS(tm) is a trademark of the Microsoft Corporation. 
  36.  
  37. Acknowledgements
  38. ASTRO algorithms are drawn from "Astronomical Formulae for Calculators" by J.Meeus, 3rd Ed.,
  39. 1985, Willman-Bell Inc, 214pp and "Astronomy with your personal computer" by P.Duffett Smith, 1985,
  40. Cambridge University Press, 256pp.
  41. Some windows code is based on "User Interfaces in C++" by Mark Goodwin, 1989, MIS:Press, 394pp.
  42. Some graphics code is based on "Graphics programming in C" by Roger Stevens, 1988, M&T Books, 639pp
  43. The GIF(tm) code is based on recoded functions from GifLib Version 1.2 by Gershon Elber.
  44. The original version of ASTRO was written by Tony Willis.
  45. The author is grateful to Martin Connors and Garth Edwards for their reviews and encouragement.
  46.  
  47. ASTRO 2.02 (C) Malcolm Reeves, 1992. All Rights Reserved.
  48. ASTRO:                                 TABLE OF CONTENTS
  49.  
  50.  
  51. ASTRO: GETTING STARTED
  52.        1.0 Introduction                                                                       4
  53.        1.1 Hardware Requirements                                                              4
  54.        1.2 User Interfaces                                                                    4
  55.        1.3 Getting Started                                                                    4
  56.        1.4 Saving Your Work                                                                   9
  57.                1.4.1 Printer Screen Dumps                                                     9
  58.                1.4.2 Graphics Interchange Format Files (GIF)                                 10
  59. ASTRO: TEXT-MENU SYSTEM
  60.        2.0 Introduction                                                                      11
  61.        2.1 Info                             <Alt_I>                                          11
  62.                2.1.1 Help                                                                    11
  63.                2.1.2 Defaults                                                                12
  64.                2.1.3 About                                                                   13
  65.        2.2 Data                             <Alt_D>                                          13
  66.                2.2.1 Position                                                                13
  67.                2.2.2 Date and Time                                                           13
  68.                2.2.3 Star Catalog                                                            14
  69.        2.3 Options                          <Alt_O>                                          14
  70.                2.3.1 General                                                                 14
  71.                2.3.2 Animation                                                               15
  72.                2.3.3 Star Magnitude                                                          15
  73.                2.3.4 Star Color                                                              15
  74.                2.3.5 Solar System                                                            16
  75.                2.3.6 Output                                                                  17
  76.        2.4 Plot                             <Alt_P>                                          17
  77.                2.4.1 Plot Star Map                                                           17
  78.                2.4.2 Cancel                                                                  18
  79.        2.5 Exit                             <Alt_X>                                          18
  80.                2.5.1 Exit to DOS                                                             18
  81.                2.5.2 Cancel                                                                  18
  82. ASTRO: GRAPHICAL USER INTERFACE BUTTONS
  83.        3.0 Introduction                                                                      19
  84.        3.1 Toggles                                                                           19
  85.                3.1.1 Sun and Moon           <Alt_S>                                          19
  86.                3.1.2 Planets                <Alt_P>                                          19
  87.                3.1.3 Star Magnitude         <Alt_M>                                          19
  88.                3.1.4 Star Color             <Alt_C>                                          19
  89.                3.1.5 Animation              <Alt_A>                                          20
  90.                3.1.6 Grids                  <Alt_G>                                          20
  91.                3.1.7 Lines and Planes       <Alt_L>                                          20
  92.                3.1.8 Text                   <Alt_T>                                          20
  93.                3.1.9 Daylight Savings       <Alt_D>                                          20
  94.        3.2 Time-Stepping and Animation                                                       21
  95.                3.2.1 Solar Time Step        <Hh> or <Dd> or <Mm> or <Yy>                     21
  96.                3.2.2 Sidereal Time Step     <Ss> or <Ll>                                     21
  97.                3.2.3 Animation Toggle       <Alt_A>                                          21
  98.                3.2.4 Stop and Redraw        <Esc>                                            22
  99.        3.3 Pan and Zoom                                                                      22
  100.                3.3.1 Pan Up                 <Up_Arrow>                                       22
  101.                3.3.2 Pan Down               <Down_Arrow>                                     22
  102.                3.3.3 Pan Left               <Left_Arrow>                                     22
  103.                3.3.4 Pan Right              <Right_Arrow>                                    22
  104.                3.3.5 Zoom Up                <+>                                              22
  105.                3.3.6 Zoom Down              <->                                              22
  106.                3.3.7 Restore Pan-Zoom       <Alt_H> or <Home>                                22
  107.        3.4 Save Screen Output               <Alt_O>                                          22
  108.        3.5 Exit to Text-Menus               <Alt_Q> or <Alt_X>                               23
  109. ASTRO: APPLICATIONS AND EXERCISES
  110.        4.0 Introduction                                                                      24
  111.        4.1 Motions of the Sun and Moon                                                       24
  112.                4.1.1 Orbital Period of the Moon                                              24
  113.                4.1.2 Changes in Altitude of the Sun                                          26
  114.        4.2 Planetary Motions                                                                 26
  115.                4.2.1 Apparent Star Motions                                                   26
  116.                4.2.2 Retrograde Planetary Motion                                             27
  117.                4.2.3 Orbital Period of the Planets                                           27
  118.        4.3 Proper Motions of the Stars                                                       28
  119.        4.4 Distances to the Stars                                                            29
  120.        4.5 Distribution of Stars in the Galaxy                                               30
  121. ASTRO: DEVELOPMENT HISTORY
  122.        5.0 Introduction                                                                      32
  123.        5.1 Star Catalog File Format                                                          32
  124.        5.2 Version 1.0                                                                       32
  125.        5.3 Version 2.0                                                                       32
  126.        5.4 Future Developments                                                               33
  127.        5.5 Version 2.xx Revisions and Changes                                                33
  128.                                     ASTRO : GETTING STARTED
  129.  
  130.  
  131. 1.0 Introduction
  132. ASTRO is the Athabasca University Micro-Planetarium Program written to support the Science
  133. 280 course "Introduction to Astronomy and Astrophysics". 
  134.  
  135. 1.1 Hardware Requirements
  136. ASTRO will run on 8088, 8086 and 80x86 machines under MS- DOS Version 2.1 or higher. It
  137. requires approximately 150K of RAM to execute. The program will use (but does not require)
  138. an MS-compatible mouse and 8087/80x87 math-coprocessor. ASTRO autodetects the video
  139. hardware and supports CGA, EGA, VGA and ATT graphics in 2 and/or 16 color modes. Hercules
  140. graphics are not currently supported. Hercules users may be able to use CGA/EGA emulators for
  141. ASTRO but the ability to save and print screens may not be supported.
  142.  
  143. 1.2 User Interfaces
  144. ASTRO has both text-menu and graphical user interfaces. At startup, the text-menu interface
  145. appears with a title bar, pulldown menu bar and status line. The pulldown selections are [Info],
  146. [Data], [Options], [Plot], [Exit]. The menus are activated either by mouse, arrow-keys, or Alt-
  147. keys (for example <Alt_X> for [Exit]). The Alt-key for a particular item is highlighted. The
  148. status line at the bottom of the screen indicates the video display adapter that has been
  149. autodetected. The graphical user interface (GUI), is accessed by selecting [Plot Star Map] from
  150. the [Plot] pulldown menu. It comprises a set of icon-buttons that control the sky display panel.
  151.  
  152. 1.3 Getting Started
  153. To start the program, make the directory in which ASTRO is stored the current directory and
  154. enter "astro" at the DOS prompt:
  155.  
  156.        C:\ASTRO> astro
  157.  
  158.        A:\> astro
  159.  
  160. For EGA/VGA systems without 16-color capability, add the command-line switch "-bw" to force
  161. 2-color video display:
  162.  
  163.        C:\ASTRO> astro -bw
  164.  
  165. The command-line switches "-cga" and "-ega" may be used to override the autodetection of
  166. ASTRO. Note: in such cases ASTRO assumes the hardware is capable of the requested video
  167. mode.
  168.  
  169. At startup, the text-menu interface should appear with a title bar, pulldown menu bar, and status
  170. line. ASTRO provides default data so no data entry is required.
  171.  
  172. MOUSE:         Click on the [Plot] pulldown menu and select the first item [Plot_Star_Map].
  173.  
  174. KEYS:          Press <Alt_P>,<Return> or <Alt_P>,<P>.
  175.  
  176. The graphical user-interface (GUI) should now replace the text-menu display on the screen. The
  177. GUI is divided into two panels, on the left the button and information panel, and on the right,
  178. the sky display (See page 4). At the top of the button-panel, below the title line, are three legends
  179. used to indicate star magnitude (from -1 to +4), star color index (O to M), and 10 solar-system
  180. objects (Sun, Mercury, Venus, Moon, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto). The Sun
  181. and Moon are represented as squares and the planets as diamonds. For black and white displays,
  182. (CGA, ATT6300, or EGA/VGA 2-color modes) the color-index legend will NOT appear.
  183.  
  184. Below the legends, an information panel gives the observer location and observation time. If a
  185. mouse was detected, an additional information line appears for azimuth and altitude (the current
  186. pointer position on the sky panel).
  187.  
  188. MOUSE:         Move the mouse onto the sky panel and check that the cross in the centre of the
  189.                circle (the zenith point) labelled "Z", returns the altitude coordinate 90 and that
  190.                points on the circumference return 0. The azimuth values should increase from
  191.                0-360 anticlockwise from the top of the circle.
  192.  
  193. KEYS:          Press <Alt_G> to turn on the altitude-azimuth grid. The radial lines (azimuth) and
  194.                concentric circles (altitude) are 15 degrees apart and can be used to estimate
  195.                coordinates. Press <Alt_G> again to toggle the grid off.
  196.  
  197. The GUI button-panel has 25 function buttons. The functions are explained in detail later in this
  198. manual and in the on-line help files (accessed from the text-menu interface). For a new-user,
  199. there are two important buttons to remember:
  200.  
  201. MOUSE:         The exit button, {Big Q} icon and the animation toggle, {Big A} icon. Click on
  202.                {Big A} and the display on the right will step forwards or backwards in time (the
  203.                default step is one sidereal day.) During animation the mouse pointer is disabled
  204.                so to stop the animation you must hit <Esc> or <Alt_A>. 
  205.  
  206. KEYS:          <Alt_Q> or <Alt_X> will Exit the GUI to the text-menu  interface. <Alt_A> is
  207.                a toggle to start and stop animation. <Esc> will also halt time-step animation.
  208.  
  209. There is an important different between using <Alt_A> and <Esc> to halt an animation sequence.
  210. <Alt_A> preserves the display with the "trails" of the animated objects. Hit <Alt_A> again and
  211. the animation continues as if nothing had happened. <Esc> erases all trails and redraws the sky
  212. for the stop-time.
  213.  
  214. The sky panel, on the right hand side of the screen, is the main display area. In the default
  215. startup configuration, you see a big circle (the horizon), a cross at the centre (the zenith point)
  216. and a square (the Moon).
  217.  
  218. If you tried out animation, there may be some dots representing the track of the moon (and
  219. possibly the sun). If the time and date is not 21:00:00 10/02/1989, reset it using the time-step
  220. buttons in the lower left hand corner of the display. The highlighted ("turned on") arrowhead
  221. indicates the current direction of time (Up forwards, Down backwards). The {Double Letter} or
  222. {*} icons indicate the current solar ({HH} or {DD} or {MM} or {YY}) or sidereal ({*} or
  223. {Three_*}) time-step.
  224.  
  225. MOUSE:         Click on {Up_Arrow} to increment or {Down_Arrow} to decrement time by one
  226.                step. To cycle the solar step from hours to days to months to years and back to
  227.                hours click on {Double Letter}. Click on the {*} to change the sidereal interval
  228.                to the long {Three_*} step of 100,000 sidereal days (273 years). The icon changes
  229.                to 3 asterisks arranged in a triangle.
  230.  
  231. KEYS:          <H> <D> <M> <Y> increment, <h> <d> <m> <y> decrement the solar time-step.
  232.                <S> <L> increment <s><l> decrement the sidereal time-step. ( S-for-short, one
  233.                day; L-for-Long, 100,000 days).
  234.  
  235. Note: the display is redrawn for every mouse-click or keystroke. On a slow machine, it may be
  236. better to exit the GUI and reset the time and date in the pulldown [Data] menu.
  237.  
  238. Assuming, we are back in the GUI at 21:00:00 10/02/1989, we can add more to the display:
  239.  
  240. MOUSE:         Click on {Planet} icon (the blob with the thick line through it) and, for the default
  241.                configuration, two planets (Mars and Jupiter) appear below and slightly to the left
  242.                of the Moon. The display should resemble the picture on page 4. Mars is nearest
  243.                the Moon. Click {Planet} again and the planets disappear.
  244.  
  245. KEYS:          <Alt_P> P-for-Planets toggles the display of planets. Wait for the screen to redraw
  246.                between keystrokes, on slow machines this may take a few seconds. Try not to
  247.                accumulate too many keystrokes as ASTRO will save and process them all
  248.                e_v_e_n_t_u_a_l_l_y!
  249.  
  250. ASTRO toggles, in addition too the {Planets} toggle, include:
  251.  
  252.        Sun and Moon                                        <Alt_S>       S-for-Sun 
  253.        Star Magnitude                                      <Alt_M>       M-for-Magnitude
  254.        Star Color                                          <Alt_C>       C-for-Color index 
  255.        Altitude-Azimuth Grid                               <Alt_G>       G-for-Grid
  256.        Ecliptic and Celestial Equators and Galactic Plane  <Alt_L>       L-for-Lines
  257.  
  258. Deciphering the icons is left as an exercise (if intuition fails the Alt-keys still work, even if you
  259. have a mouse).
  260. If tried <Alt_M> or <Alt_C> you are now asking: WHY ARE THERE NO STARS? The
  261. software features a cloudy night mode perhaps.....? The real reason is, that the default action of
  262. ASTRO is not to read the star catalog stored in the support file "YALE.BIN". This file is not
  263. needed for solar system objects and must be read explicitly from the [Data] menu. To read the
  264. file, return to the text-menu interface <Alt_Q> or click on {Big Q} and select [Star_Catalog]
  265. from the [Data] pulldown menu, the keystrokes are <Alt_D>,<S> D-for-Data, S-for-Star.
  266.  
  267. Now return to the GUI, from the [Plot] pulldown menu select [Plot_Star_Map] with the mouse
  268. or <Alt_P>,<P>. Make sure that the date and time are the defaults 21:00:00 10/02/1989 and
  269. toggle the star magnitude display <Alt_M>. You should be able to see the Big Dipper to the left
  270. and slightly above the zenith point. Check out the pointer to Polaris directly above the zenith.
  271. The very large point a little above the southern horizon is Sirius. It has a special symbol with
  272. a cross through the "circle" to make it easy to find. Look slightly above (to the North) of Sirius
  273. and right (to the West) to find Orion. The three belt stars merge on the current display scale.
  274.  
  275. COLOR MONITOR:        Flip to star color display <Alt_C>. Sirius is green, Betelgeuse (top left in
  276.                       Orion) is red, Rigel (bottom right in Orion) is cyan.
  277.  
  278. BW MONITOR:           Take a break, or check out the [Star_Color] selection in the text-menu
  279.                       interface. This allows selective display of stars by spectral class.
  280.  
  281. The lower right region of the button-panel is used to pan and zoom the sky map. To resolve the
  282. belt stars in Orion, for example. Click on {Down_Arrow} or press the <Down_Arrow> key to
  283. pan down. The sky map appears to move up.
  284.  
  285. Now click on {+} or press the <+> key and the screen is redrawn at a larger scale. If you have
  286. a slow cpu, and you are displaying 526 stars, the redraw may take about a minute. In such cases,
  287. you may prefer to turn off the stars <Alt_M> and planets <Alt_P>, pan and zoom to where you
  288. want to be, then toggle the stars and planets on again. Try panning and zooming around the sky.
  289. ASTRO has a maximum zoom factor of x16 that increases or decreases by one for every mouse
  290. click or keystroke.
  291.  
  292. To restore the original display, at any time, click on the big "H" or press <Home> or <Alt_H>
  293. H-for-Home. If you exit the GUI for any reason, when you return ASTRO remembers the toggle
  294. and pan-zoom state and restores the display.
  295.  
  296. On final feature of note in ASTRO is the on-line help. Return to the text-menu interface {Big
  297. Q} or <Alt_Q> or <Alt_X>. Press <Alt_I> to activate the [Info] menu. Now select [About] or
  298. press <A> A-for-About, to see who is responsible for ASTRO and this documentation. Any key
  299. stroke or mouse-click will dismiss this blatant piece of self-aggrandizement. Next select [Help].
  300. Guess which key? From the options in the [Help] menu, select [Menus], a help window will pop-
  301. up on the left-hand side of the screen. Press any key or click on the arrow on the title bar to
  302. close the help window. Now select [GUI Buttons], this is a more extensive piece of text so the
  303. window has a scroll bar. Use the mouse on the arrowheads on the scroll bar or the arrow keys
  304. to scroll. Outside the [Info] [Help] menu, hitting <F1> will bring up an appropriate help message
  305. EXCEPT from the pulldown menu bar.
  306.  
  307. This has been a very brief basic introduction to ASTRO. For a comprehensive reference, see
  308. section 2 for text-menus and section 3 for the GUI buttons. For some guidance on the
  309. applications for ASTRO see section 4. Section 5 features a brief description of the development
  310. history of ASTRO.
  311.  
  312. 1.4 Saving Your Work
  313. Hardcopy from ASTRO can be obtained by selecting the printer icon from the GUI or press
  314. <Alt_O> O-for-Output. This causes the program to write the complete screen to a file in one of
  315. four in standard formats:
  316.  
  317.        1. PRN file - IBM/Epson compatible screen dump.
  318.        2. PCL file - HPCL (Hewlett-Packard Print Control Language) screen dump.
  319.        3. EPS file - Encapsulated Postscript screen dump.
  320.        4. GIF file - GIF87a screen image.
  321.  
  322. ASTRO does NOT support direct printing. An intermediate file MUST be generated. Users are
  323. recommended to use GIF files. 
  324.  
  325.        1.4.1 Printer Screen Dumps
  326.        PRN files are 37-45K depending on the screen mode. They can be copied to any Epson-
  327.        compatible printer. 
  328.  
  329.        PCL files are similar screen dumps for HPCL-compatible printers (such as the Laserjet).
  330.        File sizes are similar to those for the Epson printer.
  331.  
  332.        EPS files are VERY LARGE. About 600K+ for a vga color screen. Take care that disk-
  333.        space is available when attempting to save the screen in this form. EPS files can be
  334.        copied to any Postscript printer. 
  335.  
  336.        It is NOT necessary to use the MS-DOS utility "GRAPHICS.COM" to print files
  337.        generated by ASTRO. When using the MS-DOS copy command, the /b (binary) switch
  338.        on the command-line MUST be used for .PRN and .PCL binaries or the screen dump may
  339.        be incomplete.
  340.  
  341.        C:\ASTRO> copy astroXXX.prn lpt1: /b        Epson compatible
  342.  
  343.        C:\ASTRO> copy astroXXX.pcl lpt1: /b        Hewlett-Packard compatible
  344.  
  345.        C:\ASTRO> copy astroXXX.eps lpt1:           Postscript compatible
  346.  
  347.        If files are to be saved or transferred to other systems (eg Unix, VMS), then it is
  348.        recommended that Postscript files be compressed with ZOO, ZIP or ARC compressors.
  349.        This can reduce a 630K file (640x480 VGA screen) to about 13K. REMEMBER: PRN,
  350.        PCL, ZIP, ZOO and ARC files are binary formats (set the transfer type to binary). EPS
  351.        files are in ascii.
  352.  
  353.        1.4.2 Graphics Interchange Format Files
  354.        GIF files are the recommended form of output from ASTRO. They provide a valuable
  355.        compact pictorial record in machine-readable form and can be readily printed. A typical
  356.        GIF is only 5-8K for the full-screen.
  357.  
  358.        GIF file can be viewed or printed with a suitable utility. There are many excellent
  359.        freeware and shareware GIF utilities for viewing, manipulating and printing GIF files.
  360.        These include CSHOW, VPIC, VUIMG and GIFPRT. 
  361.  
  362.        C:\ASTRO> gif2scr astroXXX.gif
  363.  
  364.        Try your local BBS or the DOS directories on the AU computer system to obtain a copy
  365.        of the latest version of such a package. Remember to register the one you choose to use -
  366.        you can try them out FREE!
  367.                                   ASTRO : TEXT-MENU SYSTEM
  368.  
  369.  
  370. 2.0 Introduction
  371. The text-menu interface comprises a desktop with a title bar, pulldown menu bar and status line.
  372. The pulldown selections are [Info], [Data], [Options], [Plot], and [Exit]. The menus are activated
  373. either by mouse, arrow-keys, or Alt-keys (for example <Alt-X> for [Exit]. The Alt-key for a
  374. particular item is highlighted.
  375.  
  376. ┌───────────────────────────────────────────────────────────────┐
  377. │ Info  Data  Options  Plot  Exit                               │
  378. └───────────────────────────────────────────────────────────────┘
  379.  
  380. The status line at the bottom of the screen indicates the video display adapter that has been
  381. autodetected (even if a command-line switch was used to override).
  382.  
  383. 2.1 Info <Alt_I>
  384. The [Info] pulldown menu (keystroke <Alt_I>) has three selections [Help], [Defaults], [About]. 
  385. ┌───────────────────────────────────────────────────────────────┐
  386. │ Info  Data  Options  Plot  Exit                               │
  387. ├──────────┬────────────────────────────────────────────────────┘
  388. │ Help     │
  389. │ Defaults │
  390. │ About    │
  391. └──────────┘
  392.  
  393. The [Help] selection pops up a list of help categories, [Defaults] allow inspection of current
  394. parameter settings and [About] gives some information about the version and author of ASTRO.
  395.  
  396.        2.1.1 Help
  397.        The [Help] selection (keystroke <H>) pops up a window of help categories:
  398.  
  399.        ┌───────────────┐
  400.        │     Help      │ Keystroke
  401.        ├───────────────┤
  402.        │ Data Entry    │    <D>
  403.        │ General       │    <G>
  404.        │ GUI Buttons   │    <U>
  405.        │ Hardware      │    <H>
  406.        │ Menus         │    <M>
  407.        │ Status Panels │    <S>
  408.        └───────────────┘
  409.  
  410.        To select a category, enter the highlighted keystroke, click on the option with the mouse
  411.        or move to the option with the arrow keys and hit return. When a category is selected,
  412.        a help window will pop-up on the left-hand side of the screen. Press any key or click on
  413.        the arrow on the title bar to close the help window. The more extensive help windows
  414.        have a scroll bars. Use the mouse on the arrowheads on the scroll bar or the arrow keys
  415.        to scroll the text up and down. Outside the [Info] [Help] menu, hitting <F1> will bring
  416.        up an appropriate help message.
  417.  
  418.        2.1.2 Defaults
  419.        The [Defaults] selection (keystroke <D>) pops up information panels for current
  420.        parameter settings but does NOT allow editing. The settings may be edited from the
  421.        [Data] and [Options] menus.
  422.  
  423.        ┌────────────────────┐
  424.        │      Defaults      │ Keystroke
  425.        ├────────────────────┤
  426.        │ Space-Time Co-ords │    <T>
  427.        │ General            │    <G>
  428.        │ Animation          │    <A>
  429.        │ Star Magnitude     │    <M>
  430.        │ Star Color         │    <C>
  431.        │ Solar System       │    <S>
  432.        │ Output             │    <O>
  433.        └────────────────────┘
  434.  
  435.        To select a category, enter the highlighted keystroke, click on the option with the mouse
  436.        or move to the option with the arrow keys and hit return. When a category is selected,
  437.        an information panel will pop-up on the right of the screen. Only one panel is displayed
  438.        at a time and the [Defaults] menu bar remains on the screen. A mouse click or the <Esc>
  439.        key will dismiss the panel.
  440.  
  441.        The [Space-Time_Co-ords] information panel gives the observers position in time and
  442.        space. Latitude, longitude, azimuth, date and time parameters are shown. The defaults are
  443.        the Latitude and Longitude of Athabasca, Alberta looking south (azimuth 180°) in winter
  444.        on 10 February 1989 at 21:00 hrs (9:00pm).
  445.  
  446.        The [General] information panel comprises a series of toggles for items to be shown on
  447.        sky plots. The symbol [■] next to an option indicates that it is selected. By default the
  448.        options to show the Sun and Moon, the ecliptic and celestial equators, and the galactic
  449.        plane are enabled. The planets and stars options are disabled. See the [Options] menu for
  450.        further details.
  451.  
  452.        The [Animation] information panel shows the animation time-step and the number of
  453.        steps per animation period. The defaults settings are for 100 steps of one sidereal day.
  454.  
  455.        The [Star Magnitude] information panel shows the magnitude range(s) for which stars will
  456.        be displayed. The default is to make stars of every magnitude visible.
  457.  
  458.        The [Star Color] information panel shows the spectral classes (O-M) or (blue to red) of
  459.        stars to be displayed. All spectral classes are selected by default.
  460.        The [Solar System] information panel shows a list of solar system objects that can be
  461.        displayed. By default, all objects, Sun, Moon and planets will be visible.
  462.  
  463.        The [Output] information panel indicates the form in which the sky panel plot may be
  464.        saved. The default is [None] - nothing will be saved. The options consist of a set of file
  465.        formats for saving the graphics screen.
  466.  
  467.        2.1.3 About
  468.        The [About] selection (keystroke <A>) pops up a window with information about the
  469.        version and authorship of Astro. The about window is dismissed by the <Esc> key or a
  470.        mouse-click outside it's borders.
  471.  
  472. 2.2 Data <Alt_D>
  473. The [Data] pulldown menu (keystroke <Alt_D>) has three selections [Position], [Date and Time],
  474. [Star Catalog].
  475.  
  476. ┌───────────────────────────────────────────────────────────────┐
  477. │ Info  Data  Options  Plot  Exit                               │
  478. └─────┬───────────────┬─────────────────────────────────────────┘
  479.       │ Position      │
  480.       │ Date and Time │
  481.       │ Star Catalog  │
  482.       └───────────────┘
  483.  
  484. These menu selections provide for the entry of the observer position (latitude, longitude) and
  485. viewing direction (azimuth); date (dd/mm/yyyy) and time (hh:mm:ss) of observation; and reading
  486. the support file "YALE.BIN" containing the data for the 526 brightest stars.
  487.  
  488.        2.2.1 Position
  489.        The [Position] menu selection (keystroke <P>) pops up a dialog box with the current
  490.        defaults for latitude, longitude and azimuth in (degs, mins, secs). Enter new values by
  491.        overtyping. The cursor will automatically skip non-numeric characters thus to enter the
  492.        latitude for Edmonton (53°35'00") type only 0533500 or +5335. Notice that leading zeros
  493.        are required for all fields but that trailing zeros may be omitted.
  494.  
  495.        Latitude values must be in the range +90 to -90, positive values are North of the equator.
  496.        Longitude values must be in the range 0 to 360 increasing from North in the sense NWSE
  497.        (counter clockwise) so that Edmonton is 113°31'30". The same numerical longitude East
  498.        of Greenwich is 290°31'30" (close to Canton, China). The NWSE direction convention
  499.        is used so that North American longitudes are in the range 0-180. Azimuth values (the
  500.        direction of view) must also be in the range 0 to 360 increasing from North in the sense
  501.        NESW (clockwise) so that NE is 45° and NW is 315°.
  502.  
  503.        2.2.2 Date and Time
  504.        The [Date and Time] menu selection (keystroke <D>) pops up a dialog box with the
  505.        current defaults for date (dd/mm/yyyy) and time (hh:mm:ss). Enter new values by
  506.        overtyping. The cursor will automatically skip non-numeric characters thus to enter the
  507.        date 1 Jan 1992 type only 01011992. Notice that leading zeros are required for the day
  508.        and month fields. Times must be in the range 00:00:00 to 24:00:00.
  509.  
  510.        2.2.3 Star Catalog
  511.        The [Star Catalog] menu selection (keystroke <S>) causes the program to attempt to read
  512.        the file "YALE.BIN" from the current DOS directory. A message box appears to indicate
  513.        reading is being attempted. If the read fails a dialog box pops up and requires an
  514.        acknowledging keystroke <Any> or mouse click. If the read succeeds a dialog box pops
  515.        up indicating the number of star data records read in. Again an acknowledgement is
  516.        required before the program continues. ASTRO does not need to read this file. The
  517.        motions of the Sun, Moon and planets can be studied without these data.
  518.  
  519. 2.3 Options <Alt_O>
  520. The [Options] pulldown menu (keystroke <Alt_O>) has six selections [General], [Animation],
  521. [Star Magnitude], [Star Color], [Solar System] and [Output]. [Options] provides editing access.
  522.  
  523. ┌───────────────────────────────────────────────────────────────┐
  524. │ Info  Data  Options  Plot  Exit                               │
  525. └───────────┬────────────────┬──────────────────────────────────┘
  526.             │ General        │
  527.             │ Animation      │
  528.             │ Star Magnitude │
  529.             │ Star Color     │
  530.             │ Solar System   │
  531.             │ Output         │
  532.             └────────────────┘
  533.  
  534. The defaults for the GUI have been carefully selected and users with slow cpus are strongly
  535. advised to use these (at least in the first instance).
  536.  
  537.        2.3.1 General
  538.        The [General] selection (keystroke <G>) pops up a window of general options for the sky
  539.        panel.
  540.  
  541.        ┌─────────────────────┐
  542.        │       General       │ Keystroke
  543.        ├─────────────────────┤
  544.        │ ■ Sun and Moon      │    <S>
  545.        │   Planets           │    <P>
  546.        │   Star Magnitude    │    <M>
  547.        │   Star Color        │    <C>
  548.        │ ■ Ecliptic Equator  │    <E>
  549.        │ ■ Celestial Equator │    <L>
  550.        │ ■ Galactic Plane    │    <G>
  551.        └─────────────────────┘
  552.        The first 4 options can be reset from within the GUI. The final three options, to show
  553.        ecliptic and celestial equators and galactic plane, can only be enabled in this menu.
  554.        Options tagged by [■] are enabled. To toggle the status of an option, enter the highlighted
  555.        keystroke, click on the option with the mouse or move to the option with the arrow keys
  556.        and hit return. The [Sun and Moon], [Planets], [Star_Magnitude] and [Star_Color] options
  557.        are enabling toggles that are duplicated as buttons in the GUI. [Star_Magnitude] and
  558.        [Star_Color] are mutually exclusive. Equators and planes can be switched on and off as
  559.        a group but NOT individually, by a button in the GUI. This menu enables a subset of
  560.        planes to be selected for display. The option window is dismissed by the <Esc> key or
  561.        a mouse-click outside it's borders.
  562.  
  563.        2.3.2 Animation
  564.        The animation option allows the user to select the number of time-steps to advance for
  565.        an animation period. The default is 100. A higher number may be appropriate for a fast
  566.        cpu. The time-step can be set from the GUI but the number of steps cannot.
  567.  
  568.        2.3.3 Star Magnitude
  569.        The [Star Magnitude] selection (keystroke <M>) pops up a window of magnitude range
  570.        options:
  571.  
  572.        ┌─────────────────┐
  573.        │Magnitude Options│ Keystroke
  574.        ├─────────────────┤
  575.        │ All             │    <L>
  576.        │ ■       < -1.0  │    <<>
  577.        │ ■  -1.0 to 0.0  │    <0>
  578.        │ ■   0.0 to 1.0  │    <1>
  579.        │ ■   1.0 to 2.0  │    <2>
  580.        │ ■   2.0 to 3.0  │    <3>
  581.        │ ■   3.0 to 4.0  │    <4>
  582.        │ ■        > 4.0  │    <>>
  583.        │ None            │    <E>
  584.        └─────────────────┘
  585.  
  586.        Options tagged by [■] are enabled. To toggle the status of an option, enter the highlighted
  587.        keystroke, click on the option with the mouse or move to the option with the arrow keys
  588.        and hit return. All options are enabled by default. This menu enables a subset of stars to
  589.        be selected for display by magnitude. The option window is dismissed by the <Esc> key
  590.        or a mouse-click outside it's borders. The [All] and [None] selections toggle every
  591.        magnitude range on and off.
  592.  
  593.        Note: the use of <l> for "All" and <e> for "None" is for consistency with other menus
  594.        where <A> and <N> are used for other selections.
  595.  
  596.        2.3.4 Star Color
  597.        The [Star Color] selection (keystroke <C>) pops up a window of spectral class options:
  598.        ┌──────────────────┐
  599.        │   Color Options  │ Keystroke
  600.        ├──────────────────┤
  601.        │ All              │    <L>
  602.        │ ■ O blue         │    <O>
  603.        │ ■ A blue-green   │    <A>
  604.        │ ■ B green        │    <B>
  605.        │ ■ F white        │    <F>
  606.        │ ■ G white-yellow │    <G>
  607.        │ ■ K orange-red   │    <K>
  608.        │ ■ M red          │    <M>
  609.        │ None             │    <E>
  610.        └──────────────────┘
  611.  
  612.        Options tagged by [■] are enabled. To toggle the status of an option, enter the highlighted
  613.        keystroke, click on the option with the mouse or move to the option with the arrow keys
  614.        and hit return. All options are enabled by default. This menu enables a subset of stars to
  615.        be selected for display by color (really spectral class). The option window is dismissed
  616.        by the <Esc> key or a mouse-click outside it's borders. The [All] and [None] selections
  617.        toggle every spectral class on and off.
  618.  
  619.        2.3.5 Solar System
  620.        The [Solar System] selection (keystroke <S>) pops up a window of options for the
  621.        display of the Sun and Moon, and planets:
  622.  
  623.        ┌────────────┐
  624.        │ SS Options │ Keystroke
  625.        ├────────────┤
  626.        │ All        │    <L>
  627.        │ ■ Sun      │    <S>
  628.        │ ■ Moon     │    <O>
  629.        │ ■ Mercury  │    <R>
  630.        │ ■ Venus    │    <V>
  631.        │ ■ Mars     │    <M>
  632.        │ ■ Jupiter  │    <J>
  633.        │ ■ Saturn   │    <T>
  634.        │ ■ Uranus   │    <U>
  635.        │ ■ Neptune  │    <N>
  636.        │ ■ Pluto    │    <P>
  637.        │ None       │    <E>
  638.        └────────────┘
  639.  
  640.        Options tagged by [■] are enabled. To toggle the status of an option, enter the highlighted
  641.        keystroke, click on the option with the mouse or move to the option with the arrow keys
  642.        and hit return. The [Sun and Moon] selection in [General] enables the group Sun and
  643.        Moon, the [Planets] selection enables the remainder. This set of options allows a subset
  644.        of planets to be selected for display or the Sun or Moon to be isolated. The groups
  645.        selected here may be toggled on and off in the GUI. The option window is dismissed by
  646.        the <Esc> key or a mouse-click outside it's borders. The [All] and [None] selections
  647.        toggle every solar system object on and off.
  648.  
  649.  
  650.        2.3.6 Output
  651.        The [Output] selection (keystroke <O>) pops up a window of screen output options:
  652.  
  653.        ┌────────────┐
  654.        │   Output   │ Keystroke
  655.        ├────────────┤
  656.        │ ■ None     │    <N>
  657.        │   PRN File │    <P>
  658.        │   PCL File │    <C>
  659.        │   EPS File │    <E>
  660.        │   GIF File │    <G>
  661.        └────────────┘
  662.  
  663.        Options tagged by [■] are enabled. To toggle the status of an option, enter the highlighted
  664.        keystroke, click on the option with the mouse or move to the option with the arrow keys
  665.        and hit return. PRN, PCL and EPS files are the equivalent of a screen dumps to
  666.        IBM/Epson, Hewlett Packard and Postscript compatible graphics printers. The GIF file
  667.        is in GIF87a format. The option window is dismissed by the <Esc> key or a mouse-click
  668.        outside it's borders. Multiple files may be written if the appropriate options are enabled.
  669.        Note: in such cases ASTRO may have to scan the screen image more than once and the
  670.        operation may take a significant amount of time. A line is drawn on the right hand side
  671.        or at the bottom of the screen to indicate the progress of a screen dump. The line is
  672.        erased when the dump is complete.
  673.  
  674. 2.4 Plot <Alt_P>
  675. The [Plot] pulldown menu has only two options: [Plot Star Map] and [Cancel].
  676.  
  677. ┌───────────────────────────────────────────────────────────────┐
  678. │ Info  Data  Options  Plot  Exit                               │
  679. └────────────────────┬───────────────┬──────────────────────────┘
  680.                      │ Plot Star Map │
  681.                      │ Cancel        │
  682.                      └───────────────┘
  683.  
  684. The [Cancel] option enables the user to avoid the time-penalty of accidentally entering the GUI.
  685.  
  686.        2.4.1 Plot Star Map
  687.        The [Plot Star Map] selection (keystroke <P>) transfers from the text-menu interface to
  688.        the graphical interface of ASTRO. Before entering the GUI, the <F1> key will pop up
  689.        a useful help window.
  690.  
  691.  
  692.        2.4.2 Cancel
  693.        The [Cancel] selection (keystroke <C>) simply causes ASTRO to exit from the [Plot]
  694.        pulldown menu.
  695.  
  696. 2.5 Exit <Alt_X>
  697.  
  698. The [Exit] pulldown menu has only two options: [Exit] and [Cancel].
  699.  
  700. ┌───────────────────────────────────────────────────────────────┐
  701. │ Info  Data  Options  Plot  Exit                               │
  702. └──────────────────────────┬─────────────┬──────────────────────┘
  703.                            │ Exit to DOS │
  704.                            │ Cancel      │
  705.                            └─────────────┘
  706.  
  707. The [Cancel] option is a safety feature to avoid loss of work by inadvertent exit.
  708.  
  709.        2.5.1 Exit to DOS
  710.        The [Exit] selection (keystroke <X>) returns to DOS.
  711.  
  712.        2.5.2 Cancel
  713.        The [Cancel] selection (keystroke <C>) simply causes ASTRO to exit from the [Exit]
  714.        pulldown menu.
  715.                            ASTRO : GRAPHICAL USER INTERFACE BUTTONS
  716.  
  717.  
  718. 3.0 Introduction
  719. The graphical user interface (GUI), is accessed by selecting [Plot Star Map] from the [Plot]
  720. pulldown menu. It comprises a set of 25 icon-buttons that control the sky display panel. Many
  721. of the buttons can be preset in the text-menu interface affording flexibility. This feature is
  722. particularly valuable to users with a slow cpus since GUI redraw-overhead can be avoided by exit
  723. to the text-menu for option changes. 
  724.  
  725. 3.1 Toggles
  726. Toggles are switches that cycle the on/off condition. The GUI has a number of such switches.
  727. On color displays, when a switch is toggled the icon on the button changes from dark gray (on)
  728. to white (off). On black and white displays, the icon switches from black on white (on) to white
  729. on black (off). On some 2-color laptop displays this may be reversed. Check the defaults to find
  730. the sense of the display for such cases. The {Sun and Moon} toggle is on in the default startup
  731. data.
  732.  
  733.        3.1.1 Sun and Moon <Alt_S>
  734.        The {Sun and Moon} icon (keystroke <Alt_S>) is two overlapping circles in different
  735.        colors. The button toggles the display of the Sun and Moon on the sky panel. Objects
  736.        (Sun or Moon) that have been "turned off" in the [Solar System] options menu are not
  737.        displayed.
  738.  
  739.        3.1.2 Planets <Alt_P>
  740.        The {Planets} icon (keystroke <Alt_P>) is a circle with a diagonal line through the
  741.        centre. The button toggles the display of the planets on the sky panel. Only those planets
  742.        that have been "turned on" in the [Solar System] options menu are displayed. Note: the
  743.        contrast for red against the default star panel background (blue) is poor. The "trail" of the
  744.        planet Mercury may be difficult to discern for some users. In such cases, try adjusting the
  745.        contrast and brightness controls on your monitors. On 2-color displays, all trails are
  746.        white-on-black. Users are advised to isolate one or two objects in the
  747.        [Options][Solar_System] menu before plotting trails.
  748.  
  749.        3.1.3 Star Magnitude <Alt_M>
  750.        The {Star Magnitude} icon (keystroke <Alt_M>) is two stars of different sizes in the
  751.        same color. The button toggles the display of star magnitudes on the sky panel.
  752.        Magnitudes are in the range -1.0 to +4.0 are display as filled circles with a radius
  753.        proportional to brightness. That is, the brightest star, Sirius, is biggest. Only those ranges
  754.        enabled in the [Star Magnitude] options menu are displayed.
  755.  
  756.        3.1.4 Star Color <Alt_C>
  757.        The {Star Color} icon (keystroke <Alt_C>) is two stars of different sizes in different
  758.        colors. The button toggles the display of star colors on the sky panel. Stars are displayed
  759.        by both magnitude and color index (OBAFGKM). 
  760.  
  761.        The correspondence between spectral type and screen color in 16-color graphics modes
  762.        is:
  763.  
  764.                Spectral Class        Screen Color
  765.  
  766.                O very blue           Light Blue
  767.                B blue                Light Cyan
  768.                A green               Light Green
  769.                F white               White
  770.                G white-yellow        Yellow
  771.                K orange-red          Light Red
  772.                M red                 Red
  773.  
  774.        Only those spectral classes enabled in the [Star Color] options menu are displayed.
  775.  
  776.        3.1.5 Animation <Alt_A>
  777.        The animate {Big A} icon (keystroke <Alt_A> toggles continuous time-stepping with
  778.        current time-step. All display objects (Sun, Moon, planets, stars) are redrawn as single
  779.        pixels to mark track through the sky panel. If the step is an integral number of sidereal
  780.        days the stars remain static so ASTRO does not have to update their positions for short-
  781.        term simulations. There is little or no overhead involved in having the stars displayed as
  782.        a backdrop to solar system animations if a sidereal day is used as the time-step.
  783.  
  784.        3.1.6 Grids <Alt_G>
  785.        The {Grids} icon (keystroke <Alt_G>) is an open circle with two mutually perpendicular
  786.        diameters drawn. The button toggles the display of the altitude-azimuth grid (concentric
  787.        circles and radial lines drawn every 15 degrees) on the sky panel. Note: the time to
  788.        redraw the grid may be several seconds on slow cpus.
  789.  
  790.        3.1.7 Lines and Planes <Alt_L>
  791.        The {Lines} icon (keystroke <Alt_L>) is an open circle with an arc passing through the
  792.        horizontal diameter. The button toggles the display of the lines representing the ecliptic
  793.        and celestial equators and the galactic plane on the sky panel. Only those planes that have
  794.        been "turned on" in the [General] options menu are displayed.
  795.  
  796.        3.1.8 Text <Alt_T>
  797.        The {Big T} icon (keystroke <Alt_T>) toggles the display of text (azimuth directions and
  798.        object labels) in the GUI. The {Text} button will eliminate all text from the sky panel.
  799.        Note: selective text elimination is not possible in this version of ASTRO.
  800.  
  801.        3.1.9 Daylight Savings <Alt_D>
  802.        The {Daylight_Savings} icon (keystroke <Alt_D>) is a circle with multiple short rays
  803.        extending from the circumference. The button toggles between local standard time (LST)
  804.        and local daylight savings time (LDT) for data entered through the [Date and Time]
  805.        selection in the [Data] menu. The default is LST.
  806.  
  807. 3.2 Time-Stepping and Animation
  808. ASTRO offers a great deal of flexibility in single-stepping and multiple-stepping (animation)
  809. through time. The program remembers the sense (forwards or backwards) and size of the current
  810. time-step (solar hour, day, month, year or sidereal day or 100,000 days) and uses it for animation.
  811. The time-step on startup is one sidereal day. The time-step icons are located in the lower left
  812. hand corner of the GUI and comprise 6 buttons. The arrow head icon of the current time step is
  813. highlighted in the GUI. The icon between the two pairs of up and down arrows indicates the size
  814. of the solar and sidereal time-step: {HH} for hours (the solar time-step default), {DD} for days,
  815. {MM} for months, {YY} for years, {*} for sidereal days (the sidereal time-step default) and
  816. {Three_*} for 100,000 sidereal days.
  817.  
  818.        3.2.1 Solar Time Step <Hh> or <Dd> or <Mm> or <Yy>
  819.        The solar time-step can be changed from hours to days to months to years and back to
  820.        hours by clicking on the {Double Letter} icon between the up and down arrows.
  821.        Alternatively, <H> or <h> will set the solar time-step to hours, <D> or <d> to days, <M>
  822.        or <m> to months and <Y> or <y> to years. The step is forwards if the {Up_Arrow} is
  823.        highlighted ("turned on") or the step is set by an upper case letter. The step is backwards
  824.        if the {Down_Arrow} is highlighted or the step is set by a lower case letter. Clicking on
  825.        the arrows causes the display to be erased and redrawn at the new time.
  826.  
  827.        3.2.2 Sidereal Time Step <Ss> or <Ll>
  828.        The sidereal time-step can be changed from days to 100,000 days and back to days by
  829.        clicking on the {*} icon between the up and down arrows. Alternatively, <S> or <s> will
  830.        set the sidereal time-step to days (S-for-Short), <L> or <l> will set the sidereal time-step
  831.        to 100,000 days (about 273 years) (L-for-Long). The step is forwards if the {Up_Arrow}
  832.        is highlighted or the step is set by an upper case letter. The step is backwards if the
  833.        {Down_Arrow} is highlighted or the step is set by a lower case letter. Clicking on the
  834.        arrows causes the display to be erased and redrawn at the new time.
  835.  
  836.        3.2.3 Animation Toggle <Alt_A>
  837.        The animate {Big A} icon (keystroke <Alt_A> toggles continuous time-stepping with
  838.        current time-step. All display objects (Sun, Moon, planets, stars) are redrawn as single
  839.        pixels to mark track through the sky panel. Note: if the step is one sidereal day (or a
  840.        small multiple) the stars remain static so ASTRO does not have to update their positions
  841.        for short-term simulations. For the long sidereal time-step, ASTRO computes and
  842.        animates the proper motions of the stars. On machines without a math co-processor, the
  843.        animating large numbers of stars is a slow process. If the zoom option is used, the
  844.        number of floating-point operations per step is considerably reduced and the animation
  845.        will proceed a little more quickly.
  846.  
  847.        3.2.4 Stop and Redraw <Esc>
  848.        Halt animation and redraw sky panel for final positions of all display objects (Sun, Moon,
  849.        planets, stars). To save tracks, stop and start animation with the <Alt_A> toggle.
  850.  
  851. 3.3 Pan and Zoom
  852. The pan and zoom icons are located in the lower right hand corner of the control panel to the
  853. right of the time-step icons.
  854.  
  855.        3.3.1 Pan Up <Up_Arrow>
  856.        The pan up icon {Up_Arrow} (keystroke <Up_Arrow>) pans the display up one eighth
  857.        screen.
  858.  
  859.        3.3.2 Pan Down <Down_Arrow>
  860.        The pan down icon {Down_Arrow} (keystroke <Down_Arrow>) pans the display down
  861.        one eighth screen.
  862.  
  863.        3.3.3 Pan Left <Left_Arrow>
  864.        The pan left icon {Left_Arrow} (keystroke <Left_Arrow>) pans the display left one
  865.        eighth screen.
  866.  
  867.        3.3.4 Pan Right <Right_Arrow>
  868.        The pan right icon {Right_Arrow} (keystroke <Right_Arrow>) pans the display right one
  869.        eighth screen.
  870.  
  871.        3.3.5 Zoom Up <+>
  872.        The zoom up icon {Big +} (keystroke <+>) zooms the screen by adding one to the
  873.        current zoom factor. That is, the zoom factor will increase from x 1 to x 2 to x 3 to x 4
  874.        and so on with each mouse-click or keystroke. The maximum zoom factor is x 16.
  875.  
  876.        3.3.6 Zoom Down <->
  877.        The zoom down icon {Big -} (keystroke <->) zooms the screen down by subtracting one
  878.        from the current zoom factor. That is, the zoom factor will decrease from x 16 to x 15
  879.        to x 14 to x 13 and so on with each mouse-click or keystroke. The minimum zoom factor
  880.        is x 1.
  881.  
  882.        3.3.7 Restore Pan-Zoom <Home> or <Alt_H>
  883.        The zoom home icon {Big H} (keystroke <Home> or <Alt_H>) restores the zenith point
  884.        to the centre of the display and the screen zoom factor to its default value of x 1.
  885.  
  886. 3.4 Save Screen Output <Alt_O>
  887. The {Printer} icon (keystroke <Alt_O>) is a stylized picture of a printer. The button causes the
  888. current screen to be written to a file in Epson, Hewlett-Packard, Postscript or GIF format,
  889. depending on the settings in the [Output] menu. ASTRO names files astroxxx.prn, astroxxx.pcl,
  890. astroxxx.eps and astroxxx.gif as appropriate, where xxx represents three decimal digits starting
  891. at 000 and incrementing by one each time a file dump is requested. ASTRO will write up to
  892. 100,000,000 files of each extension before astro000.??? is overwritten!
  893.  
  894. Note: No check is made to see if disk space is available for a file. If the file output cannot be
  895. completed, the file is deleted but no warning message is given. In some circumstances, ASTRO
  896. will fail to detect the "disk full" condition and "lock-up". The checking necessary to avoid this
  897. eventuality slows the process of writing a large EPS file and it is not included in ASTRO.
  898.  
  899. The user is responsible for ensuring adequate disk space is available. In this regard, GIF files (5-
  900. 8K) require much less space than printer screen dump files (37-45K). Postscript files may be very
  901. large (600K+).
  902.  
  903.  
  904. 3.5 Exit to Text_Menus <Alt_X> or <Alt_Q>
  905. The {Big Q} icon (keystroke <Alt_Q> or <Alt_X>) exits to the text-menu interface.
  906.                                ASTRO : APPLICATIONS AND EXAMPLES
  907.  
  908.  
  909. 4.0 Introduction
  910. This section is step-by-step guide to the Astronomy Laboratory Exercises for Science 280 at
  911. Athabasca University.
  912.  
  913. 4.1 Motions of the Sun and Moon
  914. Since ancient times, people have been interested in the motions of the Sun and Moon. In this
  915. exercise we will determine the orbital period of the Moon relative to the background of fixed
  916. stars and examine the variations in the altitude of the Sun during the year. It is NOT necessary
  917. to read the file "YALE.BIN" for this exercise. Users may optionally employ the stars as a fixed
  918. background.
  919.  
  920.        4.1.1 Orbital Period of the Moon
  921.        The orbital period is the time required for an object to travel 360 degrees around the sky.
  922.        Over time, the Moon traces a great circle on the heavens when viewed against the
  923.        background of fixed stars. To fix the stars, we view the sky at the same sidereal time on
  924.        each successive day.
  925.  
  926.        Start up ASTRO with the default data. Since we are interested in the Moon alone, go to
  927.        the [Options] pulldown menu and select [Solar System]. Click the mouse on the [Sun]
  928.        selection or enter <S> to turn off the Sun display. On the [General] options menu make
  929.        sure that only [Sun and Moon] is tagged. Check the Space-Time Coordinates information
  930.        panel from the [Defaults] selection on the [Info] pulldown to ensure that we are viewing
  931.        the southern horizon (azimuth 180 degrees). Change the latitude and longitude in the
  932.        [Data][Position] menu to reflect your location. The default is Athabasca, Alberta.
  933.  
  934.        Now we are ready to enter the graphical display, so select [Plot_Star_Map] from the
  935.        [Plot] pulldown menu. The Moon should be visible on the sky panel at roughly 3 o'clock
  936.        (if you are at a similar lat,long to the default).
  937.  
  938.        MOUSE:         Position the mouse cursor as near as possible to the centre of the square
  939.                       representing the Moon and read off the altitude and azimuth from the
  940.                       button panel on the left of the screen.
  941.  
  942.        KEYS:          Enter <Alt_G> to display the altitude-azimuth grid. Both the radial lines
  943.                       (azimuth) and the circles (altitude) are drawn every 15 degrees. The outer
  944.                       circle is at altitude zero, so estimate the altitude by counting the number
  945.                       of complete and fractional 15 degree intervals to the Moon. The radial
  946.                       lines of azimuth increase counter-clockwise from zero in the North.
  947.                       Estimate the azimuth of the Moon by counting the number of complete
  948.                       and fractional 15 degree intervals. (Mouse users can also carry out this
  949.                       exercise to check their earlier result.)
  950.        To step through time, we must first select a suitable time interval (sidereal days to fix the
  951.        stars). The default time interval is one sidereal day (notice that the {Up_Arrow} above
  952.        {*} on the button panel is "on". Write down the time displayed on the button panel. Click
  953.        on the {Up_Arrow} button above the {*} icon (keystroke <S>) and the sky panel will
  954.        redraw one sidereal day forward in time. Check the time display again and confirm that
  955.        1 sidereal day is 23h 56m 04s. Now click on {Down_Arrow} or type <s> to go back to
  956.        the original time. Notice that the {Down_Arrow} is now "on". ASTRO steps in time by
  957.        the amount and in the direction of the "on" arrow so starting animation now will move
  958.        backwards in steps of sidereal days.
  959.  
  960.        To measure the orbital period of the Moon, we need to measure the time required for the
  961.        Moon to move 360 degrees across the sky. Click on the {Up_Arrow} or type <S> several
  962.        times and watch the Moon's position move towards the right of the screen (westward).
  963.        When the Moon is reasonably close to the edge of the display, step once more or until
  964.        the Moon disappears over the western horizon, then move one step in the opposite
  965.        direction to make the Moon reappear with the {Up Arrow} "on". Record the time from
  966.        the button panel and estimate the azimuth and altitude of the Moon as accurately as you
  967.        can.
  968.  
  969.        Now step forward in time by sidereal days (counting steps) until the Moon approaches
  970.        and disappears over the eastern horizon. Continue to step forward until the Moon
  971.        reappears from the west and record time and azimuth again. We have now measured the
  972.        time for the Moon to move through an arc of close to 360 degrees. The number of
  973.        "clicks" or <S>'s is the number of sidereal days (or use the information panel time
  974.        difference in solar days).
  975.  
  976.        Advance (or retreat) one step to "bracket" your original altitude azimuth coordinates and
  977.        estimate the fractional part of a day to reach the identical point in the sky.
  978.  
  979.        We can now repeat the exercise using ASTRO's animation option. First, step back to
  980.        where you started and click on the {Up_Arrow} or type <S> to set the stepping direction
  981.        to forwards. Click on {Big Q} (keystroke <Alt_Q> or <Alt_X>) to return to the text
  982.        menu.
  983.  
  984.        From the [Options] menu (keystroke <Alt_O>, select [Animation] (keystroke <A>). Set
  985.        the number of steps to the nearest whole day past your estimate (or 30). Now select [Plot
  986.        Star Map] again from the [Plot] pulldown menu to return to the GUI.
  987.  
  988.        Click on the {Big A} or type <Alt_A> to animate the display. If you have a fast
  989.        computer, the track on the Moon will rapidly trace out the successive positions of the
  990.        Moon tracing a great circle across the sky panel. Notice that two dots appear on the path
  991.        to the west and the east of the Moon square. Each dot is one-sidereal day along the
  992.        orbital path and it is easy to estimate the fractional part of a day to reach the starting
  993.        position from this display.
  994.        4.1.2 Changes in the Altitude of the Sun
  995.  
  996.        Since ancient times, it has been known that the altitude of the Sun at noon varies with the
  997.        seasons. In this exercise, we will investigate the changes in the altitude of the Sun at noon
  998.        over the course of a year.
  999.  
  1000.        Start in the text-menu and reset the observer space-time coordinates in the [Data] menu
  1001.        to the default (or any suitable value) using the [Position] and [Date and Time] selections.
  1002.        coordinates to the default (or any suitable value). Set the time to 12:00:00. Select [Solar
  1003.        System] in the [Options] menu and make sure the Sun is tagged and the Moon is
  1004.        untagged. In the [General] options menu, check that [Sun and Moon] is tagged and
  1005.        [Planets] is untagged. Set the number of animation steps to 365 or just a few more days.
  1006.        Now open the GUI by selecting [Plot Star Map] from the [Plot] pulldown menu.
  1007.  
  1008.        The screen should display only the zenith point and a square (yellow if you have color)
  1009.        for the Sun. If you used the default data, the Sun is near the southern horizon. If you do
  1010.        not have a mouse, turn on grid lines with {Grid} (keystroke <Alt_G>) to facilitate
  1011.        estimation of angles. Click on the {double letter} icon until it reads {DD} (keystroke
  1012.        <D>). Use the {Up_Arrow} and {Down_Arrow} buttons (or <D> and <d> keys) to set
  1013.        start-time and the time-step to advancing solar days. Click on {Big A} (keystroke
  1014.        <Alt_A>) to start animation and the path of the Sun at noon will be traced out as a
  1015.        figure-of-eight loop. Use {Big A} or <Alt_A> to stop and restart the animation when the
  1016.        loop is at its highest and lowest altitude.
  1017.  
  1018.        You may want to repeat the exercise with the number of steps set to 91 or 92 in the
  1019.        [Options][Animation] menu and the start date set to an equinox or solstice. ASTRO will
  1020.        then step (approximately) between equinoxes and solstices with the <Alt A> toggle.
  1021.  
  1022. 4.2 Planetary Motions
  1023. Early models of the solar system had difficulties in explaining the motions of planets, in
  1024. particular, retrograde motions. In this exercise we will investigate the motions of the inner and
  1025. outer planets and determine the orbital period of one of the planets. We will also add the stars
  1026. to the display.
  1027.  
  1028.        4.2.1 Apparent Star Motions
  1029.        Start in the text-menu and reset the observer space-time coordinates in the [Data] menu
  1030.        to the default (or any suitable value) using the [Position] and [Date and Time] selections.
  1031.        Select the [General] options menu, untag the [Sun and Moon] and [Planets] selections.
  1032.        In the [Data] menu, select [Star Catalog] and read the data file "YALE.BIN" into Astro.
  1033.        "YALE.BIN" contains information for 526 stars. Now open the GUI by selecting
  1034.        [Plot_Star_Map].
  1035.  
  1036.        Set a forward time-step of one solar hour. Click on {Star_Magnitude} (keystroke
  1037.        <Alt_M>) to display the stars. If you used the default settings, Sirius should visible as a
  1038.        large circle marked with a cross near the southern horizon. Orion should be NW of Sirius
  1039.        and the Big Dipper should be N and E of the zenith point. Click on {Big A} (keystroke
  1040.        <Alt_A>) to animate the stars. After a time, the rotation about Polaris should become
  1041.        apparent. The stars return to the same position in the sky once every sidereal day. Thus,
  1042.        when we observe the sky at intervals of whole sidereal days, the stars appear frozen in
  1043.        place.
  1044.  
  1045.        4.2.2 Retrograde Planetary Motion
  1046.        Start in the text-menu and reset the observer space-time coordinates in the [Data] menu
  1047.        to the default (or any suitable value) using the [Position] and [Date and Time] selections.
  1048.        Select [Solar System] in the [Options] menu and untag all the planets except one. Now
  1049.        select the [General] options menu, untag the [Sun and Moon] selection and tag [Planets].
  1050.        In the [Data] menu, select [Star Catalog] and read the data file "YALE.BIN" into Astro.
  1051.        "YALE.BIN" contains information for 526 stars. Now open the GUI by selecting
  1052.        [Plot_Star_Map].
  1053.  
  1054.        Set a forward time-step of one sidereal day (this should be the default). Click on {Star
  1055.        Magnitude} (keystroke <Alt_M>) to display the stars as a backdrop to the planetary
  1056.        motions. Click on {Big A} (keystroke <Alt_A>) to animate your chosen planet. Let the
  1057.        animation run for several years then examine the plot for evidence of retrograde motion.
  1058.        You can continue the animation for another 100 steps with {Big A} or <Alt A>.
  1059.  
  1060.        4.2.3 Orbital Period of the Planets
  1061.        Start in the text-menu and reset the observer space-time coordinates to the default (or any
  1062.        suitable value). Select [Solar System] in the [Options] menu and untag all the planets
  1063.        except one. Make sure you have read the star catalog "YALE.BIN" so that you can
  1064.        display the stars as a background to your observations. Select either Jupiter, Saturn,
  1065.        Uranus, Neptune or Pluto. Now select the [General] options menu, check that the [Sun
  1066.        and Moon] selection is untagged and that [Planets] is tagged. Now open the GUI by
  1067.        selecting [Plot_Star_Map].
  1068.  
  1069.        If the planet is not visible, advance by months until it appears on the display. Try to get
  1070.        the planet near azimuth 180° as a starting position. Set a forward time-step of one sidereal
  1071.        day by stepping back then forward. Record the time and date. Click on {Big A}
  1072.        (keystroke <Alt_A>) to animate your chosen planet. Let the animation run for one orbital
  1073.        period. It will stop every 100 steps (the default). Record the time at which the planet
  1074.        passes it's starting position. You may want to change the number of steps default to get
  1075.        a more accurate estimate or use <Alt_A> to stop the animation. 
  1076.  
  1077.        Note: the orbital periods of the outer planets are many years. It may be useful to set the
  1078.        number of steps to 366, 732, 1099, 1465, 3662 or some other near multiple of a solar
  1079.        year (366.2442 sidereal days). The best optimum time-step will depend on your choice
  1080.        of planet. Hint: if you have an 8088 cpu, pick Jupiter.
  1081.  
  1082. 4.3 Motions of the Stars
  1083. The stars are at such great distances from the Earth that they are apparently immobile over
  1084. periods of centuries. However, the stars themselves are actually moving through space. The
  1085. objective of this exercise is to study the proper motions of the stars. To do this, we must plot the
  1086. position off the stars over several thousand years.
  1087.  
  1088. Start in the text-menu and reset the observer space-time coordinates in the [Data] menu to the
  1089. default (or any suitable value) using the [Position] and [Date and Time] selections. Select the
  1090. [General] options menu, untag the [Sun and Moon] and [Planets] selections. In the [Data] menu,
  1091. select [Star Catalog] and read the data file "YALE.BIN" into ASTRO. "YALE.BIN" contains
  1092. information for 526 stars. Now open the GUI by selecting [Plot Star Map].
  1093.  
  1094. Choose an area of the sky covering about 45 degrees of altitude and azimuth space. Use the
  1095. arrow keys and the <+> key to pan and zoom this region to fill the screen. If you have a slow
  1096. computer, do not display any stars when you do this. You may want to turn on the {Grid} button
  1097. (keystroke <Alt_G>) as a guide. The grid is also valuable when you come to quantify star
  1098. motions.
  1099.  
  1100. IMPORTANT NOTE: you must turn the grid on BEFORE you start star animation. The display
  1101. will be redrawn if you attempt to add a grid later and all star tracks will be lost.
  1102.  
  1103. Now display the stars using the {Star Color} button (keystroke <Alt_C>. Click the {*} button
  1104. until the {three asterisk} icon appears (keystrokes <L> or <l>). The time-step is now 100,000
  1105. sidereal days or about 273 years. Step forward {Up_Arrow} or <L> to set the animation step and
  1106. direction for observing star motions. At some stage you will need to estimate the altitude-azimuth
  1107. coordinates for all the stars visible on the zoomed display (on average there will be about 10).
  1108. Use the mouse cursor or the grid lines to do this. Now click {Big A} or <Alt_A> to begin
  1109. animation. Trails will eventually appear tracing the proper motions of the stars. With the default
  1110. number of steps (100), the animated period will be 27,300 years, enough to estimate the
  1111. magnitude of many proper motions.
  1112.  
  1113. Stop the animation every 5000 years or so <Alt_A>, read the date display, and measure the
  1114. altitude and azimuth of the "end" points of the trails. Use the mouse or the grid lines to make
  1115. these estimates. You can estimate the angular separation of the initial and final positions of the
  1116. stars using:
  1117.  
  1118.        cos(ds) = sin(h0).sin(h1) + cos(h0).cos(h1).cos(A0 - A1)
  1119.  
  1120. where (h0, A0) and (h1, A1) are the altitude-azimuth coordinates of the initial and final star
  1121. positions and (ds) is the angular separation of the points.
  1122.  
  1123. If the star moves approximately parallel to the azimuth lines, ds ≈ A0 - A1; if the star moves
  1124. approximately parallel to the altitude lines, ds ≈ h0 - h1. The proper motion in seconds of arc
  1125. per year is (ds/dt) / 3600, where ds is in degrees and dt in years. Estimate the proper motions of
  1126. as many stars as possible in your chosen field of view. 
  1127.  
  1128. Now repeat the exercise with the whole sky visible. Is there any correlation between proper
  1129. motions and spectral class? Why might such a relationship be suspected? Is there any evidence
  1130. of groups or clusters of stars with similar motions? Experiment with ASTRO to investigate these
  1131. possibilities.
  1132.  
  1133. 4.4 Distances to the Stars
  1134. The distances to main sequence stars can be estimated from their color indices and apparent
  1135. magnitudes. The objective of this exercise is to estimate the distances to those stars visible from
  1136. your location on the Earth at the present time.
  1137.  
  1138. Start in the text-menu and reset the observer space-time coordinates in the [Data] menu to your
  1139. local position and time using the [Position] and [Date and Time] selections. Select the [General]
  1140. options menu, untag the [Sun and Moon] and [Planets] selections. In the [Data] menu, select [Star
  1141. Catalog] and read the data file "YALE.BIN" into ASTRO. "YALE.BIN" contains information for
  1142. 526 stars. Now open the GUI by selecting [Plot Star Map].
  1143.  
  1144. The {Star Color} button (keystroke <Alt_C>) will display the stars by color and magnitude. To
  1145. estimate distance (r parsecs) we need the apparent magnitude (m) and the absolute magnitude
  1146. (M), then:
  1147.  
  1148.        log(r) = 1 + (m - M )/ 5
  1149.  
  1150. The color index or spectral class of a star can be used to estimate absolute magnitude using
  1151. charts or less accurately using the following table (prepared for main sequence stars) :
  1152.  
  1153. ┌────────────────┬──────────────┬────────────────────┐
  1154. │ Spectral Class │  Color       │ Absolute Magnitude │
  1155. ├────────────────┼──────────────┼────────────────────┤
  1156. │       O        │ blue         │   < -3.5           │
  1157. │       B        │ blue-green   │     -3.5 to 0.6    │
  1158. │       A        │ green        │      0.6 to 3.2    │
  1159. │       F        │ white        │      3.2 to 4.3    │
  1160. │       G        │ white-yellow │      4.3 to 6.2    │
  1161. │       K        │ orange-red   │      6.2 to 9.5    │
  1162. │       M        │ red          │           > 9.5    │
  1163. └────────────────┴──────────────┴────────────────────┘
  1164.  
  1165. To isolate stars with a particular apparent magnitude and color index, we must return to the text-
  1166. menu {Big Q} or <Alt_X> or <Alt_Q>. From the [Options] menu first select [Star Magnitude]
  1167. and untag all but one magnitude class. Hit <Esc> to exit the menu and select [Star Color]. Again
  1168. leave only one option tagged. Now return to the GUI via the [Plot Star Map] selection. The only
  1169. stars plotted will be those meeting the color/apparent magnitude criteria you chose. You may not
  1170. see any stars if you chose extreme values for your classes (< -1 or > 4) and (O). If the stars are
  1171. main sequence stars they will be approximately the same distance from Earth. You can estimate
  1172. that distance using the formula. Notice that different combinations of apparent magnitude and
  1173. color index can give the same distance, for example ( F, 3.0 to 4.0) and (B, -1.0 to 0.0).
  1174.  
  1175. ASTRO will generate (7 x 7 = 49) groups for various combinations of apparent magnitude and
  1176. spectral class. Calculate a value of r for each of these groups. Select and plot sets of stars for a
  1177. range of distances.
  1178.  
  1179. 4.5 Distribution of Stars in the Galaxy
  1180. The Milky Way Galaxy (our galaxy) was found to have a non-spherical shape by Sir William
  1181. Herschel. The discovery was made by counting the number of visible stars in different directions
  1182. in the sky. The objective of this exercise is to repeat this important observation for ourselves. For
  1183. this we need a view of the sky in the direction of the galactic centre. Such views are best
  1184. obtained in the southern hemisphere (the galactic centre is just visible on the extreme southern
  1185. horizon from the 49th parallel).
  1186.  
  1187. Start in the text-menu and reset the observer space-time coordinates in the [Data] menu to the
  1188. position of Sydney, Australia (latitude -34°, longitude 209°). Choose a night in the Australian
  1189. winter (our summer) when the galactic centre is overhead. Select the [General] options menu,
  1190. untag the [Sun and Moon] and [Planets] selections. Untag both [Equator] selections leaving the 
  1191. [Galactic Plane] tagged. Make sure you have read the data file "YALE.BIN" using the [Star
  1192. Catalog] selection in the [Data] menu. Now open the GUI by selecting [Plot Star Map].
  1193.  
  1194. Turn on the altitude-azimuth grid display with the {Grid} button (keystroke <Alt_G>). Display
  1195. the stars with the {Star Magnitude} (keystroke <Alt_M>) or {Star Color} button (keystroke
  1196. <Alt_C>). Turn on the galactic plane display with the {Lines} button (keystroke <Alt_L>) and
  1197. use the time-arrow hour button or keys (<H> and <h>) to get the galactic plane to
  1198. (approximately) pass through the zenith point. The galactic pole marked NGP or SGP will be
  1199. close to the horizon and the galactic centre close to the zenith point. Now select the grid boxes
  1200. that lie on the galactic plane around the galactic centre and count the number of stars. The pan-
  1201. zoom buttons or keys may make this task much easier. For each 15 degree grid box, count and
  1202. record the number of stars and record the azimuth-altitude coordinates of a corner (as
  1203. identification). There are no grid lines around the zenith point so you will have to estimate the
  1204. extrapolated position of the radial lines for these.
  1205.  
  1206. Now use the time-arrow hour keys to move the south galactic pole (SGP) to near the zenith point
  1207. and count the star density again.
  1208.  
  1209. Now we need to repeat the exercise for the opposite direction. Exit to the text-menu interface and
  1210. choose a point opposite Sydney in the northern hemisphere (latitude +34, longitude +29). This
  1211. point is in the North Atlantic, south of the Azores. Here the galactic anti-centre is overhead in
  1212. winter. Repeat the counting exercises, this time move the north galactic pole to the zenith point.
  1213.  
  1214. Do you agree with the conclusions of Sir William Herschel? ASTRO and other similar programs
  1215. make it possible to observe the sky from many different locations on the surface of the Earth.
  1216. As with all computer models, you should attempt to verify your observations whenever possible
  1217. by direct observation. Plan your next vacations in Australia and the Azores!
  1218.                                   ASTRO: DEVELOPMENT HISTORY
  1219.  
  1220.  
  1221. 5.0 Introduction
  1222. ASTRO 2.0 comprises approximately 10,000 lines of C source code developed at Athabasca
  1223. University between mid-March and mid-June 1992 (approximately 750 man-hours of code
  1224. development and documentation). Much of the code (mouse, windows, buttons, icons, help, GIF,
  1225. and printer support) is readily re-useable for similar scientific and technical applications.
  1226.  
  1227. 5.1 Star Catalog File Format
  1228. The format of the file "YALE.BIN" is as follows. Each star record comprises six 4-byte IEEE
  1229. single precision floating point numbers representing right ascension (radians), declination
  1230. (radians), magnitude, color index, rate of change of right ascention (radians per epoch), and rate
  1231. of change of declination (radians per epoch).
  1232.  
  1233. 5.2 Version 1.0
  1234. ASTRO Version 1.0 was developed in 1988 by Tony Willis with the following features:
  1235.  
  1236.          - CGA 2-color graphics support only
  1237.          - Menu-driven configuration
  1238.          - No built-in hardcopy or screen save support
  1239.          - Fixed resolution Alt/Az display
  1240.          - Sun, Moon and planetary motions
  1241.          - Star motions including proper motions
  1242.          - 526 star catalog
  1243.  
  1244. 5.3 Version 2.0
  1245. ASTRO Version 2.0 represents a major upgrade undertaken by Malcolm Reeves in 1992. The
  1246. significant additional features incorporated in ASTRO now include:
  1247.  
  1248.         - VGA, EGA, CGA, ATT support in 2-color and 16-color modes
  1249.         - Extended user-configuration pulldown menu system
  1250.         - Context sensitive on-line help menus and windows
  1251.         - Default configuration at start-up
  1252.         - Built-in hardcopy support for IBM/Epson, Hewlett-Packard and
  1253.           Postscript printers
  1254.         - Screen save support in GIF format files
  1255.         - Icon-button-driven graphical user interface (GUI)
  1256.         - Microsoft-compatible mouse support for menus and GUI
  1257.         - Time-step animation with trails for solar system objects and
  1258.           stars (including proper motions)
  1259.         - Full pan-zoom capability for graphics screen
  1260.         - 30+ page User Manual
  1261.  
  1262. A number of technical programming improvements have also been made to the C language code
  1263. to make the program faster, smaller, more portable and easier to maintain and upgrade:
  1264.  
  1265.         - Reduced memory and disk space requirements
  1266.         - Faster arithmetic and graphics performance
  1267.         - Increased portability of source code between MS-DOS compilers
  1268.         - Elimination of all calls to third-party graphics and windows
  1269.           routines
  1270.  
  1271. 5.4 Future Development
  1272. Future upgrade possibilities (in order of ease of implementation):
  1273.  
  1274.         - Extend star database
  1275.         - User-saved configuration file for startup
  1276.         - Real-time (system) clock option
  1277.         - RA/Dec co-ordinate display option
  1278.         - Interactive measurement of angular distances
  1279.         - Pick/find star name capability
  1280.         - Keystroke support for cursor on graphics screen
  1281.         - Support constellations
  1282.         - Provide comet and deep sky objects databases
  1283.         - Eliminate text-menus (make application 100% graphical)
  1284.         - Integer arithmetic option (for speed without 80x87)
  1285.  
  1286. 5.5 Version 2.xx Revisions and Changes
  1287. 28 May 1992
  1288.        First release of version 2.00
  1289. 4 June 1992
  1290.        Version 2.01
  1291.        Added gif file dump support.
  1292.        Added all and none options to [Solar System Options], [Star Color Options], and [Star
  1293.        Magnitude Options].
  1294.        Revised 5 time-step buttons on GUI to 2 buttons for solar and sidereal time.
  1295.        Added [Animation Options] to allow user to set number of steps
  1296.        Fixed slow scrolling of help files with mouse.
  1297.        Fixed bug causing mouse to be re-initialized every step in animation mode.
  1298.        Added text-menu exit via cursor keys.
  1299.        Added [Options] pulldown menu, old [Plot] menu.
  1300.        Information panels are not displayed at start up (there are too many).
  1301.        Added [Defaults] selection in [Info] pulldown to allow selective display of information
  1302.        panels.
  1303.        Modified user manual (revision 1.09) and on-line help routines to reflect changes.
  1304. 15 June 1992
  1305.        Version 2.02
  1306.        Added support for IBM/Epson, Hewlett-Packard and Postscript printers.
  1307.        Added [Output] selection to [Options] menu.
  1308. 25 June 1992
  1309.        User manual (revision 1.10) and on-line help revised.
  1310. 8 July 1992
  1311.        Source code documentation (revision 1.0) completed. Minor revisions to user manual
  1312.        (revision 1.11)
  1313.  
  1314.