zakuro 0.1.5 → 0.2.0

data/lib/zakuro/version/senmyou/range/annual_range.rb

@@ -1,17 +1,8 @@
 # frozen_string_literal: true
 
-require_relative '../../../output/logger'
-require_relative '../cycle/remainder'
-require_relative '../cycle/solar_term'
-require_relative '../../../calculation/monthly/initialized_month'
+require_relative '../../../calculation/range/medieval_annual_range'
 require_relative '../monthly/lunar_phase'
-require_relative '../stella/lunar/location'
-require_relative '../stella/lunar/value'
 require_relative '../stella/solar/average'
-require_relative '../stella/solar/location'
-require_relative '../stella/solar/value'
-require_relative '../stella/origin/lunar_age'
-require_relative '../stella/origin/average_november'
 
 # :nodoc:
 module Zakuro
@@ -23,11 +14,6 @@ module Zakuro
       # AnnualRange 年間範囲
       #
       module AnnualRange
-        # @return [Output::Logger] ロガー
-        LOGGER = Output::Logger.new(location: 'annual_range')
-
-        # :reek:TooManyStatements { max_statements: 6 }
-
         #
         # 一覧取得する
         #
@@ -40,71 +26,13 @@ module Zakuro
         # @return [Array<Month>] 1年データ
         #
         def self.get(context:, western_year:)
-          annual_range = initialized_annual_range(context: context, western_year: western_year)
-
-          apply_big_and_small_of_the_month(annual_range: annual_range)
-
-          solar_average = Solar::Average.new(western_year: western_year)
-          solar_average.set(annual_range: annual_range)
-
-          # 月間隔を取得するためだけの末尾要素を削除
-          annual_range.pop
-
-          initialize_month_label(annual_range: annual_range)
-        end
-
-        #
-        # 1年データを取得する
-        #
-        # @param [Context] context 暦コンテキスト
-        # @param [Integer] western_year 西暦年
-        #
-        # @return [Array<Month>] 1年データ
-        #
-        def self.initialized_annual_range(context:, western_year:)
-          result = []
           lunar_phase = Monthly::LunarPhase.new(western_year: western_year)
+          solar_average = Solar::Average.new(western_year: western_year)
 
-          # 14ヶ月分を生成する（閏年で最大13ヶ月 + 末月の大小/二十四節気を求めるために必要な月）
-          (0..13).each do |_index|
-            adjusted = lunar_phase.next_month
-
-            result.push(
-              Calculation::Monthly::InitializedMonth.new(
-                context: context,
-                month_label: Calculation::Monthly::MonthLabel.new,
-                first_day: Calculation::Monthly::FirstDay.new(remainder: adjusted),
-                phase_index: 0
-              )
-            )
-          end
-
-          result
-        end
-        private_class_method :initialized_annual_range
-
-        #
-        # 1年データの各月に月の大小を設定する
-        #
-        # @param [Array<Month>] annual_range 1年データ
-        #
-        def self.apply_big_and_small_of_the_month(annual_range:)
-          # NOTE: 最後の月は処理できない（=計算外の余分な月が最後に必要である）
-          annual_range.each_cons(2) do |(current_month, next_month)|
-            current_month.eval_many_days(next_month_day: next_month.remainder.day)
-          end
-        end
-        private_class_method :apply_big_and_small_of_the_month
-
-        #
-        # 月表示情報を更新する
-        #
-        # @param [Array<Month>] annual_range 1年データ
-        #
-        def self.initialize_month_label(annual_range:)
-          annual_range.each(&:rename_month_label_by_solar_term)
+          Calculation::Range::MedievalAnnualRange.get(
+            context: context, lunar_phase: lunar_phase, solar_average: solar_average
+          )
         end
-        private_class_method :initialize_month_label
       end
     end
   end

data/lib/zakuro/version/senmyou/stella/lunar/localization.rb

@@ -12,7 +12,7 @@ module Zakuro
       # Localization 入暦特定
       #
       module Localization
-        # @return [Integer] 1近日点
+        # @return [Integer] 1近点月
         ANOMALISTIC_MONTH = Const::Number::Cycle::ANOMALISTIC_MONTH
         # @return [Integer] 積年
         TOTAL_YEAR = Const::Number::Stack::TOTAL_YEAR
@@ -34,8 +34,7 @@ module Zakuro
           total_year = TOTAL_YEAR + western_year - BEGIN_YEAR
 
           # 通積分 - 天正閏余
-          total_day = \
-            total_year * YEAR - lunar_age.to_minute
+          total_day = total_year * YEAR - lunar_age.to_minute
 
           Cycle::LunarRemainder.new(total: (total_day % ANOMALISTIC_MONTH))
         end

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

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative '../../../../calculation/stella/lunar/abstract_location'
+
 require_relative '../../const/remainder'
 
 require_relative './localization'
@@ -13,38 +15,28 @@ module Zakuro
       #
       # Location 入暦
       #
