Skip to content

Introduce barycentric position of Solar System major bodies#127

Merged
rhannequin merged 10 commits intomainfrom
barycentric-position
Feb 5, 2025
Merged

Introduce barycentric position of Solar System major bodies#127
rhannequin merged 10 commits intomainfrom
barycentric-position

Conversation

@rhannequin
Copy link
Owner

@rhannequin rhannequin commented Jan 31, 2025

This implements planet objects like Earth or Mars and support barycentric position for them.

It adds a dependency with the ephem gem which provides accurate coordinates (Cartesian position and velocity of major Solar System bodies using ephemerides like JPL Development Ephemeris.

This implementation relies on downloading and loading an ephemeris to be able to instantiate planets, and introduces Astronoby::Ephem to help do so.

Each planet implements a #barycentric method, which returns a Barycentric position object.
Position objects (only Barycentric is supported for now) provide two main methods:

  • #position: Vector of (x,y,z) Distance
  • #velocity: Vector of (x,y,z) Velocity

Velocity is a new value object and encapsulate velocities to help converting them (meters per second, kilometers per second, kilometers per day).

Ephem::IO::Download.call(name: "de440s.bsp", target: "tmp/de440s.bsp")
# This can take time depending on the size of the ephemeris and your network performance

ephem = Astronoby::Ephem.load("tmp/de440s.bsp")

time = Time.utc(2025, 2, 7, 12)
instant = Astronoby::Instant.from_time(time)

mars = Astronoby::Mars.new(ephem: ephem, instant: instant)

mars.barycentric.position.x.kilometers # => -145270988.1901424
mars.barycentric.position.y.kilometers # => 178570354.34950638
mars.barycentric.position.z.kilometers # => 85848602.75019804

mars.barycentric.velocity.x.kilometers_per_day # => -1613303.506964632
mars.barycentric.velocity.y.kilometers_per_day # => -973055.3230063843
mars.barycentric.velocity.z.kilometers_per_day # => -402780.15249225753

The new class is a wrapper around the Ephem gem.

It allows to download an ephemeris from the internet and load it using
the Ephem gem.

Unlike Ephem, Astronoby deals with ephemeris file in an agnostic way,
regardless of the format. Internally, it knows we're only dealing with
SPK files from NASA JPL, but this is not a constraint Astronoby users
should worry about.
@rhannequin rhannequin self-assigned this Jan 31, 2025
@rhannequin rhannequin force-pushed the barycentric-position branch from 05935ae to d4b770d Compare February 3, 2025 10:18
@rhannequin rhannequin force-pushed the barycentric-position branch from f56d2a9 to d294c5d Compare February 3, 2025 13:00
@rhannequin rhannequin marked this pull request as ready for review February 3, 2025 13:00
@rhannequin rhannequin merged commit 90f571f into main Feb 5, 2025
32 checks passed
@rhannequin rhannequin deleted the barycentric-position branch February 5, 2025 20:52
@rhannequin rhannequin mentioned this pull request Apr 30, 2025
rhannequin added a commit that referenced this pull request May 12, 2025
## 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 #124
* @JoelQ made their first contribution in #166

**Full Changelog**: v0.6.0...v0.7.0

[#120]: #120
[#121]: #121
[#122]: #122
[#123]: #123
[#124]: #124
[#125]: #125
[#126]: #126
[#127]: #127
[#128]: #128
[#129]: #129
[#130]: #130
[#131]: #131
[#132]: #132
[#133]: #133
[#134]: #134
[#135]: #135
[#136]: #136
[#137]: #137
[#138]: #138
[#139]: #139
[#140]: #140
[#141]: #141
[#142]: #142
[#143]: #143
[#145]: #145
[#146]: #146
[#147]: #147
[#148]: #148
[#149]: #149
[#150]: #150
[#151]: #151
[#152]: #152
[#153]: #153
[#154]: #154
[#155]: #155
[#156]: #156
[#157]: #157
[#160]: #160
[#163]: #163
[#165]: #165
[#166]: #166
[#167]: #167
[#168]: #168
[#169]: #169
[#172]: #172
[#173]: #173
[#174]: #174
[#175]: #175
[#176]: #176
[UPGRADING.md]: https://github.com/rhannequin/astronoby/blob/main/UPGRADING.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant