astronoby 0.7.0 → 0.8.0

data/docs/twilight_times.md

@@ -0,0 +1,123 @@
+# Twilight times
+
+In astronomy, twilight is a period of time when the Sun is already set but
+some of its light still illuminates the atmosphere, making the sky brighter than
+during full night.
+
+We usually define 4 moments when talking about twilight:
+* sunrise/sunset: right when the Sun goes above the horizon or right after it
+  goes below the horizon. The Sun's horizon angle is 0°.
+* civil twilight: when the horizon angle is between 0° and -6°. Usually, during
+  this time, artificial light is not needed yet.
+* nautical twilight: when the horizon angle is between -6° and -12°. When the
+  nautical twilight starts, the difference between the horizon at sea and the
+  sky cannot be seen clearly anymore.
+* astronomical twilight: when the horizon angle is between -12° and -18°. Some
+  stars can be seen during this time.
+
+These moments change every day and depend on the observer's location. They can
+be computed using `Astronoby::TwilightCalculator`.
+
+## Initialization
+
+Once instantiated, the calculator doesn't do anything yet, it waits for your
+instruction.
+
+It takes as key arguments:
+* `observer` (`Astronoby::Observer`): location on Earth of the observer
+* `ephem`: ephemeris to provide the initial raw data
+
+You can learn more about ephemerides on the [Ephem page].
+
+```rb
+ephem = Astronoby::Ephem.load("inpop19a.bsp")
+
+observer = Astronoby::Observer.new(
+  latitude: Astronoby::Angle.from_degrees(41.0082),
+  longitude: Astronoby::Angle.from_degrees(28.9784),
+  elevation: Astronoby::Distance.from_meters(40)
+)
+
+calculator = Astronoby::TwilightCalculator.new(
+  observer: observer,
+  ephem: ephem
+)
+```
+
+You can learn more about observers on the [Observer page].
+
+## `events_between`
+
+This is the main method of the calculator. It provides all the twilight times
+that will happen between two dates.
+
+It returns a `Astronoby::TwilightEvents` object which exposes the 6 following
+instance methods:
+* `#morning_astronomical_twilight_times`: when the rising Sun reaches 18° below
+  the horizon
+* `#morning_nautical_twilight_times`: when the rising Sun reaches 12° below the
+  horizon
+* `#morning_civil_twilight_times`: when the rising Sun reaches 6° below the
+  horizon
+* `#evening_civil_twilight_times`: when the setting Sun reaches 6° below the
+  horizon
+* `#evening_nautical_twilight_times`: when the setting Sun reaches 12° below the
+  horizon
+* `#evening_astronomical_twilight_times`: when the setting Sun reaches 18° below
+  the horizon
+
+```rb
+events = calculator.events_between(
+  Time.utc(2025, 8, 1),
+  Time.utc(2025, 8, 8)
+)
+
+events.morning_civil_twilight_times
+# =>
+# [2025-08-01 02:29:17 UTC,
+#  2025-08-02 02:30:21 UTC,
+#  2025-08-03 02:31:26 UTC,
+#  2025-08-04 02:32:30 UTC,
+#  2025-08-05 02:33:35 UTC,
+#  2025-08-06 02:34:40 UTC,
+#  2025-08-07 02:35:45 UTC]
+```
+
+## `#event_on`
+
+The calculator exposes the instance method `#event_on` to compute the twilight
+times for a given `date` (`Date`) parameter.
+
+It returns a `Astronoby::TwilightEvent` object which exposes the 6 following
+instance methods: `#morning_astronomical_twilight_time`,
+`#morning_nautical_twilight_time`, `#morning_civil_twilight_time`,
+`#evening_civil_twilight_time`, `#evening_nautical_twilight_time` and
+`#evening_astronomical_twilight_time`.
+
+```rb
+event = calculator.event_on(Date.new(2025, 5, 1))
+
+event.morning_astronomical_twilight_time
+# => 2025-05-01 01:17:18 UTC
+
+event.morning_nautical_twilight_time
+# => 2025-05-01 01:56:48 UTC
+
+event.evening_civil_twilight_time
+# => 2025-05-01 17:29:41 UTC
+
+event.evening_nautical_twilight_time
+# => 2025-05-01 18:06:08 UTC
+
+event.evening_astronomical_twilight_time
+# => 2025-05-01 18:45:38 UTC
+```
+
+[Ephem page]: ephem.md
+[Observer page]: observer.md
+
+## See also
+- [Rise, Transit and Set Times](rise_transit_set_times.md) - for sun and moon events
+- [Observer](observer.md) - for location setup
+- [Ephemerides](ephem.md) - for data sources
+- [Moon Phases](moon_phases.md) - for lunar events

