zakuro 0.7.0 → 0.9.0

data/lib/zakuro/calculation/stella/solar/abstract_average.rb

@@ -10,6 +10,9 @@ module Zakuro
       # AbstractAverage 平気（太陽軌道平均）
       #
       class AbstractAverage
+        # @return [Cycle::AbstractSolarTerm] 入定気
+        attr_reader :solar_term
+
         #
         # 初期化
         #
@@ -41,30 +44,32 @@ module Zakuro
 
         # :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 [Cycle::AbstractRemainder] solar_term 二十四節気
-        # @param [Cycle::AbstractRemainder] current_month 月初
-        # @param [Cycle::AbstractRemainder] 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)
+        class << self
+          #
+          # 月内（当月朔日から当月末日（来月朔日の前日）の間）に二十四節気があるか
+          # @note 大余60で一巡するため 以下2パターンがある
+          #   * current_month <= next_month : (二十四節気) >= current_month && (二十四節気) < next_month
+          #   * current_month > next_month  : (二十四節気) >= current_month || (二十四節気) < next_month
+          #
+          # @param [Cycle::AbstractRemainder] solar_term 二十四節気
+          # @param [Cycle::AbstractRemainder] current_month 月初
+          # @param [Cycle::AbstractRemainder] next_month 月末
+          #
+          # @return [True] 対象の二十四節気がある
+          # @return [False] 対象の二十四節気がない
+          #
+          def 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
+            return current_month_over && next_month_under if current_month_time <= next_month_time
 
-          current_month_over || next_month_under
+            current_month_over || next_month_under
+          end
         end
 
         private
@@ -83,8 +88,8 @@ module Zakuro
           # * 閏月は1回しか設定しない
           # * 最大2回設定する（中気・節気）
           (0..3).each do |_index|
