zakuro 0.7.2 → 0.8.0

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

@@ -14,24 +14,26 @@ module Zakuro
       # AnnualRange 年間範囲
       #
       module AnnualRange
-        #
-        # 一覧取得する
-        #
-        #   * 対象年に対して、前年11月-当年11月までを出力する
-        #   * 対象年（西暦）と計算年（元号x年）の紐付けは行わない
-        #
-        # @param [Context::Context] context 暦コンテキスト
-        # @param [Integer] western_year 西暦年
-        #
-        # @return [Array<Month>] 1年データ
-        #
-        def self.get(context:, western_year:)
-          lunar_phase = Monthly::LunarPhase.new(western_year: western_year)
-          solar_average = Solar::Average.new(western_year: western_year)
+        class << self
+          #
+          # 一覧取得する
+          #
+          #   * 対象年に対して、前年11月-当年11月までを出力する
+          #   * 対象年（西暦）と計算年（元号x年）の紐付けは行わない
+          #
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [Integer] western_year 西暦年
+          #
+          # @return [Array<Month>] 1年データ
+          #
+          def get(context:, western_year:)
+            lunar_phase = Monthly::LunarPhase.new(western_year: western_year)
+            solar_average = Solar::Average.new(western_year: western_year)
 
-          Calculation::Range::MedievalAnnualRange.get(
-            context: context, lunar_phase: lunar_phase, solar_average: solar_average
-          )
+            Calculation::Range::MedievalAnnualRange.get(
+              context: context, lunar_phase: lunar_phase, solar_average: solar_average
+            )
+          end
         end
       end
     end

data/lib/zakuro/version/daien/stella/lunar/adjustment.rb

@@ -60,9 +60,10 @@ module Zakuro
           # @return [False] 不一致
           #
           def match?(day:, minute:)
-            return false unless @day == day
+            inner_day = @day
+            return false unless inner_day == day
 
-            return false unless @range.include?(minute: minute)
+            return false unless range.include?(minute: minute)
 
             true
           end
@@ -73,7 +74,7 @@ module Zakuro
           # @return [Integer] 分母
           #
           def denominator
-            @range.denominator
+            range.denominator
           end
         end
 
@@ -111,7 +112,7 @@ module Zakuro
           # @return [False] 含まれない
           #
           def include?(minute:)
-            minute >= @min && minute <= @max
+            minute >= min && minute <= max
           end
 
           #
@@ -120,7 +121,7 @@ module Zakuro
           # @return [Integer] 分母
           #
           def denominator
-            @max - @min
+            max - min
           end
         end
 
@@ -150,7 +151,7 @@ module Zakuro
           # @return [String] 文字
           #
           def to_s
-            "per:#{@per}, stack:#{@stack}"
+            "per:#{per}, stack:#{stack}"
           end
         end
 
@@ -197,44 +198,46 @@ module Zakuro
         ].freeze
         # rubocop:enable Layout/LineLength
 
-        #
-        # 月軌道の補正に必要な基本値を引き当てる
-        #
-        # @param [True, False] forward 進（遠地点より数える）/退（近地点より数える）
-        # @param [Integer] day 大余
-        # @param [Integer] minute 小余
-        #
-        # @return [Row] 補正値
-        #
-        # @raise [ArgumentError] 引数エラー
-        #
-        def self.specify(day:, minute:)
-          LIST.each do |row|
-            # NOTE: 範囲が重複している場合、最初に引き当てたほうを優先する
-            return row if row.match?(day: day, minute: minute)
-          end
+        class << self
+          #
+          # 月軌道の補正に必要な基本値を引き当てる
+          #
+          # @param [True, False] forward 進（遠地点より数える）/退（近地点より数える）
+          # @param [Integer] day 大余
+          # @param [Integer] minute 小余
+          #
+          # @return [Row] 補正値
+          #
+          # @raise [ArgumentError] 引数エラー
+          #
+          def specify(day:, minute:)
+            LIST.each do |row|
+              # NOTE: 範囲が重複している場合、最初に引き当てたほうを優先する
+              return row if row.match?(day: day, minute: minute)
+            end
 
