Zasada audytu: zrzut koła pokazuje wynik, lecz nie wystarcza do jego odtworzenia. Weryfikowalny kosmogram musi mieć metrykę danych wejściowych, czasu, obliczeń i ustawień astrologicznych.
Dlaczego obraz koła nie jest dokumentacją
Na grafice zwykle nie widać źródła godziny, identyfikatora strefy, wersji bazy czasu, dokładnych współrzędnych, wariantu węzłów, orbów ani wersji efemerydy. Dwa koła mogą wyglądać podobnie mimo innych ustawień. Mogą też różnić się wizualnie, choć wartości liczbowe są zgodne.
Dokumentacja ma pozwolić drugiej osobie powtórzyć obliczenie. Jeżeli odtworzenie wymaga zgadywania, wynik jest opisany zbyt słabo.
Metryka danych wejściowych
Skopiuj i uzupełnij poniższy blok:
Źródłowa data lokalna:
Źródłowa godzina lokalna:
Rodzaj zapisu: dokładny / zaokrąglony / przybliżony / nieznany
Źródło godziny i data pozyskania:
Miejscowość podana w źródle:
Współrzędne użyte przez program:
Sposób geokodowania:
Uwagi o alternatywnych zapisach:
Nie poprawiaj potajemnie źródła. Jeśli dokument podaje 7:00, a relacja rodzinna około 6:45, zachowaj obie informacje i zapisz, którą wersję przyjęto do wykresu.
Metryka czasu
W tej części rozdziel zapis lokalny od chwili UTC:
Identyfikator strefy IANA:
Wersja tzdb:
Offset zastosowany w tej dacie:
Status czasu letniego:
Wynik UTC:
Czy lokalna godzina była jednoznaczna:
Konwencja kalendarza dla daty historycznej:
Wersja bazy jest istotna, ponieważ reguły historyczne bywają korygowane. Skrót taki jak CST jest za słaby: może oznaczać różne strefy. Stały zapis UTC+1 także nie opisuje zmian sezonowych.
Metryka obliczeń astronomicznych
Raport techniczny powinien podać:
- bibliotekę oraz wersję,
- pliki lub zakres efemerydy,
- pozycje geocentryczne lub heliocentryczne,
- długości pozorne lub inną używaną flagę,
- układ i epokę odniesienia, jeśli program je ujawnia,
- precyzję obliczeń i sposób zaokrąglania wyświetlania,
- zestaw ciał oraz definicję punktów obliczeniowych.
Nie należy zaokrąglać danych pośrednich przed dalszym liczeniem. Wartość wyświetlona do minuty łuku może służyć prezentacji, lecz aspekty i cuspy powinny powstawać z pełnej wartości zwróconej przez silnik.
Metryka ustawień astrologicznych
Osobno zapisz decyzje, które nie są narzucone przez efemerydę:
| Ustawienie | Co trzeba podać |
|---|---|
| zodiak | tropikalny lub syderyczny |
| ayanamsha | nazwa i wariant przy zodiaku syderycznym |
| system domów | pełna nazwa, nie tylko kod |
| węzły | prawdziwe albo średnie |
| aspekty | użyty zestaw kątów |
| orby | wartość i ewentualne różnice dla świateł |
| punkty dodatkowe | definicja i wariant wzoru |
| reguła cuspu | czy program przesuwa punkt do następnego domu |
Te ustawienia wpływają na to, co program pokazuje jako wynik astrologiczny. Nie wszystkie zmieniają pozycje astronomiczne.
Kontrola w drugim narzędziu
Najpierw wyrównaj wejście i ustawienia. Porównywanie wykresu tropikalnego w Placidusie z syderycznym wykresem Whole Sign nie jest testem jakości. Następnie kontroluj warstwami:
- lokalny zapis i wynik UTC,
- współrzędne miejsca,
- długości Słońca, Księżyca i jednej planety,
- ASC oraz MC,
- cuspy domów,
- domy punktów,
- aspekty i orby.
Zatrzymaj się na pierwszej warstwie, na której pojawia się istotna rozbieżność. Dalsze różnice mogą być jedynie jej skutkiem.
Mapa typowych rozbieżności
| Objaw | Najbardziej prawdopodobny obszar kontroli |
|---|---|
| wszystkie planety przesunięte podobnie | UTC, data, zodiak lub ayanamsha |
| Księżyc różni się wyraźniej niż wolne planety | czas, strefa albo chwila porównania |
| planety zgodne, ASC i MC inne | miejsce, czas lokalny lub algorytm osi |
| osie zgodne, cuspy pośrednie inne | system domów |
| pozycje zgodne, aspekty inne | zestaw aspektów i orby |
| różnica tylko w ostatnich sekundach łuku | zaokrąglenie, model albo precyzja |
| znak różny o prawie stałą wartość | tropikalny wobec syderycznego |
Przypadek kontrolny Afterlogy
W audycie użyto daty 21.06.2026, godziny 14:30 w Warszawie, strefy Europe/Warsaw, czasu letniego i wyniku 12:30 UTC. Współrzędne przyjęte przez test zapisano razem z wersją silnika. Afterlogy obliczało zodiak tropikalny, pozycje geocentryczne i domy Placidusa przez Swiss Ephemeris.
Wybrane pozycje porównano z JPL Horizons. Po ujednoliceniu chwili i układu wartości były bliskie na poziomie właściwym dla takiej kontroli. Wynik potwierdza, że sprawdzony fragment łańcucha jest odtwarzalny. Nie dowodzi poprawności każdej planety, wszystkich punktów dodatkowych, domów na każdej szerokości ani warstwy interpretacyjnej.
Minimalny raport końcowy
Rzetelna nota może mieć jedno zdanie techniczne:
Obliczenie wykonano dla 21.06.2026, 14:30 czasu
Europe/Warsaw, czyli 12:30 UTC, dla podanych współrzędnych Warszawy, w zodiaku tropikalnym i systemie Placidusa, przy użyciu wskazanej wersji Swiss Ephemeris; wartości wyświetlono po zaokrągleniu, a pozycje kontrolne porównano z JPL Horizons.
Jeżeli godzina jest niepewna, nota musi dodać przedział i wskazać niestabilne elementy. Szczegóły oceny źródła omawia artykuł Jak ocenić wiarygodność danych urodzeniowych?.
Bibliografia
- Astrodienst, Swiss Ephemeris Programmer's Manual, wersja 2.10, parametry wywołań, flagi, dzień juliański i systemy domów. PDF (dostęp: 24.09.2026).
- Astrodienst, Swiss Ephemeris General Documentation, źródła danych i charakterystyka efemerydy. PDF (dostęp: 24.09.2026).
- IANA, Time Zone Database 2026d oraz Theory and pragmatics of the tz code and data. Strona projektu (dostęp: 24.09.2026).
- JPL, Horizons System Manual oraz dokumentacja API. Instrukcja (dostęp: 24.09.2026).
- JPL, Horizons API. Dokumentacja (dostęp: 24.09.2026).
- Afterlogy, kod
backend/src/domain/kosmogramEngine.ts, testy silnika iTECHNICAL-VERIFICATION.md, stan z 24.09.2026.