astronoby 0.7.0 → 0.9.0

data/lib/astronoby/time/local_sidereal_time.rb

@@ -1,41 +1,50 @@
 # frozen_string_literal: true
 
 module Astronoby
-  class LocalSiderealTime
-    attr_reader :date, :time, :longitude
+  class LocalSiderealTime < SiderealTime
+    attr_reader :longitude
 
-    # Source:
-    #  Title: Practical Astronomy with your Calculator or Spreadsheet
-    #  Authors: Peter Duffett-Smith and Jonathan Zwart
-    #  Edition: Cambridge University Press
-    #  Chapter: 14 - Local sidereal time (LST)
     def self.from_gst(gst:, longitude:)
-      date = gst.date
-      time = gst.time + longitude.hours
-      time += Constants::HOURS_PER_DAY if time.negative?
-      time -= Constants::HOURS_PER_DAY if time > Constants::HOURS_PER_DAY
+      case gst.type
+      when MEAN
+        LocalMeanSiderealTime.from_gst(gst: gst, longitude: longitude)
+      when APPARENT
+        LocalApparentSiderealTime.from_gst(gst: gst, longitude: longitude)
+      end
+    end
 
-      new(date: date, time: time, longitude: longitude)
+    def self.from_utc(utc, longitude:, type: MEAN)
+      validate_type!(type)
+      case type
+      when MEAN
+        LocalMeanSiderealTime.from_utc(utc, longitude: longitude)
+      when APPARENT
+        LocalApparentSiderealTime.from_utc(utc, longitude: longitude)
+      end
     end
 
-    def initialize(date:, time:, longitude:)
-      @date = date
-      @time = time
+    def initialize(date:, time:, longitude:, type: MEAN)
+      super(date: date, time: time, type: type)
       @longitude = longitude
     end
 
-    # Source:
-    #  Title: Practical Astronomy with your Calculator or Spreadsheet
-    #  Authors: Peter Duffett-Smith and Jonathan Zwart
-    #  Edition: Cambridge University Press
-    #  Chapter: 15 - Converting LST to GST
     def to_gst
-      date = @date
-      time = @time - @longitude.hours
-      time += Constants::HOURS_PER_DAY if time.negative?
-      time -= Constants::HOURS_PER_DAY if time > Constants::HOURS_PER_DAY
-
-      GreenwichSiderealTime.new(date: date, time: time)
+      case @type
+      when MEAN
+        lst = LocalMeanSiderealTime.new(
+          date: @date,
+          time: @time,
+          longitude: @longitude
+        )
+        lst.to_gst
+      when APPARENT
+        last = LocalApparentSiderealTime.new(
+          date: @date,
+          time: @time,
+          longitude: @longitude
+        )
+        last.to_gst
+      end
     end
   end
 end

data/lib/astronoby/time/sidereal_time.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Astronoby
+  class SiderealTime
+    TYPES = [
+      MEAN = :mean,
+      APPARENT = :apparent
+    ].freeze
+
+    attr_reader :date, :time, :type
+
+    def self.normalize_time(time)
+      time += Constants::HOURS_PER_DAY if time.negative?
+      time -= Constants::HOURS_PER_DAY if time > Constants::HOURS_PER_DAY
+      time
+    end
+
+    def self.validate_type!(type)
+      unless TYPES.include?(type)
+        raise ArgumentError, "Invalid type: #{type}. Must be one of #{TYPES}"
+      end
+    end
+
+    def initialize(date:, time:, type: MEAN)
+      @date = date
+      @time = time
+      @type = type
+    end
+
+    def mean?
+      @type == MEAN
+    end
+
+    def apparent?
+      @type == APPARENT
+    end
+
+    def normalize_time(time)
+      self.class.normalize_time(time)
+    end
+  end
+end

data/lib/astronoby/true_obliquity.rb

@@ -2,9 +2,8 @@
 
 module Astronoby
   class TrueObliquity
-    def self.for_epoch(epoch)
-      instant = Instant.from_utc_julian_date(epoch)
-      mean_obliquity = MeanObliquity.for_epoch(epoch)
+    def self.at(instant)
+      mean_obliquity = MeanObliquity.at(instant)
       nutation = Nutation.new(instant: instant).nutation_in_obliquity
 
       mean_obliquity + nutation