-          raise ArgumentError.new, "invalid parameter: #{day}/#{minute}"
-        end
+            raise ArgumentError.new, "invalid parameter: #{day}/#{minute}"
+          end
 
-        # :reek:ControlParameter
+          # :reek:ControlParameter
 
-        #
-        # 小余の下げ幅を求める
-        #
-        # @param [Integer] day 大余
-        # @param [Integer] minute 小余
-        #
-        # @return [Integer] 小余の下げ幅
-        #
-        def self.minus_minute(day:, minute:)
-          limit = DAY_LIMIT.fetch(day, -1)
-          # 該当なし
-          return minute if limit == -1
+          #
+          # 小余の下げ幅を求める
+          #
+          # @param [Integer] day 大余
+          # @param [Integer] minute 小余
+          #
+          # @return [Integer] 小余の下げ幅
+          #
+          def minus_minute(day:, minute:)
+            limit = DAY_LIMIT.fetch(day, -1)
+            # 該当なし
+            return minute if limit == -1
 
-          return minute unless minute > limit
+            return minute unless minute > limit
 
-          minute - limit
+            minute - limit
+          end
         end
       end
     end

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

@@ -21,22 +21,24 @@ module Zakuro
         # @return [Integer] 年
         YEAR = Const::Number::Cycle::YEAR
 
-        #
-        # 対象年の最初の入暦を求める
-        #
-        # @param [Remainder] lunar_age 天正閏余
-        # @param [Integer] western_year 西暦年
-        #
-        # @return [Cycle::LunarRemainder] 入暦
-        #
-        def self.first_remainder(lunar_age:, western_year:)
-          # 積年の開始から対象年までの年数
-          total_year = TOTAL_YEAR + western_year - BEGIN_YEAR
+        class << self
+          #
+          # 対象年の最初の入暦を求める
+          #
+          # @param [Remainder] lunar_age 天正閏余
+          # @param [Integer] western_year 西暦年
+          #
+          # @return [Cycle::LunarRemainder] 入暦
+          #
+          def first_remainder(lunar_age:, western_year:)
+            # 積年の開始から対象年までの年数
+            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))
+            Cycle::LunarRemainder.new(total: (total_day % ANOMALISTIC_MONTH))
+          end
         end
       end
     end

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

@@ -21,56 +21,59 @@ module Zakuro
 
         # :reek:TooManyStatements { max_statements: 9 }
 
-        #
-        # 月の運行による補正値を算出する
-        #
-        # @param [Cycle::LunarRemainder] remainder 月の大余小余
-        #
-        # @return [Integer] 補正値
-        #
-        def self.get(remainder:)
-          valid?(remainder: remainder)
-
-          day, minute = Calculation::Lunar::ChoukeiValue.remainder_without_second(
-            remainder: remainder
-          )
-
-          # 引き当て
-          row = Adjustment.specify(day: day, minute: minute)
-
-          value = row.value
-
-          # LOGGER.debug("value.per: #{value.per}")
-          # LOGGER.debug("row.denominator: #{row.denominator}")
-          # LOGGER.debug("value.stack: #{value.stack}")
-
-          minus_minute = Adjustment.minus_minute(day: day, minute: minute)
-
-          day = Calculation::Lunar::ChoukeiValue.rounded_day(
-            per: value.per, denominator: row.denominator, minute: minus_minute
-          )
-
-          # LOGGER.debug("day: #{day}")
-
-          value.stack + day
-        end
-
-        #
-        # 大余小余を検証する
-        #
-        # @param [Cycle::LunarRemainder] remainder 大余小余
-        #
-        # @return [True] 正しい（月の位相計算に使う大余小余）
-        # @return [True] 正しくない
-        #
-        # @raise [ArgumentError] 引数エラー
-        #
-        def self.valid?(remainder:)
-          return if remainder.is_a?(Cycle::LunarRemainder)
-
-          raise ArgumentError, "unmatch parameter type: #{remainder.class}"
+        class << self
+          #
+          # 月の運行による補正値を算出する
+          #
+          # @param [Cycle::LunarRemainder] remainder 月の大余小余
+          #
+          # @return [Integer] 補正値
+          #
+          def get(remainder:)
+            valid?(remainder: remainder)
+
+            day, minute = Calculation::Lunar::ChoukeiValue.remainder_without_second(
+              remainder: remainder
+            )
+
+            # 引き当て
+            row = Adjustment.specify(day: day, minute: minute)
+
+            value = row.value
+
+            # LOGGER.debug("value.per: #{value.per}")
+            # LOGGER.debug("row.denominator: #{row.denominator}")
+            # LOGGER.debug("value.stack: #{value.stack}")
+
+            minus_minute = Adjustment.minus_minute(day: day, minute: minute)
+
+            day = Calculation::Lunar::ChoukeiValue.rounded_day(
+              per: value.per, denominator: row.denominator, minute: minus_minute
+            )
+
+            # LOGGER.debug("day: #{day}")
+
+            value.stack + day
+          end
+
+          private
+
+          #
+          # 大余小余を検証する
+          #
+          # @param [Cycle::LunarRemainder] remainder 大余小余
+          #
+          # @return [True] 正しい（月の位相計算に使う大余小余）
+          # @return [True] 正しくない
+          #
+          # @raise [ArgumentError] 引数エラー
+          #
+          def valid?(remainder:)
+            return if remainder.is_a?(Cycle::LunarRemainder)
+
+            raise ArgumentError, "unmatch parameter type: #{remainder.class}"
+          end
         end
