astronoby 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 15679e58775b5058f6a154502a3e94731effe12a9c90d0a28c642b96d07aa6b2
-  data.tar.gz: 00f9bcc5a4c0fa4111e33911ba3f1e3da4829edad54e4d1419c0d716f660ea69
+  metadata.gz: e26fab1e74e0fa27c784712cb44a5557c553c1104752eb5e63ddda0c48a95b52
+  data.tar.gz: cfb3e98fc8a4f841b144a0ae2ea435ea764d7eafb85f150a0e3cc7495af3218e
 SHA512:
-  metadata.gz: b524b994952bfec402e42e69976c5f74d69d51e1d6fbf3b2f21327c9ed0e02011c32d897d09c216f7784c3c286ed69c11beee466207a64051aef536fbc8f5a64
-  data.tar.gz: 5ebbd92e2bb360d2d354800b7f05d35e4e74bce01cae06c8cf8176dae286e8ae70baa39c509c2c3466b05c676d624d4942a4a7cd08546ec895255785645e235b
+  metadata.gz: 43b7bdbd274fc42b1c1c992a677abf71dc831e727abb2bf78b93190595a4746a07f266affececa6e495a534eda304164422623a09673fe779c9b1064be9d11d0
+  data.tar.gz: b8a3dcd0992c55606c6e13b4f7783325268a1168d26343ac6a20d050514ca7b30b4fd3548a2903db5abfcbb8133efe79ae7868681cdcba8b61d284862f1f423c

data/.ruby-version

@@ -0,0 +1 @@
+3.4.4

data/.standard.yml

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

data/CHANGELOG.md

@@ -1,5 +1,205 @@
 # Changelog
 
