O wyniku

Pytanie

Czy dziś warto zależy od trzech rzeczy: ile widać nieba (chmury), jak ciemno jest (słońce i księżyc) i gdzie jesteś (zanieczyszczenie świetlne). Wynik łączy dwie pierwsze. Zanieczyszczenie świetlne kształtuje to, co widać z Twojej lokalizacji, ale nie wchodzi do liczby.

Jeden wynik, dwie wskazówki

• Główny — Średnia z całego okna ciemności astronomicznej (słońce ≥ 18° pod horyzontem). Uczciwa odpowiedź na pytanie „jak dobra jest noc jako całość”.
• Najlepsze 2 godziny — Dwie najlepsze kolejne godziny w ciemnym okresie. Przydatne, gdy masz mało czasu; nigdy nie zastępuje głównego wyniku.
• Wieczór, 21–01 — Od 21:00 do 01:00, przycięte do części naprawdę ciemnej: to, co zobaczysz, wychodząc wieczorem.

Wzór

Wynik łączy klarowność (część nieba bez chmur) i ciemność (jak słabo księżyc rozjaśnia niebo) z miękką bramką widoczności.

score      = visibility × (clearness × 0.6 + darkness × 0.4) / 10
clearness  = 100 − cloudCover%     // averaged over the dark window
darkness   = 100 − moonPenalty     // averaged over the same hours
visibility = min(1, clearness / 30)

Współczynnik widoczności uznaje, że chmury zamykają wszystko: jeśli niebo jest w większości zachmurzone, nawet idealnie ciemna noc nie zdobywa punktów. Powyżej 30% klarowności visibility = 1 i wzór redukuje się do zwykłej średniej ważonej. Poniżej 30% wynik liniowo spada do zera.

Kara księżycowa

Jasność Księżyca jest stopniowana według oświetlenia, a potem skalowana według jego rzeczywistej wysokości w każdej ciemnej godzinie.

• Mniej niż 25% oświetlenia (nów lub wąski sierp): brak kary.
• 25–75% oświetlenia (okolice kwadry): kara = oświetlenie × 0,5.
• Powyżej 75% oświetlenia (księżyc garbaty lub pełnia): kara = oświetlenie × 1,0.
• Pod horyzontem Księżyc nic nie kosztuje; od 30° wysokości pełny stopień; pomiędzy skaluje się z wysokością. Wschód, zachód i wysokość pochodzą z astronomy-engine dla Twojej dokładnej lokalizacji.

Czego nie ma w wyniku

• Zanieczyszczenie świetlne (klasa Bortle’a, na podstawie danych satelitarnych VIIRS) kształtuje listę „Widoczne dziś wieczorem” dla deep sky, nie liczbę.
• Wiatr, wilgotność i opady są widoczne na osi czasu po przewinięciu, ale nie zmieniają wyniku.
• Pewność prognozy. Nie obniżamy wyniku, gdy model pogody jest niepewny — ufamy prognozie i pozwalamy następnej aktualizacji ją skorygować.

Przykład: noc w pełni zachmurzona

Amsterdam · 19 września 2026 · prawdziwa prognoza

moonPenalty = 1   (low Moon, sets 23:33)
clearness  = 100 − 96 = 4
darkness   = 100 − 1 = 99
visibility = min(1, 4 / 30) = 0.13
raw        = 0.13 × (4×0.6 + 99×0.4) / 10 = 0.56

Przykład: świetna noc

To samo miejsce · czyste niebo, sierp księżyca

moonPenalty = 0     (< 25% lit)
clearness  = 100 − 8 = 92
darkness   = 100 − 0 = 100
visibility = min(1, 92 / 30) = 1
raw        = 1 × (92×0.6 + 100×0.4) / 10 = 9.52

Źródła

• Open-Meteo: zachmurzenie godzinowe, godziny słońca i księżyca, wiatr, wilgotność.
• VIIRS Day/Night Band: zanieczyszczenie świetlne, używane do oszacowania klasy Bortle’a dla listy „Widoczne dziś wieczorem”.

Częstotliwość aktualizacji

Prognozy odświeżają się co 30 minut po stronie źródła. Endpoint wyniku jest cache’owany przez 30 minut na edge (s-maxage=1800). Prognoza siedmionocna aktualizuje się codziennie.