This change introduces multiple new objects to be able to get all the phase times for a given month.
The Moon phases are: New Moon, First Quarter, Full Moon and Last Quarter.
Because the average lunar month is approximatively 29.5 days, most of the time there are only one of each phase per month. This also means that in some configuration, it is possible to have only 3 phases in a month, or to have a phase happening twice in a month, giving 5 phases:
February 2012 had only a Full Moon, Last Quarter and New Moon
May 2024 had two Last Quarter
For this reason, this change generates an array of unknown length, containing a Astronoby::MoonPhase object for each phase happening in the month.
The algorithm provided by Jean Meeus report having a mean margin error of 3 seconds, which has been confirmed from a few comparisons with the IMCCE.
The new Astronoby::MoonPhase object only exposes the time and phase name of the event. In the future, it could be interesting to add more methods like #full_moon? or similar.
Astronoby::Events::MoonPhases contains all the logic and exposes the final list. This list can also be accessed through Astronoby::Moon for ease of use.
trevorturk
commented
6 months ago
This change introduces multiple new objects to be able to get all the phase times for a given month.
The Moon phases are: New Moon, First Quarter, Full Moon and Last Quarter.
Because the average lunar month is approximatively 29.5 days, most of the time there are only one of each phase per month. This also means that in some configuration, it is possible to have only 3 phases in a month, or to have a phase happening twice in a month, giving 5 phases:
For this reason, this change generates an array of unknown length, containing a
Astronoby::MoonPhaseobject for each phase happening in the month.The algorithm provided by Jean Meeus report having a mean margin error of 3 seconds, which has been confirmed from a few comparisons with the IMCCE.
The new
Astronoby::MoonPhaseobject only exposes thetimeandphasename of the event. In the future, it could be interesting to add more methods like#full_moon?or similar.Astronoby::Events::MoonPhasescontains all the logic and exposes the final list. This list can also be accessed throughAstronoby::Moonfor ease of use.