sekki24 1.0.0

data/lib/sekki24/names.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Sekki24
+  module Names
+    Definition = Struct.new(
+      :key,
+      :name_ja,
+      :reading,
+      :name_en,
+      :name_zh,
+      :longitude,
+      keyword_init: true
+    )
+
+    TERMS = [
+      [:risshun, "立春", "りっしゅん", "Start of spring", "立春", 315],
+      [:usui, "雨水", "うすい", "Rain water", "雨水", 330],
+      [:keichitsu, "啓蟄", "けいちつ", "Awakening of insects", "惊蛰", 345],
+      [:shunbun, "春分", "しゅんぶん", "Spring equinox", "春分", 0],
+      [:seimei, "清明", "せいめい", "Pure brightness", "清明", 15],
+      [:kokuu, "穀雨", "こくう", "Grain rain", "谷雨", 30],
+      [:rikka, "立夏", "りっか", "Start of summer", "立夏", 45],
+      [:shoman, "小満", "しょうまん", "Grain buds", "小满", 60],
+      [:boshu, "芒種", "ぼうしゅ", "Grain in ear", "芒种", 75],
+      [:geshi, "夏至", "げし", "Summer solstice", "夏至", 90],
+      [:shosho, "小暑", "しょうしょ", "Minor heat", "小暑", 105],
+      [:taisho, "大暑", "たいしょ", "Major heat", "大暑", 120],
+      [:risshu, "立秋", "りっしゅう", "Start of autumn", "立秋", 135],
+      [:shoshu, "処暑", "しょしょ", "End of heat", "处暑", 150],
+      [:hakuro, "白露", "はくろ", "White dew", "白露", 165],
+      [:shubun, "秋分", "しゅうぶん", "Autumn equinox", "秋分", 180],
+      [:kanro, "寒露", "かんろ", "Cold dew", "寒露", 195],
+      [:soko, "霜降", "そうこう", "Frost descent", "霜降", 210],
+      [:ritto, "立冬", "りっとう", "Start of winter", "立冬", 225],
+      [:shosetsu, "小雪", "しょうせつ", "Minor snow", "小雪", 240],
+      [:taisetsu, "大雪", "たいせつ", "Major snow", "大雪", 255],
+      [:toji, "冬至", "とうじ", "Winter solstice", "冬至", 270],
+      [:shokan, "小寒", "しょうかん", "Minor cold", "小寒", 285],
+      [:daikan, "大寒", "だいかん", "Major cold", "大寒", 300]
+    ].map do |key, name_ja, reading, name_en, name_zh, longitude|
+      Definition.new(
+        key: key,
+        name_ja: name_ja,
+        reading: reading,
+        name_en: name_en,
+        name_zh: name_zh,
+        longitude: longitude
+      ).freeze
+    end.freeze
+
+    BY_KEY = TERMS.to_h { |term| [term.key, term] }.freeze
+    BY_LONGITUDE = TERMS.to_h { |term| [term.longitude, term] }.freeze
+    CALENDAR_ORDER = (TERMS.drop(22) + TERMS.take(22)).freeze
+
+    module_function
+
+    def fetch(key)
+      BY_KEY.fetch(key.to_sym)
+    rescue NoMethodError, KeyError
+      raise ArgumentError, "unknown solar term: #{key.inspect}"
+    end
+  end
+end

data/lib/sekki24/nutation.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Sekki24
+  module Nutation
+    J2000 = 2_451_545.0
+    JULIAN_CENTURY = 36_525.0
+    DEGREES_TO_RADIANS = Math::PI / 180.0
+
+    module_function
+
+    # Four dominant IAU 1980 terms, returned in degrees.
+    def longitude(jde)
+      centuries = (Float(jde) - J2000) / JULIAN_CENTURY
+      sun_mean_longitude = 280.4665 + (36_000.7698 * centuries)
+      moon_mean_longitude = 218.3165 + (481_267.8813 * centuries)
+      ascending_node = 125.04452 - (1934.136261 * centuries) +
+        (0.0020708 * centuries**2) + (centuries**3 / 450_000.0)
+
+      arcseconds = (-17.20 * sin_degrees(ascending_node)) -
+        (1.32 * sin_degrees(2.0 * sun_mean_longitude)) -
+        (0.23 * sin_degrees(2.0 * moon_mean_longitude)) +
+        (0.21 * sin_degrees(2.0 * ascending_node))
+      arcseconds / 3600.0
+    end
+
+    def sin_degrees(angle)
+      Math.sin(angle * DEGREES_TO_RADIANS)
+    end
+    private_class_method :sin_degrees
+  end
+end