-        private_class_method :valid?
       end
     end
   end

data/lib/zakuro/version/daien/stella/origin/average_november.rb

@@ -13,20 +13,22 @@ module Zakuro
       # AverageNovember 11月経
       #
       module AverageNovember
-        #
-        # 11月経朔（冬至が含まれる月の1日）を求める
-        #
-        # @param [Integer] western_year 西暦年
-        #
-        # @return [Remainder] 11月経朔
-        #
-        def self.get(western_year:)
-          # 冬至
-          winter_solstice = WinterSolstice.get(western_year: western_year)
-          # 天正閏余
-          lunar_age = LunarAge.get(western_year: western_year)
+        class << self
+          #
+          # 11月経朔（冬至が含まれる月の1日）を求める
+          #
+          # @param [Integer] western_year 西暦年
+          #
+          # @return [Remainder] 11月経朔
+          #
+          def get(western_year:)
+            # 冬至
+            winter_solstice = WinterSolstice.get(western_year: western_year)
+            # 天正閏余
+            lunar_age = LunarAge.get(western_year: western_year)
 
-          winter_solstice.sub(lunar_age)
+            winter_solstice.sub(lunar_age)
+          end
         end
       end
     end

data/lib/zakuro/version/daien/stella/origin/lunar_age.rb

@@ -28,33 +28,35 @@ module Zakuro
 
         # :reek:TooManyStatements { max_statements: 7 }
 
-        #
-        # 対象年の天正閏余（冬至より前にある11月経朔との差 = 月齢）を算出する
-        # 太陽と月の運動による補正値を算出し、その補正結果を返す
-        #
-        # @param [Integer] western_year 西暦年
-        #
-        # @return [Remainder] 天正閏余
-        #
-        def self.get(western_year:)
-          # 積年の開始から対象年までの年数
-          total = TOTAL_YEAR + western_year - BEGIN_YEAR
+        class << self
+          #
+          # 対象年の天正閏余（冬至より前にある11月経朔との差 = 月齢）を算出する
+          # 太陽と月の運動による補正値を算出し、その補正結果を返す
+          #
+          # @param [Integer] western_year 西暦年
+          #
+          # @return [Remainder] 天正閏余
+          #
+          def get(western_year:)
+            # 積年の開始から対象年までの年数
+            total = TOTAL_YEAR + western_year - BEGIN_YEAR
 
-          # 12朔望月に対する1年の余り（単位:分）
-          remainder_minute = YEAR - (SYNODIC_MONTH * 12)
+            # 12朔望月に対する1年の余り（単位:分）
+            remainder_minute = YEAR - (SYNODIC_MONTH * 12)
 
