zakuro 0.1.5 → 0.5.0

data/lib/zakuro/version/senmyou/stella/solar/adjustment.rb

@@ -15,9 +15,9 @@ module Zakuro
       #
       module Adjustment
         #
-        # Item 24気損益眺朒（ちょうじく）数
+        # Row 行データ
         #
-        class Item
+        class Row
           # @return [Integer] 眺朒（ちょうじく）積
           attr_reader :stack
           # @return [Integer] 眺朒（ちょうじく）数
@@ -48,40 +48,40 @@ module Zakuro
           end
         end
 
-        # @return [Array<Item>] 24気損益眺朒（ちょうじく）数
+        # @return [Array<Row>] 24気損益眺朒（ちょうじく）数
         MAP = {
-          touji: Item.new(stack: 0.0, per_term: +33.4511, per_day: -0.3695),        # 冬至（とうじ）
-          shoukan: Item.new(stack: +449.0, per_term: +28.0389, per_day: -0.3606),   # 小寒（しょうかん）
-          daikan: Item.new(stack: +823.0, per_term: +22.6998, per_day: -0.3519),    # 大寒（だいかん）
-          risshun: Item.new(stack: +1122.0, per_term: +17.8923, per_day: -0.4068),  # 立春（りっしゅん）
-          usui: Item.new(stack: +1346.0, per_term: +11.7966, per_day: -0.3998),     # 雨水（うすい）
-          keichitsu: Item.new(stack: +1481.0, per_term: +5.7986, per_day: -0.3998), # 啓蟄（けいちつ）
-          shunbun: Item.new(stack: +1526.0, per_term: -0.2433, per_day: -0.3779),   # 春分（しゅんぶん）
-          seimei: Item.new(stack: +1481.0, per_term: -6.1254, per_day: -0.3634),    # 清明（せいめい）
-          kokuu: Item.new(stack: +1346.0, per_term: -12.2048, per_day: -0.2987),    # 穀雨（こくう）
-          rikka: Item.new(stack: +1122.0, per_term: -16.9060, per_day: -0.2919),    # 立夏（りっか）
-          shouman: Item.new(stack: +823.0, per_term: -21.5362, per_day: -0.2854),   # 小満（しょうまん）
-          boushu: Item.new(stack: +449.0, per_term: -26.0498, per_day: -0.2854),    # 芒種（ぼうしゅ）
-          geshi: Item.new(stack: 0.0, per_term: -30.3119, per_day: +0.2854),        # 夏至（げし）
-          shousho: Item.new(stack: -449.0, per_term: -25.8126, per_day: +0.2919),   # 小暑（しょうしょ）
-          taisho: Item.new(stack: -823.0, per_term: -21.2454, per_day: +0.2987),    # 大暑（たいしょ）
-          risshuu: Item.new(stack: -1122.0, per_term: -17.0296, per_day: +0.3634),  # 立秋（りっしゅう）
-          shosho: Item.new(stack: -1346.0, per_term: -11.4744, per_day: +0.3779),   # 処暑（しょしょ）
-          hakuro: Item.new(stack: -1481.0, per_term: -5.6429, per_day: +0.3779),    # 白露（はくろ）
-          shuubun: Item.new(stack: -1526.0, per_term: +0.1432, per_day: +0.3998),   # 秋分（しゅうぶん）
-          kanro: Item.new(stack: -1481.0, per_term: +6.1488, per_day: +0.4068),     # 寒露（かんろ）
-          soukou: Item.new(stack: -1346.0, per_term: +12.6336, per_day: +0.3519),   # 霜降（そうこう）
-          rittou: Item.new(stack: -1122.0, per_term: +17.8043, per_day: +0.3606),   # 立冬（りっとう）
-          shousetsu: Item.new(stack: -823.0, per_term: +23.0590, per_day: +0.3695), # 小雪（しょうせつ）
-          taisetsu: Item.new(stack: -449.0, per_term: +28.4618, per_day: +0.3695)   # 大雪（たいせつ）
+          touji: Row.new(stack: 0.0, per_term: +33.4511, per_day: -0.3695),        # 冬至（とうじ）
+          shoukan: Row.new(stack: +449.0, per_term: +28.0389, per_day: -0.3606),   # 小寒（しょうかん）
+          daikan: Row.new(stack: +823.0, per_term: +22.6998, per_day: -0.3519),    # 大寒（だいかん）
+          risshun: Row.new(stack: +1122.0, per_term: +17.8923, per_day: -0.4068),  # 立春（りっしゅん）
+          usui: Row.new(stack: +1346.0, per_term: +11.7966, per_day: -0.3998),     # 雨水（うすい）
+          keichitsu: Row.new(stack: +1481.0, per_term: +5.7986, per_day: -0.3998), # 啓蟄（けいちつ）
+          shunbun: Row.new(stack: +1526.0, per_term: -0.2433, per_day: -0.3779),   # 春分（しゅんぶん）
+          seimei: Row.new(stack: +1481.0, per_term: -6.1254, per_day: -0.3634),    # 清明（せいめい）
+          kokuu: Row.new(stack: +1346.0, per_term: -12.2048, per_day: -0.2987),    # 穀雨（こくう）
+          rikka: Row.new(stack: +1122.0, per_term: -16.9060, per_day: -0.2919),    # 立夏（りっか）
+          shouman: Row.new(stack: +823.0, per_term: -21.5362, per_day: -0.2854),   # 小満（しょうまん）
+          boushu: Row.new(stack: +449.0, per_term: -26.0498, per_day: -0.2854),    # 芒種（ぼうしゅ）
+          geshi: Row.new(stack: 0.0, per_term: -30.3119, per_day: +0.2854),        # 夏至（げし）
+          shousho: Row.new(stack: -449.0, per_term: -25.8126, per_day: +0.2919),   # 小暑（しょうしょ）
+          taisho: Row.new(stack: -823.0, per_term: -21.2454, per_day: +0.2987),    # 大暑（たいしょ）
+          risshuu: Row.new(stack: -1122.0, per_term: -17.0296, per_day: +0.3634),  # 立秋（りっしゅう）
+          shosho: Row.new(stack: -1346.0, per_term: -11.4744, per_day: +0.3779),   # 処暑（しょしょ）
+          hakuro: Row.new(stack: -1481.0, per_term: -5.6429, per_day: +0.3779),    # 白露（はくろ）
+          shuubun: Row.new(stack: -1526.0, per_term: +0.1432, per_day: +0.3998),   # 秋分（しゅうぶん）
+          kanro: Row.new(stack: -1481.0, per_term: +6.1488, per_day: +0.4068),     # 寒露（かんろ）
+          soukou: Row.new(stack: -1346.0, per_term: +12.6336, per_day: +0.3519),   # 霜降（そうこう）
+          rittou: Row.new(stack: -1122.0, per_term: +17.8043, per_day: +0.3606),   # 立冬（りっとう）
+          shousetsu: Row.new(stack: -823.0, per_term: +23.0590, per_day: +0.3695), # 小雪（しょうせつ）
+          taisetsu: Row.new(stack: -449.0, per_term: +28.4618, per_day: +0.3695)   # 大雪（たいせつ）
         }.freeze
 
         #