data/lib/sekki24/seventy_two_kou.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+require_relative "kou_names"
+require_relative "kou"
+
+module Sekki24
+  module SeventyTwoKou
+    @cache_mutex = Mutex.new
+    @year_cache = {}
+    @candidate_cache = {}
+
+    class << self
+      def year(year, tz:, precision:)
+        calendar_year = validate_year(year)
+        mode = normalize_precision(precision)
+        solar = Solar.model(mode)
+        cache_key = [calendar_year, TimeScale.timezone_key(tz), mode].freeze
+        cached = @cache_mutex.synchronize { @year_cache[cache_key] }
+        return cached if cached
+
+        calculated = calculate_year(calendar_year, tz, mode, solar)
+        @cache_mutex.synchronize { @year_cache[cache_key] ||= calculated }
+      end
+
+      def fetch(year, ordinal, tz:, precision:)
+        definition = KouNames.fetch(ordinal)
+        self.year(year, tz: tz, precision: precision).find { |entry| entry.ordinal == definition.ordinal }
+      end
+
+      def current(time, tz:, precision:)
+        navigation_terms(time, tz, precision).select { |entry| entry.time <= time }.max ||
+          raise(RangeError, "no current kou in the supported range")
+      end
+
+      def next_kou(time, tz:, precision:)
+        navigation_terms(time, tz, precision).select { |entry| entry.time > time }.min ||
+          raise(RangeError, "no next kou in the supported range")
+      end
+
+      def previous(time, tz:, precision:)
+        navigation_terms(time, tz, precision).select { |entry| entry.time < time }.max ||
+          raise(RangeError, "no previous kou in the supported range")
+      end
+
+      def clear_cache!
+        @cache_mutex.synchronize do
+          @year_cache.clear
+          @candidate_cache.clear
+        end
+      end
+
+      private
+
+      def calculate_year(calendar_year, timezone, mode, solar)
+        entries = candidate_times(calendar_year, mode, solar).map do |definition, utc_time|
+          local_time = TimeScale.localize(utc_time, timezone)
+          Kou.new(definition: definition, time: local_time)
+        end.sort.freeze
+        return entries if entries.length == 72
+
+        raise Error, "expected 72 kou for #{calendar_year}, got #{entries.length}"
+      end
+
+      def candidate_times(year, mode, solar)
+        cache_key = [year, mode].freeze
+        cached = @cache_mutex.synchronize { @candidate_cache[cache_key] }
+        return cached if cached
+
+        calculated = Names::CALENDAR_ORDER.flat_map do |term_definition|
+          term_time = Finder.find(year: year, longitude: term_definition.longitude, solar: solar).freeze
+          KouNames::TERMS.select { |definition| definition.term_key == term_definition.key }.map do |definition|
+            time = if definition.position == :initial
+                     term_time
+                   else
+                     Finder.find_after(time: term_time, longitude: definition.longitude, solar: solar).freeze
+                   end
+            [definition, time].freeze
+          end
+        end.freeze
+        @cache_mutex.synchronize { @candidate_cache[cache_key] ||= calculated }
+      end
+
+      def navigation_terms(time, timezone, precision)
+        raise TypeError, "expected Time, got #{time.class}" unless time.is_a?(Time)
+
+        local_year = TimeScale.localize(time, timezone).year
+        years = ((local_year - 1)..(local_year + 1)).select { |value| (MIN_YEAR..MAX_YEAR).cover?(value) }
+        years.flat_map { |value| year(value, tz: timezone, precision: precision) }
+      end
+
+      def validate_year(year)
+        value = Integer(year)
+        return value if (MIN_YEAR..MAX_YEAR).cover?(value)
+
+        raise RangeError, "year must be between #{MIN_YEAR} and #{MAX_YEAR}"
+      rescue ArgumentError, TypeError
+        raise ArgumentError, "year must be an Integer between #{MIN_YEAR} and #{MAX_YEAR}"
+      end
+
+      def normalize_precision(precision)
+        precision.to_sym
+      rescue NoMethodError
+        raise ArgumentError, "precision must be :fast or :precise"
+      end
+    end
+  end
+
+  class << self
+    def kou_year(year, tz: DEFAULT_TIMEZONE, precision: DEFAULT_PRECISION)
+      SeventyTwoKou.year(year, tz: tz, precision: precision)
+    end
+
+    def kou(year, ordinal, tz: DEFAULT_TIMEZONE, precision: DEFAULT_PRECISION)
+      SeventyTwoKou.fetch(year, ordinal, tz: tz, precision: precision)
+    end
+
+    def current_kou(time = Time.now, tz: DEFAULT_TIMEZONE, precision: DEFAULT_PRECISION)
+      SeventyTwoKou.current(time, tz: tz, precision: precision)
+    end
+
+    def next_kou(time = Time.now, tz: DEFAULT_TIMEZONE, precision: DEFAULT_PRECISION)
+      SeventyTwoKou.next_kou(time, tz: tz, precision: precision)
+    end
+
+    def prev_kou(time = Time.now, tz: DEFAULT_TIMEZONE, precision: DEFAULT_PRECISION)
+      SeventyTwoKou.previous(time, tz: tz, precision: precision)
+    end
+  end
+end

