78 lines
2.9 KiB
Groff
78 lines
2.9 KiB
Groff
|
.TH WMMOONCLOCK 1 "21 December 1998"
|
||
|
|
.SH NAME
|
||
|
|
WMMOONCLOCK \- Dockable Moon Phase Clock
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B wmMoonClock
|
||
|
|
[-display <Display>] [-bc <Color>] [-lc <Color>] [-dc <Color>] [-low] [-lat <Latitude>] [-lon <Longitude>] [-h]
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.PP
|
||
|
|
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;
|
||
|
|
|
||
|
|
.TP
|
||
|
|
.B First Page
|
||
|
|
Shows the Moon phase image.
|
||
|
|
.TP
|
||
|
|
.B 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?).
|
||
|
|
.TP
|
||
|
|
.B 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.
|
||
|
|
.TP
|
||
|
|
.B 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.
|
||
|
|
.TP
|
||
|
|
.B Fifth Page
|
||
|
|
Shows the Moon's ecliptic coordinates. (i.e. the Right Ascention/Declination system).
|
||
|
|
Useful for astronomers?
|
||
|
|
.PP
|
||
|
|
Many of the quantities shown will not be correct unless LT and UT are correct, and the user
|
||
|
|
specifies the proper latitude and longitude.
|
||
|
|
.SH OPTIONS
|
||
|
|
.TP
|
||
|
|
.B \-display <display>
|
||
|
|
Use an alternate X Display.
|
||
|
|
.TP
|
||
|
|
.B \-bc
|
||
|
|
Set background color. (E.g. #7e9e69 or blue)
|
||
|
|
.TP
|
||
|
|
.B \-lc
|
||
|
|
Set color of text labels.
|
||
|
|
.TP
|
||
|
|
.B \-dc
|
||
|
|
Set color of data values.
|
||
|
|
.TP
|
||
|
|
.B \-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.
|
||
|
|
.TP
|
||
|
|
.B -lat <Latitude>
|
||
|
|
Observers Latitude in degrees. Positive in northern hemisphere, negative in southern hemisphere.
|
||
|
|
.TP
|
||
|
|
.B -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).
|
||
|
|
.TP
|
||
|
|
.B \-h
|
||
|
|
Display list of command-line options.
|
||
|
|
.SH BUGS
|
||
|
|
Who knows? (Let me know if you find any).
|
||
|
|
.SH AUTHOR
|
||
|
|
Michael G. Henderson <mghenderson@lanl.gov>
|