-        # 24気損益眺朒（ちょうじく）数を特定する
+        # 24気損益眺朒（ちょうじく）数の行データを特定する
         #
         # @param [Integer] index 連番（二十四節気）
         #
-        # @return [Adjustment::Item] 24気損益眺朒（ちょうじく）数
+        # @return [Row] 行データ
         #
         def self.specify(index:)
           key = Cycle::SolarTerm::ORDER[index]

data/lib/zakuro/version/senmyou/stella/solar/average.rb

@@ -1,9 +1,15 @@
 # frozen_string_literal: true
 
+require_relative '../../../../calculation/stella/solar/abstract_average'
+
 require_relative '../../const/remainder'
 
+require_relative '../../cycle/solar_term'
+
 require_relative '../origin/winter_solstice'
 
+require_relative './location'
+
 # :nodoc:
 module Zakuro
   # :nodoc:
@@ -11,19 +17,17 @@ module Zakuro
     # :nodoc:
     module Solar
       #
-      # Average 常気（太陽軌道平均）
+      # Average 平気（太陽軌道平均）
       #
-      class Average
-        # @return [Remainder] 気策
-        SOLAR_TERM_AVERAGE = Const::Remainder::Solar::SOLAR_TERM_AVERAGE
-
+      class Average < Calculation::Solar::AbstractAverage
         #
         # 初期化
         #
         # @param [Integer] western_year 西暦年
         #
         def initialize(western_year:)
