astronoby 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 43ef390a6ab6a498edbf148b2af44c906daf73ff9ba61b5aafeadd828fb550e4
-  data.tar.gz: b2cf0743676aa49f95f24c62b3d5d759553014bc52114260a71ecedfb9e6c1cb
+  metadata.gz: 3406973da55433c82cd985454453f570220feb119f8274176ed8ab0539a8c99d
+  data.tar.gz: c4094d2e8a6d9be6c93ef0c48a8202cec8fe8e6a8f12197f9ee930b18b1e1302
 SHA512:
-  metadata.gz: 052bfebf4ddaf6ef3f24883fec090a831d38a9e4124dd5f561d6b1dd7074b6385502396edddd5496ab6066ff93acab4f220ec3aaa244ad0638c0b65fbaace55f
-  data.tar.gz: fe37ac2714328893b068ba958e37a3b057a76ddfa1b299a35f22be005687d3168d20e98ebe571db519bd6cf69227cc0f0dc4c0889dd9ca5bb9d1abb2b1ee550d
+  metadata.gz: 49156fb3ade1cc6b3d15120e4942c0a798b00fdff3b35024cf3ffe8f1bf9c8d7f1eeae40d457485ae3a225e418fa5f8e5c4bc95e826ed14b3ff26b71b2fa6200
+  data.tar.gz: cee4783838c39d8df122dc5542cc52eee1527aa37a6fab493759c58a89686b0bc2b9cc547cbec2bd6feaee2a46bc094a72dba0a372719a4875355d1af8440f00

data/.ruby-version

@@ -0,0 +1 @@
+3.4.3

data/.standard.yml

@@ -0,0 +1 @@
+ruby_version: 3.0.0

data/CHANGELOG.md

@@ -1,5 +1,167 @@
 # Changelog
 
