ECLIPSE v1.1 

     The following program calculates and animates solar and lunar 
eclipses.  The first step in setting up the program involves initializing 
three variables.  These are LONG, LAT and CITY.  So, store your geographic 
longitude as decimal degrees in LONG variable, then store your geographic 
latitude as decimal degrees in LAT variable and the name of your city as 
a String in the CITY variable.  Once that is done, you can now start.  

1. Press GO.  

2. The prompt will ask you, if you want to look for solar or lunar 
    eclipses.  By pressing either the SOLAR menu key or the LUNAR menu key 
    will set the program to search for the one that you have chosen.  So 
    if we press SOLAR, this means we want to look for solar eclipses.  

3. The next prompt will ask for the date you wish the program to start at.  
    eg. May,1,1994 -> you would enter 5.011994.    

4. Now wait for a prompt string which will be something like this.  
   TUE 05/10/94 
   ECLIPSE CERTAIN
   This Eclipse Will Be
   ANNULAR, CENTRAL
   Continue calculating?

   By pressing any key, except the one labelled N, the program will continue 
   calculating.  By pressing the N key, the program will continue on 
   its search for the next occurrence of a eclipse.  

5. If you pressed any key except N in the last step, the program continues 
   calculating.  If the circumstances are favorable for a eclipse to occur, 
   the program will display the eclipse.  

6. So in this example, the animation display will be of the solar eclipse, 
   which occurred on May 10,1994.  

7. The program quits after you decide to display an eclipse.  To resume the
   search for eclipses goto step 1.  

Explanation of display: 
When the display screen shows up, numerous labels appear on the screen.  


FOR A SOLAR ECLIPSE:

top row righthand side:  FC=_ _:_ _ universal time -> first contact
top row center:  TT=_ _:_ _ universal time -> totality
                MAG=__% -> magnitude of eclipse
top row lefthand side :  LC=_ _:_ _ universal time -> last contact
right bottom corner : City name 
                      Long  Lat 

The unfilled stationary circle represents the sun while the moving dark 
circle is the moon which travels along the path indicated by the straight
line.

FOR A LUNAR ECLIPSE: 

EP= Enters Penumbra at _ _:_ _ universal time 
EU= Enters Umbra at _ _:_ _ universal time 
TB= totality begins at _ _:_ _ universal time 
TE= Totality Ends at _ _:_ _ universal time 
LU= Leaves Umbra at _ _:_ _ universal time 
LP= Leaves Penumbra at _ _:_ _ universal time 
TT= Totality at _ _:_ _ universal time
MAG= magnitude of eclipse as percentage

The Penumbra is represented in the display by the dotted fill pattern while 
the umbra is represented by the dark inner circle.
The moving circle is the moon which travels along the path indicated by 
the straight line.

NOTES:
Lunar eclipses are displayed as seen from the ground.
The times given are usually within five minutes or so of the exact times.
The previous version was more accurate but to save memory accuracy was 
sacrificed in this current version.
Program is not perfectly free of bugs.
This program is Freeware.

Thanks to: Conrad Winchester for CIRCLE
           Peter Duffet-Smith (Astronomy with your Personal Computer)
           Jean Meeus (Astronomical Formulae for Calculators and 
                       Astronomical Algorithms)

Author: Arnold Moy (amoy@unixg.ubc.ca)




















