Kshana dokumentatsioon

Kõik siin renderdatakse ehitamise ajal Kshana hoidlas jälgitavatest Markdown-failidest (mootor v0.40.0) ning kahe stsenaariumifailidest ja kontrollimaatriksist genereeritud viitelehe. Saidi jaoks ei kirjutata midagi käsitsi.

Alustamine

• ÜlevaadeKshana taasesitab segamist, spuufimist ja kella holdover-it, kui GNSS-i (ülemaailmne satelliitnavigatsioonisüsteem) signaalid…
• Mõistete lühikursusSee leht selgitab, mida Kshana teeb ja miks, alustades nullist ja jõudes füüsikani.
• SõnastikKshanas kasutatavate terminite lihtsas keeles määratlused.
• KeeledMootori inimesele mõeldud tekst on 17 keeles lisaks inglise keelele: nl, pl, pt-BR, pt-PT, fi, sv, da, nb, cs…
• Stuudio juhendKshana Studio: mootori käitamine brauseris, ilma paigaldamata.
• ÕpetusedPraktilised lahendatud näited, mis viivad kaasasoleva stsenaariumi käivitamisest tulemuse kvantifitseerimise ja kaitsmiseni…
• 1 · Esimene orbiitLõpuks on tegelik töötav GPS-i konstellatsioon propageeritud, selle kättesaadavus ja…
• 2 · Kella holdoverLõpuks on tehtud kella holdover olukorras, kus GNSS-i (ülemaailmne satelliitnavigatsioonisüsteem) signaalid on keelatud…
• 3 · Kvant versus klassikalineLõputöö. Käivitatakse spuufimisdetektori stsenaarium ja täielik liitpositsioneerimise, navigatsiooni ja aja…
• Lahendatud näide: mitme tööriista torujuheSee viib ühe trajektoori läbi standarditel põhineva koostalitlusvõime ja missioonianalüüsi stsenaariumi liikide otsast lõpuni…

Stsenaariumid

• Stsenaariumi liigid92 sisseehitatud stsenaariumi liiki, mille vahel kshana::api::run_toml jaotab, igaühel selle üherealine…
• Iga stsenaariumi liik, perekondade kaupaIga stsenaariumi liik, mida mootor v0.40.0 jaotab (92), paigutatud 13 perekonda.
• Iga käskkshana <scenario.toml> käivitab stsenaariumi; iga teine käsk on alamkäsk. kshana --help trükib kasutusjuhendi…
• Iga pindÜks mootor, kõikjal samad tulemused. docs/SURFACES.md loetleb iga käsu ja liigi kohta, millisel pinnal…
• Võimekuse valdkonnadAvaliku kaardi iga võimekus valdkonniti koos oma registri (ledger) märgisega.
• Stsenaariumide teatmikIga kaasasolev stsenaariumifail (193), rühmitatud liigi järgi, koos selle põhiseadetega.
• Tulemuse skeemIga käivitus kirjutab stsenaariumi kõrvale versioonitud, isekirjeldava JSON-artefakti (JavaScript Object Notation).
• Päris TLE-de kasutamineKaasasolev scenarios/orbit-sgp4-gps.toml sisaldab juba päris TLE-sid (kaherealised elementide komplektid): Celestrak…
• KampaaniadÜks stsenaarium vastab ühele küsimusele ühe olukorra kohta.

Väljundid ja ekspordid

• KäivitusaruandedIga käsurealiidese (CLI) käivitus kirjutab oma tulemuse kõrvale aruande: prinditav HyperText…
• Animatsiooni eksport--animate muudab käivituse ajarea liikuvaks: animeeritud Scalable Vector Graphics (SVG)…
• Koostalitlusvõime eksport ja importKäivitus kirjutab tulemusdokumendi, diagrammi ja aruande. --export kirjutab ka stsenaariumi geomeetria või selle…

Valideerimine ja tõendid