data/lib/astronoby/util/time.rb

@@ -4,7 +4,7 @@ module Astronoby
   module Util
     module Time
       OLD_LEAP_SECONDS = {
-        2378496.5 => 13.188148343557259,
+        2378496.5 => 13.188148343557259, # 1800-01-01T00:00:00+00:00
         2378677.5 => 12.977779959648615,
         2378861.5 => 12.789307379498496,
         2379042.5 => 12.627219619724201,
@@ -400,52 +400,70 @@ module Astronoby
         2450265.5 => 61.2837935622083,
         2450449.5 => 61.96410528309934,
         2450630.5 => 62.7581330776884,
-        2450814.5 => 63,
-        2450995.5 => 63,
-        2451179.5 => 64
+        2450814.5 => 62.966,
+        2450995.5 => 63.284,
+        2451179.5 => 63.467,
+        2451360.5 => 63.664 # 1999-07-01T00:00:00+00:00
       }.freeze
 
       RECENT_LEAP_SECONDS = {
-        2451360.5 => 64,
-        2451544.5 => 64,
-        2451726.5 => 64,
-        2451910.5 => 64,
-        2452091.5 => 64,
-        2452275.5 => 64,
-        2452456.5 => 64,
-        2452640.5 => 64,
-        2452821.5 => 64,
-        2453005.5 => 64,
-        2453187.5 => 64,
-        2453371.5 => 64,
-        2453552.5 => 64,
-        2453736.5 => 65,
-        2453917.5 => 65,
-        2454101.5 => 65,
-        2454282.5 => 65,
-        2454466.5 => 65,
-        2454648.5 => 65,
-        2454832.5 => 66,
-        2455013.5 => 66,
-        2455197.5 => 66,
-        2455378.5 => 66,
-        2455562.5 => 66,
-        2455743.5 => 66,
-        2455927.5 => 66,
-        2456109.5 => 67,
-        2456293.5 => 67,
-        2456474.5 => 67,
-        2456658.5 => 67,
-        2456839.5 => 67,
-        2457023.5 => 67,
-        2457204.5 => 68,
-        2457388.5 => 68,
-        2457570.5 => 68,
-        2457754.5 => 69
+        2451544.5 => 63.829, # 2000-01-01T00:00:00+00:00
+        2451726.5 => 63.980,
+        2451910.5 => 64.091,
+        2452091.5 => 64.212,
+        2452275.5 => 64.300,
+        2452456.5 => 64.413,
+        2452640.5 => 64.473,
+        2452821.5 => 64.551,
+        2453005.5 => 64.574,
+        2453187.5 => 64.653,
+        2453371.5 => 64.688,
+        2453552.5 => 64.799,
+        2453736.5 => 64.845,
+        2453917.5 => 64.989,
+        2454101.5 => 65.146,
+        2454282.5 => 65.341,
+        2454466.5 => 65.457,
+        2454648.5 => 65.629,
+        2454832.5 => 65.777,
+        2455013.5 => 65.951,
+        2455197.5 => 66.070,
+        2455378.5 => 66.241,
+        2455562.5 => 66.325,
+        2455743.5 => 66.475,
+        2455927.5 => 66.603,
+        2456109.5 => 66.771,
+        2456293.5 => 66.907,
+        2456474.5 => 67.127,
+        2456658.5 => 67.281,
+        2456839.5 => 67.486,
+        2457023.5 => 67.644,
+        2457204.5 => 67.861,
+        2457388.5 => 68.102,
+        2457570.5 => 68.396,
+        2457754.5 => 68.593,
+        2457935.5 => 68.824,
+        2458119.5 => 68.968,
+        2458300.5 => 69.113,
+        2458484.5 => 69.220,
+        2458665.5 => 69.358,
+        2458849.5 => 69.361,
+        2459031.5 => 69.424,
+        2459215.5 => 69.359,
+        2459396.5 => 69.351,
+        2459580.5 => 69.294,
+        2459761.5 => 69.253,
+        2459945.5 => 69.204,
+        2460126.5 => 69.220,
+        2460310.5 => 69.175,
+        2460492.5 => 69.188,
+        2460676.5 => 69.138,
+        2460857.5 => 69.139 # 2025-07-01T00:00:00+00:00
       }.freeze
 
       OLDEST_JD = 2378496.5