-          @solar_term = Average.first_solar_term(western_year: western_year)
+          solar_term = Average.first_solar_term(western_year: western_year)
+          super(solar_term: solar_term)
         end
 
         #
@@ -34,16 +38,7 @@ module Zakuro
         # @return [Array<Month>] 1年データ
         #
         def set(annual_range:)
-          # 次月と比較しながら当月の二十四節気を決める
-          # NOTE: 最後の月は処理できない（=計算外の余分な月が最後に必要である）
-          annual_range.each_cons(2) do |(current_month, next_month)|
-            set_solar_term(
-              current_month: current_month,
-              next_month: next_month
-            )
-          end
-
-          annual_range
+          super(annual_range: annual_range)
         end
 
         #
@@ -60,7 +55,7 @@ module Zakuro
           # 二十四節気（冬至）
           solar_term = Cycle::SolarTerm.new(index: 0, remainder: winter_solstice)
 
-          first_solar_term_index = Average.calc_fist_solar_term_index(western_year: western_year)
+          first_solar_term_index = Average.calc_first_solar_term_index(western_year: western_year)
 
           # 対象の二十四節気まで戻す
           solar_term.prev_by_index(first_solar_term_index)
@@ -82,7 +77,7 @@ module Zakuro
         #
         # @return [Integer] 二十四節気番号
         #
-        def self.calc_fist_solar_term_index(western_year:)
+        def self.calc_first_solar_term_index(western_year:)
           # 天正閏余
           lunar_age = Origin::LunarAge.get(western_year: western_year)
 
@@ -92,83 +87,10 @@ module Zakuro
           solar_term_index = solar_location.index
 
           # 入定気の一つ後の二十四節気まで戻す（ただし11月経朔が二十四節気上にある場合は戻さない）
-          solar_term_index += 1 unless solar_location.remainder == Cycle::Remainder.new(total: 0)
+          solar_term_index += 1 unless solar_location.remainder.day.zero?
 
           solar_term_index
         end
-
-        # :reek:TooManyStatements { max_statements: 7 }
-
-        #
-        # 月内（当月朔日から当月末日（来月朔日の前日）の間）に二十四節気があるか
-        # @note 大余60で一巡するため 以下2パターンがある
-        #   * current_month <= next_month : (二十四節気) >= current_month && (二十四節気) < next_month
-        #   * current_month > next_month  : (二十四節気) >= current_month || (二十四節気) < next_month
-        #
-        # @param [Remainder] solar_term 二十四節気
-        # @param [Remainder] current_month 月初
-        # @param [Remainder] next_month 月末
-        #
-        # @return [True] 対象の二十四節気がある
-        # @return [False] 対象の二十四節気がない
-        #
-        def self.in_solar_term?(solar_term:, current_month:, next_month:)
-          # 大余で比較する
-          target_time = solar_term.day
-          current_month_time = current_month.day
-          next_month_time = next_month.day
-          current_month_over = (target_time >= current_month_time)
-          next_month_under = (target_time < next_month_time)
-
-          return current_month_over && next_month_under if current_month_time <= next_month_time
-
-          current_month_over || next_month_under
-        end
-
-        private
-
-        # :reek:TooManyStatements { max_statements: 8 }
-
-        #
-        # 二十四節気を設定する
-        #
-        # @param [Month] current_month 当月
-        # @param [Month] next_month 次月
-        #
-        def set_solar_term(current_month:, next_month:)
-          # 安全策として無限ループは回避する
-          # * 最大試行回数：4回（設定なし => 設定あり => 設定あり => 設定なし）
-          # * 閏月は1回しか設定しない
-          # * 最大2回設定する（中気・節気）
-          (0..3).each do |_index|
-            in_range = Average.in_solar_term?(
-              solar_term: @solar_term.remainder, current_month: current_month.remainder,
-              next_month: next_month.remainder
-            )
-
-            # 範囲外
-            unless in_range
-              # 1つ以上設定されていれば切り上げる（一つ飛ばしで二十四節気を設定することはない）
-              break unless current_month.empty_solar_term?
-
-              next_solar_term
-              next
-            end
-
-            current_month.add_term(term: @solar_term.clone)
-            next_solar_term
-
-            # 宣明暦は最大2つまで
-            break if current_month.solar_term_size == 2
-          end
-        end
-
-        #
-        # 次の二十四節気に移る
-        #
-        def next_solar_term
-          @solar_term.next_term!
-        end
       end
     end
   end

