astronoby 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e26fab1e74e0fa27c784712cb44a5557c553c1104752eb5e63ddda0c48a95b52
-  data.tar.gz: cfb3e98fc8a4f841b144a0ae2ea435ea764d7eafb85f150a0e3cc7495af3218e
+  metadata.gz: 3e781560f80c12781becc942c58f026386dbc252bff0830ab154e1217dba319f
+  data.tar.gz: '0939683834940fe9bef423fe6e59b5a8ce5a1c53921015ee612c0f258c0fd224'
 SHA512:
-  metadata.gz: 43b7bdbd274fc42b1c1c992a677abf71dc831e727abb2bf78b93190595a4746a07f266affececa6e495a534eda304164422623a09673fe779c9b1064be9d11d0
-  data.tar.gz: b8a3dcd0992c55606c6e13b4f7783325268a1168d26343ac6a20d050514ca7b30b4fd3548a2903db5abfcbb8133efe79ae7868681cdcba8b61d284862f1f423c
+  metadata.gz: 731fe3a326ddeca238f9479647e61e0554bbef2e10a35e468079240a58e8482a3e21b316fc61d5bcfb6962de353002e882c1e104f3e5c1626f6a02177a55a9a1
+  data.tar.gz: 035fb37802b80e6be88c216d0b117e3804bcd55c75871c4de4d6554e55fe8634f39e7dfe73e794bef4d00d35e59ccdbab65851bf34525a05f3ef290c4a5d2373

data/.ruby-version

@@ -1 +1 @@
-3.4.4
+4.0.5

data/CHANGELOG.md

@@ -1,5 +1,164 @@
 # Changelog
 
