Przykład krok po kroku — Kshana jako warstwa łącząca wiele narzędzi do analizy misji
Ten przykład prowadzi jedną trajektorię od początku do końca przez oparte na normach rodzaje scenariuszy interoperacyjności i analizy misji, pokazując, jak Kshana stoi pomiędzy wysokiej wierności narzędziami, z których program już korzysta, zamiast z nimi konkurować: GMAT (General Mission Analysis Tool), Orekit i STK (Systems Tool Kit) do projektowania trajektorii oraz Basilisk lub 42 do symulacji systemu kontroli orientacji i orbity (AOCS). Każdy krok jest uruchamialnym rodzajem scenariusza, a każdy wynik niesie label podającą jego zakres i poziom dowodowy.
Uwaga o rzetelności: to jest potok geometryczno-analityczny na poziomie przed fazą A / studium wariantów (przed pierwszą formalną fazą projektową misji). Nie jest to certyfikacja dynamiki lotu; zob. pole
labelkażdego rodzaju.
Inne skróty użyte poniżej: FDS (system dynamiki lotu), CCSDS (Consultative Committee for Space Data Systems), OEM (Orbit Ephemeris Message), SGP4 (Simplified General Perturbations 4, propagator elementów dwuwierszowych), TOML (format pliku scenariusza) i CLI (interfejs wiersza poleceń).
Potok#
external FDS (GMAT/Orekit/STK) Kshana open core
│ CCSDS OEM ephemeris │
▼ ▼
[oem-interop] ──ingest──▶ [passes] ──▶ [link-budget] (when does the
import the orbit the when is it does the contact close?)
designer produced visible? downlink close?
│
▼
[space-weather] (how fast does drag
activity-driven decay the orbit?)
density
Kroki są osobnymi przebiegami: każdy bierze dane wejściowe z własnego pliku scenariusza, więc liczbę z jednego przenosisz do następnego (na przykład odległość ukośną z passes do link-budget) przez edycję następnego pliku. Rodzaj campaign może zawierać kilka rodzajów w jednym przebiegu przy wspólnych warunkach; zob. CAMPAIGNS.md.
Każde polecenie poniżej uruchamia się z katalogu głównego repozytorium, a podsumowanie pod nim to pierwszy wiersz, który kshana 0.40.0 wypisuje dla dołączonego scenariusza.
1. Wczytaj trajektorię, którą wytworzył projektant (oem-interop)#
GMAT, Orekit i STK wszystkie eksportują komunikaty CCSDS Orbit Ephemeris Message. Kshana je importuje (drugi kierunek mostu), więc analiza Kshana może zacząć od dokładnej orbity zatwierdzonej przez projektanta trajektorii, a nie od ponownie wyprowadzonego przybliżenia:
kshana scenarios/oem-interop.toml # round-trips a reference orbit (self-test)
# or, to ingest a real file, set oem_text in the scenario to the external OEM
oem-interop: round-tripped 2 segment(s), 12 states; max round-trip error 4.88e-7 km / 4.61e-10 km/s (MODELLED interop)
Podaje segmenty, obiekty, układy odniesienia i zakres epok oraz kontrolę spójności prędkości, pokazując, że efemerydy wczytano wiernie (błąd w obie strony poniżej 1×10⁻⁶ km). Gdy zamiast tego poda się zewnętrzny plik w oem_text, raportuje, co sparsował: po podaniu OEM, który zapisuje kshana scenarios/orbit-sgp4-gps.toml --export-oem gps.oem, wypisuje oem-interop: ingested 30 segment(s), 10830 states from external OEM (originator KSHANA) (MODELLED interop). label jednoznacznie stwierdza, że jest to strukturalna i fizyczna kontrola wczytania, a nie walidacja dokładności orbity źródła.
2. Kiedy jest widoczny ze stacji naziemnej? (passes)#
kshana scenarios/passes.toml
passes: 5 pass(es) of a 550 km / 97.6° orbit over (52.2°, 4.4°) > 10° in 24 h; 1659 s total access (MODELLED)
Przewiduje przeloty (wschód i zachód) nad stacją powyżej maski elewacji: pozyskanie sygnału (AOS), czas największego zbliżenia (TCA), utrata sygnału (LOS), maksymalna elewacja i czas trwania, oraz łączny czas dostępu. To jest zapytanie planistyczne segmentu naziemnego. Orbita to zestaw elementów SGP4 przeniesiony do układu związanego z Ziemią łańcuchem IAU 2006/2000A, a elewacje są pozorne: refrakcja ITU-R P.834-9 i czas światła w łączu w dół, każde z nich przełączane (refraction, light_time).
3. Czy łącze się domyka? (link-budget)#
Dla przelotu wstaw odległość ukośną i wartości terminala do równania łącza CCSDS 401 / DSN 810-005 (NASA Deep Space Network):
kshana scenarios/link-budget.toml
link-budget: x-band, 2000 km, 1000000 bit/s -> FSPL 177.0 dB, Eb/N0 96.6 dB, margin 92.1 dB (closes)
Podaje tłumienie w wolnej przestrzeni (FSPL), stosunek nośnej do gęstości szumu (C/N₀), energię na bit względem gęstości szumu (Eb/N₀), margines oraz to, czy łącze się domyka względem wymaganego Eb/N₀: kontrolę wykonalności łączności, która zamienia „jest widoczny” w „możemy faktycznie pobrać dane”. Liczby wynikają wprost z danych wejściowych w pliku (tutaj EIRP 55 dBW, efektywna moc promieniowana izotropowo, do odbioru z G/T 53 dB/K, stosunek zysku do temperatury szumowej); przed odczytaniem marginesu wstaw wartości własnego terminala. To deterministyczne obliczenie, a nie skalibrowana karta katalogowa terminala.
4. Jak szybko środowisko ją wytraca? (space-weather)#
kshana scenarios/space-weather.toml
space-weather: F10.7=180 F10.7a=165 Kp=4.0 (ap=27) -> T_inf=1047 K; density x1.49 at 300 km (MODELLED)
Wyznacza gęstość neutralną termosfery z aktywności słonecznej (F10.7, strumień radiowy 10,7 cm, i jego 81-dniowa średnia F10.7a) oraz geomagnetycznej (wskaźniki Kp i ap) przez temperaturę egzosferyczną Jacchii-71. To oddaje ~5–10× wahania gęstości w cyklu słonecznym, które pomija statyczna atmosfera, więc szacunek czasu życia orbity lub oporu odzwierciedla reżim pogody kosmicznej, a nie stałą atmosferę. Od 0,30 gęstość jest gęstością termosfery Jacchii 1971, scharakteryzowaną względem NRLMSISE-00 (Naval Research Laboratory, spektrometr mas i rozpraszanie niekoherentne), ale nie jest to atmosfera NRLMSISE-00 sprawdzona względem danych.
5. Przekaż wynik dalej (eksporty)#
To samo CLI zapisuje standardowe pliki dla następnego narzędzia. Dla scenariusza orbit opcja --export-oem <file> zapisuje efemerydy CCSDS OEM 2,0 z prędkością (plik, który czytają GMAT, Orekit i STK), --export-sp3 <file> precyzyjne efemerydy SP3 (Standard Product 3), a --export-omm <file> katalog CCSDS Orbit Mean-Elements Message. --export <czml|kml|geojson|stk|sigmf|all|list> obejmuje przeglądarki: CZML (Cesium Language), KML (Keyhole Markup Language, dla Google Earth), GeoJSON, pliki efemeryd STK (.e, po jednym na satelitę plus użytkownika) i nagrania SigMF (Signal Metadata Format) z rodzaju spectrum. --export list mówi, które mają zastosowanie do scenariusza. Dla Księżyca rodzaj lunar-interop-export emituje księżycowy układ odniesienia, skalę czasu i efemerydy jako CCSDS OEM z kontrolą compliance. Zob. INTEROP.md.
Dlaczego to jest warstwa łącząca, a nie konkurent#
Każdy krok jest małym, audytowalnym, odtwarzalnym scenariuszem z jawną etykietą zakresu. Narzędzia wysokiej wierności zajmują się optymalizacją trajektorii, sześciostopniowym (6-DoF) AOCS i aerotermicznym wejściem, opadaniem i lądowaniem (EDL); Kshana zajmuje się otwartą, cytowalną, uruchamialną tkanką łączną: wczytuje standardowe formaty, odpowiada na przekrojowe pytania o geometrię i wykonalność oraz przekazuje wynik dalej, na poziomie, który każdy partner może uruchomić bez licencji. Zob. także towarzyszące rodzaje analizy misji launch-window, reentry, eo-coverage, space-packet i attitude-budget.