-          # 朔望月に含まれなかった余り（単位:年）
-          remainder_year = total % SYNODIC_MONTH
+            # 朔望月に含まれなかった余り（単位:年）
+            remainder_year = total % SYNODIC_MONTH
 
-          LOGGER.debug("[01]: #{remainder_year}")
+            LOGGER.debug("[01]: #{remainder_year}")
 
-          # 天正閏余
-          lunar_age = remainder_minute * remainder_year % SYNODIC_MONTH
+            # 天正閏余
+            lunar_age = remainder_minute * remainder_year % SYNODIC_MONTH
 
-          LOGGER.debug("[02]: #{lunar_age}")
+            LOGGER.debug("[02]: #{lunar_age}")
 
-          # 大余・小余に変換する
-          Cycle::Remainder.new(total: lunar_age)
+            # 大余・小余に変換する
+            Cycle::Remainder.new(total: lunar_age)
+          end
         end
       end
     end

data/lib/zakuro/version/daien/stella/origin/winter_solstice.rb

@@ -28,26 +28,28 @@ module Zakuro
 
         # :reek:TooManyStatements { max_statements: 6 }
 
-        #
-        # 対象年の前年の冬至を求める
-        #
-        # @param [Integer] western_year 西暦年
-        #
-        # @return [Remainder] 前年の冬至
-        #
-        def self.get(western_year:)
-          # 積年の開始から対象年までの年数
-          total = TOTAL_YEAR + western_year - BEGIN_YEAR
-          remainder_year = total % SIXTY_DAYS
-
-          LOGGER.debug("[01]:#{remainder_year}")
-
-          # 通余を使う
-          winter_solstice_minute = (remainder_year * REMAINDER_ALL_YEAR) % SIXTY_DAYS
-
-          LOGGER.debug("[02]:#{winter_solstice_minute}")
-
-          Cycle::Remainder.new(total: winter_solstice_minute)
+        class << self
+          #
+          # 対象年の前年の冬至を求める
+          #
+          # @param [Integer] western_year 西暦年
+          #
+          # @return [Remainder] 前年の冬至
+          #
+          def get(western_year:)
+            # 積年の開始から対象年までの年数
+            total = TOTAL_YEAR + western_year - BEGIN_YEAR
+            remainder_year = total % SIXTY_DAYS
+
+            LOGGER.debug("[01]:#{remainder_year}")
+
+            # 通余を使う
+            winter_solstice_minute = (remainder_year * REMAINDER_ALL_YEAR) % SIXTY_DAYS
+
+            LOGGER.debug("[02]:#{winter_solstice_minute}")
+
+            Cycle::Remainder.new(total: winter_solstice_minute)
+          end
         end
       end
     end

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

@@ -76,16 +76,18 @@ module Zakuro
           taisetsu: Row.new(stack: -176.0, per_term: +10.9010, per_day: +0.1886)   # 大雪（たいせつ）
         }.freeze
 
-        #
-        # 24気損益眺朒（ちょうじく）数の行データを特定する
-        #
-        # @param [Integer] index 連番（二十四節気）
-        #
-        # @return [Row] 行データ
-        #
-        def self.specify(index:)
-          key = Cycle::SolarTerm::ORDER[index]
-          Adjustment::MAP[key].clone
+        class << self
+          #
+          # 24気損益眺朒（ちょうじく）数の行データを特定する
+          #
+          # @param [Integer] index 連番（二十四節気）
+          #
+          # @return [Row] 行データ
+          #
+          def specify(index:)
+            key = Cycle::SolarTerm::ORDER[index]
+            Adjustment::MAP[key].clone
+          end
         end
       end
     end

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

@@ -26,7 +26,7 @@ module Zakuro
         # @param [Integer] western_year 西暦年
         #
         def initialize(western_year:)
-          solar_term = Average.first_solar_term(western_year: western_year)
+          solar_term = self.class.first_solar_term(western_year: western_year)
           super(solar_term: solar_term)
         end
 