data/lib/zakuro/version/senmyou/stella/solar/location.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative '../../../../calculation/stella/solar/abstract_location'
+
 require_relative '../../const/remainder'
 
 require_relative './interval'
@@ -13,150 +15,45 @@ module Zakuro
       #
       # Location 入定気
       #
-      class Location
+      class Location < Calculation::Solar::AbstractLocation
         # @return [Cycle::Remainder] 弦
         QUARTER = Const::Remainder::Solar::QUARTER
 
-        # @return [True] 計算済み（前回計算あり）
-        # @return [False] 未計算（初回計算）
-        attr_reader :calculated
-        # @return [Integer] 連番
-        attr_reader :index
-        # @return [Cycle::Remainder] 大余小余
-        attr_reader :remainder
-
         #
         # 初期化
         #
         # @param [Cycle::Remainder] lunar_age 天正閏余（大余小余）
         #
-        def initialize(lunar_age: Cycle::Remainder.new)
-          @calculated = false
-          @index = -1
-          @remainder = lunar_age.clone
+        def initialize(lunar_age:)
+          super(lunar_age: lunar_age, quarter: QUARTER)
         end
 
-        #
-        # 入定気を計算する
-        #
-        def run
-          return current if calculated
-
-          first
-        end
+        # :reek:UtilityFunction
 
         #
-        # 無効かどうか
-        #
-        # @return [True] 無効
-        # @return [False] 有効
-        #
-        def invalid?
-          @index == -1
-        end
-
-        #
-        # 弦の分だけ太陽地点を進める
-        #
-        def add_quarter
-          @remainder.add!(QUARTER)
-        end
-
-        private
-
-        #
-        # 2回目以降の計算をする
-        #
-        def current
-          decrease_recursively
-        end
-
+        # 二十四節気番号に対応する入気定日加減数を返す
         #
-        # 初回計算する
+        # @note 継承のためクラスメソッドにしない
         #
-        def first
-          define_first
-          @calculated = true
-        end
-
+        # @param [Integer] index 二十四節気番号
         #
-        # 初回の入定気を定める
+        # @return [Cycle::Remainder] 入気定日加減数
         #