data/lib/sekki24/solar/fast.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Sekki24
+  module Solar
+    module Fast
+      J2000 = 2_451_545.0
+      JULIAN_CENTURY = 36_525.0
+      DEGREES_TO_RADIANS = Math::PI / 180.0
+
+      module_function
+
+      def longitude(jde)
+        centuries = (Float(jde) - J2000) / JULIAN_CENTURY
+        mean_longitude = 280.46646 + (36_000.76983 * centuries) + (0.0003032 * centuries**2)
+        mean_anomaly = 357.52911 + (35_999.05029 * centuries) - (0.0001537 * centuries**2) +
+          (centuries**3 / 24_490_000.0)
+        center = equation_of_center(mean_anomaly, centuries)
+        omega = 125.04 - (1934.136 * centuries)
+
+        normalize(mean_longitude + center - 0.00569 - (0.00478 * sin_degrees(omega)))
+      end
+
+      def equation_of_center(mean_anomaly, centuries)
+        ((1.914602 - (0.004817 * centuries) - (0.000014 * centuries**2)) * sin_degrees(mean_anomaly)) +
+          ((0.019993 - (0.000101 * centuries)) * sin_degrees(2.0 * mean_anomaly)) +
+          (0.000289 * sin_degrees(3.0 * mean_anomaly))
+      end
+      private_class_method :equation_of_center
+
+      def sin_degrees(angle)
+        Math.sin(angle * DEGREES_TO_RADIANS)
+      end
+      private_class_method :sin_degrees
+
+      def normalize(angle)
+        angle % 360.0
+      end
+      private_class_method :normalize
+    end
+  end
+end

data/lib/sekki24/solar/precise.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative "vsop87_earth"
+require_relative "../nutation"
+
+module Sekki24
+  module Solar
+    module Precise
+      J2000 = 2_451_545.0
+      JULIAN_MILLENNIUM = 365_250.0
+      JULIAN_CENTURY = 36_525.0
+      RADIANS_TO_DEGREES = 180.0 / Math::PI
+      ABERRATION_ARCSECONDS = 20.4898
+      FK5_LONGITUDE_CORRECTION = -0.09033 / 3600.0
+
+      module_function
+
+      def longitude(jde)
+        jde = Float(jde)
+        millennia = (jde - J2000) / JULIAN_MILLENNIUM
+        earth_longitude = evaluate(VSOP87Earth::LONGITUDE, millennia) * RADIANS_TO_DEGREES
+        radius = evaluate(VSOP87Earth::RADIUS, millennia)
+        geometric_longitude = earth_longitude + 180.0 + FK5_LONGITUDE_CORRECTION
+        apparent_longitude = geometric_longitude + Nutation.longitude(jde) -
+          (ABERRATION_ARCSECONDS / (3600.0 * radius))
+
+        apparent_longitude % 360.0
+      end
+
+      def evaluate(series, time)
+        power = 1.0
+        series.sum do |terms|
+          value = terms.sum do |amplitude, phase, frequency|
+            amplitude * Math.cos(phase + (frequency * time))
+          end
+          result = value * power
+          power *= time
+          result
+        end
+      end
+      private_class_method :evaluate
+
+    end
+  end
+end

data/lib/sekki24/solar/vsop87_earth.rb