-            in_range = AbstractAverage.in_solar_term?(
-              solar_term: @solar_term.remainder, current_month: current_month.remainder,
+            in_range = self.class.in_solar_term?(
+              solar_term: solar_term.remainder, current_month: current_month.remainder,
               next_month: next_month.remainder
             )
 
@@ -97,7 +102,7 @@ module Zakuro
               next
             end
 
-            current_month.add_term(term: @solar_term.clone)
+            current_month.add_term(term: solar_term.clone)
             next_solar_term
 
             # 定気は最大2つまで
@@ -109,7 +114,7 @@ module Zakuro
         # 次の二十四節気に移る
         #
         def next_solar_term
-          @solar_term.next_term!
+          solar_term.next_term!
         end
       end
     end

data/lib/zakuro/calculation/stella/solar/abstract_location.rb

@@ -58,7 +58,7 @@ module Zakuro
         # 弦の分だけ太陽地点を進める
         #
         def add_quarter
-          @remainder.add!(quarter)
+          remainder.add!(quarter)
         end
 
         #
@@ -105,6 +105,8 @@ module Zakuro
         #
         # 初回の入定気を定める
         #
+        # @raise [ArgumentError] 引数エラー
+        #
         def define_first
           # 入定気の起算方法
           # 概要:
@@ -149,12 +151,12 @@ module Zakuro
         def prev(index:)
           interval = interval(index: index)
           if remainder > interval
-            @remainder.sub!(interval)
+            remainder.sub!(interval)
             return
           end
 
           # 入定気が確定する
-          @remainder = interval.sub(@remainder)
+          @remainder = interval.sub(remainder)
           @index = index
         end
 
@@ -163,7 +165,7 @@ module Zakuro
         #
         def next_index
           @index += 1
-          @index = 0 if @index >= interval_size
+          @index = 0 if index >= interval_size
         end
 
         #
@@ -174,7 +176,7 @@ module Zakuro
           # 現在の二十四節気に留まる
           return if remainder < interval
 
-          @remainder.sub!(interval)
+          remainder.sub!(interval)
 
           next_index
 

data/lib/zakuro/calculation/stella/solar/choukei_value.rb

@@ -15,121 +15,121 @@ module Zakuro
         # @return [Output::Logger] ロガー
         LOGGER = Output::Logger.new(location: 'solar_choukei')
 
-        #
-        # 補正値を返す
-        #
-        # @param [Cycle::AbstractRemainder] remainder 大余小余
-        # @param [Adjustment::Row] row 24気損益眺朒（ちょうじく）数
-        #
-        # @return [Integer] 補正値
-        #
-        def self.get(remainder:, row:)
-          # 損益率/眺朒（ちょうじく）数
-          # パラメータ:
-          #  a: 眺朒（ちょうじく）数の初日の値
-          #  b: 損益率初日の値
-          #  c: 損益率の毎日の差
-          #  n: 定気の日から数えた日数
-
-          # LOGGER.debug("row.per_day: #{row.per_day}")
-          # LOGGER.debug("row.stack: #{row.stack}")
-
-          day_stack = calc_day_stack(remainder: remainder, row: row)
-
-          # LOGGER.debug("day_stack: #{day_stack}")
-
-          month_stack = calc_month_stack(row: row, day: remainder.day)
-
-          # LOGGER.debug("month_stack: #{month_stack}")
-
-          # 冬至であれば眺朒数がプラスになり続けて損益率が「益」で、小雪であればマイナスの眺朒数がプラスされ続けて「損」
-          month_stack + day_stack
+        class << self
+          #
+          # 補正値を返す
+          #
+          # @param [Cycle::AbstractRemainder] remainder 大余小余
+          # @param [Adjustment::Row] row 24気損益眺朒（ちょうじく）数
+          #
+          # @return [Integer] 補正値
+          #
+          def get(remainder:, row:)
+            # 損益率/眺朒（ちょうじく）数
+            # パラメータ:
+            #  a: 眺朒（ちょうじく）数の初日の値
+            #  b: 損益率初日の値
+            #  c: 損益率の毎日の差
+            #  n: 定気の日から数えた日数
+
+            # LOGGER.debug("row.per_day: #{row.per_day}")
+            # LOGGER.debug("row.stack: #{row.stack}")
+
+            day_stack = calc_day_stack(remainder: remainder, row: row)
+
+            # LOGGER.debug("day_stack: #{day_stack}")
+
+            month_stack = calc_month_stack(row: row, day: remainder.day)
+
+            # LOGGER.debug("month_stack: #{month_stack}")
+
+            # 冬至であれば眺朒数がプラスになり続けて損益率が「益」で、小雪であればマイナスの眺朒数がプラスされ続けて「損」
+            month_stack + day_stack
+          end
+
+          private
+
+          #
+          # 損益率を求める
+          #
+          # @param [Remainder] remainder 入定気
+          # @param [Adjustment::Row] row 24気損益眺朒（ちょうじく）数
+          #
+          # @return [Integer] 損益率
+          #
+          def calc_day_stack(remainder:, row:)
+            ratio = calc_ratio(day: remainder.day, per_term: row.per_term, per_day: row.per_day)
+
+            # LOGGER.debug("ratio.sign: #{ratio.sign}")
+            # LOGGER.debug("ratio.abs: #{ratio.abs}")
+
+            calc_day_stack_from_ratio(
+              ratio: ratio, minute: remainder.minute, limit: remainder.base_day
+            )
+          end
+
+          #
+          # 大余に対応する損益率を求める
+          #   損益率 = b + n * c
+          #
+          # @param [Integer] day 大余
+          # @param [Integer] per_term 眺朒（ちょうじく）数
+          # @param [Integer] per_day 毎日差
+          #
+          # @return [Type::OldFloat] 大余に対応する損益率
+          #
+          def calc_ratio(day:, per_term:, per_day:)
+            ratio = Type::OldFloat.new(per_term + day * per_day)
+            # 小数点以下は無視する
+            ratio.floor!
+
+            ratio
+          end
+
+          #
+          # 小余を含めた損益率を求める
+          #
+          # @param [Integer] sign 正負（大余に対応する損益率）
+          # @param [Integer] ratio 大余に対応する損益率
+          # @param [Integer] minute 小余
+          #
+          # @return [Integer] 小余を含めた損益率
+          #
+          def calc_day_stack_from_ratio(ratio:, minute:, limit:)
+            minute_stack = ratio.abs * minute
+            day_stack = (minute_stack / limit).floor
+            # 四捨五入
+            # NOTE 資料では「この余りが4200をこえていれば切り上げる」とあり「>=」とした
+            # 1612年の7月（慶長17年7月）が境界値4200だが、繰り上げを行なっていたため
+            day_stack += 1 if minute_stack % limit >= (limit / 2)
+            day_stack *= ratio.sign
+
+            day_stack
+          end
+
+          #
+          # 眺朒（ちょうじく）数を求める
+          #   眺朒（ちょうじく）数 = a + (n * b) + (1/2)n(n-1)c
+          #
+          # @param [Adjustment::Row] row 24気損益眺朒（ちょうじく）数
+          # @param [Integer] day 大余
+          #
+          # @return [Integer] 眺朒（ちょうじく）数
+          #
+          def calc_month_stack(row:, day:)
+            # row.stack: 眺朒（ちょうじく）積
+            # row.per_term: 眺朒（ちょうじく）数
+            # row.per_day: 毎日差
+            month_stack = Type::OldFloat.new(
+              row.stack + day * row.per_term + \
+              (1 / 2.0) * (day * (day - 1) * row.per_day)
+            )
+            # 切り捨て（プラスマイナスに関わらず小数点以下切り捨て）
+            month_stack.floor!
+
+            month_stack.get
+          end
         end
-
-        #
-        # 損益率を求める
-        #
-        # @param [Remainder] remainder 入定気
-        # @param [Adjustment::Row] row 24気損益眺朒（ちょうじく）数
-        #
-        # @return [Integer] 損益率
-        #
-        def self.calc_day_stack(remainder:, row:)
-          ratio = calc_ratio(day: remainder.day, per_term: row.per_term, per_day: row.per_day)
-
-          # LOGGER.debug("ratio.sign: #{ratio.sign}")
-          # LOGGER.debug("ratio.abs: #{ratio.abs}")
-
-          calc_day_stack_from_ratio(
-            ratio: ratio, minute: remainder.minute, limit: remainder.base_day
-          )
-        end
-        private_class_method :calc_day_stack
-
-        #
-        # 大余に対応する損益率を求める
-        #   損益率 = b + n * c
-        #
-        # @param [Integer] day 大余
-        # @param [Integer] per_term 眺朒（ちょうじく）数
-        # @param [Integer] per_day 毎日差
-        #
-        # @return [Type::OldFloat] 大余に対応する損益率
-        #
-        def self.calc_ratio(day:, per_term:, per_day:)
-          ratio = Type::OldFloat.new(per_term + day * per_day)
-          # 小数点以下は無視する
-          ratio.floor!
-
-          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(ratio:, minute:, limit:)
-          minute_stack = ratio.abs * minute
-          day_stack = (minute_stack / limit).floor
-          # 四捨五入
-          # NOTE 資料では「この余りが4200をこえていれば切り上げる」とあり「>=」とした
-          # 1612年の7月（慶長17年7月）が境界値4200だが、繰り上げを行なっていたため
-          day_stack += 1 if minute_stack % limit >= (limit / 2)
-          day_stack *= ratio.sign
-
-          day_stack
-        end
-        private_class_method :calc_day_stack_from_ratio
-
-        #
-        # 眺朒（ちょうじく）数を求める
-        #   眺朒（ちょうじく）数 = a + (n * b) + (1/2)n(n-1)c
-        #
-        # @param [Adjustment::Row] row 24気損益眺朒（ちょうじく）数
-        # @param [Integer] day 大余
-        #
-        # @return [Integer] 眺朒（ちょうじく）数
-        #
-        def self.calc_month_stack(row:, day:)
-          # row.stack: 眺朒（ちょうじく）積
-          # row.per_term: 眺朒（ちょうじく）数
-          # row.per_day: 毎日差
-          month_stack = Type::OldFloat.new(
-            row.stack + day * row.per_term + \
-            (1 / 2.0) * (day * (day - 1) * row.per_day)
-          )
-          # 切り捨て（プラスマイナスに関わらず小数点以下切り捨て）
-          month_stack.floor!
-
-          month_stack.get
-        end
-        private_class_method :calc_month_stack
       end
     end
   end

data/lib/zakuro/calculation/summary/internal/day.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require_relative '../../../calculation/base/day'
+require_relative '../../../era/western/calendar'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Summary
+      #
+      # Day 特定日
+      #
+      module Day
+        class << self
+          #
+          # 日を取得する
+          #
+          # @param [Month] month 月
+          # @param [Western::Calendar] date 現在西暦日
+          #
+          # @return [Calculation::Base::Day] 特定日
+          #
+          def get(month:, date: Western::Calendar.new)
+            first_date = month.western_date
+            days = date - first_date
+            remainder = month.remainder
+            remainder = remainder.add(
+              # 常に参照元のRemainderクラスで生成する
+              remainder.class.new(day: days, minute: 0, second: 0)
+            )
+
+            Calculation::Base::Day.new(
+              number: days + 1, western_date: date, remainder: remainder
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/calculation/summary/internal/month.rb

@@ -2,6 +2,9 @@
 
 require_relative '../../../output/response'
 
+require_relative './day'
+require_relative './option'
+
 # :nodoc:
 module Zakuro
   # :nodoc:
@@ -12,6 +15,8 @@ module Zakuro
       # Month 特定月
       #
       class Month
+        # @return [Context::Context] 暦コンテキスト
+        attr_reader :context
         # @return [Western::Calendar] 西暦開始日
         attr_reader :start_date
         # @return [Western::Calendar] 西暦終了日
@@ -24,12 +29,14 @@ module Zakuro
         #
         # 初期化
         #
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Western::Calendar] start_date 西暦開始日
         # @param [Western::Calendar] last_date 西暦終了日
         # @param [Base::Year] year 年
         # @param [Monthly::Month] month 月
         #
-        def initialize(start_date:, last_date:, year:, month:)
+        def initialize(context:, start_date:, last_date:, year:, month:)
+          @context = context
           @start_date = start_date
           @last_date = last_date
           @year = year
@@ -43,19 +50,14 @@ module Zakuro
         #
         def get
           result = []
-          first_date = @month.western_date.clone
+          first_date = month.western_date.clone
 
-          (0..@month.days).each do |index|
+          (0..month.days).each do |index|
             current_date = first_date.clone + index
 
             next unless include?(date: current_date)
 
-            day = Output::Response::SingleDay.save_single_day(
-              param: Output::Response::SingleDay::Param.new(
-                year: @year, month: @month,
-                date: current_date, days: index
-              )
-            )
+            day = single_day(current_date: current_date)
 
             result.push(day)
           end
@@ -72,12 +74,31 @@ module Zakuro
         # @return [False] 含まない
         #
         def include?(date:)
-          return false if date < @start_date
+          return false if date < start_date
 
-          return false if date > @last_date
+          return false if date > last_date
 
           true
         end
+
+        private
+
+        #
+        # 1日データを取得する
+        #
+        # @param [Western::Calendar] current_date 現在西暦日
+        #
+        # @return [Result::Data::SingleDay] 1日データ
+        #
+        def single_day(current_date:)
+          day = Day.get(month: month, date: current_date)
+
+          options = Option.create(month: month, day: day)
+
+          Output::Response::SingleDay.create(
+            year: year, month: month, day: day, options: options
+          )
+        end
       end
     end
   end

data/lib/zakuro/calculation/summary/internal/operation.rb

@@ -12,86 +12,87 @@ module Zakuro
       # Operation 運用情報
       #
       module Operation
-        #
-        # 運用情報を生成する
-        #
-        # @param [Result::Data::SingleDay] calc_date 和暦日（計算値）
-        #
-        # @return [Result::Operation::Bundle] 運用情報
-        #
-        def self.create(calc_date: Result::Data::SingleDay.new)
-          first_day = calc_date.month.first_day.western_date
-          operation_history = Zakuro::Operation.specify_history(western_date: first_day)
+        class << self
+          #
+          # 運用情報を生成する
+          #
+          # @param [Result::Data::SingleDay] calc_date 和暦日（計算値）
+          #
+          # @return [Result::Operation] 運用情報
+          #
+          def create(calc_date: Result::Data::SingleDay.new)
+            first_day = calc_date.month.first_day.western_date
+            operation_history = Zakuro::Operation.specify_history(western_date: first_day)
 
-          operation_month = create_operation_month(operation_history: operation_history)
+            operation_month = create_operation_month(operation_history: operation_history)
 
-          Result::Operation::Bundle.new(
-            operated: !operation_history.invalid?, month: operation_month, original: calc_date
-          )
-        end
+            Result::Operation.new(
+              operated: !operation_history.invalid?, month: operation_month, original: calc_date
+            )
+          end
 
-        #
-        # 月履歴集約情報を生成する
-        #
-        # @param [Operation::MonthHistory] operation_history 変更履歴（月）
-        #
-        # @return [Result::Operation::Month::Bundle] 月履歴集約情報
-        #
-        def self.create_operation_month(operation_history: Operation::MonthHistory.new)
-          return Result::Operation::Month::Bundle.new if operation_history.invalid?
+          private
 
-          parent_operation_history = Zakuro::Operation.specify_history_by_id(
-            id: operation_history.parent_id
-          )
+          #
+          # 月履歴集約情報を生成する
+          #
+          # @param [Operation::MonthHistory] operation_history 変更履歴（月）
+          #
+          # @return [Result::Operation::Month] 月履歴情報
+          #
+          def create_operation_month(operation_history: Operation::MonthHistory.new)
+            return Result::Operation::Month.new if operation_history.invalid?
 
-          Result::Operation::Month::Bundle.new(
-            current: create_operation_month_history(operation_history: operation_history),
-            parent: create_operation_month_history(operation_history: parent_operation_history)
-          )
-        end
-        private_class_method :create_operation_month
+            parent_operation_history = Zakuro::Operation.specify_history_by_id(
+              id: operation_history.parent_id
+            )
 
-        #
-        # 月別履歴情報を生成する
-        #
-        # @param [Operation::MonthHistory] operation_history 変更履歴（月）
-        #
-        # @return [Result::Operation::Month::History] 月別履歴情報
-        #
-        def self.create_operation_month_history(operation_history: Operation::MonthHistory.new)
-          return Result::Operation::Month::History.new if operation_history.invalid?
+            Result::Operation::Month.new(
+              current: create_operation_month_history(operation_history: operation_history),
+              parent: create_operation_month_history(operation_history: parent_operation_history)
+            )
+          end
 
-          annotations = create_annnotations(operation_history: operation_history)
+          #
+          # 月別履歴情報を生成する
+          #
+          # @param [Operation::MonthHistory] operation_history 変更履歴（月）
+          #
+          # @return [Result::Operation::Month::History] 月別履歴情報
+          #
+          def create_operation_month_history(operation_history: Operation::MonthHistory.new)
+            return Result::Operation::Month::History.new if operation_history.invalid?
 
-          reference = operation_history.reference
-          Result::Operation::Month::History.new(
-            id: operation_history.id, western_date: operation_history.western_date.format,
-            page: reference.page, number: reference.number, annotations: annotations
-          )
-        end
-        private_class_method :create_operation_month_history
+            annotations = create_annnotations(operation_history: operation_history)
 
-        #
-        # 注釈情報を生成する
-        #
-        # @param [Operation::MonthHistory] operation_history 変更履歴（月）
-        #
-        # @return [Array<Result::Operation::Month::Annotation>] 注釈
-        #
-        def self.create_annnotations(operation_history: Operation::MonthHistory.new)
-          annotations = []
-          operation_history.annotations.each do |annotation|
-            annotations.push(
-              Result::Operation::Month::Annotation.new(
-                description: annotation.description,
-                note: annotation.note
-              )
+            reference = operation_history.reference
+            Result::Operation::Month::History.new(
+              id: operation_history.id, western_date: operation_history.western_date.format,
+              page: reference.page, number: reference.number, annotations: annotations
             )
           end
 
-          annotations
+          #
+          # 注釈情報を生成する
+          #
+          # @param [Operation::MonthHistory] operation_history 変更履歴（月）
+          #
+          # @return [Array<Result::Operation::Month::Annotation>] 注釈
+          #
+          def create_annnotations(operation_history: Operation::MonthHistory.new)
+            annotations = []
+            operation_history.annotations.each do |annotation|
+              annotations.push(
+                Result::Operation::Month::Annotation.new(
+                  description: annotation.description,
+                  note: annotation.note
+                )
+              )
+            end
+
+            annotations
+          end
         end
-        private_class_method :create_annnotations
       end
     end
   end