NAME

       WMMOONCLOCK - Dockable Moon Phase Clock

SYNOPSIS

       wmMoonClock  [-display  <Display>]  [-bc <Color>] [-lc <Color>] [-dc <Color>] [-low] [-lat
       <Latitude>] [-lon <Longitude>] [-h]

DESCRIPTION

       wmMoonClock displays the current phase of  the  moon.  Clicking  on  the  icon  brings  up
       different displays -- there are 5 in all. The different "pages" are;

       First Page
              Shows the Moon phase image.

       Second Page
              Shows  the  current Local Time (LT) and Universal Time (UT), the Moon's Age (number
              of days since last new moon), the geometric (as opposed to  temporal)  fraction  of
              the way through the current lunar cyle (e.g. 50 for full moon), the fraction of the
              Moon's disc that is illuminated (ratio of area illuminated to total area  of  disc)
              and whether the Moon is (locally) visible of not (i.e. is it above the horizon?).

       Third Page
              Shows  the  Rise and Set times for yesterday (first line), today (middle line), and
              tommorrow (last line). If the Moon does not rise or set on  a  given  day  a  `null
              time'  is  shown  (--:--).  Note  that  these  times  should still be good for high
              latitude observers. Also note that there  will  always  be  at  least  one  (--:--)
              showing  up per month. This is because once per month the Moon will rise (set) on a
              given day but will set (rise) in the very early portion of the next day.

       Fourth Page
              Shows the Moon's horizon coordinates (i.e. the Altitude/Azimuth system). Azimuth is
              measured  in  degrees  CCW from due south, and altitude is measured in degrees from
              the horizon up to the Moon. Distance (Dist) is measured in units on Earth radii  (1
              Re  is  about  6370km). Note that this is a local coordinate system and will not be
              correct if the observer's latitude and longitude are not set correctly.

       Fifth Page
              Shows the  Moon's  ecliptic  coordinates.  (i.e.  the  Right  Ascention/Declination
              system).  Useful for astronomers?

       Many  of  the  quantities  shown will not be correct unless LT and UT are correct, and the
       user specifies the proper latitude and longitude.

OPTIONS

       -display <display>
              Use an alternate X Display.

       -bc    Set background color. (E.g. #7e9e69 or blue)

       -lc    Set color of text labels.

       -dc    Set color of data values.

       -low   Conserve  colors.  For  8-bit  displays,  a  lower-color  pixmap   will   be   used
              automatically,  but  you  can  also  force  its  use  on  higher-color  displays if
              necessary.

       -lat <Latitude>
              Observers Latitude  in  degrees.  Positive  in  northern  hemisphere,  negative  in
              southern hemisphere.

       -lon <Longitude>
              Observers   Longitude  in  degrees.  Greenwich  is  0.0,  and  longitude  increases
              positively toward the west. (Alternatively, negative numbers can also  be  used  to
              specify longitudes to the east of Greenwich).

       -h     Display list of command-line options.

BUGS

       Who knows? (Let me know if you find any).

AUTHOR

       Michael G. Henderson <mghenderson@lanl.gov>

                                         21 December 1998                          WMMOONCLOCK(1)