Веками люди смотрели на Луну, пытаясь понять и спрогнозировать её поведение. Знание фаз Луны необходимо не только астрономам и романтикам, но и навигаторам, фермерам и даже программистам. Благодаря инициативе программиста Oliver K. Webb, на GitHub появился полезный и оригинальный репозиторий moonphase, который предоставляет простые и эффективные алгоритмы определения текущей фазы Луны практически на всех популярных языках программирования.
Репозиторий привлекает внимание своей практичностью и многообразием реализации алгоритма. В нём представлены имплементации на языках:
🔧 Системные языки:
- ⚙️ C/C++
- 🦀 Rust
- 🚀 Zig
📜 Скриптовые языки:
- 🌓 Lua
- 🌐 JavaScript
- 🐍 Python
💻 DSL и микролокальные языки:
- 🗒️ awk
- 🖩 bc
🌟 Чем примечателен алгоритм?
Алгоритм основывается на классическом подходе, предложенном Джоном Уокером (John Walker) в программе Moontool, появившейся в 80-х годах. Уокер, в свою очередь, опирался на книгу «Practical Astronomy With Your Calculator». С тех пор, несмотря на бурное развитие технологий, базовый подход остаётся надёжным, понятным и универсальным.
📐 Как это работает?
Основная идея алгоритма заключается в следующем:
- Принимаем на вход текущее время (обычно UNIX timestamp или аналогичный формат).
- Вычисляем угол фазы Луны в радианах. Из этого угла можно получить долю освещённости поверхности Луны с помощью формулы:
(1 - cos(угол))/2 - Этот подход позволяет однозначно определить фазу Луны даже при повторении одинаковых значений освещённости (например, первая и третья четверть имеют одинаковую долю освещённости 50%, но отличаются углом и направлением освещения).
🎨 Интересные технические моменты
🔍 Чистота реализации (Pure function)
Автор поставил чёткое условие: функции должны быть максимально чистыми (pure), то есть они должны легко копироваться и вставляться в любой проект без внешних зависимостей и побочных эффектов. Например, никакого изменения глобальных переменных или использования директив препроцессора, которые могут повлиять на окружение вне функции.
🧮 Пример реализации (Rust)
Приведём фрагмент кода на языке Rust, демонстрирующий элегантный подход к определению фазы Луны по проценту освещённости и углу фазы:
fn phaseidx(ilumfrac: f64, ang: time::Angle) -> usize {
match (ilumfrac, ang.degrees() > 90.0) {
(0.00..0.04, _) => 0, // 🌑 Новолуние
(0.96..1.00, _) => 4, // 🌕 Полнолуние
(0.46..0.54, true) => 6, // 🌗 Последняя четверть
(0.46..0.54, false) => 2,// 🌓 Первая четверть
(0.54..0.96, true) => 5, // 🌖 Убывающая Луна
(0.54..0.96, false) => 3,// 🌔 Растущая Луна
(_, true) => 7, // 🌘 Убывающий серп
(_, false) => 1, // 🌒 Растущий серп
}
}
Для корректности угла он должен быть нормализован в диапазон [0°;360°).
🚩 Как это использовать на практике?
Алгоритмы из репозитория могут быть полезны для:
- 🗓️ Создания календарей и приложений с лунным календарём.
- 🎲 Интеграции в игры, где фазам Луны отводится особая роль (например, в фэнтези-играх для определения появления монстров или оборотней).
- 🌱 Агрономических расчётов, где учитываются фазы Луны при посадке растений.
- ⛵ Морских и навигационных программ для расчёта приливов и отливов.
💡 Мнение автора статьи: почему это важно и интересно?
В наше время, когда большинство программистов используют готовые библиотеки и API для астрономических расчётов, этот репозиторий выделяется своей лаконичностью и ясностью реализации. Он напоминает о том, что даже сложные вещи могут быть выражены простым и понятным кодом.
Более того, автор статьи считает, что именно такая мультиплатформенная реализация подчёркивает красоту программирования — возможность выразить одну и ту же идею на множестве языков, адаптируясь к требованиям и возможностям каждого из них.
Также стоит отметить педагогический аспект: подобные репозитории идеально подходят для изучения новых языков и сравнения их синтаксиса и возможностей.
🔗 Полезные ссылки:
Таким образом, проект moonphase — яркий пример того, как простота и ясность алгоритмов способны покорить программистов со всего мира, а также вдохновить их на изучение и творческое использование астрономии в своих проектах. 🌝✨