-      MOST_RECENT_JD = 2457754.5
+      FIRST_RECENT_JD = 2451544.5
+      MOST_RECENT_JD = 2460857.5
 
       # @param date [Date]
       # @param decimal [Numeric] Hour of the day, in decimal hours
@@ -496,16 +514,16 @@ module Astronoby
         when Numeric
           instant
         when ::Time, ::Date, ::DateTime
-          Epoch.from_time(instant)
+          JulianDate.from_time(instant)
         else
           raise IncompatibleArgumentsError,
             "Expected a Numeric, Time, Date or DateTime object, got #{instant.class}"
         end
 
-        return RECENT_LEAP_SECONDS[MOST_RECENT_JD] if jd >= 2457754.5
+        return RECENT_LEAP_SECONDS[MOST_RECENT_JD] if jd >= MOST_RECENT_JD
         return 0 if jd < OLDEST_JD
 
-        if jd >= 2451360.5
+        if jd >= FIRST_RECENT_JD
           closest_jd = RECENT_LEAP_SECONDS.keys.bsearch { |key| key >= jd }
           leap_seconds = RECENT_LEAP_SECONDS[closest_jd]
         else

data/lib/astronoby/velocity.rb

@@ -40,6 +40,11 @@ module Astronoby
       end
       alias_method :vector_from_mps, :vector_from_meters_per_second
 
+      def vector_from_astronomical_units_per_day(array)
+        Vector.elements(array.map { from_aupd(_1) })
+      end
+      alias_method :vector_from_aupd, :vector_from_astronomical_units_per_day
+
       def light_speed
         from_meters_per_second(Constants::LIGHT_SPEED_M_PER_S)
       end

data/lib/astronoby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Astronoby
-  VERSION = "0.7.0"
+  VERSION = "0.9.0"
 end

data/lib/astronoby.rb

@@ -1,12 +1,19 @@
 # frozen_string_literal: true
 
+require "astronoby/cache"
+require "astronoby/configuration"
 require "astronoby/constants"
 require "astronoby/angle"
 require "astronoby/angles/dms"
 require "astronoby/angles/hms"
+require "astronoby/angular_velocity"
+require "astronoby/constellation"
+require "astronoby/constellations/repository"
+require "astronoby/constellations/data"
+require "astronoby/constellations/finder"
 require "astronoby/distance"
 require "astronoby/ephem"
-require "astronoby/epoch"
+require "astronoby/julian_date"
 require "astronoby/instant"
 require "astronoby/vector"
 require "astronoby/velocity"
@@ -27,14 +34,19 @@ require "astronoby/coordinates/equatorial"
 require "astronoby/coordinates/horizontal"
 require "astronoby/corrections/light_time_delay"
 require "astronoby/aberration"
+require "astronoby/bodies/deep_sky_object"
+require "astronoby/bodies/deep_sky_object_position"
 require "astronoby/deflection"
 require "astronoby/equinox_solstice"
 require "astronoby/errors"
+require "astronoby/events/extremum_event"
+require "astronoby/events/extremum_calculator"
 require "astronoby/events/moon_phases"
 require "astronoby/events/rise_transit_set_event"
 require "astronoby/events/rise_transit_set_events"
 require "astronoby/events/rise_transit_set_calculator"
 require "astronoby/events/twilight_event"
+require "astronoby/events/twilight_events"
 require "astronoby/events/twilight_calculator"
 require "astronoby/geocentric_parallax"
 require "astronoby/mean_obliquity"
@@ -49,8 +61,14 @@ require "astronoby/reference_frames/mean_of_date"
 require "astronoby/reference_frames/apparent"
 require "astronoby/reference_frames/topocentric"
 require "astronoby/refraction"
+require "astronoby/stellar_propagation"
+require "astronoby/time/sidereal_time"
 require "astronoby/time/greenwich_sidereal_time"