-        def define_first
-          # 入定気の起算方法
-          # 概要:
-          #  * 太陽の運行による補正値は、二十四節気の気ごとに定められる
-          #  * 11月経朔の前にある気を求め、それから11月経朔との間隔を求める
-          #  * 気ごとの補正値と、気から11月経朔までにかかる補正値を求める
-          # 前提:
-          #  * 11月経朔に関わる二十四節気は、時系列から順に、小雪・大雪・冬至である
-          #  * 小雪〜大雪の間隔は小雪定数で、大雪〜冬至の間隔は大雪定数で決められている（24気損益眺朒（ちょうじく）数のこと）
-          #  * 11月経朔は、この小雪〜冬至の間のいずれかにある
-          # 計算:
-          # 2パターンある
-          #  (a) 大雪〜冬至にある場合
-          #   *「大雪定数 >= 天正閏余」の場合を指す
-          #   * * NOTE 資料では「より大きい（>）」とされるが、大雪そのものの場合は大雪から起算すべき
-          #   * この場合は、大雪〜経朔の間隔を求める
-          #  (b) 小雪〜大雪にある場合
-          #   *「大雪定数 < 天正閏余」の場合を指す
-          #   * この場合は、小雪〜経朔の間隔を求める
-
-          # NOTE: 上記パターンとは別に、稀だが立冬のパターンも存在する
-          # この場合は比較方法はそのままに立冬〜経朔の間隔を求める
-
-          # 大雪（23）/小雪（22）/立冬（21）
-          [23, 22, 21].each do |index|
-            prev(index: index)
-
-            break unless invalid?
-          end
-
-          # 立冬（21）を超える天正閏余は成立し得ない（1朔望月をはるかに超えることになる）
-          return unless invalid?
-
-          raise ArgumentError.new, 'invalid winster solstice age'
+        def interval(index:)
+          Interval.index_of(index)
         end
 
-        #
-        # 大余小余の分だけ二十四節気を遡る
-        #
-        # @param [Integer] index 二十四節気番号
-        #
-        def prev(index:)
-          interval = Interval.index_of(index)
-          if remainder > interval
-            @remainder.sub!(interval)
-            return
-          end
-
-          # 入定気が確定する
-          @remainder = interval.sub(@remainder)
-          @index = index
-        end
+        # :reek:UtilityFunction
 
         #
-        # 二十四節気番号を次に進める
+        # 入気定日加減数の要素数を返す
         #
-        def next_index
-          @index += 1
-          @index = 0 if @index >= Interval.size
-        end
-
+        # @note 継承のためクラスメソッドにしない
         #
-        # 二十四節気を減算する
+        # @return [Integer] 入気定日加減数の要素数
         #
-        def decrease_recursively
-          interval = Interval.index_of(@index)
-          # 現在の二十四節気に留まる
-          return if remainder < interval
-
-          @remainder.sub!(interval)
-
-          next_index
-
-          # 再帰
-          decrease_recursively
+        def interval_size
+          Interval.size
         end
       end
     end

data/lib/zakuro/version/senmyou/stella/solar/value.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative '../../../../calculation/stella/solar/choukei_value'
+
 require_relative '../../const/number'
 
 require_relative './adjustment'
@@ -27,111 +29,10 @@ module Zakuro
         def self.get(solar_location:)
           remainder = solar_location.remainder
 
