astro_moon 0.1 → 0.2

data/README

@@ -4,3 +4,6 @@ This file is a thoughtless manual compilation of Astro::MoonPhase perl
 module (which, in turn, is influenced by moontool.c). I don't know
 how it all works.
 
+This gem contains an example script (bin/moon.rb), which hopefully helps to
+understand the API of this module.
+

data/lib/astro/moon.rb

@@ -11,13 +11,25 @@ module Astro # :nodoc:
     module Moon # :doc:
       class << self
 
-        # a container structure for phase() return value.
+        # a container structure for phase() return value. accessors:
+        #   phase - moon phase, 0 or 1 for new moon, 0.5 for full moon, etc
+        #   illumination - moon illumination, 0.0 .. 0.1
+        #   age - moon age, in days from the most recent new moon
+        #   distance - moon distance from earth, in kilometers
+        #   angle - moon angle
+        #   sun_distance - sun distance from earth, in kilometers
+        #   sun_angle - sun angle
         Phase = Struct.new(:phase, :illumination, :age, :distance, :angle,
                            :sun_distance, :sun_angle)
 
-        # a container structure for phasehunt() return value.
+        # a container structure for phasehunt() return value. accessors:
+        #   moon_start - a DateTime of the most recent new moon
+        #   moon_end   - a DateTime of the next new moon
+        #   moon_fill  - a DateTime of the full moon of this lunar month
+        #   first_quarter, last_quarter -- <...>
         PhaseHunt = Struct.new(:moon_start, :first_quarter, :moon_full,
                                :last_quarter, :moon_end)
+
         # Astronomical constants.
         # 1980 January 0.0
         EPOCH      = 2444238.5
@@ -60,7 +72,7 @@ module Astro # :nodoc:
 
         # Finds the key dates of the specified lunar month.
         # Takes a DateTime object (or creates one using now() function).
-        # Returns a PhaseHunt struct instance.
+        # Returns a PhaseHunt struct instance. (see Constants section)
         #
         #    # find the date/time of the full moon in this lunar month
         #    Astro::Moon.phasehunt.moon_full.strftime("%D %T %Z") \
@@ -71,7 +83,7 @@ module Astro # :nodoc:
             sdate = date.ajd
 
             adate = sdate - 45
-            ad1 = DateTime.new1(adate)
+            ad1 = DateTime.jd(adate)
 
             k1 = ((ad1.year + ((ad1.month - 1) *
                                (1.0 / 12.0)) - 1900) * 12.3685).floor
@@ -100,7 +112,7 @@ module Astro # :nodoc:
 
         # Finds the lunar phase for the specified date.
         # Takes a DateTime object (or creates one using now() function).
-        # Returns a Phase struct instance.
+        # Returns a Phase struct instance. (see Constants section)
         #
         #    # find the current moon illumination, in percents
         #    Astro::Moon.phase.illumination * 100     # => 63.1104513958699
@@ -304,7 +316,7 @@ module Astro # :nodoc:
             if !apcor || apcor == 0
                 raise "truephase() called with invalid phase selector (#{phase})."
             end
-            return DateTime.new1(pt + 0.5)
+            return DateTime.jd(pt + 0.5)
         end
 
         def kepler(m, ecc)

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.0
 specification_version: 1
 name: astro_moon
 version: !ruby/object:Gem::Version 
-  version: "0.1"
-date: 2007-03-10 00:00:00 +03:00
+  version: "0.2"
+date: 2007-03-15 00:00:00 +03:00
 summary: A library for calculating the lunar phases and dates
 require_paths: 
 - lib