@@ -0,0 +1,227 @@
+# frozen_string_literal: true
+
+module Sekki24
+  module Solar
+    # Truncated VSOP87D Earth series (Bretagnon & Francou, 1988).
+    # Coefficients are from the official IMCCE VSOP87D.ear distribution.
+    module VSOP87Earth
+      LONGITUDE = [
+        [
+          [1.75347045673, 0.00000000000, 0.00000000000].freeze,
+          [0.03341656456, 4.66925680417, 6283.07584999140].freeze,
+          [0.00034894275, 4.62610241759, 12566.15169998280].freeze,
+          [0.00003417571, 2.82886579606, 3.52311834900].freeze,
+          [0.00003497056, 2.74411800971, 5753.38488489680].freeze,
+          [0.00003135896, 3.62767041758, 77713.77146812050].freeze,
+          [0.00002676218, 4.41808351397, 7860.41939243920].freeze,
+          [0.00002342687, 6.13516237631, 3930.20969621960].freeze,
+          [0.00001273166, 2.03709655772, 529.69096509460].freeze,
+          [0.00001324292, 0.74246356352, 11506.76976979360].freeze,
+          [0.00000901855, 2.04505443513, 26.29831979980].freeze,
+          [0.00001199167, 1.10962944315, 1577.34354244780].freeze,
+          [0.00000857223, 3.50849156957, 398.14900340820].freeze,
+          [0.00000779786, 1.17882652114, 5223.69391980220].freeze,
+          [0.00000990250, 5.23268129594, 5884.92684658320].freeze,
+          [0.00000753141, 2.53339053818, 5507.55323866740].freeze,
+          [0.00000505264, 4.58292563052, 18849.22754997420].freeze,
+          [0.00000492379, 4.20506639861, 775.52261132400].freeze,
+          [0.00000356655, 2.91954116867, 0.06731030280].freeze,
+          [0.00000284125, 1.89869034186, 796.29800681640].freeze,
+          [0.00000242810, 0.34481140906, 5486.77784317500].freeze,
+          [0.00000317087, 5.84901952218, 11790.62908865880].freeze,
+          [0.00000271039, 0.31488607649, 10977.07880469900].freeze,
+          [0.00000206160, 4.80646606059, 2544.31441988340].freeze,
+          [0.00000205385, 1.86947813692, 5573.14280143310].freeze,
+          [0.00000202261, 2.45767795458, 6069.77675455340].freeze,
+          [0.00000126184, 1.08302630210, 20.77539549240].freeze,
+          [0.00000155516, 0.83306073807, 213.29909543800].freeze,
+          [0.00000115132, 0.64544911683, 0.98032106820].freeze,
+          [0.00000102851, 0.63599846727, 4694.00295470760].freeze,
+          [0.00000101724, 4.26679821365, 7.11354700080].freeze,
+          [0.00000099206, 6.20992940258, 2146.16541647520].freeze,
+          [0.00000132212, 3.41118275555, 2942.46342329160].freeze,
+          [0.00000097607, 0.68101272270, 155.42039943420].freeze,
+          [0.00000085128, 1.29870743025, 6275.96230299060].freeze,
+          [0.00000074651, 1.75508916159, 5088.62883976680].freeze,
+          [0.00000101895, 0.97569221824, 15720.83878487840].freeze,
+          [0.00000084711, 3.67080093025, 71430.69561812909].freeze,
+          [0.00000073547, 4.67926565481, 801.82093112380].freeze,
+          [0.00000073874, 3.50319443167, 3154.68708489560].freeze,
+          [0.00000078756, 3.03698313141, 12036.46073488820].freeze,
+          [0.00000079637, 1.80791330700, 17260.15465469040].freeze,
+          [0.00000085803, 5.98322631256, 161000.68573767410].freeze,
+          [0.00000056963, 2.78430398043, 6286.59896834040].freeze,
+          [0.00000061148, 1.81839811024, 7084.89678111520].freeze,
+          [0.00000069627, 0.83297596966, 9437.76293488700].freeze,
+          [0.00000056116, 4.38694880779, 14143.49524243060].freeze,
+          [0.00000062449, 3.97763880587, 8827.39026987480].freeze,
+          [0.00000051145, 0.28306864501, 5856.47765911540].freeze,
+          [0.00000055577, 3.47006009062, 6279.55273164240].freeze,
+          [0.00000041036, 5.36817351402, 8429.24126646660].freeze,
+          [0.00000051605, 1.33282746983, 1748.01641306700].freeze,
+          [0.00000051992, 0.18914945834, 12139.55350910680].freeze,
+          [0.00000049000, 0.48735065033, 1194.44701022460].freeze,
+          [0.00000039200, 6.16832995016, 10447.38783960440].freeze,
+          [0.00000035566, 1.77597314691, 6812.76681508600].freeze,
+          [0.00000036770, 6.04133859347, 10213.28554621100].freeze,
+          [0.00000036596, 2.56955238628, 1059.38193018920].freeze,
+          [0.00000033291, 0.59309499459, 17789.84561978500].freeze,
+          [0.00000035954, 1.70876111898, 2352.86615377180].freeze,
+          [0.00000040938, 2.39850881707, 19651.04848109800].freeze,
+          [0.00000030047, 2.73975123935, 1349.86740965880].freeze,
+          [0.00000030412, 0.44294464135, 83996.84731811189].freeze,
+          [0.00000023663, 0.48473567763, 8031.09226305840].freeze,
+        ].freeze,
+        [
+          [6283.31966747491, 0.00000000000, 0.00000000000].freeze,
+          [0.00206058863, 2.67823455584, 6283.07584999140].freeze,
+          [0.00004303430, 2.63512650414, 12566.15169998280].freeze,
+          [0.00000425264, 1.59046980729, 3.52311834900].freeze,
+          [0.00000108977, 2.96618001993, 1577.34354244780].freeze,
+          [0.00000093478, 2.59212835365, 18849.22754997420].freeze,
+          [0.00000119261, 5.79557487799, 26.29831979980].freeze,
+          [0.00000072122, 1.13846158196, 529.69096509460].freeze,
+          [0.00000067768, 1.87472304791, 398.14900340820].freeze,
+          [0.00000067327, 4.40918235168, 5507.55323866740].freeze,
+          [0.00000059027, 2.88797038460, 5223.69391980220].freeze,
+          [0.00000055976, 2.17471680261, 155.42039943420].freeze,
+          [0.00000045407, 0.39803079805, 796.29800681640].freeze,
+          [0.00000036369, 0.46624739835, 775.52261132400].freeze,
+          [0.00000028958, 2.64707383882, 7.11354700080].freeze,
+          [0.00000019097, 1.84628332577, 5486.77784317500].freeze,
+          [0.00000020844, 5.34138275149, 0.98032106820].freeze,
+          [0.00000018508, 4.96855124577, 213.29909543800].freeze,
+          [0.00000016233, 0.03216483047, 2544.31441988340].freeze,
+          [0.00000017293, 2.99116864949, 6275.96230299060].freeze,
+          [0.00000015832, 1.43049285325, 2146.16541647520].freeze,
+          [0.00000014615, 1.20532366323, 10977.07880469900].freeze,
+          [0.00000011877, 3.25804815607, 5088.62883976680].freeze,
+          [0.00000011514, 2.07502418155, 4694.00295470760].freeze,
+          [0.00000009721, 4.23925472239, 1349.86740965880].freeze,
+          [0.00000009969, 1.30262991097, 6286.59896834040].freeze,
+          [0.00000009452, 2.69957062864, 242.72860397400].freeze,
+          [0.00000012461, 2.83432285512, 1748.01641306700].freeze,
+          [0.00000011808, 5.27379790480, 1194.44701022460].freeze,
+          [0.00000008577, 5.64475868067, 951.71840625060].freeze,
+          [0.00000010641, 0.76614199202, 553.56940284240].freeze,
+          [0.00000007576, 5.30062664886, 2352.86615377180].freeze,
+          [0.00000005834, 1.76649917904, 1059.38193018920].freeze,
+          [0.00000006385, 2.65033984967, 9437.76293488700].freeze,
+        ].freeze,
+        [
+          [0.00052918870, 0.00000000000, 0.00000000000].freeze,
+          [0.00008719837, 1.07209665242, 6283.07584999140].freeze,
+          [0.00000309125, 0.86728818832, 12566.15169998280].freeze,
+          [0.00000027339, 0.05297871691, 3.52311834900].freeze,
+          [0.00000016334, 5.18826691036, 26.29831979980].freeze,
+          [0.00000015752, 3.68457889430, 155.42039943420].freeze,
+          [0.00000009541, 0.75742297675, 18849.22754997420].freeze,
+          [0.00000008937, 2.05705419118, 77713.77146812050].freeze,
+          [0.00000006952, 0.82673305410, 775.52261132400].freeze,
+          [0.00000005064, 4.66284525271, 1577.34354244780].freeze,
+          [0.00000004061, 1.03057162962, 7.11354700080].freeze,
+          [0.00000003463, 5.14074632811, 796.29800681640].freeze,
+          [0.00000003169, 6.05291851171, 5507.55323866740].freeze,
+          [0.00000003020, 1.19246506441, 242.72860397400].freeze,
+          [0.00000002886, 6.11652627155, 529.69096509460].freeze,
+          [0.00000003810, 3.44050803490, 5573.14280143310].freeze,
+          [0.00000002714, 0.30637881025, 398.14900340820].freeze,
+          [0.00000002371, 4.38118838167, 5223.69391980220].freeze,
+          [0.00000002538, 2.27992810679, 553.56940284240].freeze,
+          [0.00000002079, 3.75435330484, 0.98032106820].freeze,
+        ].freeze,
+        [
+          [0.00000289226, 5.84384198723, 6283.07584999140].freeze,
+          [0.00000034955, 0.00000000000, 0.00000000000].freeze,
+          [0.00000016819, 5.48766912348, 12566.15169998280].freeze,
+          [0.00000002962, 5.19577265202, 155.42039943420].freeze,
+          [0.00000001288, 4.72200252235, 3.52311834900].freeze,
+          [0.00000000635, 5.96925937141, 242.72860397400].freeze,
+          [0.00000000714, 5.30045809128, 18849.22754997420].freeze,
+        ].freeze,
+        [
+          [0.00000114084, 3.14159265359, 0.00000000000].freeze,
+          [0.00000007717, 4.13446589358, 6283.07584999140].freeze,
+          [0.00000000765, 3.83803776214, 12566.15169998280].freeze,
+        ].freeze,
+        [
+          [0.00000000878, 3.14159265359, 0.00000000000].freeze,
+        ].freeze,
+      ].freeze
+      RADIUS = [
+        [
+          [1.00013988799, 0.00000000000, 0.00000000000].freeze,
+          [0.01670699626, 3.09846350771, 6283.07584999140].freeze,
+          [0.00013956023, 3.05524609620, 12566.15169998280].freeze,
+          [0.00003083720, 5.19846674381, 77713.77146812050].freeze,
+          [0.00001628461, 1.17387749012, 5753.38488489680].freeze,
+          [0.00001575568, 2.84685245825, 7860.41939243920].freeze,
+          [0.00000924799, 5.45292234084, 11506.76976979360].freeze,
+          [0.00000542444, 4.56409149777, 3930.20969621960].freeze,
+          [0.00000472110, 3.66100022149, 5884.92684658320].freeze,
+          [0.00000328780, 5.89983646482, 5223.69391980220].freeze,
+          [0.00000345983, 0.96368617687, 5507.55323866740].freeze,
+          [0.00000306784, 0.29867139512, 5573.14280143310].freeze,
+          [0.00000174844, 3.01193636534, 18849.22754997420].freeze,
+          [0.00000243189, 4.27349536153, 11790.62908865880].freeze,
+          [0.00000211829, 5.84714540314, 1577.34354244780].freeze,
+          [0.00000185752, 5.02194447178, 10977.07880469900].freeze,
+          [0.00000109835, 5.05510636285, 5486.77784317500].freeze,
+          [0.00000098316, 0.88681311277, 6069.77675455340].freeze,
+          [0.00000086499, 5.68959778254, 15720.83878487840].freeze,
+          [0.00000085825, 1.27083733351, 161000.68573767410].freeze,
+          [0.00000062916, 0.92177108832, 529.69096509460].freeze,
+          [0.00000057056, 2.01374292014, 83996.84731811189].freeze,
+          [0.00000064903, 0.27250613787, 17260.15465469040].freeze,
+          [0.00000049384, 3.24501240359, 2544.31441988340].freeze,
+          [0.00000055736, 5.24159798933, 71430.69561812909].freeze,
+          [0.00000042515, 6.01110242003, 6275.96230299060].freeze,
+          [0.00000046963, 2.57805070386, 775.52261132400].freeze,
+          [0.00000038968, 5.36071738169, 4694.00295470760].freeze,
+          [0.00000044661, 5.53715807302, 9437.76293488700].freeze,
+          [0.00000035660, 1.67468058995, 12036.46073488820].freeze,
+          [0.00000031921, 0.18368229781, 5088.62883976680].freeze,
+          [0.00000031846, 1.77775642085, 398.14900340820].freeze,
+          [0.00000033193, 0.24370300098, 7084.89678111520].freeze,
+          [0.00000038245, 2.39255343974, 8827.39026987480].freeze,
+          [0.00000028464, 1.21344868176, 6286.59896834040].freeze,
+          [0.00000037490, 0.82952922332, 19651.04848109800].freeze,
+          [0.00000036957, 4.90107591914, 12139.55350910680].freeze,
+          [0.00000034537, 1.84270693282, 2942.46342329160].freeze,
+          [0.00000026275, 4.58896850401, 10447.38783960440].freeze,
+          [0.00000024596, 3.78660875483, 8429.24126646660].freeze,
+        ].freeze,
+        [
+          [0.00103018608, 1.10748969588, 6283.07584999140].freeze,
+          [0.00001721238, 1.06442301418, 12566.15169998280].freeze,
+          [0.00000702215, 3.14159265359, 0.00000000000].freeze,
+          [0.00000032346, 1.02169059149, 18849.22754997420].freeze,
+          [0.00000030799, 2.84353804832, 5507.55323866740].freeze,
+          [0.00000024971, 1.31906709482, 5223.69391980220].freeze,
+          [0.00000018485, 1.42429748614, 1577.34354244780].freeze,
+          [0.00000010078, 5.91378194648, 10977.07880469900].freeze,
+          [0.00000008634, 0.27146150602, 5486.77784317500].freeze,
+          [0.00000008654, 1.42046854427, 6275.96230299060].freeze,
+        ].freeze,
+        [
+          [0.00004359385, 5.78455133738, 6283.07584999140].freeze,
+          [0.00000123633, 5.57934722157, 12566.15169998280].freeze,
+          [0.00000012341, 3.14159265359, 0.00000000000].freeze,
+          [0.00000008792, 3.62777733395, 77713.77146812050].freeze,
+          [0.00000005689, 1.86958905084, 5573.14280143310].freeze,
+          [0.00000003301, 5.47027913302, 18849.22754997420].freeze,
+        ].freeze,
+        [
+          [0.00000144595, 4.27319435148, 6283.07584999140].freeze,
+          [0.00000006729, 3.91697608662, 12566.15169998280].freeze,
+        ].freeze,
+        [
+          [0.00000003858, 2.56384387339, 6283.07584999140].freeze,
+        ].freeze,
+        [
+        ].freeze,
+      ].freeze
+    end
+  end
+end
+