data/lib/astronoby/bodies/earth.rb

@@ -17,7 +17,13 @@ module Astronoby
 
     private
 
-    def compute_astrometric(ephem)
+    # Attributes that require Sun data like phase angle or magnitude are not
+    # applicable for Earth.
+    def requires_sun_data?
+      false
+    end
+
+    def compute_astrometric(_ephem)
       Astrometric.new(
         position: Vector[
           Distance.zero,
@@ -35,7 +41,7 @@ module Astronoby
       )
     end
 
-    def compute_mean_of_date(ephem)
+    def compute_mean_of_date(_ephem)
       MeanOfDate.new(
         position: Vector[
           Distance.zero,

data/lib/astronoby/bodies/jupiter.rb

@@ -3,9 +3,26 @@
 module Astronoby
   class Jupiter < SolarSystemBody
     EQUATORIAL_RADIUS = Distance.from_meters(71_492_000)
+    ABSOLUTE_MAGNITUDE = -9.395
 
     def self.ephemeris_segments(_ephem_source)
       [[SOLAR_SYSTEM_BARYCENTER, JUPITER_BARYCENTER]]
     end
+
+    def self.absolute_magnitude
+      ABSOLUTE_MAGNITUDE
+    end
+
+    private
+
+    # Source:
+    #  Title: Computing Apparent Planetary Magnitudes for The Astronomical
+    #    Almanac (2018)
+    #  Authors: Anthony Mallama and James L. Hilton
+    def magnitude_correction_term
+      phase_angle_degrees = phase_angle.degrees
+      -3.7 * 10**-4 * phase_angle_degrees +
+        6.16 * 10**-4 * phase_angle_degrees * phase_angle_degrees
+    end
   end
 end

data/lib/astronoby/bodies/mars.rb

@@ -3,9 +3,26 @@
 module Astronoby
   class Mars < SolarSystemBody
     EQUATORIAL_RADIUS = Distance.from_meters(3_396_200)
+    ABSOLUTE_MAGNITUDE = -1.601
 
     def self.ephemeris_segments(_ephem_source)
       [[SOLAR_SYSTEM_BARYCENTER, MARS_BARYCENTER]]
     end
+
+    def self.absolute_magnitude
+      ABSOLUTE_MAGNITUDE
+    end
+
+    private
+
+    # Source:
+    #  Title: Computing Apparent Planetary Magnitudes for The Astronomical
+    #    Almanac (2018)
+    #  Authors: Anthony Mallama and James L. Hilton
+    def magnitude_correction_term
+      phase_angle_degrees = phase_angle.degrees
+      2.267 * 10**-2 * phase_angle_degrees -
+        1.302 * 10**-4 * phase_angle_degrees * phase_angle_degrees
+    end
   end
 end

data/lib/astronoby/bodies/mercury.rb

@@ -3,9 +3,30 @@
 module Astronoby
   class Mercury < SolarSystemBody
     EQUATORIAL_RADIUS = Distance.from_meters(2_439_700)
+    ABSOLUTE_MAGNITUDE = -0.613
 
     def self.ephemeris_segments(_ephem_source)
       [[SOLAR_SYSTEM_BARYCENTER, MERCURY_BARYCENTER]]
     end
+
+    def self.absolute_magnitude
+      ABSOLUTE_MAGNITUDE
+    end
+
+    private
+
+    # Source:
+    #  Title: Computing Apparent Planetary Magnitudes for The Astronomical
+    #    Almanac (2018)
+    #  Authors: Anthony Mallama and James L. Hilton
+    def magnitude_correction_term
+      phase_angle_degrees = phase_angle.degrees
+      6.328 * 10**-2 * phase_angle_degrees -
+        1.6336 * 10**-3 * phase_angle_degrees * phase_angle_degrees +
+        3.3634 * 10**-5 * phase_angle_degrees**3 -
+        3.4265 * 10**-7 * phase_angle_degrees**4 +
+        1.6893 * 10**-9 * phase_angle_degrees**5 -
+        3.0334 * 10**-12 * phase_angle_degrees**6
+    end
   end
 end

data/lib/astronoby/bodies/moon.rb

@@ -4,6 +4,7 @@ module Astronoby
   class Moon < SolarSystemBody
     SEMIDIAMETER_VARIATION = 0.7275
     EQUATORIAL_RADIUS = Distance.from_meters(1_737_400)
+    ABSOLUTE_MAGNITUDE = 0.28
 
     def self.ephemeris_segments(ephem_source)
       if ephem_source == ::Ephem::SPK::JPL_DE
@@ -32,16 +33,8 @@ module Astronoby
       Events::MoonPhases.phases_for(year: year, month: month)
     end
 
-    attr_reader :phase_angle
-
-    def initialize(instant:, ephem:)
-      super
-      @phase_angle = compute_phase_angle(ephem)
-    end
-
-    # @return [Float] Moon's illuminated fraction
-    def illuminated_fraction
-      @illuminated_fraction ||= (1 + phase_angle.cos) / 2.0
+    def self.absolute_magnitude
+      ABSOLUTE_MAGNITUDE
     end
 
     # @return [Float] Phase fraction, from 0 to 1
@@ -56,31 +49,6 @@ module Astronoby
     #  Author: Jean Meeus
     #  Edition: 2nd edition
     #  Chapter: 48 - Illuminated Fraction of the Moon's Disk
-
-    # @return [Angle] Moon's phase angle
-    def compute_phase_angle(ephem)
-      @phase_angle ||= begin
-        sun = Sun.new(instant: @instant, ephem: ephem)
-        geocentric_elongation = Angle.acos(
-          sun.apparent.equatorial.declination.sin *
-            apparent.equatorial.declination.sin +
-            sun.apparent.equatorial.declination.cos *
-              apparent.equatorial.declination.cos *
-              (
-                sun.apparent.equatorial.right_ascension -
-                  apparent.equatorial.right_ascension
-              ).cos
-        )
-
-        term1 = sun.astrometric.distance.km * geocentric_elongation.sin
-        term2 = astrometric.distance.km -
-          sun.astrometric.distance.km * geocentric_elongation.cos
-        angle = Angle.atan(term1 / term2)
-        Astronoby::Util::Trigonometry
-          .adjustement_for_arctangent(term1, term2, angle)
-      end
-    end
-
     def mean_elongation
       @mean_elongation ||= Angle.from_degrees(
         (
@@ -94,7 +62,32 @@ module Astronoby
     end
 
     def elapsed_centuries
-      (@instant.tt - Epoch::DEFAULT_EPOCH) / Constants::DAYS_PER_JULIAN_CENTURY
+      (@instant.tt - JulianDate::DEFAULT_EPOCH) / Constants::DAYS_PER_JULIAN_CENTURY
+    end
+
+    private
+
+    # Source:
+    #  Title: Computing Apparent Planetary Magnitudes for The Astronomical
+    #    Almanac (2018)
+    #  Authors: Anthony Mallama and James L. Hilton
+    def magnitude_correction_term
+      phase_angle_degrees = phase_angle.degrees
+      if phase_angle_degrees <= 150 && current_phase_fraction <= 0.5
+        2.9994 * 10**-2 * phase_angle_degrees -
+          1.6057 * 10**-4 * phase_angle_degrees**2 +
+          3.1543 * 10**-6 * phase_angle_degrees**3 -
+          2.0667 * 10**-8 * phase_angle_degrees**4 +
+          6.2553 * 10**-11 * phase_angle_degrees**5
+      elsif phase_angle_degrees <= 150 && current_phase_fraction > 0.5
+        3.3234 * 10**-2 * phase_angle_degrees -
+          3.0725 * 10**-4 * phase_angle_degrees**2 +
+          6.1575 * 10**-6 * phase_angle_degrees**3 -
+          4.7723 * 10**-8 * phase_angle_degrees**4 +
+          1.4681 * 10**-10 * phase_angle_degrees**5
+      else
+        super
+      end
     end
   end
 end

data/lib/astronoby/bodies/neptune.rb

@@ -3,9 +3,30 @@
 module Astronoby
   class Neptune < SolarSystemBody
     EQUATORIAL_RADIUS = Distance.from_meters(24_764_000)
+    ABSOLUTE_MAGNITUDE = -7.0
 
     def self.ephemeris_segments(_ephem_source)
       [[SOLAR_SYSTEM_BARYCENTER, NEPTUNE_BARYCENTER]]
     end
+
+    def self.absolute_magnitude
+      ABSOLUTE_MAGNITUDE
+    end
+
+    private
+
+    # Source:
+    #  Title: Computing Apparent Planetary Magnitudes for The Astronomical
+    #    Almanac (2018)
+    #  Authors: Anthony Mallama and James L. Hilton
+    def magnitude_correction_term
+      phase_angle_degrees = phase_angle.degrees
+      if phase_angle_degrees < 133 && @instant.tt > JulianDate::J2000
+        7.944 * 10**-3 * phase_angle_degrees +
+          9.617 * 10**-5 * phase_angle_degrees * phase_angle_degrees
+      else
+        super
+      end
+    end
   end
 end

data/lib/astronoby/bodies/saturn.rb

@@ -3,9 +3,35 @@
 module Astronoby
   class Saturn < SolarSystemBody
     EQUATORIAL_RADIUS = Distance.from_meters(60_268_000)
+    ABSOLUTE_MAGNITUDE = -8.914
 
     def self.ephemeris_segments(_ephem_source)
       [[SOLAR_SYSTEM_BARYCENTER, SATURN_BARYCENTER]]
     end
+
+    def self.absolute_magnitude
+      ABSOLUTE_MAGNITUDE
+    end
+
+    private
+
+    # Source:
+    #  Title: Computing Apparent Planetary Magnitudes for The Astronomical
+    #    Almanac (2018)
+    #  Authors: Anthony Mallama and James L. Hilton
+    def magnitude_correction_term
+      phase_angle_degrees = phase_angle.degrees
+      if phase_angle_degrees <= 6
+        -0.036 -
+          3.7 * 10**-4 * phase_angle_degrees +
+          6.16 * 10**-4 * phase_angle_degrees * phase_angle_degrees
+      else
+        0.026 +
+          2.446 * 10**-4 * phase_angle_degrees +
+          2.672 * 10**-4 * phase_angle_degrees * phase_angle_degrees -
+          1.505 * 10**-6 * phase_angle_degrees**3 +
+          4.767 * 10**-9 * phase_angle_degrees**4
+      end
+    end
   end
 end

data/lib/astronoby/bodies/solar_system_body.rb

@@ -27,42 +27,49 @@ module Astronoby
       segments = ephemeris_segments(ephem.type)
       segment1 = segments[0]
       segment2 = segments[1] if segments.size == 2
-
-      state1 = ephem[*segment1].state_at(instant.terrestrial_time)
-
-      if segment2
-        state2 = ephem[*segment2].state_at(instant.terrestrial_time)
-        position = state1.position + state2.position
-        velocity = state1.velocity + state2.velocity
-      else
-        position = state1.position
-        velocity = state1.velocity
+      cache_key = CacheKey.generate(:geometric, instant, segment1, segment2)
+
+      Astronoby.cache.fetch(cache_key) do
+        state1 = ephem[*segment1].state_at(instant.tt)
+
+        if segment2
+          state2 = ephem[*segment2].state_at(instant.tt)
+          position = state1.position + state2.position
+          velocity = state1.velocity + state2.velocity
+        else
+          position = state1.position
+          velocity = state1.velocity
+        end
+
+        position_vector = Vector[
+          Distance.from_kilometers(position.x),
+          Distance.from_kilometers(position.y),
+          Distance.from_kilometers(position.z)
+        ]
+
+        velocity_vector = Vector[
+          Velocity.from_kilometers_per_day(velocity.x),
+          Velocity.from_kilometers_per_day(velocity.y),
+          Velocity.from_kilometers_per_day(velocity.z)
+        ]
+
+        Geometric.new(
+          position: position_vector,
+          velocity: velocity_vector,
+          instant: instant,
+          target_body: self
+        )
       end
-
-      position_vector = Vector[
-        Distance.from_kilometers(position.x),
-        Distance.from_kilometers(position.y),
-        Distance.from_kilometers(position.z)
-      ]
-
-      velocity_vector = Vector[
-        Velocity.from_kilometers_per_day(velocity.x),
-        Velocity.from_kilometers_per_day(velocity.y),
-        Velocity.from_kilometers_per_day(velocity.z)
-      ]
-
-      Geometric.new(
-        position: position_vector,
-        velocity: velocity_vector,
-        instant: instant,
-        target_body: self
-      )
     end
 
     def self.ephemeris_segments(_ephem_source)
       raise NotImplementedError
     end
 
+    def self.absolute_magnitude
+      nil
+    end
+
     def initialize(ephem:, instant:)
       @instant = instant
       @geometric = compute_geometric(ephem)
@@ -74,6 +81,7 @@ module Astronoby
           target: @geometric,
           ephem: ephem
         )
+      compute_sun(ephem) if requires_sun_data?
     end
 
     def astrometric
@@ -113,10 +121,112 @@ module Astronoby
       )
     end
 
+    # Returns the constellation of the body
+    # @return [Astronoby::Constellation, nil]
+    def constellation
+      @constellation ||= Constellations::Finder.find(
+        Precession.for_equatorial_coordinates(
+          coordinates: astrometric.equatorial,
+          epoch: JulianDate::B1875
+        )
+      )
+    end
+
+    # Source:
+    #  Title: Astronomical Algorithms
+    #  Author: Jean Meeus
+    #  Edition: 2nd edition
+    #  Chapter: 48 - Illuminated Fraction of the Moon's Disk
+    # @return [Astronoby::Angle, nil] Phase angle of the body
+    def phase_angle
+      return unless @sun
+
+      @phase_angle ||= begin
+        geocentric_elongation = Angle.acos(
+          @sun.apparent.equatorial.declination.sin *
+          apparent.equatorial.declination.sin +
+          @sun.apparent.equatorial.declination.cos *
+          apparent.equatorial.declination.cos *
+          (
+            @sun.apparent.equatorial.right_ascension -
+              apparent.equatorial.right_ascension
+          ).cos
+        )
+
+        term1 = @sun.astrometric.distance.km * geocentric_elongation.sin
+        term2 = astrometric.distance.km -
+          @sun.astrometric.distance.km * geocentric_elongation.cos
+        angle = Angle.atan(term1 / term2)
+        Astronoby::Util::Trigonometry
+          .adjustement_for_arctangent(term1, term2, angle)
+      end
+    end
+
+    # Fraction between 0 and 1 of the body's disk that is illuminated.
+    # @return [Float, nil] Body's illuminated fraction, between 0 and 1.
+    def illuminated_fraction
+      return unless phase_angle
+
+      @illuminated_fraction ||= (1 + phase_angle.cos) / 2.0
+    end
+
+    # Source:
+    #  Title: Astronomical Algorithms
+    #  Author: Jean Meeus
+    #  Edition: 2nd edition
+    #  Chapter: 48 - Illuminated Fraction of the Moon's Disk
+    # Apparent magnitude of the body, as seen from Earth.
+    # @return [Float, nil] Apparent magnitude of the body.
+    def apparent_magnitude
+      return unless self.class.absolute_magnitude
+
+      @apparent_magnitude ||= begin
+        body_sun_distance =
+          (astrometric.position - @sun.astrometric.position).magnitude
+        self.class.absolute_magnitude +
+          5 * Math.log10(body_sun_distance.au * astrometric.distance.au) +
+          magnitude_correction_term
+      end
+    end
+
+    # Angular diameter of the body, as seen from Earth. Based on the apparent
+    #   position of the body.
+    # @return [Astronoby::Angle] Angular diameter of the body
+    def angular_diameter
+      @angular_radius ||= begin
+        return if apparent.position.zero?
+
+        Angle.from_radians(
+          Math.asin(self.class::EQUATORIAL_RADIUS.m / apparent.distance.m) * 2
+        )
+      end
+    end
+
     private
 
+    # By default, Solar System bodies expose attributes that are dependent on
+    # the Sun's position, such as phase angle and illuminated fraction.
+    # If a body does not require Sun data, it should override this method to
+    # return false.
+    def requires_sun_data?
+      true
+    end
+
     def compute_geometric(ephem)
       self.class.compute_geometric(ephem: ephem, instant: @instant)
     end
+
+    def compute_sun(ephem)
+      @sun ||= Sun.new(instant: @instant, ephem: ephem)
+    end
+
+    # Source:
+    #  Title: Explanatory Supplement to the Astronomical Almanac
+    #  Authors: Sean E. Urban and P. Kenneth Seidelmann
+    #  Edition: University Science Books
+    #  Chapter: 10.3 - Phases and Magnitudes
+    def magnitude_correction_term
+      -2.5 * Math.log10(illuminated_fraction)
+    end
   end
 end

data/lib/astronoby/bodies/sun.rb

@@ -3,11 +3,28 @@
 module Astronoby
   class Sun < SolarSystemBody
     EQUATORIAL_RADIUS = Distance.from_meters(695_700_000)
+    ABSOLUTE_MAGNITUDE = -26.74
 
     def self.ephemeris_segments(_ephem_source)
       [[SOLAR_SYSTEM_BARYCENTER, SUN]]
     end
 
+    def self.absolute_magnitude
+      ABSOLUTE_MAGNITUDE
+    end
+
+    # Source:
+    #  Title: Explanatory Supplement to the Astronomical Almanac
+    #  Authors: Sean E. Urban and P. Kenneth Seidelmann
+    #  Edition: University Science Books
+    #  Chapter: 10.3 - Phases and Magnitudes
+    # Apparent magnitude of the body, as seen from Earth.
+    # @return [Float] Apparent magnitude of the body.
+    def apparent_magnitude
+      @apparent_magnitude ||=
+        self.class.absolute_magnitude + 5 * Math.log10(astrometric.distance.au)
+    end
+
     # Source:
     #  Title: Astronomical Algorithms
     #  Author: Jean Meeus
@@ -17,7 +34,7 @@ module Astronoby
     # @return [Integer] Equation of time in seconds
     def equation_of_time
       right_ascension = apparent.equatorial.right_ascension
-      t = (@instant.julian_date - Epoch::J2000) / Constants::DAYS_PER_JULIAN_MILLENIA
+      t = (@instant.julian_date - JulianDate::J2000) / Constants::DAYS_PER_JULIAN_MILLENIA
       l0 = (280.4664567 +
         360_007.6982779 * t +
         0.03032028 * t**2 +
@@ -25,7 +42,7 @@ module Astronoby
         t**4 / 15_300 -
         t**5 / 2_000_000) % Constants::DEGREES_PER_CIRCLE
       nutation = Nutation.new(instant: instant).nutation_in_longitude
-      obliquity = TrueObliquity.for_epoch(@instant.julian_date)
+      obliquity = TrueObliquity.at(@instant)
 
       (
         Angle
@@ -37,5 +54,11 @@ module Astronoby
           ).hours * Constants::SECONDS_PER_HOUR
       ).round
     end
+
+    private
+
+    def requires_sun_data?
+      false
+    end
   end
 end

data/lib/astronoby/bodies/uranus.rb

@@ -3,9 +3,14 @@
 module Astronoby
   class Uranus < SolarSystemBody
     EQUATORIAL_RADIUS = Distance.from_meters(25_559_000)
+    ABSOLUTE_MAGNITUDE = -7.11
 
     def self.ephemeris_segments(_ephem_source)
       [[SOLAR_SYSTEM_BARYCENTER, URANUS_BARYCENTER]]
     end
+
+    def self.absolute_magnitude
+      ABSOLUTE_MAGNITUDE
+    end
   end
 end

data/lib/astronoby/bodies/venus.rb

@@ -3,9 +3,34 @@
 module Astronoby
   class Venus < SolarSystemBody
     EQUATORIAL_RADIUS = Distance.from_meters(6_051_800)
+    ABSOLUTE_MAGNITUDE = -4.384
 
     def self.ephemeris_segments(_ephem_source)
       [[SOLAR_SYSTEM_BARYCENTER, VENUS_BARYCENTER]]
     end
+
+    def self.absolute_magnitude
+      ABSOLUTE_MAGNITUDE
+    end
+
+    private
+
+    # Source:
+    #  Title: Computing Apparent Planetary Magnitudes for The Astronomical
+    #    Almanac (2018)
+    #  Authors: Anthony Mallama and James L. Hilton
+    def magnitude_correction_term
+      phase_angle_degrees = phase_angle.degrees
+      if phase_angle_degrees < 163.7
+        -1.044 * 10**-3 * phase_angle_degrees +
+          3.687 * 10**-4 * phase_angle_degrees * phase_angle_degrees -
+          2.814 * 10**-6 * phase_angle_degrees**3 +
+          8.938 * 10**-9 * phase_angle_degrees**4
+
+      else
+        240.44228 - 2.81914 * phase_angle_degrees +
+          8.39034 * 10**-3 * phase_angle_degrees * phase_angle_degrees
+      end
+    end
   end
 end