Welcome to the Lunar Almanac
Whether you are an astrophotographer planning a deep-sky shoot, an angler tracking solunar periods, or simply a stargazer looking for the next Blood Moon, this guide will help you understand the metrics and badges displayed in WeatherAPP Libre's Lunar Calendar and astronomical tools.
1. Lunar Phases & The Synodic Cycle
The Moon's appearance changes continuously as it orbits the Earth, driven by the changing angles of illumination from the Sun. This cycle, known as the synodic month, dictates the fundamental rhythm of the lunar calendar and is the baseline for all other lunar phenomena.
- Synodic Month
- The time it takes for the Moon to complete one full cycle of phases (e.g., from New Moon to New Moon). This period averages approximately 29.53 days. Because it is not a whole number of days, the phases shift slightly each month relative to our calendar.
- Illumination Fraction
- The percentage of the Moon's visible disk that is currently lit by the Sun. A New Moon is 0% illuminated, while a Full Moon is 100% illuminated. WeatherAPP Libre calculates this using exact geometric angles rather than simple approximations.
- Moon Age
- The number of days that have passed since the last exact New Moon. A Moon Age of ~0 days indicates a New Moon, ~7.4 days indicates First Quarter, ~14.8 days indicates Full Moon, and ~22.1 days indicates Last Quarter.
- Waxing vs. Waning
- Waxing means the illuminated portion is growing (moving from New to Full). Waning means the illuminated portion is shrinking (moving from Full back to New). In the Northern Hemisphere, a waxing moon is illuminated on the right, while a waning moon is illuminated on the left.
- Apparent Diameter
- The visual size of the Moon in the sky, measured in arcminutes ('). Because the Moon's orbit is elliptical, its distance from Earth varies, causing its apparent diameter to range from about 29.3' (at apogee) to 34.1' (at perigee).
2. Lunar Eclipses
A lunar eclipse occurs when the Earth passes directly between the Sun and the Moon, casting its shadow onto the lunar surface. Because the Earth's shadow has two distinct parts—the outer penumbra and the inner umbra—eclipses are classified by how deeply the Moon penetrates these shadow cones.
- Penumbral Lunar Eclipse
- Occurs when the Moon passes only through the Earth's outer, faint shadow (the penumbra). The dimming is very subtle and often difficult to notice with the naked eye unless the eclipse is deep.
- Partial Lunar Eclipse
- Occurs when a portion of the Moon enters the Earth's dark inner shadow (the umbra), while the rest remains in the penumbra or fully illuminated. A distinct, dark "bite" appears to be taken out of the lunar disk.
- Total Lunar Eclipse (Blood Moon)
- Occurs when the entire Moon passes into the Earth's umbra. Instead of going completely dark, the Moon often turns a striking coppery-red or orange. This happens because Earth's atmosphere bends (refracts) sunlight around the planet, filtering out blue light and projecting red light onto the Moon.
- Umbral Magnitude
- A metric indicating how deeply the Moon penetrates the umbra. A magnitude of 0.0 means it just touches the umbra; 0.5 means half the Moon's diameter is inside; and 1.0 or greater indicates a Total Eclipse.
- Contact Times (P1, U1, U2, U3, U4, P4)
- The exact timestamps defining the stages of an eclipse. P1/P4 mark entry/exit of the penumbra. U1/U4 mark entry/exit of the umbra (partial phases). U2/U3 mark the beginning and end of totality.
3. Special Lunar Events
Beyond standard phases, the Moon's elliptical orbit, its relationship to the seasons, and calendar definitions create notable visual events. WeatherAPP Libre highlights these events with distinct badges in the Lunar Calendar.
- Supermoon
- A Full Moon that coincides with perigee—the point in the Moon's orbit where it is closest to Earth (typically under 360,000 km). A Supermoon appears up to 14% larger and 30% brighter than a standard Full Moon.
- Micromoon
- The opposite of a Supermoon. A Full Moon that coincides with apogee—the farthest point in the Moon's orbit (typically over 404,000 km). It appears noticeably smaller and dimmer than average.
- Blue Moon
- Traditionally defined as the second Full Moon to occur within a single calendar month. Because the synodic month is ~29.5 days, this rare alignment happens roughly once every 2.5 years.
- Harvest Moon
- The Full Moon that occurs closest to the Autumnal Equinox. Historically significant for agriculture, it is unique because it rises at nearly the same time for several consecutive nights, providing extended evening light.
- Syzygy
- An astronomical term describing a straight-line configuration of three celestial bodies. In the context of the Moon, syzygy occurs during every exact New Moon and Full Moon, when the Sun, Earth, and Moon are aligned, resulting in higher-than-average "spring" tides.
4. Atmospheric Optical Phenomena
Occasionally, moonlight interacts with ice crystals or water droplets in Earth's atmosphere, creating rare and stunning optical illusions. WeatherAPP Libre uses heuristic probability models (combining lunar illumination, altitude, and cloud microphysics) to forecast the likelihood of these events.
- Lunar Moonbow
- A rainbow created by moonlight rather than sunlight. Requires a nearly Full Moon (high illumination), a low moon altitude (under 42°), and falling rain or mist in the opposite direction of the Moon. Because moonlight is faint, moonbows often appear white to the naked eye but reveal color in long-exposure photographs.
- Lunar Halo
- A massive, glowing ring with a 22° radius surrounding the Moon. It is caused by moonlight refracting through millions of hexagonal ice crystals suspended in high-altitude cirrus clouds. Often a precursor to an approaching warm front and precipitation.
- Lunar Corona
- Not to be confused with a halo, a corona is a tight, multi-colored ring (or rings) immediately hugging the Moon. It is caused by the diffraction of moonlight through uniform water droplets in thin, mid-level clouds like altocumulus.
- Parselene (Mock Moon)
- The lunar equivalent of a "sun dog." These are bright, distinct spots of light that appear on the left and right of the Moon, sitting on the same horizontal plane. They are caused by moonlight refracting through flat, plate-like ice crystals in the atmosphere.
5. Observation & Planning Tools
WeatherAPP Libre features dedicated calculation engines designed to help astronomers, photographers, and outdoor enthusiasts plan their activities around the lunar cycle and local weather conditions.
- True Dark Sky Window
- Calculates the exact periods of "Astronomical Darkness" (when the Sun is more than 18° below the horizon) and cross-references this with the Moon's interference. This tells deep-sky astrophotographers exactly when the sky will be darkest and free of lunar washout.
- Night Visibility Forecast
- Estimates the ambient light potential for the night. It factors in lunar illumination, moon altitude, twilight phases, and crucially, integrates with local weather forecasts to account for cloud cover attenuation, providing a realistic "Viewing Score" for the night.
- Stellar and Selenic Viewing Scores
- To serve both deep-sky and lunar observers, the Lunar Calendar displays two distinct metrics. The Stellar score favors dark skies and minimal moonlight, indicating conditions suitable for viewing the Milky Way, stars, and deep-space objects. The Selenic score favors high lunar illumination and clear skies, indicating conditions suitable for observing the Moon's surface features.
- Special Events Generator
- A calculation engine that generates a three-year forward-looking schedule of special lunar events (eclipses, supermoons, micromoons). This schedule is cached locally, allowing instant browsing of rare celestial alignments within the app's dedicated events view.
- Solunar Activity
- Based on traditional solunar theory, this tool calculates Major and Minor activity periods for wildlife. Major periods occur when the Moon is transiting (directly overhead) or at its nadir (directly underfoot). Minor periods align with moonrise and moonset. Highly utilized by anglers and hunters.
- Transit Altitude & Azimuth
- The Transit is the moment the Moon reaches its highest point in the sky for the night. The Altitude tells you how high it will be (crucial for avoiding tree lines or buildings), and the Azimuth tells you the exact compass direction it will be facing at that peak.