• Valideerimise seisTolerantsidest. „Valideeritud“ tähendab allpool, et kalibreerimistest väidab, et simuleeritud statistik vastab…
• KontrollimaatriksTäielik masinkontrollitud tõenduste register: 401 rida — 176 VALIDATED, 221 MODELLED, 4 PARTNER.
• Võimekuste teatmikVõimekuskaardid ja kõik 401 kontrollimaatriksi rida.
• Miks read jäävad modelleerituksNeed võimekused on realiseeritud avaldatud või esimestest printsiipidest lähtuvast füüsikast koos testidega, kuid on ausalt…
• Väited tegelikkuse vastuKshana varasema versiooni sõltumatu audit kataloogis neliteist ülepaisutatud väidet (OC-0…OC-13): kohad, kus…
• PäritoluKshana keskne ausadusdistsipliin on, et iga sensori parameeter, füüsikaline mudel ja valideerimisandmestik…
• ReprodutseeritavusKshana on ehitatud reprodutseeritavaks: samad sisendid annavad samad tulemused ja ehitusartefakte saab…
• Võimekuse kaartKshana on PNT (positsioneerimine, navigatsioon ja aeg) toimivuse ja vastupidavuse tõendimootor, mitte täielik…
• Standardid ja koostalitlusvõimeKshana räägib GNSS-i (ülemaailmne satelliitnavigatsioonisüsteem) standardseid vahetusvorminguid…
• Rea katvusREADME märgil, README CI (pidev integreerimine) tabelis, crates.io-s olev „~95 % rea katvus“…
• TõendipaketidPakett on tehniline kirje, mitte õiguslik arvamus.
• Andmepartnerid ja edutavad readKshana märgib iga võimekuse masinkontrollitud registris (kontrollimaatriks).

Ajastus