+## 0.8.0 - 2025-09-01
+
+_If you are upgrading: please see [UPGRADING.md]._
+
+### Bug fixes
+
+* Fix UPGRADING documentation ([#178])
+* Fix possible division by zero in RTS ([#185])
+
+### Features
+
+* Introduce performance benchmark ([#183])
+* Cache positions in RTS calculator ([#182])
+* Internal global LRU cache ([#186])
+* Global configuration ([#187])
+* Compute the constellation a body is in ([#199])
+* Add `#phase_angle` and `#illuminated_fraction` to planets ([#200])
+* Apparent magnitude ([#201])
+* Add #events_between to TwilightCalculator with better accuracy ([#204])
+* `#angular_diameter` on Solar System bodies ([#207])
+* Fix constellation boundaries near 24h right ascension ([#209])
+
+### Improvements
+
+* Bump standard from 1.49.0 to 1.50.0 by @dependabot ([#177])
+* Bump ephem from 0.3.0 to 0.4.1 by @dependabot ([#181], [#191])
+* Bump irb from 1.14.3 to 1.15.2 by @dependabot ([#184])
+* Bump rspec from 3.13.0 to 3.13.1 by @dependabot ([#188])
+* Bump benchmark from 0.4.0 to 0.4.1 by @dependabot ([#189])
+* Bump rake from 13.2.1 to 13.3.0 by @dependabot ([#190])
+* Bump matrix from 0.4.2 to 0.4.3 by @dependabot ([#193])
+* Update rubyzip requirement from ~> 2.3 to ~> 3.0 by @dependabot ([#194])
+* Bump rubyzip from 3.0.0 to 3.0.2 by @dependabot ([#202], [#206])
+* Exclude benchmarks from release ([#196])
+* `Epoch` refactoring into `JulianDate` ([#197])
+* Support Ruby 3.4.4 ([#198])
+* Bump actions/checkout from 4 to 5 ([#203])
+* Internal documentation ([#205])
+
+### Backward-incompatible changes
+
+* `Epoch` refactoring into `JulianDate` ([#197])
+* `#angular_diameter` on Solar System bodies ([#207])
+* Rename "epoch" ([#208])
+
+### Closed issues
+
+* Consider adding typical usage/deployment info ([#179])
+* Performance degradation in v0.7 ([#180])
+
+**Full Changelog**: https://github.com/rhannequin/astronoby/compare/v0.7.0...v0.8.0
+
+[#177]: https://github.com/rhannequin/astronoby/pull/177
+[#178]: https://github.com/rhannequin/astronoby/pull/178
+[#179]: https://github.com/rhannequin/astronoby/pull/179
+[#180]: https://github.com/rhannequin/astronoby/pull/180
+[#181]: https://github.com/rhannequin/astronoby/pull/181
+[#182]: https://github.com/rhannequin/astronoby/pull/182
+[#183]: https://github.com/rhannequin/astronoby/pull/183
+[#184]: https://github.com/rhannequin/astronoby/pull/184
+[#185]: https://github.com/rhannequin/astronoby/pull/185
+[#186]: https://github.com/rhannequin/astronoby/pull/186
+[#187]: https://github.com/rhannequin/astronoby/pull/187
+[#188]: https://github.com/rhannequin/astronoby/pull/188
+[#189]: https://github.com/rhannequin/astronoby/pull/189
+[#190]: https://github.com/rhannequin/astronoby/pull/190
+[#191]: https://github.com/rhannequin/astronoby/pull/191
+[#193]: https://github.com/rhannequin/astronoby/pull/193
+[#194]: https://github.com/rhannequin/astronoby/pull/194
+[#196]: https://github.com/rhannequin/astronoby/pull/196
+[#197]: https://github.com/rhannequin/astronoby/pull/197
+[#198]: https://github.com/rhannequin/astronoby/pull/198
+[#199]: https://github.com/rhannequin/astronoby/pull/199
+[#200]: https://github.com/rhannequin/astronoby/pull/200
+[#201]: https://github.com/rhannequin/astronoby/pull/201
+[#202]: https://github.com/rhannequin/astronoby/pull/202
+[#203]: https://github.com/rhannequin/astronoby/pull/203
+[#204]: https://github.com/rhannequin/astronoby/pull/204
+[#205]: https://github.com/rhannequin/astronoby/pull/205
+[#206]: https://github.com/rhannequin/astronoby/pull/206
+[#207]: https://github.com/rhannequin/astronoby/pull/207
+[#208]: https://github.com/rhannequin/astronoby/pull/208
+[#209]: https://github.com/rhannequin/astronoby/pull/209
+
+## 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]._
@@ -180,7 +380,7 @@ _If you are upgrading: please see [UPGRADING.md]._
 
 ## 0.3.0 - 2024-03-29
 
-_If you are upgrading: please see [`UPGRADING.md`]._
+_If you are upgrading: please see [UPGRADING.md]._
 
 ### Improvements
 
@@ -199,7 +399,7 @@ _If you are upgrading: please see [`UPGRADING.md`]._
 
 ## 0.2.0 - 2024-03-24
 
-_If you are upgrading: please see [`UPGRADING.md`]._
+_If you are upgrading: please see [UPGRADING.md]._
 
 ### Features
 
@@ -270,4 +470,4 @@ _If you are upgrading: please see [`UPGRADING.md`]._
 * Add `Astronoby::Angle`
 * Support angles in degrees and radians
 
-[`UPGRADING.md`]: https://github.com/rhannequin/astronoby/blob/main/UPGRADING.md
+[UPGRADING.md]: https://github.com/rhannequin/astronoby/blob/main/UPGRADING.md

data/README.md

@@ -2,30 +2,20 @@
 
 [![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 that provides a useful API for computing 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 bodies' positions are computed based on ephemerides from the
+[IMCCE] or [NASA/JPL].
+
 ## 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,306 +28,85 @@ 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)
+## Usage Documentation
 
-horizontal_coordinates = sun.horizontal_coordinates(
-  observer: observer
-)
+Since version 0.7.0, the usage documentation resides in [`docs/`]. For
+previous versions, you can access the documentation in the README for each
+[release].
 
-horizontal_coordinates.altitude.degrees
-# => 27.500082409271247
-
-horizontal_coordinates.altitude.str(:dms)
-# => "+27° 30′ 0.2966″"
-```
+### See also
+- [Quick Start Guide](docs/README.md) - for getting started examples
+- [Celestial Bodies](docs/celestial_bodies.md) - for understanding planets and objects
+- [Reference Frames](docs/reference_frames.md) - for coordinate systems
+- [Observer Setup](docs/observer.md) - for location configuration
+- [Glossary](docs/glossary.md) - for astronomical and technical terms
 
-#### Sunrise and sunset times and azimuths
-
-Only date part of the time is relevant for the calculation. The offset must
-be provided to the observer.
-
-```rb
-utc_offset = "-05:00"
-time = Time.new(2015, 2, 5, 0, 0, 0, utc_offset)
-observer = Astronoby::Observer.new(
-  latitude: Astronoby::Angle.from_degrees(38),
-  longitude: Astronoby::Angle.from_degrees(-78),
-  utc_offset: utc_offset
-)
-sun = Astronoby::Sun.new(time: time)
-observation_events = sun.observation_events(observer: observer)
+### Expected breaking changes notice
 
-observation_events.rising_time.getlocal(utc_offset)
-# => 2015-02-05 07:12:59 -0500
-
-observation_events.rising_azimuth.str(:dms)
-# => "+109° 29′ 35.5069″"
-
-observation_events.transit_time.getlocal(utc_offset)
-# => 2015-02-05 12:25:59 -0500
-
-observation_events.transit_altitude.str(:dms)
-# => "+36° 8′ 14.9673″"
-
-observation_events.setting_time.getlocal(utc_offset)
-# => 2015-02-05 17:39:27 -0500
-
-observation_events.setting_azimuth.str(:dms)
-# => "+250° 40′ 41.7129″"
-```
+This library is still in heavy development. The public API is not stable, so
+please be aware that new minor versions will probably lead to breaking changes
+until a major one is released.
 
-#### Twilight times
-
-```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)
-
-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
+Changes are documented in the [CHANGELOG] and adapting to breaking changes is
+described in the [UPGRADING] document.
 
-Astronoby::EquinoxSolstice.march_equinox(year)
-# => 2024-03-20 03:05:08 UTC
-
-Astronoby::EquinoxSolstice.june_solstice(year)
-# => 2024-06-20 20:50:18 UTC
-```
+## Precision
 
-### Moon
+The current precision for the major Solar System bodies' locations in the sky
+as seen from an observer on Earth is below 10 arc seconds. This corresponds to
+half the size of Saturn when it is closest to Earth.
 
-#### Moon's location in the sky
+While the precision is not enough for spacecraft navigation, it is enough for
+automated guiding of amateur telescopes.
 
-```rb
-time = Time.utc(2023, 2, 17, 11, 0, 0)
+The sources used for comparison are: [IMCCE], [JPL Horizons], [Stellarium],
+and the [Skyfield] library.
 
-observer = Astronoby::Observer.new(
-  latitude: Astronoby::Angle.from_degrees(48.8566),
-  longitude: Astronoby::Angle.from_degrees(2.3522)
-)
+## Development
 
-moon = Astronoby::Moon.new(time: time)
+After checking out the repo, run `bin/setup` to install dependencies. Then, run
+`rake spec` to run the tests. You can also run `bin/console` for an interactive
+prompt that will allow you to experiment.
 
-horizontal_coordinates = moon.horizontal_coordinates(
-  observer: observer
-)
+To install this gem onto your local machine, run `bundle exec rake install`. To
+release a new version, update the version number in `version.rb`, and then run
+`bundle exec rake release`, which will create a git tag for the version, push
+git commits and the created tag, and push the `.gem` file to [rubygems.org].
 
-horizontal_coordinates.altitude.degrees
-# => 10.277834691708053
+### Performance
 
-horizontal_coordinates.altitude.str(:dms)
-# => "+10° 16′ 40.2048″"
-```
+The library is designed to be fast, but there is always room for improvement.
+When comparing the performance of two implementations, please use the
+performance benchmark in the console before and after your implementation.
 
-#### Moon's current attributes
+    $ bin/console
 
 ```rb
-time = Time.utc(2024, 6, 1, 10, 0, 0)
-moon = Astronoby::Moon.new(time: time)
+require_relative "benchmarks/performance"
 
-moon.illuminated_fraction.round(2)
-# => 0.31
-
-moon.current_phase_fraction.round(2)
-# => 0.82
-
-moon.distance.km.round
-# => 368409
-
-moon.phase_angle.degrees.round
-# => 112
+PerformanceBenchmark.new.run
 ```
 
-#### Moon's phases of the month
+For fast feedback, you can customise the parameters:
 
 ```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
+PerformanceBenchmark
+  .new(warmup_runs: 1, measure_runs: 3, iterations_per_run: 5)
+  .run
 ```
 
-#### Moonrise and moonset times and azimuths
-
-Only date part of the time is relevant for the calculation. The offset must
-be provided to the observer.
-
-```rb
-utc_offset = "-10:00"
-time = Time.new(2024, 9, 1, 0, 0, 0, utc_offset)
-observer = Astronoby::Observer.new(
-  latitude: Astronoby::Angle.from_degrees(-17.5325),
-  longitude: Astronoby::Angle.from_degrees(-149.5677),
-  utc_offset: utc_offset
-)
-moon = Astronoby::Moon.new(time: time)
-observation_events = moon.observation_events(observer: observer)
-
-observation_events.rising_time.getlocal(utc_offset)
-# => 2024-09-01 05:24:55 -1000
-
-observation_events.rising_azimuth.str(:dms)
-# => "+72° 15′ 19.1814″"
-
-observation_events.transit_time.getlocal(utc_offset)
-# => 2024-09-01 11:12:32 -1000
-
-observation_events.transit_altitude.str(:dms)
-# => "+56° 39′ 59.132″"
-
-observation_events.setting_time.getlocal(utc_offset)
-# => 2024-09-01 16:12:08 -1000
-
-observation_events.setting_azimuth.str(:dms)
-# => "+290° 25′ 42.5421″"
-```
-
-## 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.
-
-While the precision is not enough for very high accuracy computations, it is
-equal to the Human naked eye's angular resolution.
-
-[IMCCE]: https://www.imcce.fr
-
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run
-`rake spec` to run the tests. You can also run `bin/console` for an interactive
-prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To
-release a new version, update the version number in `version.rb`, and then run
-`bundle exec rake release`, which will create a git tag for the version, push
-git commits and the created tag, and push the `.gem` file to [rubygems.org].
-
-[rubygems.org]: https://rubygems.org
+Performance is not absolute, which is why the results are not documented here.
+What is important is to compare the relative performance of two implementations
+and make sure new features do not degrade performance.
 
 ## Contributing
 
-Please see [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
+Please see [CONTRIBUTING.md].
 
 ## License
 
@@ -350,4 +119,16 @@ The gem is available as open source under the terms of the [MIT License].
 Everyone interacting in the Astronoby project's codebases, issue trackers, chat
 rooms and mailing lists is expected to follow the [code of conduct].
 
+[NASA/JPL]: https://ssd.jpl.nasa.gov/planets/eph_export.html
+[Bundler]: https://bundler.io
+[`docs/`]: https://github.com/rhannequin/astronoby/blob/main/docs
+[release]: https://github.com/rhannequin/astronoby/releases
+[CHANGELOG]: https://github.com/rhannequin/astronoby/blob/main/CHANGELOG.md
+[UPGRADING]: https://github.com/rhannequin/astronoby/blob/main/UPGRADING.md
+[IMCCE]: https://www.imcce.fr
+[JPL Horizons]: https://ssd.jpl.nasa.gov/horizons.cgi
+[Stellarium]: https://stellarium.org
+[Skyfield]: https://rhodesmill.org/skyfield/
+[rubygems.org]: https://rubygems.org
+[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