-          adjustment = Adjustment.specify(index: solar_location.index)
-          # 損益率/眺朒（ちょうじく）数
-          # パラメータ:
-          #  a: 眺朒（ちょうじく）数の初日の値
-          #  b: 損益率初日の値
-          #  c: 損益率の毎日の差
-          #  n: 定気の日から数えた日数
-
-          day_stack = calc_day_stack(remainder: remainder, adjustment: adjustment)
-
-          month_stack = calc_month_stack(stack: adjustment.stack, day: remainder.day,
-                                         per_term: adjustment.per_term, per_day:
-                                         adjustment.per_day)
-
-          # 冬至であれば眺朒数がプラスになり続けて損益率が「益」で、小雪であればマイナスの眺朒数がプラスされ続けて「損」
-          month_stack + day_stack
-        end
-
-        #
-        # 損益率を求める
-        #
-        # @param [Remainder] remainder 入定気
-        # @param [Adjustment::Item] adjustment 24気損益眺朒（ちょうじく）数
-        #
-        # @return [Integer] 損益率
-        #
-        def self.calc_day_stack(remainder:, adjustment:)
-          per_term = adjustment.per_term
-          per_day = adjustment.per_day
-          sign, ratio = calc_ratio(day: remainder.day, per_term: per_term, per_day: per_day)
-
-          calc_day_stack_from_ratio(sign: sign, ratio: ratio,
-                                    minute: remainder.minute)
-        end
-        private_class_method :calc_day_stack
-
-        # :reek:TooManyStatements { max_statements: 6 }
-
-        #
-        # 大余に対応する損益率を求める
-        #   損益率 = b + n * c
-        #
-        # @param [Integer] day 大余
-        # @param [Integer] per_term 眺朒（ちょうじく）数
-        # @param [Integer] per_day 毎日差
-        #
-        # @return [Integer] 正負
-        # @return [Integer] 大余に対応する損益率
-        #
-        def self.calc_ratio(day:, per_term:, per_day:)
-          ratio = per_term + day * per_day
-          sign = 1
-          if ratio.negative?
-            sign = -1
-            ratio *= sign
-          end
-          # 小数点以下は無視する
-          ratio = ratio.floor
-
-          [sign, ratio]
-        end
-        private_class_method :calc_ratio
-
-        #
-        # 小余を含めた損益率を求める
-        #
-        # @param [Integer] sign 正負（大余に対応する損益率）
-        # @param [Integer] ratio 大余に対応する損益率
-        # @param [Integer] minute 小余
-        #
-        # @return [Integer] 小余を含めた損益率
-        #
-        def self.calc_day_stack_from_ratio(sign:, ratio:, minute:)
-          minute_stack = ratio * minute
-          day_stack = (minute_stack / DAY).floor
-          # 四捨五入
-          # NOTE 資料では「この余りが4200をこえていれば切り上げる」とあり「>=」とした
-          # 1612年の7月（慶長17年7月）が境界値4200だが、繰り上げを行なっていたため
-          day_stack += 1 if minute_stack % DAY >= (DAY / 2)
-          day_stack *= sign
-
-          day_stack
-        end
-        private_class_method :calc_day_stack_from_ratio
-
-        # :reek:LongParameterList { max_params: 4 }
+          row = Adjustment.specify(index: solar_location.index)
 
-        #
-        # 眺朒（ちょうじく）数を求める
-        #   眺朒（ちょうじく）数 = a + (n * b) + (1/2)n(n-1)c
-        #
-        # @param [Integer] stack 眺朒（ちょうじく）積
-        # @param [Integer] day 大余
-        # @param [Integer] per_term 眺朒（ちょうじく）数
-        # @param [Integer] per_day 毎日差f
-        #
-        # @return [Integer] 眺朒（ちょうじく）数
-        #
-        def self.calc_month_stack(stack:, day:, per_term:, per_day:)
-          month_stack = stack + day * per_term + \
-                        (1 / 2.0) * (day * (day - 1) * per_day)
-          # 切り捨て（プラスマイナスに関わらず小数点以下切り捨て）
-          month_stack.negative? ? month_stack.ceil : month_stack.floor
+          Calculation::Solar::ChoukeiValue.get(remainder: remainder, row: row)
         end
-        private_class_method :calc_month_stack
       end
     end
   end

data/lib/zakuro/version/version_class_resolver.rb

@@ -1,5 +1,17 @@
 # frozen_string_literal: true
 
+require_relative './genka/cycle/remainder'
+require_relative './genka/cycle/solar_term'
+require_relative './genka/range/annual_range'
+
+require_relative './gihou/cycle/remainder'
+require_relative './gihou/cycle/solar_term'
+require_relative './gihou/range/annual_range'
+
+require_relative './daien/cycle/remainder'
+require_relative './daien/cycle/solar_term'
+require_relative './daien/range/annual_range'
+
 require_relative './senmyou/cycle/remainder'
 require_relative './senmyou/cycle/solar_term'
 require_relative './senmyou/range/annual_range'

data/lib/zakuro/version.rb

@@ -3,5 +3,5 @@
 # :nodoc:
 module Zakuro
   # @return [String] library version
-  VERSION = '0.1.5'
+  VERSION = '0.5.0'
 end

data/lib/zakuro/version_factory.rb

@@ -4,7 +4,7 @@ require_relative './era/japan/reki'
 require_relative './era/western'
 require_relative './version/genka/genka'
 require_relative './version/gihou/gihou'
-require_relative './version/taien/taien'
+require_relative './version/daien/daien'
 require_relative './version/senmyou/senmyou'
 require_relative './version/joukyou/joukyou'
 require_relative './version/houryaku/houryaku'