+require "astronoby/time/greenwich_mean_sidereal_time"
+require "astronoby/time/greenwich_apparent_sidereal_time"
 require "astronoby/time/local_sidereal_time"
+require "astronoby/time/local_mean_sidereal_time"
+require "astronoby/time/local_apparent_sidereal_time"
 require "astronoby/util/maths"
 require "astronoby/util/time"
 require "astronoby/util/trigonometry"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: astronoby
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Rémy Hannequin
@@ -37,6 +37,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.4.2
+- !ruby/object:Gem::Dependency
+  name: benchmark
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: irb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -71,14 +99,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.3'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.3'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -120,22 +148,34 @@ files:
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - CONTRIBUTING.md
-- Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
 - UPGRADING.md
-- benchmark/README.md
-- benchmark/benchmark.rb
-- benchmark/data/imcce.csv.zip
-- benchmark/data/sun_calc.csv.zip
+- docs/README.md
+- docs/angles.md
+- docs/configuration.md
+- docs/coordinates.md
+- docs/deep_sky_bodies.md
+- docs/ephem.md
+- docs/equinoxes_solstices_times.md
+- docs/glossary.md
+- docs/instant.md
+- docs/moon_phases.md
+- docs/observer.md
+- docs/reference_frames.md
+- docs/rise_transit_set_times.md
+- docs/solar_system_bodies.md
+- docs/twilight_times.md
 - lib/astronoby.rb
 - lib/astronoby/aberration.rb
 - lib/astronoby/angle.rb
 - lib/astronoby/angles/dms.rb
 - lib/astronoby/angles/hms.rb
+- lib/astronoby/angular_velocity.rb
 - lib/astronoby/astronomical_models/moon_phases_periodic_terms.rb
+- lib/astronoby/bodies/deep_sky_object.rb
+- lib/astronoby/bodies/deep_sky_object_position.rb
 - lib/astronoby/bodies/earth.rb
 - lib/astronoby/bodies/jupiter.rb
 - lib/astronoby/bodies/mars.rb
@@ -147,25 +187,39 @@ files:
 - lib/astronoby/bodies/sun.rb
 - lib/astronoby/bodies/uranus.rb
 - lib/astronoby/bodies/venus.rb
+- lib/astronoby/cache.rb
+- lib/astronoby/configuration.rb
 - lib/astronoby/constants.rb
+- lib/astronoby/constellation.rb
+- lib/astronoby/constellations/data.rb
+- lib/astronoby/constellations/finder.rb
+- lib/astronoby/constellations/repository.rb
 - lib/astronoby/coordinates/ecliptic.rb
 - lib/astronoby/coordinates/equatorial.rb
 - lib/astronoby/coordinates/horizontal.rb
 - lib/astronoby/corrections/light_time_delay.rb
+- lib/astronoby/data/constellations/constellation_names.dat
+- lib/astronoby/data/constellations/indexed_abbreviations.dat
+- lib/astronoby/data/constellations/radec_to_index.dat
+- lib/astronoby/data/constellations/sorted_declinations.dat
+- lib/astronoby/data/constellations/sorted_right_ascensions.dat
 - lib/astronoby/deflection.rb
 - lib/astronoby/distance.rb
 - lib/astronoby/ephem.rb
-- lib/astronoby/epoch.rb
 - lib/astronoby/equinox_solstice.rb
 - lib/astronoby/errors.rb
+- lib/astronoby/events/extremum_calculator.rb
+- lib/astronoby/events/extremum_event.rb
 - lib/astronoby/events/moon_phases.rb
 - lib/astronoby/events/rise_transit_set_calculator.rb
 - lib/astronoby/events/rise_transit_set_event.rb
 - lib/astronoby/events/rise_transit_set_events.rb
 - lib/astronoby/events/twilight_calculator.rb
 - lib/astronoby/events/twilight_event.rb
+- lib/astronoby/events/twilight_events.rb
 - lib/astronoby/geocentric_parallax.rb
 - lib/astronoby/instant.rb
+- lib/astronoby/julian_date.rb
 - lib/astronoby/mean_obliquity.rb
 - lib/astronoby/moon_phase.rb
 - lib/astronoby/nutation.rb