data/lib/sekki24/solar.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative "solar/fast"
+require_relative "solar/precise"
+
+module Sekki24
+  module Solar
+    MODELS = {
+      fast: Fast,
+      precise: Precise
+    }.freeze
+
+    module_function
+
+    def model(precision)
+      MODELS.fetch(precision.to_sym)
+    rescue NoMethodError, KeyError
+      raise ArgumentError, "precision must be :fast or :precise"
+    end
+  end
+end

data/lib/sekki24/term.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require "date"
+require "time"
+
+module Sekki24
+  class Term
+    include Comparable
+
+    ATTRIBUTES = %i[key name_ja reading name_en name_zh longitude time].freeze
+
+    attr_reader(*ATTRIBUTES)
+
+    def initialize(definition:, time:)
+      @key = definition.key
+      @name_ja = definition.name_ja
+      @reading = definition.reading
+      @name_en = definition.name_en
+      @name_zh = definition.name_zh
+      @longitude = definition.longitude
+      @time = time.dup.freeze
+      freeze
+    end
+
+    def <=>(other)
+      return unless other.respond_to?(:time)
+
+      time <=> other.time
+    end
+
+    def ==(other)
+      other.is_a?(Term) && key == other.key && time == other.time
+    end
+    alias eql? ==
+
+    def hash
+      [self.class, key, time].hash
+    end
+
+    def to_date
+      time.to_date
+    end
+
+    def to_h
+      ATTRIBUTES.to_h { |attribute| [attribute, public_send(attribute)] }
+    end
+
+    def inspect
+      "#<#{self.class} #{name_ja} (#{key}) #{time.iso8601} longitude=#{longitude}°>"
+    end
+  end
+end