"
=== ASTRO Help =================
-- Conventions -----------------
Dates : DD.MMYYYY
Times : HH.MMSSsss
Angles: decimal degrees (DEG)
*     : cmd uses ASET

Applications:
Dates and times are local.
Coordinates are
 A      Azimuth decimal deg,
        > 0: N -> E -> S
        < 0: N -> W -> S
 a      altitude decimal deg,
        a > 0 above horizon

All calculations ignore:
precession, nutation, parallax,
aberration, refraction, ...

-- State Variable --------------
HOME ASET
 { date time lat long TZ DST }
date    explicit, or 0 for curr
time    explicit, or 0 for curr
lat     latitude [deg N], N > 0
long    longitude [deg W], W > 0
TZ      time zone [hrs], W > 0
DST     daylight saving time
        0 = no, 1 = plus one hr

-- Applications ----------------
== Parameters ==
DST
 interactive (re)set of daylight
 saving time, w/ HP clock update
SETA
 modify HOME ASET
 {...} -> *
 val n -> *[n], n = 1..6
 obj1 ... obj6 0 -> *
GETA
 read ASET in path
 0 -> {ASET}
 n -> ASET[n], n = 1..6

== Navigation ==
LLZ->
 select from a list of places
 across the earth
 -> lat long TZ
GCDH
 Great Circle Distance/Heading
 lat1 long1 lat2 long2 ->
 distance initial_heading delTZ

== Calendar ==
CAL
 * -> calendar display with
 menu. Use EXIT to exit!
HOLY
 * -> 2 msgboxes of variable
 and fixed holy days
DAYN
 * -> DOW $DY DOY ROY Wk
 DOW   Day Of Week
 DOY   Day Of Year
 ROY   Rest Of Year
 Wk    Week

== Moon ==
MPHA
 * -> Mph,
 msgbox of current and next
 four moon phases
MRS
 moon rise and set data
 * -> Ar As tr tc ts
 Ar    azimuth of rise
 As    azimuth of set
 tr    time of rise
 tc    time of culmination
 ts    time of set
MSKY
 current moon data
 * -> A a Age Ph
 A,a   azimuth, altitude
 Age  Phase  =>
   0      0  new moon
 ...         increasing
 180      1  full moon
 ...         decreasing
 360      0  new moon

== Sun ==
SRS
 sun rise and set data
 * -> Ar As tr tc ts
 (see MRS)
SSKY
 current sun position
 * -> A a
 A,a   azimuth, altitude

== Planets and Stars ==
PALL
 (noargs) -> $all planets data
        0 -> $all planets data
        n -> $planet n data
 n = 1,2,4..9 for Mercury..Pluto
     3    Earth, no data
 data: Ar As tr tc ts A a
  Ar..ts = rise/set (see MRS)
  A,a    = curr azimuth, altit.
UMSKY
 Two Ursa Major star positions
 * -> Miz_A Miz_a Dub_A Dub_a
 Miz = Mizar/Alcor (tail 2nd)
 Dub = Dubhe (head)

-- Tools -----------------------
== Calendar ==
->YMD
 * -> yyyy mm dd
YMD->
 yyyy mm dd -> dd.mmyyyy
->JD
 * -> Julian_Day_No
JD->
 Julian_Day_No -> dd.mmyyyy
->MJD
 * -> Modified_JD_No
MJD->
 Modified_JD_No -> dd.mmyyyy

== Coordinates ==
AB->
 coordinate conversions
 a b fm to -> a' b'
 fm, to:
 1  ecliptic   : lambda beta
    (celestial long, cel. lat)
 2  equatorial : alpha delta
    (right ascension, declin.)
 3  galactic   : l b
 4  horizon    : A a
    (azimuth, altitude)
 5  equatorial': H delta
    (hour angle, declination)

<alpha><delta>->RS
 rise and set data from
 equatorial coordinates
 alpha delta -> Ar As tr tc ts
 (see AB->)     (see MRS)

== Times ==
T->
 time conversions
 t fm to -> t'
 fm, to:
 1  Loc (local incl. DST)
 2  UT (universal)
 3  GST (Greenwich sidereal)
 4  LST (local sidereal)
================================
"