• Optilised lingid atmosfääri kauduStsenaariumi liik optical-atmosphere vastab sellele, kui sageli optiline link maapinnaga töötab, miks see ebaõnnestub…
• Ajapesa ajastusStsenaariumi liik slot-timing vastab kolmele küsimusele kella kohta, mis töötab sünkroniseerimiste vahel vabalt…
• Telekomi ajastusSee leht loetleb iga piiri, mida stsenaariumi liik telecom-timing kontrollib, kust igaüks pärineb ja mis oli…
• Eksitatud aegTehniline märkus ajaindekseeritud võrkude operaatoritele: konstellatsioonid, mis marsruudivad, annavad ülesandeid või annavad üle…
• Holdover-test ja ajastusriistvara silmusesTelekomi- ja energiaoperaatorid testivad ajastussüsteemi, võttes selle GNSS-i ära ja jälgides, mida kell teeb.
• Kellalogi vormingudsrc/clock_log.rs loeb mõõdetud kellalogi üheks normaliseeritud faasireaks: ühtlane võrk (time_s…
• Riistvara ohutusKshana on nõuandev tarkvara uurimiseks, simulatsiooniks ja katsetamiseks.

Terviklikkus ja häired

• Terviklikkus ja turvalisusKshana teatab kaks kvaliteedinäitajat (FoM) — terviklikkus ja turvalisus —, mida on lihtne segi ajada…
• Spekter ja jugaStsenaariumi liik spectrum ehitab Global Navigation Satellite System (GNSS) L-riba ja mis tahes muu riba, mida…
• ARAIM-i viideSee märkus dokumenteerib Kshana avatud realisatsiooni Advanced Receiver Autonomous Integrity Monitoring…
• DO-316 / DO-229E kaartSee dokument seostab RTCA (endine Radio Technical Commission for Aeronautics) DO-229E (SBAS…
• Vastupidavuse ristviideJoondatud, mitte hinnatud ega heaks kiidetud. See seostab Kshana simuleeritud võimekused avaldatud PNT-vastupidavuse…

Vastuvõtja usaldus ja merendus

• Vastuvõtja usalduskshana receiver-trust loeb logi päris globaalse satelliitnavigatsioonisüsteemi (GNSS) vastuvõtjast, käivitab usaldus…
• Mere usalduskshana receiver-trust suudab liikuva laeva jaoks anda iga asukohafiksi kohta reaalajas 0-100 usaldusnäitaja, alates…
• NMEA treeningvoodMeremajandusakadeemiad ja simulaatorikeskused saavad Kshana loodud NMEA 0183 sisestada sillasimulaatorisse või…
• Häirekaart ja marsruudi kokkupuudekshana interference-map koostab päevapõhise pildi sellest, kus õhusõidukid ja laevad teatasid halvenenud navigatsioonist…
• Häirekaart: andmeallikad ja litsentsidKshana väljundid ei sisalda kunagi õhusõiduki- ega laevapõhiseid identifikaatoreid (ICAO hex, MMSI, kutsung, nimi).
• Mere integratsioonidKshana mere usaldusnäitaja (MARITIME-TRUST.md) on kättesaadav tarkvarast, mida paadiomanikud juba kasutavad: Signal K…
• Taevageomeetria ja silmapiirijoonedKuni 0,36 oli iga Maa nähtavuskatse mootoris üks kõrgusnurga piir, mask_deg: satelliit…
• Usaldus turvatelemeetrianakshana trust-telemetry muudab epohhipõhise GNSS-i usaldusvoo (skoor 0-100, riba, põhjused) signaalideks, mida…
• Galileo OSNMA kontrollimineVastuvõtja poolne kontrollija Galileo Open Service Navigation Message Authentication (OSNMA) jaoks, puhtas Rustis.
• LunaNeti täiendatud edastatav signaalKshana realiseerib LunaNet Augmented Forward Signal (AFS) levikoodid ja sõnumikihi kui…
• Jammertest kohtunikunakshana jammertest import loeb Jammertesti katsekataloogi ja edastusplaani ning muudab ühe katsepiirkonna…
• Masina- ja sensorisisendidLugejad, mis toovad teised vastuvõtjad, lahendajad ja sensorid receiver-trust liiki.
• Loetavad vastuvõtjaprotokollidKogu ulatuses ainult lugemine: siin ei kirjutata vastuvõtjasse ainsatki baiti ning mingit saatmisteed ei ole.
• Häirevaatluskeskus: meetodÜks toode UTC päeva ja piirkonna kohta, ühest avatud õhusõidukite asukohaarhiivist.
• Häirevaatluskeskus: tulemusedNäide sellest, mida päev näitab: 2026-09-15 oli arhiivis 110 619 797 asukohakirjet 79 826 jälgfailis…
• kshana-benchAvatud ülesannete, jaotuste ja mõõdikute komplekt GNSS-i häirete tuvastamiseks ja ajastuse holdover-iks.

Compliance ja test bench

• Vastuvõtja käivitamine stsenaariumi vastuVastuvõtjatootja, kellel on laboratoorne GNSS-simulaator, saab Kshana stsenaariumi sõiduki liikumise taasesitada…
• Compliance-vastendusOstjad ja vastuvõtjatootjad vastavad avalikele vastupidavusraamistikele.
• US DHS vastupidava PNT raamistikRaamistik kirjeldab vastupidavuse tasemeid 0 kuni 4, mis on ehitatud kaheksast nummerdatud nõudest, ja hindamist…
• IMO juhised laevadeleIMO GNSS-i häirete tekst laevadele on napp: MSC.1/Circ.1644 on suunatud peamiselt liikmesriikidele ja…
• EASA juhised lennunduse jaoksEASA ohutusteabe bülletään on informatiivne, mitte kohustuslik, ning suunatud ametiasutustele, õhusõiduki…
• EL NIS2, artikkel 21Artikkel 21 loetleb lõike 2 punktides (a) kuni (j) meetmed, mida olulised ja tähtsad üksused…
• EN 16803EN 16803 on tasuline standard. Ainult selle osade struktuur ja avalikes kataloogides nähtavad klauslite numbrid…

Orbiidid

• SGP4 valideerimineKshana orbiidipropageerija on valideeritud SGP4/SDP4 kanoonilise kogukonnaetaloni vastu (SGP4…
• Jõumudeli valideerimineKshana täisjõumootor (src/precise_od.rs) sobitatud päris asutuste täpsete orbiiditoodetega, ausa…
• Päikesesüsteem ja muud kehadLiik constellation-design kasutab sama kataloogi konstellatsioonide ehitamiseks mis tahes nende kehade ümber…
• Kuu etalonjaamMODELLED. Nimetatud eelduste korral (konstellatsioon, selle ruumis oleva signaali viga, jaama mõõtmis…
• Kosmosekasutaja navigatsioon (gnss-ssv)Ainult nõuandev. Modelleeritud tulemused nimetatud sisenditest ja simuleeritud tõest; mitte sertifitseerimine, …
• Kuu orbiit ja pind taristunaKavandid, sisendid ja lävendid fikseeriti failis xval/lunar-infra/PREREGISTRATION.md (kommiti enne mis tahes uuringut…
• Missiooniahel: startimisest sisenemiseniNõuandev tarkvara, mitte sertifitseeritud navigatsiooniseade.
• Missiooniahel: Kuu lõikNeli stsenaariumi liiki, millest igaüks on ka missiooniahela liidese (src/mission_thread/) faasiliik: need…

Madala Maa orbiidi (LEO) navigatsioon

• LEO positsioneerimine, navigatsioon ja aegLEO-PNT on positsioneerimine, navigatsioon ja aeg (PNT) madala Maa orbiidi (LEO) satelliitidelt, kõrvuti või…
• LEO signaalikavandidStsenaariumi liik leo-signal analüüsib madala Maa orbiidi (LEO) positsioneerimise, navigatsiooni ja aja (PNT) signaale.
• LEO läbilend ja sideliini energiabilanssLEO-PNT on positsioneerimine, navigatsioon ja aeg (PNT) madala Maa orbiidi (LEO) satelliitidelt.
• LEO navigatsioonisõnumStsenaariumi liik leo-navmsg ehitab madala Maa orbiidi (LEO) edastatava efemeriidi ja kellasõnumi…
• Liit-MEO ja LEO positsioneerimineKolm stsenaariumi liiki pakuvad positsioneerimist, navigatsiooni ja aega (PNT) madala Maa orbiidi satelliitidega…
• Konstellatsiooni kavandamineLiik constellation-design ehitab ühe või mitu satelliidikonstellatsiooni Maa, Kuu, Marsi ümber…

Kvantsensorid

• Kvantsensorite mudelidKshana on PNT-vastupidavuse (PNT: positsioneerimine, navigatsioon ja aeg) simulaator kvantsensoritega…
• Külmaatomite interferomeeterEnamik Kshanast juhib oma kvantsensoreid avaldatud Alani/müra koefitsientidest — andmelehe otsingutest (vt…

API-d ja integratsioonid

• Pythoni APIKshana pakub esmaklassilist Pythoni rakendusliidest (API), mis on ehitatud PyO3 ja maturiniga.
• npm ja WebAssemblyKshana taasesitab segamist, spuufimist ja kella holdover-it, kui GNSS-i (ülemaailmne satelliitnavigatsioonisüsteem) signaalid…
• Rusti pakett (crate)Kshana taasesitab segamist, spuufimist ja kella holdover-it, kui GNSS-i (ülemaailmne satelliitnavigatsioonisüsteem) signaalid…
• MCP-serverkshana-mcp on Kshana Model Context Protocol (MCP) server, PNT avatud lähtekoodiga simulaator…
• MCP-server: kõik paigalduskanalidNõuandev, mitte tüübikinnitust omav navigatsiooniseade: navigeerimise eest vastutab jätkuvalt operaator.
• MCP-server: isehostitav HTTP-režiimKshana ei hosti lõpp-punkti. Jagatud kshana serverit, mille poole klient saaks pöörduda, ei ole.
• Kshana kasutamine agendistAgendile (või seda juhtivale inimesele): millist tööriista millise küsimuse jaoks kutsuda, mida tööriistad teevad ja…
• Kus iga võimekus kättesaadav onIga võimekus on saadaval pindadel, kus see on mõttekas; kus mõni pind ei saa võimekust kanda, …
• JetBrainsi pluginNatiivne plugin, mis käivitab Kshana PNT-vastupidavuse simulaatori mis tahes JetBrainsi IDE-s (IntelliJ IDEA…
• Kus Kshana töötabUlatuse piir, kirja pandud nii, et keegi ei avastaks seda kohustusena koosolekul.
• ArhitektuurKshana on üks mootor, mis on organiseeritud kihtidesse ühise tuuma kohal: sensoripaketid (kell, inertsiaal…
• Kus Kshana asubKshana on avatud, reprodutseeritav PNT (positsioneerimine, navigatsioon ja aeg) vastupidavuse tõendimootor.

Projekt

• Muudatuste logiSiin on dokumenteeritud kõik Kshana märkimisväärsed muudatused.
• LitsentsimineKshana on kahe litsentsiga. Avatud mootorit võib kasutada kas avatud litsentsi (AGPL-3.0) või…
• TurvalisusTurvatundlike teadete jaoks ei tohi avada avalikku probleemi (issue).
• Kaastöö tegemineAitäh huvi eest. Kshana eesmärk on olla neutraalne, reprodutseeritav, ausalt valideeritud etalon…
• JuhtimineKäesolev dokument kirjeldab, kuidas Kshanat juhitakse: kes teeb otsuseid, kuidas ja mida projekt omaks võtab ning mida mitte…
• KäitumisjuhendMeie, kogukonna liikmed, kaastöötajad ja juhid, lubame muuta osalemise meie kogukonnas ahistamisvabaks…

Stsenaariumi liikide perekonnad

• Kampaaniad1 stsenaariumi liik mootorist v0.40.0. Nõuandev: uurimis- ja inseneeriatööriista analüüsitulemus; mitte…
• Kellad, ajastus ja holdover9 stsenaariumi liiki mootorist v0.40.0. Nõuandev: uurimis- ja inseneeriatööriista analüüsitulemus; mitte…
• Konstellatsioonide katvus ja geomeetria7 stsenaariumi liiki mootorist v0.40.0. Nõuandev: uurimis- ja inseneeriatööriista analüüsitulemus; mitte…
• GNSS-i mõõtmised, positsioneerimine ja terviklikkusMootori v0.40.0 6 stsenaariumi liiki. Nõuandev: uurimis- ja inseneeriatööriista analüüsitulemus; mitte…
• GPS-i puudumise tingimustes toimivad alternatiivsed PNT-lahendusedMootori v0.40.0 5 stsenaariumi liiki. Nõuandev: uurimis- ja inseneeriatööriista analüüsitulemus; mitte…
• Inertsiaalne liitmine ja kvantanduridMootori v0.40.0 9 stsenaariumi liiki. Nõuandev: uurimis- ja inseneeriatööriista analüüsitulemus; mitte…
• Segamine, spuufimine ja raadiospekterMootori v0.40.0 6 stsenaariumi liiki. Nõuandev: uurimis- ja inseneeriatööriista analüüsitulemus; mitte…
• Madala Maa orbiidi navigatsioonMootori v0.40.0 7 stsenaariumi liiki. Nõuandev: uurimis- ja inseneeriatööriista analüüsitulemus; mitte…
• Kuu ja tsislunaarneMootori v0.40.0 24 stsenaariumi liiki. Nõuandev: uurimis- ja inseneeriatööriista analüüsitulemus, mitte…
• Missioonianalüüs, sideliinid ja kosmoseoperatsioonidMootori v0.40.0 14 stsenaariumi liiki. Nõuandev: uurimis- ja inseneeriatööriista analüüsitulemus; mitte…
• MissiooniaheladMootori v0.40.0 1 stsenaariumi liik. Nõuandev: uurimis- ja inseneeriatööriista analüüsitulemus, mitte…
• Optiline PNTMootori v0.40.0 2 stsenaariumi liiki. Nõuandev: uurimis- ja inseneeriatööriista analüüsitulemus; mitte…
• Kosmosekasutaja navigatsioonMootori v0.40.0 1 stsenaariumi liik. Nõuandev: uurimis- ja inseneeriatööriista analüüsitulemus; mitte…

Stsenaariumi liikide lehed

92 lehte, üks iga stsenaariumi liigi kohta, viidatud lehelt Iga stsenaariumi liik, perekondade kaupa.

Kaasamata

Hooldusprotsessi dokumendid jäävad hoidlasse: docs/RELEASING.md (väljalaskemenetlus); docs/WHEEL_TAGS.md (pakendamise üksikasjad); docs/revisions/ (sisemised muudatusmärkmed); docs/design/ (sisemised disainimärkmed); README.pypi.md (PyPI leht; selle katab Python API dokument); .github/ mallid; docs/integrations.md (üles ehitatud nimeliste kolmandate osapoolte tehisintellekti toodete ümber, mida see sait ei nimeta).