Аркадный зал Школы Империи

Астрономические данные и расширения контрактов

Астрономия дополняет погодные данные и входы динамической композиции. 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.

Порядок чтения: Оглавление · Назад: Числовые входы · Далее: Орбитальная астрономия