@@ -41,56 +41,58 @@ module Zakuro
           super(annual_range: annual_range)
         end
 
-        #
-        # 計算開始する二十四節気を求める
-        #
-        # @param [Integer] western_year 西暦年
-        #
-        # @return [SolarTerm] 二十四節気
-        #
-        def self.first_solar_term(western_year:)
-          # 天正冬至
-          winter_solstice = Origin::WinterSolstice.get(western_year: western_year)
-
-          # 二十四節気（冬至）
-          solar_term = Cycle::SolarTerm.new(index: 0, remainder: winter_solstice)
-
-          first_solar_term_index = Average.calc_first_solar_term_index(western_year: western_year)
-
-          # 対象の二十四節気まで戻す
-          solar_term.prev_by_index(first_solar_term_index)
-
-          solar_term
-        end
-
-        # :reek:TooManyStatements { max_statements: 6 }
-
-        #
-        # 計算開始する二十四節気番号を求める
-        #
-        # * 前提として入定気は冬至の手前にある
-        # * 例えば、定気が大雪であれば入定気は大雪の範囲内にある
-        # * 入定気は、定気の開始位置に重複しない限り、常に定気より後にある
-        # * 基本的に定気の一つ前から起算すれば、当時から求めた11月(閏10/閏11月)に二十四節気を割り当てられる
-        #
-        # @param [Integer] western_year 西暦年
-        #
-        # @return [Integer] 二十四節気番号
-        #
-        def self.calc_first_solar_term_index(western_year:)
-          # 天正閏余
-          lunar_age = Origin::LunarAge.get(western_year: western_year)
-
-          solar_location = Solar::Location.new(lunar_age: lunar_age)
-          solar_location.run
-
-          solar_term_index = solar_location.index
-
-          # 入定気の一つ後の二十四節気まで戻す（ただし11月経朔が二十四節気上にある場合は戻さない）
-          # NOTE: 789年で大余0のパターンあり
-          solar_term_index += 1 unless solar_location.remainder.day.zero?
-
-          solar_term_index
+        class << self
+          #
+          # 計算開始する二十四節気を求める
+          #
+          # @param [Integer] western_year 西暦年
+          #
+          # @return [SolarTerm] 二十四節気
+          #
+          def first_solar_term(western_year:)
+            # 天正冬至
+            winter_solstice = Origin::WinterSolstice.get(western_year: western_year)
+
+            # 二十四節気（冬至）
+            solar_term = Cycle::SolarTerm.new(index: 0, remainder: winter_solstice)
+
+            first_solar_term_index = calc_first_solar_term_index(western_year: western_year)
+
+            # 対象の二十四節気まで戻す
+            solar_term.prev_by_index(first_solar_term_index)
+
+            solar_term
+          end
+
+          # :reek:TooManyStatements { max_statements: 6 }
+
+          #
+          # 計算開始する二十四節気番号を求める
+          #
+          # * 前提として入定気は冬至の手前にある
+          # * 例えば、定気が大雪であれば入定気は大雪の範囲内にある
+          # * 入定気は、定気の開始位置に重複しない限り、常に定気より後にある
+          # * 基本的に定気の一つ前から起算すれば、当時から求めた11月(閏10/閏11月)に二十四節気を割り当てられる
+          #
+          # @param [Integer] western_year 西暦年
+          #
+          # @return [Integer] 二十四節気番号
+          #
+          def calc_first_solar_term_index(western_year:)
+            # 天正閏余
+            lunar_age = Origin::LunarAge.get(western_year: western_year)
+
+            solar_location = Solar::Location.new(lunar_age: lunar_age)
+            solar_location.run
+
+            solar_term_index = solar_location.index
+
+            # 入定気の一つ後の二十四節気まで戻す（ただし11月経朔が二十四節気上にある場合は戻さない）
+            # NOTE: 789年で大余0のパターンあり
+            solar_term_index += 1 unless solar_location.remainder.day.zero?
+
+            solar_term_index
+          end
         end
       end
     end