Астрономические данные и расширения контрактов
Астрономия дополняет погодные данные и входы динамической композиции. Weather 1.7 и динамические контракты 0.1/0.2 сохраняют обязательные поля и прежнюю семантику. Новые необязательные сведения не требуют переименования состояний, устройств, архивов или перехода темы на другую версию схемы.
Совместимость и расширения
Читатель проверяет обязательные поля, типы и диапазоны известных параметров. Незнакомые необязательные свойства и коды групп принимаются и сохраняются. Коды имеют вид group.value, числовые условия — group.field. Список в реестре описывает известные параметры, а не запрещает будущие.
Доступное конечное число можно сравнивать обычными операторами даже для нового имени поля. При отсутствии числа сравнение, в том числе !=, ложно. Неизвестная форма условия или неподдерживаемый оператор отключает всё соответствующее правило, включая случай неизвестной ветки внутри any. Остальные правила и тема продолжают работать. Известные запреты — например чтение derived.life_slot базовыми правилами — сохраняются. Новые необязательные данные не меняют выбранные слои сами по себе.
Старый строгий валидатор нужно обновить один раз: уже установленная программа не приобретает способность пропускать расширения от изменения документации. Поддержка неизвестных необязательных данных закреплена в исправленной редакции схем 0.1/0.2. Неизвестную несовместимую версию schema_version читатель по-прежнему не угадывает.
Где находятся данные
| Документ | Дополнительные сведения |
|---|---|
| Погодный прогноз | astronomy.events; прежние astronomy.days, движок и лунная политика сохраняются |
| Погодное текущее состояние | astronomy.events, независимо от доступности прогноза погоды |
| Общий текущий JSON динамической коллекции | astronomy |
| Сохранённые входы динамической сборки | inputs.astronomy — подробности, inputs.astro — числа, inputs.active — коды |
| Происхождение динамической сборки | provenance.astronomy: движок, ревизия, эфемерида, каталог и статус |
Астрономический снимок содержит schema: 1, status, at, valid_until, source_id, location_revision, timezone, reference_frame, values, active, days, objects, meteor_showers, events. У готового снимка есть revision, версия движка, имя и SHA-256 эфемериды, ревизия каталога. Статусы: ready, unavailable, disabled. Неготовый снимок не добавляет чисел или активных кодов в правила.
Получение и обновление исходных данных
Загрузка выполняется в штатном обновлении погоды, до расчётов; она также доступна отдельной командой refresh_astronomy_sources.py. Чистый астрономический расчёт, воспроизведение истории и режим build-only не скачивают справочники. Обычный погодный --force не отменяет месячный срок; немедленную проверку выполняет отдельная команда refresh_astronomy_sources.py --force.
По умолчанию источники проверяются раз в 30 дней. Отсутствующая или повреждённая рабочая копия загружается сразу, без ожидания месячного срока. Для JPL проверяются каталог коротких файлов deNNNs.bsp и опубликованные контрольные суммы. При неизменных версии и сумме BSP повторно не скачивается. Кандидат должен совпасть с опубликованной суммой, открыться, содержать нужные объекты и поддерживать прежний диапазон дат. Он сохраняется отдельным объектом с SHA-256; указатель переключается только после проверки.
Каталог потоков получается напрямую из JSON Stellarium. Проверяются версия формата 2, уникальность IAU-номеров, полнота 13 используемых потоков, конечные числа и диапазоны. Условные HTTP-запросы позволяют не скачивать неизменный JSON. Сохраняются SHA-256 исходного JSON, ссылка, версия и нормализованные значения. Неизвестная версия, неполные или повреждённые данные не заменяют прежний каталог. PDF не загружаются и не разбираются; pypdf для астрономии не требуется.
Кеш общий для погодных коллекций и динамических тем и находится в служебном хранилище погодного движка. Управление учитывает содержимое, а не даты файлов. Последняя успешная проверка хранится отдельно от неудачной попытки. При сетевом сбое действующая проверенная копия сохраняется; повтор разрешается на следующем погодном интервале, с учётом Retry-After. Параллельные обновления сериализуются. Сохраняются текущая и предыдущая проверенные версии.
В views.weather.astronomy доступны auto_update (по умолчанию true) и update_interval_days (30). auto_update: false отключает сетевое получение справочников. Явный ephemeris закрепляет пользовательский локальный файл и исключает его автоматическую замену. Изменение рабочего содержимого сразу подхватывается в процессе; перезапуск для новой эфемериды или нового календаря не требуется.
Что рассчитывается
Расчёты выполняются локально через Skyfield 1.55. Эфемерида получается загрузчиком в общий кеш; в пакет кода BSP не входит. Ранее установленная начальная копия при наличии может использоваться как резервная. Штатное обновление погоды проверяет внешние источники и выбирает проверенную совместимую эфемериду из локального кеша. Годовой календарь и времена восхода/захода Луны кешируются по содержимому исходных данных и местоположению. Отсутствие библиотеки или эфемериды делает недоступной дополнительную астрономию; прежняя погода и композиция продолжают работать.
| Данные | Смысл |
|---|---|
| Луна | Геометрические высота и азимут, геоцентрические расстояние, освещённая доля и фазовый угол; местные восход/заход |
| Солнце | Долгота J2000 и стадия темноты; коды золотого и синего часа |
| Планеты | Высота, азимут и элонгация Меркурия, Венеры, Марса, Юпитера и Сатурна |
| Звёздные объекты | Положение представительных точек Плеяд и Ориона в ICRS J2000 |
| Календарь | Ближайшие основные фазы Луны, равноденствия, солнцестояния и максимумы лунных затмений |
| Метеорные потоки | Активность 13 основных потоков, номинальные максимумы, положение радианта и условия наблюдения |
Стадия astro.darkness: 0 — тёмная ночь, 1 — астрономические, 2 — навигационные, 3 — гражданские сумерки, 4 — Солнце над горизонтом. Азимуты и долготы находятся в диапазоне 0 ≤ угол < 360°. Высота — от −90° до +90°. Освещённая доля Луны — 0–1, расстояние — километры. Непрерывный фазовый угол не заменяет существующую художественную фазу moon.*.
Золотой час: −4° ≤ высота Солнца ≤ 6°. Синий час: −6° ≤ высота < −4°. Это отдельные признаки, которые не меняют прежние time.dawn/day/dusk/night. Метеорологические сезоны также сохраняются при публикации равноденствия или солнцестояния.
events — упорядоченный список ближайших моментов на 32 дня. Типы: moon_phase, season, meteor_shower_peak, lunar_eclipse. Для затмения публикуется расчётный максимум и положение Луны над горизонтом в этот момент; контакты и длительность затмения этим списком не обещаются. Солнечные затмения, пролёты спутников, кометы и прогноз сияния в эту редакцию не входят.
Активность и видимость
Активный метеорный поток существует независимо от облаков, местного дня и горизонта наблюдателя. Поэтому astro.meteor_perseids_active и astro.meteor_perseids_observable — разные коды. Дополнительно есть astro.meteor_perseids_near_peak (отклонение от номинальной солнечной долготы не более 1°) и общий astro.meteor_shower_active.
Справочные периоды активности и ZHR берутся из JSON Stellarium. Активность проверяется по интервалу солнечной долготы J2000, включая переход через 0°. Основа — ежегодная модель generic; запись с точным совпадением года дополняет её только для этого года, включая частичные переопределения. Исторические всплески не переносятся на текущий год. Общий catalog_annual_approximation равен true, catalog_reference_year — null; у отдельного потока year_specific показывает наличие сведений для расчётного года. Переменный ZHR передаётся как null с zhr_qualifier: variable и справочным zhr_range, без выбора выдуманного среднего. Это каталог для моделирования, а не ежегодный бюллетень прогнозов всплесков IMO. Ранее сохранённые нормализованные таблицы с календарными датами также читаются. Номинальный максимум вычисляется по солнечной долготе для равноденствия J2000.0. Радиант в этой редакции фиксирован на координатах максимума: вне максимума его положение приблизительное. ZHR — справочная интенсивность в идеальных условиях, а не число видимых метеоров в нашем месте. Отдельные метеоры не предсказываются.
Для потоков геометрическое окно требует радиант не ниже 10° и Солнце не выше −18°. Для объектов — высоту не ниже 10° и Солнце не выше −12°. Погодный фильтр: облачность не более 40 %, видимость не менее 10 км. Эти пороги — объявленная модель пригодности для оформления, а не гарантия наблюдения. Лунная засветка потока отмечается отдельно в moon_interference.
При отсутствии погодных измерений weather_suitable равен null; при подходящей геометрии observable также null. Дневное небо или объект под горизонтом дают observable: false. Коды *_observable добавляются только при true. Модель не учитывает рельеф, городскую засветку, атмосферное преломление и прозрачность по направлению к отдельному объекту.
Пример правила
{
"all": [
{"code": "astro.meteor_perseids_active"},
{"field": "astro.darkness", "op": "=", "value": 0},
{"field": "weather.cloud_cover", "op": "<=", "value": 30}
]
}
Условия лишь выбирают подготовленный автором слой. Они не рисуют метеоры автоматически. Для геометрической проверки можно добавить сравнение astro.meteor_perseids_radiant_elevation >= 10. Новые числовые имена такого вида работают без изменения синтаксиса правил.
Космические темы и игровой мир
Наземный снимок сохраняет reference_frame: earth_surface: положение объектов и пригодность наблюдения относятся к месту погодного источника. Космический наблюдатель объявляется отдельно в профиле темы; для environment: space генератор читает devices.<device>.render.orbit и render.camera и выдаёт inputs.space_scene. Наземные облачность и горизонт не становятся условиями видимости станции. Реализованы общий Hipparcos, векторы тел, RTN/камера, освещение, перекрытия и отдельная орбитальная пригодность потоков. Подробности — орбитальная астрономия.
Для game-world земные события автоматически не добавляются. Явный режим views.weather.astronomy.game_world: earth_analogue разрешает земной аналог с действующими координатами и смещением календаря мира. Снимок сохраняет рассчитанную дату и смещение. Приложение не подменяет их своими местными часами.
Веб-клиент и воспроизведение
Данные передаются в JSON динамической темы как необязательное расширение. Веб-интерфейс сохраняет прежнее оформление; дополнительных астрономических подписей в нём нет. Загрузка и проверка JPEG продолжают работать независимо от доступности астрономических сведений. Нативным приложениям для получения прежнего готового кадра новые данные не требуются.
История сохраняет использованные входы. Воспроизведение сборки использует их и готовый рецепт; свежий астрономический расчёт не запускается. Если дополнительные данные не изменили выбранные слои, прежний JPEG переиспользуется. Появление новых сведений не продлевает срок старого прогноза погоды.
Источники: Skyfield, эфемериды JPL, каталог потоков Stellarium.
Порядок чтения: Оглавление · Назад: Числовые входы · Далее: Орбитальная астрономия