@@ -178,8 +232,14 @@ files:
 - lib/astronoby/reference_frames/mean_of_date.rb
 - lib/astronoby/reference_frames/topocentric.rb
 - lib/astronoby/refraction.rb
+- lib/astronoby/stellar_propagation.rb
+- lib/astronoby/time/greenwich_apparent_sidereal_time.rb
+- lib/astronoby/time/greenwich_mean_sidereal_time.rb
 - lib/astronoby/time/greenwich_sidereal_time.rb
+- lib/astronoby/time/local_apparent_sidereal_time.rb
+- lib/astronoby/time/local_mean_sidereal_time.rb
 - lib/astronoby/time/local_sidereal_time.rb
+- lib/astronoby/time/sidereal_time.rb
 - lib/astronoby/true_obliquity.rb
 - lib/astronoby/util/maths.rb
 - lib/astronoby/util/time.rb
@@ -208,7 +268,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.7.1
 specification_version: 4
 summary: Astronomical calculations
 test_files: []

data/Gemfile

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-source "https://rubygems.org"
-
-gemspec

data/Gemfile.lock

@@ -1,102 +0,0 @@
-PATH
-  remote: .
-  specs:
-    astronoby (0.7.0)
-      ephem (~> 0.3)
-      matrix (~> 0.4.2)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    ast (2.4.3)
-    diff-lcs (1.5.1)
-    docile (1.4.1)
-    ephem (0.3.0)
-      minitar (~> 0.12)
-      numo-narray (~> 0.9.2.1)
-      zlib (~> 3.2)
-    json (2.10.2)
-    language_server-protocol (3.17.0.4)
-    lint_roller (1.1.0)
-    matrix (0.4.2)
-    minitar (0.12.1)
-    numo-narray (0.9.2.1)
-    parallel (1.26.3)
-    parser (3.3.7.4)
-      ast (~> 2.4.1)
-      racc
-    prism (1.4.0)
-    racc (1.8.1)
-    rainbow (3.1.1)
-    rake (13.2.1)
-    regexp_parser (2.10.0)
-    rspec (3.13.0)
-      rspec-core (~> 3.13.0)
-      rspec-expectations (~> 3.13.0)
-      rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.2)
-      rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.3)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.2)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-support (3.13.2)
-    rubocop (1.75.2)
-      json (~> 2.3)
-      language_server-protocol (~> 3.17.0.2)
-      lint_roller (~> 1.1.0)
-      parallel (~> 1.10)
-      parser (>= 3.3.0.2)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.44.0, < 2.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.44.0)
-      parser (>= 3.3.7.2)
-      prism (~> 1.4)
-    rubocop-performance (1.25.0)
-      lint_roller (~> 1.1)
-      rubocop (>= 1.75.0, < 2.0)
-      rubocop-ast (>= 1.38.0, < 2.0)
-    ruby-progressbar (1.13.0)
-    rubyzip (2.4.1)
-    simplecov (0.22.0)
-      docile (~> 1.1)
-      simplecov-html (~> 0.11)
-      simplecov_json_formatter (~> 0.1)
-    simplecov-html (0.13.1)
-    simplecov_json_formatter (0.1.4)
-    standard (1.49.0)
-      language_server-protocol (~> 3.17.0.2)
-      lint_roller (~> 1.0)
-      rubocop (~> 1.75.2)
-      standard-custom (~> 1.0.0)
-      standard-performance (~> 1.8)
-    standard-custom (1.0.2)
-      lint_roller (~> 1.0)
-      rubocop (~> 1.50)
-    standard-performance (1.8.0)
-      lint_roller (~> 1.1)
-      rubocop-performance (~> 1.25.0)
-    unicode-display_width (3.1.4)
-      unicode-emoji (~> 4.0, >= 4.0.4)
-    unicode-emoji (4.0.4)
-    zlib (3.2.1)
-
-PLATFORMS
-  ruby
-  x86_64-linux
-
-DEPENDENCIES
-  astronoby!
-  rake (~> 13.0)
-  rspec (~> 3.0)
-  rubyzip (~> 2.3)
-  simplecov (~> 0.22)
-  standard (~> 1.3)
-
-BUNDLED WITH
-   2.5.7