-      class Location
-        # @return [Cycle::LunarRemainder] 暦中日
+      class Location < Calculation::Lunar::AbstractLocation
+        # @return [Cycle::LunarRemainder] 暦中日（1近点月の半分）
         HALF_ANOMALISTIC_MONTH = Const::Remainder::Lunar::HALF_ANOMALISTIC_MONTH
         # @return [Cycle::LunarRemainder] 入暦上限
         LIMIT = Const::Remainder::Lunar::LIMIT
         # @return [Cycle::LunarRemainder] 弦
         QUARTER = Const::Remainder::Lunar::QUARTER
 
-        # @return [True] 計算済み（前回計算あり）
-        # @return [False] 未計算（初回計算）
-        attr_reader :calculated
-        # @return [Integer] 西暦年
-        attr_reader :western_year
-        # @return [True] 進（遠地点より数える）
-        # @return [False] 退（近地点より数える）
+        # @return [True] 進
+        # @return [False] 退
         attr_reader :forward
-        # @return [Cycle::LunarRemainder] 大余小余（初回：昨年天正閏余）
-        attr_reader :remainder
 
         #
         # 初期化
         #
         # @param [Cycle::LunarRemainder] lunar_age 天正閏余（大余小余）
         # @param [Integer] western_year 西暦年
-        # @param [True, False] forward 進（遠地点より数える）/退（近地点より数える）
         #
         def initialize(lunar_age:, western_year:)
-          @calculated = false
-          @western_year = western_year
+          super(lunar_age: lunar_age, western_year: western_year)
           # 進
           @forward = true
-          @remainder = lunar_age
         end
 
         #
@@ -64,7 +56,7 @@ module Zakuro
         # 弦の分だけ月地点を進める
         #
         def add_quarter
-          @remainder.add!(QUARTER)
+          remainder.add!(QUARTER)
         end
 
         private
@@ -74,9 +66,9 @@ module Zakuro
         #
         def first
           @remainder = Localization.first_remainder(
-            lunar_age: @remainder, western_year: @western_year
+            lunar_age: remainder, western_year: western_year
           )
-          # 初回は0始まりで計算しているので、暦中日を用いる
+          # 初回は0始まりで計算しているので、入暦上限ではなく暦中日を用いる
           decrease(limit: HALF_ANOMALISTIC_MONTH)
           # 1始まりに改める
           one_based
@@ -90,17 +82,10 @@ module Zakuro
         # @param [Cycle::LunarRemainder] limit 上限
         #
         def decrease(limit:)
-          return if @remainder < limit
-
-          @remainder.sub!(HALF_ANOMALISTIC_MONTH)
-          @forward = !@forward
-        end
+          return if remainder < limit
 
-        #
-        # 1始まりにする
-        #
-        def one_based
-          @remainder.add!(Cycle::Remainder.new(day: 1, minute: 0, second: 0))
+          remainder.sub!(HALF_ANOMALISTIC_MONTH)
+          @forward = !forward
         end
       end
     end

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

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative '../../../../calculation/stella/lunar/choukei_value'
+
 require_relative '../../cycle/remainder'
 
 require_relative './adjustment'
@@ -34,12 +36,12 @@ module Zakuro
           row = Adjustment.specify(forward: forward, day: day, minute: minute)
 
           value = row.value
-          denominator = row.denominator
 
           minus_minute = Adjustment.minus_minute(day: day, minute: minute)
 
-          day = calc_day(per: value.per, denominator: denominator,
-                         minute: minus_minute)
+          day = Calculation::Lunar::ChoukeiValue.rounded_day(
+            per: value.per, denominator: row.denominator, minute: minus_minute
+          )
 
           value.stack + day
         end
@@ -58,31 +60,6 @@ module Zakuro
           raise ArgumentError, "unmatch parameter type: #{remainder.class}"
         end
         private_class_method :valid?
-
-        # :reek:TooManyStatements { max_statements: 9 }
-
-        #
-        # 累計値（大余）を作成する
-        #
-        # @param [Integer] per 入暦（1-14）
-        # @param [Integer] denominator 小余の分母
-        # @param [Integer] minute 小余
-        #
-        # @return [Integer] 累計値（大余）
-        #
-        def self.calc_day(per:, denominator:, minute:)
-          remainder_minute = (per * minute).to_f
-          day = remainder_minute / denominator
-          # 切り捨て（プラスマイナスに関わらず小数点以下切り捨て）
-          day = day.negative? ? day.ceil : day.floor
-          sign = remainder_minute.negative? ? -1 : 1
-          remainder_day = (sign * remainder_minute) % denominator
-          # 四捨五入（8400ならその半分の4200以上を繰り上げる）
-          day += sign if remainder_day >= (denominator / 2)
-
-          day
-        end
-        private_class_method :calc_day
       end
     end
   end

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
 
         #
@@ -96,79 +91,6 @@ module Zakuro
 
           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