home *** CD-ROM | disk | FTP | other *** search
/ Fritz: Win Best Test 1 / 70001.ZIP / 70001 / WINWARE1 / PHOEBE / PHOEBE.DOC next >
Encoding:
Text File  |  1993-09-26  |  8.4 KB  |  181 lines
  1.  
  2.                                 Phoebe
  3.  
  4.  
  5.                                                 March 20, 1992
  6.  
  7.    Introduction:
  8.  
  9.         Thank you for down-loading Phoebe, a small Windows utility program
  10.     that gives various astrological information related to the moon.
  11.     Phoebe is named after the Greek Goddess of the moon who was also the
  12.     protector of children.  I wrote Phoebe to aid the Vietnamese refugee
  13.     children without parents who are in refugee camps in the Philippines.
  14.  
  15.         The Center for Aid to Displaced Persons, CADP, is an agency run by
  16.     the Philippine Daughters of Charity of the Catholic church which
  17.     provides shelter, counseling and education to the unaccompanied minors
  18.     in the Philippines First Asylum Camp (PFAC).  If you enjoy Phoebe, I
  19.     beg you to make a donation to CADP (no matter how small).  You may send
  20.     the money directly to CADP or you may send it to Hong Bang, an
  21.     organization in New Orleans that works closely with CADP.  Hong Bang
  22.     will forward any money received for CADP directly with no overhead
  23.     costs of any kind.  Both CADP and Hong Bang are nonprofit
  24.     agencies staffed through volunteers.  Hong Bang is dedicated to
  25.     improving the health, education and social welfare of Vietnamese,
  26.     and has helped volunteers work in the refugee camps.
  27.  
  28.  
  29.    Address:
  30.  
  31.    CADP, Inc.                      CADP, Inc.
  32.    PO Box 3273                     c/o Hong Bang
  33.    Manila, Philippines             2476 Park Place Dr.
  34.                                    Gretna, LA 70053
  35.  
  36.  
  37.  
  38.    Phoebe:
  39.  
  40.         Phoebe calculates the sunrise and sunset times to within about a
  41.     minute and the moonrise and moonset times to within 15 minutes by using
  42.     successive approximation.  The equations are based on the book
  43.     Astronomical Formulae for Calculators by Jean Meeus published by
  44.     Willmann-Bell.  To calculate these times accurately, Phoebe must use
  45.     the correct local longitude and latitude and the correct difference in
  46.     time from GMT.  Odd values for these numbers will lead Phoebe to
  47.     calculate odd values for the rise and set times.  Phoebe's icon
  48.     is set to resemble the phase of the moon and zodiac information
  49.     is given for the time phoebe was started.
  50.  
  51.         The easiest way to set the local parameters is to select
  52.     Location/Select City from the menu and then select the nearest city,
  53.     and use the Adjust Hours and Adjust Minutes option to vary the times to
  54.     agree with the times in a local newspaper.  Check the system time
  55.     (Location/Show System Time) to verify that the difference in hours from
  56.     GMT is correct.  For locations such as Newfoundland that are half-hours
  57.     difference from GMT, set the Adjust Minutes option to 30.  Alternately
  58.     one can use Adjust Hours, Change Longitude, Change Latitudes options to
  59.     set everything correctly.  Your local library should be able to tell
  60.     you the exact Latitude and Longitude for your city.
  61.  
  62.         Use Recalculate to update the display once the location information
  63.     has been changed.
  64.  
  65.         Once the location parameters are set, check the sunrise/sunset
  66.     times in an almanac or newspaper.  The Adjust Minutes parameter can be
  67.     used to take care of any small local differences in time caused by
  68.     different altitudes).  Once all of these location parameters are to
  69.     your liking, save them with the Save Changes option and Phoebe will
  70.     write them to a Phoebe.ini file and set itself up correctly the next
  71.     time.
  72.  
  73.         Most systems default to Eastern time, although there is an obscure
  74.     DOS environment variable TZ to set DOS for other Time-zones.  If this
  75.     variable is set Phoebe will use it.  Phoebe provides enough control to
  76.     correctly set the location information without setting this variable in
  77.     your autoexec.bat file.
  78.  
  79.         Setting the location information for Phoebe is much easier than
  80.     describing it in writing.  Note that because the moon's period is
  81.     roughly 29.5 days the rising and setting times vary greatly.  Sometimes
  82.     the moon rises and sets in the same day and sometimes the old moon sets
  83.     and then the young moon rises.  There is one day a month where the moon
  84.     rises and does not set until the next day and one day where the moon
  85.     sets but does not rise until the next day.
  86.  
  87.  
  88.    The Lunar and Horary Date:
  89.  
  90.         The Lunar Date is today's date on the Eastern Lunar calendar.  The
  91.     Horary Date is the date on the Chinese calendar given in terms of the
  92.     Heavenly Stems (Colors) and Heavenly Branches (Animals).  The ten
  93.     Heavenly Stems are Purple, Black, Orange, Red, Golden, Green, White
  94.     Yellow, Blue and Silver.  The actual words in Chinese or Vietnamese are
  95.     not the names of colors, but in Chinese Numerology these colors are
  96.     assigned to the stems.  I used the colors instead of the more
  97.     traditional "first stem", "second stem" translation in hopes that the
  98.     translation would be more pleasing.  The names of the Heavenly Branches
  99.     are the names of animals and I followed the Vietnamese style in
  100.     translating them as Rat, Ox, Tiger, Cat, Dragon, Snake, Horse, Goat,
  101.     Monkey, Chicken, Dog and Pig.  The Heavenly Stem and Branch pairs
  102.     rotate through a sixty unit cycle.  Adding the place value for the day,
  103.     month and year, dividing by 8 and using the dividend and remainder to
  104.     generate a character from the I Ching determines whether the day is a
  105.     lucky or unlucky day.
  106.  
  107.     References:
  108.         Astronomical Formulae for Calculators by Jean Meeus.
  109.         Calendar Conversions by Way of the Julian Day Number by O L Harvey.
  110.         An Anthology of the I Ching by Sherril and Chu.
  111.         The I Ching by Sam Reiffer.
  112.  
  113.  
  114.  
  115.    DOS Time-zone:
  116.  
  117.         Phoebe relies on the DOS system time to calculate the times of
  118.    the rise and set of the sun and the moon.  Usually DOS will report
  119.    Eastern Standard Time (EST) or Eastern Daylight Time when the
  120.    time-zone is requested.  To correct this difference, an environment
  121.    variable TZ can be set in the autoexec.bat file.
  122.  
  123.    For example,
  124.  
  125.    SET  TZ=CST6CDT
  126.  
  127.    will set the time-zone to Central Standard Time, 6 hours difference
  128.    from GMT and Central Daylight Time in the summer.  Someone in
  129.    Indiana (Indiana has no daylight savings time.) may use
  130.  
  131.    SET  TZ = CST6
  132.  
  133.    which sets the time-zone information to Central Standard Time, 6
  134.    hours difference from GMT, no daylight savings time in the summer.
  135.  
  136.    Someone in California might set the time-zone variable by:
  137.  
  138.    SET  TZ = PST8PDT
  139.  
  140.    The syntax for this command is,
  141.  
  142.    SET  TZ = zzz[+/-]d[d][lll]
  143.  
  144.    where zzz is the three letter abbreviation for standard time,
  145.    [+/-]d[d] is a one or two digit number, optionally signed that
  146.    gives the time difference for standard time from GMT.  Time-zones
  147.    West of GMT are positive and time-zones East of GMT are negative.
  148.    This number should range between -12 and 12 for correct results.
  149.    [lll] is the optional designation for daylight savings time or
  150.    summer time.  If [lll] is present, DOS will use daylight savings
  151.    time in computing the time.  If this string is not present DOS
  152.    assumes TZ = EST5EDT as the default string.  It is not necessary
  153.    to go to the trouble to set this variable to use Phoebe.
  154.  
  155.  
  156.    Distribution:
  157.  
  158.         This program may be freely distributed without cost, provided
  159.    that it is not changed in any way.  The current version is 1.21.
  160.    Bug reports and comments and suggestions can be sent to Anthony Nguyen
  161.    in care of Hong Bang.
  162.  
  163.  
  164.    Closing Notes:
  165.  
  166.         I hope you enjoy Phoebe.  I hope that some kindhearted people
  167.    enjoy it enough to help CADP care for the poor, lonely children
  168.    in the camps.  Everyday the situation grows worse for the refugees and
  169.    for children with no parents in the camps the situation is becoming
  170.    unbearable.  CADP helps them to endure by providing them with
  171.    counselling, education, recreation and shelter.  I pray to God that
  172.    this program in some way helps the volunteers in CADP to continue
  173.    their good work.  Working as a volunteer for CADP was one of the
  174.    most fulfilling experiences of my life, and it breaks my heart to
  175.    see the conditions of the refugees in the camps today. Good-bye
  176.    and may God Bless you.
  177.  
  178.  
  179.                                                 Anthony Nguyen
  180.                                                 Vestal, New York
  181.