+## 0.7.0 - 2025-05-12
+
+_If you are upgrading: please see [UPGRADING.md]._
+
+### Bug fixes
+
+* Fix Moon monthly phase events calculation by @valeriy-sokoloff in ([#124])
+
+### Features
+
+* Add `Instant` value object ([#121])
+* Introduce barycentric position of Solar System major bodies ([#127])
+* Introduce Astrometric position for planets ([#129])
+* Rename Barycentric into Geometric ([#130])
+* Rename IRCF and remove module Position ([#131])
+* Geometric and Astrometric reference frames with coordinates ([#132])
+* Ecliptic coordinates for Geometric and Astrometric reference frames ([#134])
+* Add Geometric and Astrometric positions for `Sun` and `Moon` ([#135])
+* Implement new aberration correction ([#136])
+* Precession matrix for 2006 P03 model ([#137])
+* Introduce `MeanOfDate` reference frame ([#138])
+* New nutation model ([#141])
+* Light deflection correction ([#142])
+* Introduce `Apparent` reference frame ([#143])
+* Introduce `Topocentric` reference frame ([#145])
+* Improve Vector integration with value objects ([#146])
+* Handle refracted topocentric horizontal coordinates ([#147])
+* Add `#angular_diameter` to apparent and topocentric reference frames ([#149])
+* Introduce new calculator for rising, transit and setting times ([#148])
+* Clean code after Ephem refactoring ([#152])
+* Improve `RisingTransitSettingEventsCalculator` ([#155])
+* Simplify `RisingTransitSettingEventsCalculator` ([#156])
+* Lazy-load reference frames ([#157])
+* Overall performance improvements ([#163])
+* Add support for IMCCE INPOP by @JoelQ and @rhannequin ([#166])
+* Update INPOP excerpt in spec data ([#167])
+* Introduce a better rise/transit/set calculator ([#168])
+* Drop `Astronoby::Observer#observe` ([#174])
+
+### Improvements
+
+* Bump standard from 1.42.1 to 1.49.0 by @dependabot ([#123], [#128], [#150], [#165])
+* Bump rubyzip from 2.3.2 to 2.4.1 by @dependabot ([#120])
+* Add more tests for Julian Date conversion ([#122])
+* Upgrade main Ruby version and supported ones ([#125])
+* Update email address and gem description ([#126])
+* Increase precision of mean obliquity ([#133])
+* Add supported Rubies ([#139])
+* Set Ruby 3.4.2 as default version ([#140])
+* Fix dependency secutiry patch ([#151])
+* Improve HMS/DMS formats ([#153])
+* Use excerpts ephemerides for specs of Sun and Moon ([#154])
+* Add link to deprecated documentation ([#160])
+* Default Ruby 3.4.3 and support recent rubies ([#169])
+* Better Moon phases test coverage ([#172])
+* Optimize Observer with GMST from Instant ([#173])
+* Update README about documentation location ([#175])
+* Add GitHub Actions permissions ([#176])
+
+### New Contributors
+
+* @valeriy-sokoloff made their first contribution in https://github.com/rhannequin/astronoby/pull/124
+* @JoelQ made their first contribution in https://github.com/rhannequin/astronoby/pull/166
+
+**Full Changelog**: https://github.com/rhannequin/astronoby/compare/v0.6.0...v0.7.0
+
+[#120]: https://github.com/rhannequin/astronoby/pull/120
+[#121]: https://github.com/rhannequin/astronoby/pull/121
+[#122]: https://github.com/rhannequin/astronoby/pull/122
+[#123]: https://github.com/rhannequin/astronoby/pull/123
+[#124]: https://github.com/rhannequin/astronoby/pull/124
+[#125]: https://github.com/rhannequin/astronoby/pull/125
+[#126]: https://github.com/rhannequin/astronoby/pull/126
+[#127]: https://github.com/rhannequin/astronoby/pull/127
+[#128]: https://github.com/rhannequin/astronoby/pull/128
+[#129]: https://github.com/rhannequin/astronoby/pull/129
+[#130]: https://github.com/rhannequin/astronoby/pull/130
+[#131]: https://github.com/rhannequin/astronoby/pull/131
+[#132]: https://github.com/rhannequin/astronoby/pull/132
+[#133]: https://github.com/rhannequin/astronoby/pull/133
+[#134]: https://github.com/rhannequin/astronoby/pull/134
+[#135]: https://github.com/rhannequin/astronoby/pull/135
+[#136]: https://github.com/rhannequin/astronoby/pull/136
+[#137]: https://github.com/rhannequin/astronoby/pull/137
+[#138]: https://github.com/rhannequin/astronoby/pull/138
+[#139]: https://github.com/rhannequin/astronoby/pull/139
+[#140]: https://github.com/rhannequin/astronoby/pull/140
+[#141]: https://github.com/rhannequin/astronoby/pull/141
+[#142]: https://github.com/rhannequin/astronoby/pull/142
+[#143]: https://github.com/rhannequin/astronoby/pull/143
+[#145]: https://github.com/rhannequin/astronoby/pull/145
+[#146]: https://github.com/rhannequin/astronoby/pull/146
+[#147]: https://github.com/rhannequin/astronoby/pull/147
+[#148]: https://github.com/rhannequin/astronoby/pull/148
+[#149]: https://github.com/rhannequin/astronoby/pull/149
+[#150]: https://github.com/rhannequin/astronoby/pull/150
+[#151]: https://github.com/rhannequin/astronoby/pull/151
+[#152]: https://github.com/rhannequin/astronoby/pull/152
+[#153]: https://github.com/rhannequin/astronoby/pull/153
+[#154]: https://github.com/rhannequin/astronoby/pull/154
+[#155]: https://github.com/rhannequin/astronoby/pull/155
+[#156]: https://github.com/rhannequin/astronoby/pull/156
+[#157]: https://github.com/rhannequin/astronoby/pull/157
+[#160]: https://github.com/rhannequin/astronoby/pull/160
+[#163]: https://github.com/rhannequin/astronoby/pull/163
+[#165]: https://github.com/rhannequin/astronoby/pull/165
+[#166]: https://github.com/rhannequin/astronoby/pull/166
+[#167]: https://github.com/rhannequin/astronoby/pull/167
+[#168]: https://github.com/rhannequin/astronoby/pull/168
+[#169]: https://github.com/rhannequin/astronoby/pull/169
+[#172]: https://github.com/rhannequin/astronoby/pull/172
+[#173]: https://github.com/rhannequin/astronoby/pull/173
+[#174]: https://github.com/rhannequin/astronoby/pull/174
+[#175]: https://github.com/rhannequin/astronoby/pull/175
+[#176]: https://github.com/rhannequin/astronoby/pull/176
+
+## 0.6.0 - 2024-12-10
+
+_If you are upgrading: please see [UPGRADING.md]._
+
+[UPGRADING.md]: https://github.com/rhannequin/astronoby/blob/main/UPGRADING.md
+
+### Bug fixes
+
+* Fix `ObservationEvents` infinite loop in ([#110])
+* Fix observation events times with local time dates in ([#105])
+* Fix `IncompatibleArgumentsError` on Moon's observation events in ([#111])
+
+### Features
+
+* Add `Astronoby::Moon#current_phase_fraction` in ([#115])
+* Add sources and results for comparison in ([#114])
+
+### Improvements
+
+* Bump standard from 1.36.0 to 1.39.2 by @dependabot in ([#95])
+* Bump standard from 1.39.2 to 1.40.0 by @dependabot in ([#96])
+* Bump dependencies in ([#100])
+* Move dependencies to development ones in ([#99])
+* Bump standard from 1.40.0 to 1.41.1 by @dependabot in ([#104])
+* Bump standard from 1.41.1 to 1.42.0 by @dependabot in ([#107])
+* Bump standard from 1.42.0 to 1.42.1 by @dependabot in ([#108])
+* Bump dependencies in ([#116])
+* Add supported Ruby versions in ([#117])
+
+**Full Changelog**: https://github.com/rhannequin/astronoby/compare/v0.5.0...v0.6.0
+
+[#95]: https://github\.com/rhannequin/astronoby/pull/95
+[#96]: https://github\.com/rhannequin/astronoby/pull/96
+[#99]: https://github\.com/rhannequin/astronoby/pull/99
+[#100]: https://github\.com/rhannequin/astronoby/pull/100
+[#104]: https://github\.com/rhannequin/astronoby/pull/104
+[#105]: https://github\.com/rhannequin/astronoby/pull/105
+[#107]: https://github\.com/rhannequin/astronoby/pull/107
+[#108]: https://github\.com/rhannequin/astronoby/pull/108
+[#110]: https://github\.com/rhannequin/astronoby/pull/110
+[#111]: https://github\.com/rhannequin/astronoby/pull/111
+[#114]: https://github\.com/rhannequin/astronoby/pull/114
+[#115]: https://github\.com/rhannequin/astronoby/pull/115
+[#116]: https://github\.com/rhannequin/astronoby/pull/116
+[#117]: https://github\.com/rhannequin/astronoby/pull/117
+
 ## 0.5.0 - 2024-06-11
 
 _If you are upgrading: please see [UPGRADING.md]._

data/Gemfile.lock

@@ -1,74 +1,90 @@
 PATH
   remote: .
   specs:
-    astronoby (0.5.0)
+    astronoby (0.7.0)
+      ephem (~> 0.3)
       matrix (~> 0.4.2)
-      rake (~> 13.0)
-      rspec (~> 3.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    ast (2.4.2)
+    ast (2.4.3)
     diff-lcs (1.5.1)
-    json (2.7.2)
-    language_server-protocol (3.17.0.3)
+    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)
-    parallel (1.24.0)
-    parser (3.3.1.0)
+    minitar (0.12.1)
+    numo-narray (0.9.2.1)
+    parallel (1.26.3)
+    parser (3.3.7.4)
       ast (~> 2.4.1)
       racc
-    racc (1.7.3)
+    prism (1.4.0)
+    racc (1.8.1)
     rainbow (3.1.1)
     rake (13.2.1)
-    regexp_parser (2.9.1)
-    rexml (3.2.8)
-      strscan (>= 3.0.9)
+    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.0)
+    rspec-core (3.13.2)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.0)
+    rspec-expectations (3.13.3)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.0)
+    rspec-mocks (3.13.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-support (3.13.1)
-    rubocop (1.63.5)
+    rspec-support (3.13.2)
+    rubocop (1.75.2)
       json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
+      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 (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.31.1, < 2.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, < 3.0)
-    rubocop-ast (1.31.3)
-      parser (>= 3.3.1.0)
-    rubocop-performance (1.21.0)
-      rubocop (>= 1.48.1, < 2.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
+      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)
-    standard (1.36.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.63.0)
+      rubocop (~> 1.75.2)
       standard-custom (~> 1.0.0)
-      standard-performance (~> 1.4)
+      standard-performance (~> 1.8)
     standard-custom (1.0.2)
       lint_roller (~> 1.0)
       rubocop (~> 1.50)
-    standard-performance (1.4.0)
+    standard-performance (1.8.0)
       lint_roller (~> 1.1)
-      rubocop-performance (~> 1.21.0)
-    strscan (3.1.0)
-    unicode-display_width (2.5.0)
+      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
@@ -76,6 +92,10 @@ PLATFORMS
 
 DEPENDENCIES
   astronoby!
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  rubyzip (~> 2.3)
+  simplecov (~> 0.22)
   standard (~> 1.3)
 
 BUNDLED WITH

data/README.md

@@ -2,30 +2,22 @@
 
 [![Tests](https://github.com/rhannequin/astronoby/workflows/Ruby/badge.svg)](https://github.com/rhannequin/astronoby/actions?query=workflow%3ARuby)
 
-Ruby library to provide a useful API to compute astronomical calculations, based
-on astrometry books.
+Ruby library to provide a useful API to compute astronomical calculations.
 
-The main reference is:
-- _Astronomical Algorithms_ by Jean Meeus
-- _Celestial Calculations_ by J. L. Lawrence
-- _Practical Astronomy with your Calculator or Spreadsheet_ by Peter
+Some algorithms are based on the following astrometry books:
+* _Astronomical Algorithms_ by Jean Meeus
+* _Celestial Calculations_ by J. L. Lawrence
+* _Practical Astronomy with your Calculator or Spreadsheet_ by Peter
   Duffet-Smith and Jonathan Zwart
 
+Solar System body's positions are computed based on ephemerides coming from
+the [IMCCE] or [NASA/JPL].
+
+[NASA/JPL]: https://ssd.jpl.nasa.gov/planets/eph_export.html
+
 ## Content
 - [Installation](#installation)
-- [Usage](#usage)
-  - [Angle manipulation](#angle-manipulation)
-  - [Coordinates conversion](#coordinates-conversion)
-  - [Sun](#sun)
-    - [Sun's location in the sky](#suns-location-in-the-sky)
-    - [Sunrise and sunset times and azimuths](#sunrise-and-sunset-times-and-azimuths)
-    - [Twilight times](#twilight-times)
-  - [Solstice and Equinox times](#solstice-and-equinox-times)
-  - [Moon](#moon)
-    - [Moon's location in the sky](#moons-location-in-the-sky)
-    - [Moon's current attributes](#moons-current-attributes)
-    - [Moon's phases of the month](#moons-phases-of-the-month)
-    - [Moonrise and moonset times and azimuths](#moonrise-and-moonset-times-and-azimuths)
+- [Usage Documentation](#usage-documentation)
 - [Precision](#precision)
 - [Development](#development)
 - [Contributing](#contributing)
@@ -38,274 +30,50 @@ Install the gem and add to the application's Gemfile by executing:
 
     $ bundle add astronoby
 
-If bundler is not being used to manage dependencies, install the gem by
+If [Bundler] is not being used to manage dependencies, install the gem by
 executing:
 
     $ gem install astronoby
 
-## Usage
-
-This library is still in heavy development. The public is not stable, please
-be aware new minor versions will probably lead to breaking changes until a
-major one is released.
-
-### Angle manipulation
-
-```rb
-angle1 = Astronoby::Angle.from_degrees(90)
-angle2 = Astronoby::Angle.from_radians(Math::PI / 2)
-angle3 = Astronoby::Angle.from_hours(12)
-
-angle1 == angle2
-# => true
-
-angle1 < angle3
-# => true
-
-angle = angle1 + angle2 + angle3
-angle.cos
-# => 1.0
-```
-
-### Distance manipulation
-
-```rb
-distance1 = Astronoby::Distance.from_astronomical_units(1)
-distance2 = Astronoby::Distance.from_kilometers(149_597_870.7)
-distance3 = Astronoby::Distance.from_meters(300)
-
-distance1 == distance2
-# => true
-
-distance1 > distance3
-# => true
-
-distance =
-  Astronoby::Distance.from_m(300) +
-  Astronoby::Distance.from_km(3)
-
-distance.km
-# => 3.3
-```
-
-### Coordinates conversion
-
-```rb
-observer = Astronoby::Observer.new(
-  latitude: Astronoby::Angle.from_degrees(38),
-  longitude: Astronoby::Angle.from_degrees(-78)
-)
-
-equatorial = Astronoby::Coordinates::Equatorial.new(
-  right_ascension: Astronoby::Angle.from_hms(17, 43, 54),
-  declination: Astronoby::Angle.from_dms(-22, 10, 0)
-)
-
-horizontal = equatorial.to_horizontal(
-  time: Time.new(2016, 1, 21, 21, 30, 0, "-05:00"),
-  observer: observer
-)
-
-horizontal.altitude.str(:dms)
-# => "-73° 27′ 19.1557″"
-
-horizontal.azimuth.str(:dms)
-# => "+341° 33′ 21.587″"
-```
-
-### Sun
-
-#### Sun's location in the sky
-
-```rb
-time = Time.utc(2023, 2, 17, 11, 0, 0)
-
-observer = Astronoby::Observer.new(
-  latitude: Astronoby::Angle.from_degrees(48.8566),
-  longitude: Astronoby::Angle.from_degrees(2.3522)
-)
-
-sun = Astronoby::Sun.new(time: time)
-
-horizontal_coordinates = sun.horizontal_coordinates(
-  observer: observer
-)
-
-horizontal_coordinates.altitude.degrees
-# => 27.500082409271247
-
-horizontal_coordinates.altitude.str(:dms)
-# => "+27° 30′ 0.2966″"
-```
-
-#### Sunrise and sunset times and azimuths
-
-```rb
-time = Time.new(2015, 2, 5)
-observer = Astronoby::Observer.new(
-  latitude: Astronoby::Angle.from_degrees(38),
-  longitude: Astronoby::Angle.from_degrees(-78)
-)
-sun = Astronoby::Sun.new(time: time)
-observation_events = sun.observation_events(observer: observer)
-
-observation_events.rising_time
-# => 2015-02-05 12:12:59 UTC
-
-observation_events.rising_azimuth.str(:dms)
-# => "+109° 29′ 34.3674″"
-
-observation_events.transit_time
-# => 2015-02-05 17:25:59 UTC
-
-observation_events.transit_altitude.str(:dms)
-# => "+36° 8′ 15.8197″"
+[Bundler]: https://bundler.io
 
-observation_events.setting_time
-# => 2015-02-05 22:39:27 UTC
+## Usage Documentation
 
-observation_events.setting_azimuth.str(:dms)
-# => "+250° 40′ 42.8609″"
-```
+Since version 0.7.0, the usage documentation resides in the [Wiki]. For
+previous versions, you can access the documentation in the README for each
+[release].
 
-#### Twilight times
+[Wiki]: https://github.com/rhannequin/astronoby/wiki
+[release]: https://github.com/rhannequin/astronoby/releases
 
-```rb
-time = Time.new(2024, 1, 1)
-sun = Astronoby::Sun.new(time: time)
-observer = Astronoby::Observer.new(
-  latitude: Astronoby::Angle.from_degrees(48.8566),
-  longitude: Astronoby::Angle.from_degrees(2.3522)
-)
-twilight_events = sun.twilight_events(observer: observer)
+### Expected breaking changes notice
 
-twilight_events.morning_astronomical_twilight_time
-# => 2024-01-01 05:49:25 UTC
-
-twilight_events.morning_nautical_twilight_time
-# => 2024-01-01 06:27:42 UTC
-
-twilight_events.morning_civil_twilight_time
-# => 2024-01-01 07:07:50 UTC
-
-twilight_events.evening_civil_twilight_time
-# => 2024-01-01 16:40:01 UTC
-
-twilight_events.evening_nautical_twilight_time
-# => 2024-01-01 17:20:10 UTC
-
-twilight_events.evening_astronomical_twilight_time
-# => 2024-01-01 17:58:26 UTC
-```
-
-### Solstice and Equinox times
-
-```rb
-year = 2024
-
-Astronoby::EquinoxSolstice.march_equinox(year)
-# => 2024-03-20 03:05:08 UTC
-
-Astronoby::EquinoxSolstice.june_solstice(year)
-# => 2024-06-20 20:50:18 UTC
-```
-
-### Moon
-
-#### Moon's location in the sky
-
-```rb
-time = Time.utc(2023, 2, 17, 11, 0, 0)
-
-observer = Astronoby::Observer.new(
-  latitude: Astronoby::Angle.from_degrees(48.8566),
-  longitude: Astronoby::Angle.from_degrees(2.3522)
-)
-
-moon = Astronoby::Moon.new(time: time)
-
-horizontal_coordinates = moon.horizontal_coordinates(
-  observer: observer
-)
-
-horizontal_coordinates.altitude.degrees
-# => 10.277834691708053
-
-horizontal_coordinates.altitude.str(:dms)
-# => "+10° 16′ 40.2048″"
-```
-
-#### Moon's current attributes
-
-```rb
-time = Time.utc(2024, 6, 1, 10, 0, 0)
-moon = Astronoby::Moon.new(time: time)
-
-moon.illuminated_fraction.round(2)
-# => 0.31
-
-moon.distance.km.round
-# => 368409
-
-moon.phase_angle.degrees.round
-# => 112
-```
-
-#### Moon's phases of the month
-
-```rb
-june_phases = Astronoby::Moon.monthly_phase_events(
-  year: 2024,
-  month: 6
-)
-
-june_phases.each { puts "#{_1.phase}: #{_1.time}" }
-# new_moon: 2024-06-06 12:37:41 UTC
-# first_quarter: 2024-06-14 05:18:28 UTC
-# full_moon: 2024-06-22 01:07:53 UTC
-# last_quarter: 2024-06-28 21:53:25 UTC
-```
-
-#### Moonrise and moonset times and azimuths
-
-```rb
-time = Time.utc(2024, 6, 1, 10, 0, 0)
-observer = Astronoby::Observer.new(
-  latitude: Astronoby::Angle.from_degrees(48.8566),
-  longitude: Astronoby::Angle.from_degrees(2.3522)
-)
-moon = Astronoby::Moon.new(time: time)
-observation_events = moon.observation_events(observer: observer)
-
-observation_events.rising_time
-# => 2024-06-01 00:35:36 UTC
-
-observation_events.rising_azimuth.str(:dms)
-# => "+93° 7′ 43.2347″"
-
-observation_events.transit_time
-# => 2024-06-01 02:42:43 UTC
-
-observation_events.transit_altitude.str(:dms)
-# => "+26° 59′ 30.9915″"
+This library is still in heavy development. The public is not stable, please
+be aware new minor versions will probably lead to breaking changes until a
+major one is released.
 
-observation_events.setting_time
-# => 2024-06-01 16:02:26 UTC
+Changes are documented in the [CHANGELOG] and adapting to breaking changes is
+described in the [UPGRADING] document.
 
-observation_events.setting_azimuth.str(:dms)
-# => "+273° 29′ 30.0954″"
-```
+[CHANGELOG]: https://github.com/rhannequin/astronoby/blob/main/CHANGELOG.md
+[UPGRADING]: https://github.com/rhannequin/astronoby/blob/main/UPGRADING.md
 
 ## Precision
 
-The current precision for the Sun's apparent location in the sky, compared 
-to values computed by the [IMCCE] is approximately 1 arc minute. It corresponds
-to twice the apparent size of Jupiter when it is the closest to Earth.
+The current precision for the major Solar System bodies' location in the sky
+as seen from an observer on Earth is below 10 arc seconds. It corresponds to
+half the size of Saturn when it is the closest to Earth.
 
-While the precision is not enough for very high accuracy computations, it is
-equal to the Human naked eye's angular resolution.
+While the precision is not enough for spacecraft navigation, it is enough for
+automated guiding of amateur telescopes.
+
+The compared sources are: [IMCCE], [JPL Horizons], [Stellarium], and the
+[Skyfield] library.
 
 [IMCCE]: https://www.imcce.fr
+[JPL Horizons]: https://ssd.jpl.nasa.gov/horizons.cgi
+[Stellarium]: https://stellarium.org
+[Skyfield]: https://rhodesmill.org/skyfield/
 
 ## Development
 
@@ -322,7 +90,9 @@ git commits and the created tag, and push the `.gem` file to [rubygems.org].
 
 ## Contributing
 
-Please see [CONTRIBUTING.md](https://github.com/rhannequin/astronoby/blob/main/CONTRIBUTING.md).
+Please see [CONTRIBUTING.md].
+
+[CONTRIBUTING.md]: https://github.com/rhannequin/astronoby/blob/main/CONTRIBUTING.md
 
 [code of conduct]: https://github.com/rhannequin/astronoby/blob/main/CODE_OF_CONDUCT.md
 
@@ -335,6 +105,6 @@ The gem is available as open source under the terms of the [MIT License].
 ## Code of Conduct
 
 Everyone interacting in the Astronoby project's codebases, issue trackers, chat
-rooms and mailing lists is expected to follow the [code of conduct].
+rooms and mailing lists are expected to follow the [code of conduct].
 
 [code of conduct]: https://github.com/rhannequin/astronoby/blob/main/CODE_OF_CONDUCT.md