+## 0.10.0 - 2026-06-26
+
+_If you are upgrading: please see [UPGRADING.md]._
+
+### Bug fixes
+
+* Fix constant name typo ([#245])
+* Fix matrix multiplication order in Apparent frame ([#250])
+* Remove spurious N·P from observer ECEF-to-TOD transformation ([#251])
+* Apply aberration in GCRS before precession/nutation rotation ([#253])
+* Fix Moon magnitude ([#254])
+* Fix astrometric position for Deep Sky Objects ([#272])
+
+### Features
+
+* Defer Solar System body computations lazily ([#244])
+* Integrate `iers` gem for Delta T and GMST ([#249])
+* Add IERS polar motion correction to observer ECEF-to-TOD transformation ([#252])
+* Fall back to polynomial GMST for dates outside IERS EOP range ([#255])
+* Add ICRS frame bias to precession matrix ([#257])
+* Extract `EarthRotation` class from `Observer` ([#260])
+* Add TEME reference frame for satellite tracking ([#261])
+* Add ECEF to geodetic conversion (WGS-84) ([#262])
+* Memoize per-instant conversions on `Instant` ([#268])
+* Add `ReferenceFrame#separation_from` for angular separation ([#269])
+* Introduce `Center`, `Body` and `Position` domain objects ([#270])
+* Add planetary phenomena ([#271])
+* Add lunar libration, position angle of axis and bright limb ([#273])
+* Add `Astronoby::Orientation` for arcsecond lunar libration ([#279])
+* Add Lunar eclipses ([#280])
+* Add `Astronoby::Duration` ([#281])
+
+### Improvements
+
+* Optimize nutation loop by eliminating array allocations ([#246])
+* Reuse single Nutation instance in observer matrix computation ([#247])
+* Memoize Observer geodetic computation methods ([#248])
+* Update documentation with recent values ([#256])
+* Update referential frames documentation ([#258])
+* YARD documentation update ([#259])
+* Update zlib, JSON and ERB for security reasons
+* Add references to README
+* Bump actions/checkout from 5 to 7 by @dependabot ([#239], [#276])
+* Bump rubyzip from 3.2.1 to 3.4.0 by @dependabot ([#237], [#267], [#275])
+* Bump irb from 1.15.2 to 1.17.0 by @dependabot ([#242])
+* Bump standard from 1.51.1 to 1.55.0 by @dependabot ([#243], [#274])
+* Bump rake from 13.3.1 to 13.4.2 by @dependabot ([#264])
+* Bump ephem from 0.4.1 to 0.5.0 by @dependabot ([#278])
+* Upgrade default Ruby to 4.0.5 ([#277])
+
+### Backward-incompatible changes
+
+* Minimum Ruby version bumped to 3.2.0 ([#249])
+* Delta T and GMST now use IERS data ([#249])
+* Defer Solar System body computations lazily ([#244])
+* `SolarSystemBody#ephem` is now publicly accessible ([#244])
+* `ReferenceFrame#center_identifier` replaced by `#center` ([#270])
+* `Sun#equation_of_time` now returns a `Duration` ([#281])
+
+**Full Changelog**: https://github.com/rhannequin/astronoby/compare/v0.9.0...v0.10.0
+
+[#237]: https://github.com/rhannequin/astronoby/pull/237
+[#239]: https://github.com/rhannequin/astronoby/pull/239
+[#242]: https://github.com/rhannequin/astronoby/pull/242
+[#243]: https://github.com/rhannequin/astronoby/pull/243
+[#244]: https://github.com/rhannequin/astronoby/pull/244
+[#245]: https://github.com/rhannequin/astronoby/pull/245
+[#246]: https://github.com/rhannequin/astronoby/pull/246
+[#247]: https://github.com/rhannequin/astronoby/pull/247
+[#248]: https://github.com/rhannequin/astronoby/pull/248
+[#249]: https://github.com/rhannequin/astronoby/pull/249
+[#250]: https://github.com/rhannequin/astronoby/pull/250
+[#251]: https://github.com/rhannequin/astronoby/pull/251
+[#252]: https://github.com/rhannequin/astronoby/pull/252
+[#253]: https://github.com/rhannequin/astronoby/pull/253
+[#254]: https://github.com/rhannequin/astronoby/pull/254
+[#255]: https://github.com/rhannequin/astronoby/pull/255
+[#256]: https://github.com/rhannequin/astronoby/pull/256
+[#257]: https://github.com/rhannequin/astronoby/pull/257
+[#258]: https://github.com/rhannequin/astronoby/pull/258
+[#259]: https://github.com/rhannequin/astronoby/pull/259
+[#260]: https://github.com/rhannequin/astronoby/pull/260
+[#261]: https://github.com/rhannequin/astronoby/pull/261
+[#262]: https://github.com/rhannequin/astronoby/pull/262
+[#264]: https://github.com/rhannequin/astronoby/pull/264
+[#267]: https://github.com/rhannequin/astronoby/pull/267
+[#268]: https://github.com/rhannequin/astronoby/pull/268
+[#269]: https://github.com/rhannequin/astronoby/pull/269
+[#270]: https://github.com/rhannequin/astronoby/pull/270
+[#271]: https://github.com/rhannequin/astronoby/pull/271
+[#272]: https://github.com/rhannequin/astronoby/pull/272
+[#273]: https://github.com/rhannequin/astronoby/pull/273
+[#274]: https://github.com/rhannequin/astronoby/pull/274
+[#275]: https://github.com/rhannequin/astronoby/pull/275
+[#276]: https://github.com/rhannequin/astronoby/pull/276
+[#277]: https://github.com/rhannequin/astronoby/pull/277
+[#278]: https://github.com/rhannequin/astronoby/pull/278
+[#279]: https://github.com/rhannequin/astronoby/pull/279
+[#280]: https://github.com/rhannequin/astronoby/pull/280
+[#281]: https://github.com/rhannequin/astronoby/pull/281
+
+## 0.9.0 - 2025-10-31
+
+_If you are upgrading: please see [UPGRADING.md]._
+
+### Features
+
+* Add `#approaching_primary?` and `#receding_from_primary?` to solar system bodies ([#211])
+* Calculate apoapsis and periapsis events ([#213])
+* Improve precision of ΔT ([#219])
+* Deep Sky Object: Compute astrometric position ([#217])
+* Deep Sky Object: Compute apparent position ([#220])
+* Deep Sky Object: Handle velocities properly ([#222])
+* Deep Sky Object: Compute topocentric position ([#226])
+* Deep Sky Object: difference between the body and the position ([#227])
+* Deep Sky Object: Add support for RiseTransitSetCalculator ([#228])
+
+### Improvements
+
+* Drop `Astronoby::Apparent#angular_diameter` ([#221])
+* Bump rubyzip from 3.0.2 to 3.2.1 by @dependabot ([#210], [#215], [#223], [#233])
+* Bump standard from 1.50.0 to 1.51.1 by @dependabot ([#212], [#214])
+* Be proud about the precision achieved ([#218])
+* Use local apparent instead of local mean sidereal time for hour angle ([#225])
+* Bump rspec from 3.13.1 to 3.13.2 by @dependabot ([#229])
+* Bump benchmark from 0.4.1 to 0.5.0 by @dependabot ([#230])
+* Add documentation for deep-sky objects ([#232])
+* Bump rake from 13.3.0 to 13.3.1 by @dependabot ([#235])
+
+### Backward-incompatible changes
+
+* Drop `Astronoby::Apparent#angular_diameter` ([#221])
+* Use local apparent instead of local mean sidereal time for hour angle ([#225])
+
+**Full Changelog**: https://github.com/rhannequin/astronoby/compare/v0.8.0...v0.9.0
+
+[#210]: https://github.com/rhannequin/astronoby/pull/210
+[#211]: https://github.com/rhannequin/astronoby/pull/211
+[#212]: https://github.com/rhannequin/astronoby/pull/212
+[#213]: https://github.com/rhannequin/astronoby/pull/213
+[#214]: https://github.com/rhannequin/astronoby/pull/214
+[#215]: https://github.com/rhannequin/astronoby/pull/215
+[#217]: https://github.com/rhannequin/astronoby/pull/217
+[#218]: https://github.com/rhannequin/astronoby/pull/218
+[#219]: https://github.com/rhannequin/astronoby/pull/219
+[#220]: https://github.com/rhannequin/astronoby/pull/220
+[#221]: https://github.com/rhannequin/astronoby/pull/221
+[#222]: https://github.com/rhannequin/astronoby/pull/222
+[#223]: https://github.com/rhannequin/astronoby/pull/223
+[#225]: https://github.com/rhannequin/astronoby/pull/225
+[#226]: https://github.com/rhannequin/astronoby/pull/226
+[#227]: https://github.com/rhannequin/astronoby/pull/227
+[#228]: https://github.com/rhannequin/astronoby/pull/228
+[#229]: https://github.com/rhannequin/astronoby/pull/229
+[#230]: https://github.com/rhannequin/astronoby/pull/230
+[#232]: https://github.com/rhannequin/astronoby/pull/232
+[#233]: https://github.com/rhannequin/astronoby/pull/233
+[#235]: https://github.com/rhannequin/astronoby/pull/235
+
 ## 0.8.0 - 2025-09-01
 
 _If you are upgrading: please see [UPGRADING.md]._

data/README.md

@@ -11,7 +11,9 @@ Some algorithms are based on the following astrometry books:
   Duffet-Smith and Jonathan Zwart
 
 Solar System bodies' positions are computed based on ephemerides from the
-[IMCCE] or [NASA/JPL].
+[IMCCE] or [NASA/JPL]. The library also supports Earth-orbiting satellite
+tracking through the [TEME] reference frame, suitable for use with SGP4/SDP4
+orbit propagators.
 
 ## Content
 - [Installation](#installation)
@@ -41,9 +43,12 @@ previous versions, you can access the documentation in the README for each
 
 ### See also
 - [Quick Start Guide](docs/README.md) - for getting started examples
-- [Celestial Bodies](docs/celestial_bodies.md) - for understanding planets and objects
+- [Solar System Bodies](docs/solar_system_bodies.md) - for understanding planets
+  and objects
 - [Reference Frames](docs/reference_frames.md) - for coordinate systems
 - [Observer Setup](docs/observer.md) - for location configuration
+- [IERS Data](docs/iers.md) - for Delta T and Greenwich Mean Sidereal Time
+  (GMST) data management
 - [Glossary](docs/glossary.md) - for astronomical and technical terms
 
 ### Expected breaking changes notice
@@ -58,11 +63,12 @@ described in the [UPGRADING] document.
 ## Precision
 
 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.
+as seen from an observer on Earth is around 1-2 arc seconds, with sub-arcsecond
+often achieved. This corresponds to less than the apparent size of Neptune when
+it is closest to Earth.
 
 While the precision is not enough for spacecraft navigation, it is enough for
-automated guiding of amateur telescopes.
+automated guiding of amateur telescopes and some professional use-cases.
 
 The sources used for comparison are: [IMCCE], [JPL Horizons], [Stellarium],
 and the [Skyfield] library.
@@ -120,6 +126,7 @@ 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
+[TEME]: https://github.com/rhannequin/astronoby/blob/main/docs/reference_frames.md#teme
 [Bundler]: https://bundler.io
 [`docs/`]: https://github.com/rhannequin/astronoby/blob/main/docs
 [release]: https://github.com/rhannequin/astronoby/releases

data/UPGRADING.md

@@ -7,6 +7,115 @@ changes to it as long as a major version has not been released.
 If you are already using Astronoby and wish to follow the changes to its
 public API, please read the upgrading notes for each release.
 
+## Upgrading from 0.9.0 to 0.10.0
+
+### Minimum Ruby version bumped to 3.2.0
+
+The minimum required Ruby version is now 3.2.0 (previously 3.0.0), due to the
+new `iers` gem dependency.
+
+### Delta T and GMST now use IERS data
+
+Delta T (TT - UT1) is now computed from IERS data via the
+[`iers`](https://github.com/rhannequin/iers) gem instead of hardcoded lookup
+tables. Greenwich Mean Sidereal Time (GMST) is now computed using the IERS
+Conventions 2010 ERA-based expression instead of the Duffett-Smith polynomial.
+
+Both changes improve accuracy significantly (Delta T error reduced from ~0.5s
+to ~0.001s, GMST error reduced by 600-2200x vs Skyfield). As a result,
+computed values for sidereal times, horizontal coordinates, and
+rise/transit/set times may differ slightly from previous versions.
+
+The `iers` gem ships with bundled data files that work out of the box. See
+[IERS Data](docs/iers.md) for details on data coverage and updates.
+
+### `SolarSystemBody` initialization is now lazy
+
+`SolarSystemBody#initialize` no longer eagerly computes geometric positions,
+light-time corrections, or Sun data. All computations are now deferred until
+the corresponding method is first called. This means ephemeris-related errors
+will surface on first property access rather than during instantiation.
+
+### `SolarSystemBody#geometric` is now a lazy method
+
+`geometric` was previously exposed via `attr_reader` and eagerly computed in
+`initialize`. It is now a lazy memoized method. The public interface is
+unchanged — `body.geometric` still returns a `Geometric` object.
+
+### `SolarSystemBody#ephem` is now publicly accessible
+
+The `ephem` object passed to `initialize` is now exposed via `attr_reader`.
+
+### `ReferenceFrame#center_identifier` replaced by `#center`
+
+Every reference frame previously exposed `#center_identifier`, an `Integer`
+(e.g. `Astronoby::SolarSystemBody::EARTH`) for barycentric/geocentric frames or
+a `[longitude, latitude]` array for topocentric frames. It is replaced by
+`#center`, which returns an `Astronoby::Center` value object.
+
+```rb
+# Before
+frame.center_identifier # => 399 or [longitude, latitude]
+
+# After
+frame.center                 # => #<Astronoby::Center ...>
+frame.center.geocentric?     # => true
+frame.center == Astronoby::Center.geocentric # => true
+frame.center.observer        # => the Observer, for topocentric frames
+```
+
+Two topocentric centers are equal when their observers share the same
+latitude, longitude and elevation (atmospheric parameters are ignored).
+
+### `Sun#equation_of_time` now returns a `Duration`
+
+Lengths of time are now wrapped in a new `Astronoby::Duration` value object,
+consistent with `Angle`, `Distance` and `Velocity`. As a result,
+`Sun#equation_of_time` returns an `Astronoby::Duration` instead of an
+`Integer` of seconds. Call `#seconds` to get the previous value.
+
+```rb
+# Before
+sun.equation_of_time # => -185
+
+# After
+sun.equation_of_time         # => #<Astronoby::Duration ...>
+sun.equation_of_time.seconds # => -185
+sun.equation_of_time.minutes # => -3.08...
+```
+
+A `Duration` can be built with `from_seconds`, `from_minutes`, `from_hours`
+and `from_days`, and read back in any of those units. It is immutable,
+comparable, and supports `+` and `-`.
+
+Note that `EclipsePhase#duration`, also introduced in this release, returns
+an `Astronoby::Duration` as well.
+
+## Upgrading from 0.8.0 to 0.9.0
+
+### Constant `MINUTES_PER_DEGREE` renamed
+
+The constant `Constants::MINUTES_PER_DEGREE` has been renamed to
+`Constants::ARC_MINUTES_PER_DEGREE` to clarify its purpose. The value remains
+unchanged (`60.0`).
+
+### Signature change in `RiseTransitSetCalculator`
+
+The `RiseTransitSetCalculator` constructor's `ephem` key argument is not
+mandatory anymore. This allows to support bodies that don't require ephemerides
+(e.g. deep-sky objects).
+
+### Sidereal time API change
+
+It is is now preferred to use `Instant#gmst`, `Instant#gast`, `Instant#lmst` and
+`Instant#last` to get sidereal times.
+
+It is also possible to use dedicated classes:
+- `GreenwichMeanSiderealTime`
+- `GreenwichApparentSiderealTime`
+- `LocalMeanSiderealTime`
+- `LocalApparentSiderealTime`
+
 ## Upgrading from 0.7.0 to 0.8.0
 
 ### Benchmark directory changed

data/docs/README.md

@@ -34,7 +34,7 @@ You can learn more about time scales on the [Instant page].
 jupiter = Astronoby::Jupiter.new(instant: instant, ephem: ephem)
 ```
 
-You can learn more about planets and bodies on the [Celestial Bodies page].
+You can learn more about planets and bodies on the [Solar System Bodies page].
 
 ## Define an observer from geographic coordinates
 
@@ -62,10 +62,10 @@ You can learn more about reference frames and positions on the
 
 ```rb
 topocentric.horizontal.azimuth.str(:dms)
-# => "+175° 34′ 28.2724″"
+# => "+175° 34′ 33.2353″"
 
 topocentric.horizontal.altitude.str(:dms)
-# => "+64° 22′ 58.1084″"
+# => "+64° 22′ 58.229″"
 ```
 
 You can learn more about coordinates on the [Coordinates page].
@@ -108,22 +108,22 @@ calculator = Astronoby::TwilightCalculator.new(
 event = calculator.event_on(Date.new(2025, 5, 1))
 
 event.morning_astronomical_twilight_time
-# => 2025-05-01 02:17:28 UTC
+# => 2025-05-01 02:17:07 UTC
 
 event.morning_nautical_twilight_time
-# => 2025-05-01 03:10:17 UTC
+# => 2025-05-01 03:09:44 UTC
 
 event.morning_civil_twilight_time
-# => 2025-05-01 03:55:17 UTC
+# => 2025-05-01 03:54:38 UTC
 
 event.evening_civil_twilight_time
-# => 2025-05-01 19:40:12 UTC
+# => 2025-05-01 19:41:51 UTC
 
 event.evening_nautical_twilight_time
-# => 2025-05-01 20:25:12 UTC
+# => 2025-05-01 20:26:56 UTC
 
 event.evening_astronomical_twilight_time
-# => 2025-05-01 21:18:01 UTC
+# => 2025-05-01 21:19:57 UTC
 ```
 
 You can learn more about this calculator on the [Twilight times page].
@@ -141,7 +141,7 @@ may_2024_phases.each { puts "#{_1.phase}: #{_1.time}" }
 # new_moon: 2024-05-08 03:21:56 UTC
 # first_quarter: 2024-05-15 11:48:02 UTC
 # full_moon: 2024-05-23 13:53:12 UTC
-# last_quarter: 2024-05-30 17:12:43 UTC
+# last_quarter: 2024-05-30 17:12:42 UTC
 ```
 
 ```rb
@@ -150,14 +150,53 @@ instant = Astronoby::Instant.from_time(time)
 moon = Astronoby::Moon.new(ephem: ephem, instant: instant)
 
 moon.illuminated_fraction.round(2)
-# => 0.15
+# => 0.95
 
 moon.current_phase_fraction.round(2)
-# => 0.11
+# => 0.59
 ```
 
 You can learn more about phases on the [Moon phases page].
 
+## Lunar observation
+
+```rb
+time = Time.utc(2025, 3, 1)
+instant = Astronoby::Instant.from_time(time)
+moon = Astronoby::Moon.new(ephem: ephem, instant: instant)
+
+moon.libration.longitude.str(:dms)
+# => "-2° 5′ 4.4219″"
+
+moon.libration.latitude.str(:dms)
+# => "+0° 28′ 45.9616″"
+
+moon.position_angle_of_axis.str(:dms)
+# => "-21° 48′ 46.657″"
+
+moon.bright_limb_position_angle.str(:dms)
+# => "+248° 1′ 57.9467″"
+```
+
+You can learn more about libration, axis and limb angles on the
+[Lunar observation page].
+
+## Lunar eclipses
+
+```rb
+eclipses = Astronoby::Moon.eclipse_events(
+  ephem: ephem,
+  start_time: Time.utc(2025, 1, 1),
+  end_time: Time.utc(2026, 1, 1)
+)
+
+eclipses.map { |eclipse| [eclipse.instant.to_time, eclipse.kind] }
+# => [[2025-03-14 06:58:47 UTC, :total], [2025-09-07 18:11:49 UTC, :total]]
+```
+
+You can learn more about umbral and penumbral magnitudes, phases and contact
+times on the [Lunar eclipses page].
+
 ## Equinox and solstice times
 
 ```rb
@@ -166,26 +205,76 @@ Astronoby::EquinoxSolstice.march_equinox(2025, ephem)
 # => 2025-03-20 09:01:29 UTC
 
 Astronoby::EquinoxSolstice.june_solstice(2025, ephem)
-# => 2025-06-21 02:42:19 UTC
+# => 2025-06-21 02:42:16 UTC
 
 Astronoby::EquinoxSolstice.september_equinox(2025, ephem)
-# => 2025-09-22 18:19:22 UTC
+# => 2025-09-22 18:19:21 UTC
 
 Astronoby::EquinoxSolstice.december_solstice(2025, ephem)
-# => 2025-12-21 15:03:03 UTC
+# => 2025-12-21 15:03:05 UTC
 ```
 
 You can learn more about equinoxes and solstices on the
 [Equinoxes and solstices times page].
 
+## Planetary phenomena
+
+```rb
+Astronoby::Mars.opposition_events(
+  ephem: ephem,
+  start_time: Time.utc(2025, 1, 1),
+  end_time: Time.utc(2026, 1, 1)
+).first.instant.to_time
+# => 2025-01-16 02:38:35 UTC
+
+Astronoby::Venus.greatest_elongation_events(
+  ephem: ephem,
+  start_time: Time.utc(2025, 1, 1),
+  end_time: Time.utc(2026, 1, 1)
+).first.angle.degrees.round(1)
+# => 47.2
+```
+
+You can learn more about conjunctions, oppositions and greatest elongations on
+the [Planetary phenomena page].
+
+## Deep-sky objects
+
+It is possible to manipulate any deep-sky possible, given equatorial coordinates
+from a catalogue at J2000 epoch.
+
+```rb
+time = Time.utc(2025, 10, 1)
+instant = Astronoby::Instant.from_time(time)
+
+vega_j2000 = Astronoby::Coordinates::Equatorial.new(
+  right_ascension: Astronoby::Angle.from_hms(18, 36, 56.33635),
+  declination: Astronoby::Angle.from_dms(38, 47, 1.2802),
+  epoch: Astronoby::JulianDate::J2000
+)
+
+# Build the body for star Vega
+vega = Astronoby::DeepSkyObject.new(equatorial_coordinates: vega_j2000)
+
+# Build the position of star Vega for a given instant
+vega_position = vega.at(instant)
+
+vega_position.apparent.equatorial.right_ascension.str(:hms)
+# => "18h 37m 48.2804s"
+```
+
+You can learn more about deep-sky objects on the [Deep-sky Bodies page].
+
 ## See also
+
 - [Glossary](glossary.md) - for astronomical and technical terms
+- [IERS Data](iers.md) - for Delta T and GMST data management
 - [Configuration](configuration.md) - for performance tuning
 - [Performance Benchmarks](../benchmarks/README.md) - for testing improvements
 
 [Ephem page]: ephem.md
 [Instant page]: instant.md
-[Celestial Bodies page]: celestial_bodies.md
+[Solar System Bodies page]: solar_system_bodies.md
 [Observer page]: observer.md
 [Reference Frames page]: reference_frames.md
 [Angles page]: angles.md
@@ -193,4 +282,8 @@ You can learn more about equinoxes and solstices on the
 [Rise, transit and setting times page]: rise_transit_set_times.md
 [Twilight times page]: twilight_times.md
 [Moon phases page]: moon_phases.md
+[Lunar observation page]: lunar_observation.md
+[Lunar eclipses page]: lunar_eclipses.md
 [Equinoxes and solstices times page]: equinoxes_solstices_times.md
+[Planetary phenomena page]: planetary_phenomena.md
+[Deep-sky Bodies page]: deep_sky_bodies.md

data/docs/angles.md

@@ -131,7 +131,8 @@ angle1.negative? # => false
 ```
 
 ## See also
+
 - [Coordinates](coordinates.md) - for using angles in coordinate systems
 - [Observer](observer.md) - for latitude and longitude
 - [Reference Frames](reference_frames.md) - for position calculations
-- [Celestial Bodies](celestial_bodies.md) - for object positions
+- [Solar System Bodies](solar_system_bodies.md) - for object positions

data/docs/configuration.md

@@ -20,11 +20,12 @@ Astronoby.configuration.cache_enabled = true
 
 Once caching is enabled, it will be used for the following parts of the library
 with default precision values:
-* [Geometric positions]
-* [Topocentric positions] when computing rising/transit/setting times
-* [Moon phases]
-* Nutation
-* Precession
+
+- [Geometric positions]
+- [Topocentric positions] when computing rising/transit/setting times
+- [Moon phases]
+- Nutation
+- Precession
 
 ## Cache precision
 
@@ -35,10 +36,11 @@ However, users may want to improve performance even more at the cost of some
 precision.
 
 It is possible to change the precision value for the following:
-* Geometric position, default: `9`
-* Topocentric position, default: `5`
-* Nutation, default: `2`
-* Precession, default: `2`
+
+- Geometric position, default: `9`
+- Topocentric position, default: `5`
+- Nutation, default: `2`
+- Precession, default: `2`
 
 ### Precision value
 
@@ -49,14 +51,14 @@ Let's take the example of `1`. Rounding a Julian Day with only one digit means
 that all times within 8640 seconds will be rounded to the same instant, which
 means a maximum rounding of 2.4 hours.
 
-* `1`: 2.4 hours
-* `2`: 14.4 minutes
-* `3`: 86.4 seconds
-* `4`: 8.6 seconds
-* `5`: 0.86 seconds
-* `6`: 0.086 seconds
-* `7`: 0.0086 seconds
-* ...
+- `1`: 2.4 hours
+- `2`: 14.4 minutes
+- `3`: 86.4 seconds
+- `4`: 8.6 seconds
+- `5`: 0.86 seconds
+- `6`: 0.086 seconds
+- `7`: 0.0086 seconds
+- ...
 
 ### Setting custom precision
 
@@ -92,6 +94,7 @@ Astronoby.cache.max_size
 [Julian Day]: https://en.wikipedia.org/wiki/Julian_day
 
 ## See also
+
 - [Reference Frames](reference_frames.md) - for understanding position calculations
 - [Ephemerides](ephem.md) - for data sources
 - [Performance Benchmarks](benchmarks/README.md) - for testing improvements