Kshanan dokumentaatio

Kaikki tässä muodostetaan käännösvaiheessa Markdown-tiedostoista, joita seurataan Kshana-repositoriossa (moottori v0.40.0), sekä kahdesta skenaariotiedostoista ja varmennusmatriisista luodusta viitesivusta. Sivustolle ei kirjoiteta mitään käsin.

Aloita

• YleiskatsausKshana toistaa häirinnän, harhautuksen ja kellon holdoverin, kun GNSS-signaalit (maailmanlaajuinen satelliittinavigointijärjestelmä)…
• PeruskäsitteetTämä sivu selittää, mitä Kshana tekee ja miksi, alusta alkaen ja fysiikkaan asti rakentaen.
• SanastoSelkokieliset määritelmät Kshanassa käytetyistä termeistä.
• KieletMoottorin ihmiselle tarkoitettu teksti on 17 kielellä englannin rinnalla: nl, pl, pt-BR, pt-PT, fi, sv, da, nb, cs…
• Studio-opasKshana Studio: aja moottoria selaimessa, ilman asennusta.
• OppaatKäytännönläheisiä, läpikäytyjä esimerkkejä, jotka vievät sinut vaiheesta ”aja mukana toimitettu skenaario” vaiheeseen ”määritä ja puolusta tulosta”…
• 1 · Ensimmäinen kiertoratasiLopuksi olet propagoinut todellisen toiminnassa olevan GPS-satelliittitähdistön, lukenut sen saatavuuden ja…
• 2 · Kellon holdoverLopuksi olet ajanut kellon holdoverin GNSS-signaalien (maailmanlaajuinen satelliittinavigointijärjestelmä) ollessa estetty…
• 3 · Kvantti klassista vastaanPäätösosa. Ajat harhautuksenilmaisinskenaarion ja täydellisen yhdistetyn paikannus-, navigointi- ja ajanmääritysskenaarion…
• Läpikäyty esimerkki: monityökaluputkiTämä vie yhden reitin standardipohjaisen yhteentoimivuuden ja tehtäväanalyysin skenaariotyyppien läpi päästä päähän…

Skenaariot

• Skenaariotyypit92 sisäänrakennettua skenaariotyyppiä, joiden kesken kshana::api::run_toml ohjaa, kullakin yksirivinen…
• Jokainen skenaariotyyppi perheittäinJokainen skenaariotyyppi, jonka moottori v0.40.0 ohjaa (92), jaoteltuna 13 perheeseen.
• Jokainen komentokshana <scenario.toml> ajaa skenaarion; jokainen muu komento on alikomento. kshana --help tulostaa käyttöohjeen…
• Jokainen pintaYksi moottori, samat tulokset kaikkialla. docs/SURFACES.md luettelee jokaiselle komennolle ja tyypille, mikä pinta…
• OminaisuusalueetJulkisen kartan jokainen ominaisuus alueittain, kirjanpitomerkintöineen.
• SkenaarioviiteJokainen mukana toimitettu skenaariotiedosto (193) tyypeittäin ryhmiteltynä, avainasetuksineen.
• TulosskeemaJokainen ajo kirjoittaa versioidun, itsekuvaavan JSON-artefaktin (JavaScript Object Notation) skenaarion viereen.
• Todellisten TLE-tietojen käyttöMukana toimitettu scenarios/orbit-sgp4-gps.toml sisältää jo todellisia TLE-tietoja (kaksirivisiä elementtijoukkoja): Celestrak…
• KampanjatYksittäinen skenaario vastaa yhteen kysymykseen yhdestä tilanteesta.

Tulosteet ja viennit

• AjoraportitJokainen komentorivikäyttöliittymän (CLI) ajo kirjoittaa tuloksensa viereen raportin: tulostettavan HyperText…
• Animaatioviennti--animate muuttaa ajon aikasarjan liikkuvaksi: animoiduksi Scalable Vector Graphics -kuvaksi (SVG)…
• Yhteentoimivuusviennit ja -tuonnitAjo kirjoittaa tulosasiakirjan, kaavion ja raportin. --export kirjoittaa myös skenaarion geometrian tai sen…

Validointi ja todisteet

• Validoinnin tilaToleransseista. Alla ”validoitu” tarkoittaa, että kalibrointitesti toteaa simuloidun tilastosuureen vastaavan…
• VarmennusmatriisiTäydellinen, koneellisesti tarkistettu todistekirjanpito: 401 riviä — 176 VALIDATED, 221 MODELLED, 4 PARTNER.
• OminaisuusviiteOminaisuuskortit ja varmennusmatriisin kaikki 401 riviä.
• Miksi rivit jäävät mallinnetuiksiNämä ominaisuudet on toteutettu julkaistun tai ensiperiaatteisiin perustuvan fysiikan pohjalta ja testein, mutta ne ovat rehellisesti…
• Väitteet todellisuutta vastenKshanan aiemman version riippumaton auditointi luetteloi neljätoista liioittelua (OC-0…OC-13): paikat, joissa…
• AlkuperäKshanan keskeinen rehellisyysperiaate on, että jokainen anturiparametri, fysikaalinen malli ja validointiaineisto…
• ToistettavuusKshana on rakennettu toistettavaksi: samat syötteet tuottavat samat tulokset, ja koontiartefaktit voidaan…
• OminaisuuskarttaKshana on PNT:n (paikannus, navigointi ja ajanmääritys) suorituskyvyn ja kestävyyden todistemoottori, ei täysi…
• Standardit ja yhteentoimivuusKshana puhuu GNSS:n (maailmanlaajuinen satelliittinavigointijärjestelmä) standardeja vaihtoformaatteja…
• RivikattavuusREADME-merkin, README:n CI-taulukon (jatkuva integrointi) ja crates.io:n ”~95 % rivikattavuus”…
• TodistepaketitPaketti on tekninen asiakirja, ei oikeudellinen lausunto.
• Datakumppanit ja ylentävät rivitKshana merkitsee jokaisen ominaisuuden koneellisesti tarkistetussa kirjanpidossa (varmennusmatriisi).

Ajoitus

• Optiset linkit ilmakehän läpiOptisen ilmakehän skenaariotyyppi vastaa siihen, kuinka usein optinen linkki maahan toimii, miksi se epäonnistuu…
• AikaväliajoitusSlot-timing-skenaariotyyppi vastaa kolmeen kysymykseen kellosta, joka kulkee vapaasti synkronointien välillä…
• Telealan ajoitusTämä sivu luettelee jokaisen rajan, jonka telecom-timing-skenaariotyyppi tarkistaa, mistä kukin tulee ja mikä oli…
• Harhautettu aikaTekninen muistio aikaindeksoitujen verkkojen operaattoreille: satelliittitähdistöt, jotka reitittävät, tehtävöivät tai luovuttavat…
• Holdover-testi ja ajoituslaitteisto silmukassaTelealan ja sähköalan operaattorit testaavat ajoitusjärjestelmää poistamalla sen GNSS:n ja seuraamalla, mitä kello tekee.
• Kellolokien formaatitsrc/clock_log.rs lukee mitatun kellolokin yhdeksi normalisoiduksi vaihesarjaksi: tasavälinen ruudukko (time_s…
• LaitteistoturvallisuusKshana on ohjeellinen ohjelmisto tutkimukseen, simulointiin ja testaukseen.

Eheys ja häiriöt

• Eheys ja tietoturvaKshana raportoi kaksi laatumittaria (FoM) — Eheys ja Tietoturva — jotka on helppo sekoittaa…
• Spektri ja vesiputouskaavioSpektriskenaariotyyppi rakentaa GNSS-järjestelmän (maailmanlaajuinen satelliittinavigointijärjestelmä) L-kaistan ja minkä tahansa muun kaistan…
• ARAIM-viiteTämä muistio dokumentoi Kshanan avoimen toteutuksen Advanced Receiver Autonomous Integrity Monitoringista…
• DO-316 / DO-229E -karttaTämä asiakirja kartoittaa RTCA:n (aiemmin Radio Technical Commission for Aeronautics) DO-229E:n (SBAS…
• Kestävyyden ristiinkartoitusLinjassa, ei arvioitu eikä hyväksytty. Tämä kartoittaa Kshanan simuloidut ominaisuudet julkaistuihin PNT-kestävyyden…

Vastaanottimen luottamus ja meriliikenne

• Vastaanottimen luottamuskshana receiver-trust lukee lokin todellisesta GNSS-vastaanottimesta (maailmanlaajuinen satelliittinavigointijärjestelmä), ajaa luottamus…
• Merenkulun luottamuskshana receiver-trust voi pisteyttää liikkuvalle alukselle reaaliaikaisen 0–100 luottamusluvun jokaiselle paikkaratkaisulle, alkaen…
• NMEA-harjoitusvirratMerenkulkuoppilaitokset ja simulaattorikeskukset voivat syöttää Kshanan tuottamaa NMEA 0183 -dataa siltasimulaattoriin tai…
• Häiriökartta ja reittialtistuskshana interference-map rakentaa päiväkohtaisen kuvan siitä, missä ilma-alukset ja alukset raportoivat heikentynyttä navigointia…
• Häiriökartta: tietolähteet ja lisenssitKshanan tulosteet eivät koskaan sisällä ilma-aluskohtaisia tai aluskohtaisia tunnisteita (ICAO hex, MMSI, kutsutunnus, nimi).
• Merenkulun integraatiotKshanan merenkulun luottamuspistemäärä (MARITIME-TRUST.md) on tavoitettavissa ohjelmistoista, joita veneilijät jo ajavat: Signal K…
• Taivaan geometria ja horisonttiprofiilitVersioon 0,36 asti jokainen moottorin Maa-näkyvyystesti oli yksi korkeuskulman raja, mask_deg: satelliitti…
• Luottamus tietoturvatelemetrianakshana trust-telemetry muuttaa epookkikohtaisen GNSS-luottamusvirran (pistemäärä 0–100, kaista, syyt) signaaleiksi, joita…
• Galileo OSNMA -varmennusVastaanotinpuolen varmentaja Galileon Open Service Navigation Message Authenticationille (OSNMA), puhtaalla Rustilla.
• LunaNetin täydennetty eteenpäin lähetettävä signaaliKshana toteuttaa LunaNet Augmented Forward Signalin (AFS) levityskoodit ja viestikerroksen…
• Jammertest erotuomarinakshana jammertest import lukee Jammertestin testiluettelon ja lähetyssuunnitelman ja muuttaa yhden testialueen…
• Kone- ja anturisyötteetLukijat, jotka tuovat muita vastaanottimia, ratkaisijoita ja antureita receiver-trust-tyyppiin.
• Luetut vastaanotinprotokollatKaikkialla vain luku: mikään täällä ei kirjoita yhtäkään tavua vastaanottimeen, eikä minkäänlaista lähetyspolkua ole.
• Häiriöobservatorio: menetelmäYksi tuote UTC-päivää ja aluetta kohti, yhdestä avoimesta ilma-alusten paikka-arkistosta.
• Häiriöobservatorio: tuloksetEsimerkki siitä, miltä päivä näyttää: 2026-09-15 arkistossa oli 110 619 797 paikkariviä 79 826 jälkitiedostossa…
• kshana-benchAvoin joukko tehtäviä, jakoja ja mittareita GNSS-häiriön havaitsemiseen ja ajoituksen holdoveriin.

Compliance ja test bench

• Vastaanottimen ajaminen skenaariota vastenVastaanottimen valmistaja, jolla on laboratorion GNSS-simulaattori, voi toistaa Kshana-skenaarion ajoneuvon liikkeen…
• Compliance mappingOstajat ja vastaanottimien valmistajat vastaavat julkisille kestävyyskehyksille.
• Yhdysvaltain DHS:n kestävä PNT -kehysKehys kuvaa kestävyystasot 0–4, jotka on rakennettu kahdeksasta numeroidusta vaatimuksesta, ja arviointi…
• IMO:n ohjeistus aluksilleIMO:n GNSS-häiriötä käsittelevä teksti aluksille on niukka: MSC.1/Circ.1644 on osoitettu pääasiassa jäsenvaltioille, ja…
• EASA:n ohjeistus ilmailulleEASA:n Safety Information Bulletin on tiedottava, ei pakottava, ja osoitettu viranomaisille, ilma-…
• EU:n NIS2, artikla 21Artikla 21 luettelee kohdan 2 alakohdissa (a)–(j) toimenpiteet, joita keskeiset ja tärkeät toimijat toteuttavat…
• EN 16803EN 16803 on maksullinen standardi. Vain sen osarakenne ja julkisten luettelo…

Radat

• SGP4-validointiKshanan ratapropagaattori on validoitu SGP4/SDP4:n kanoniseen yhteisön vertailukohtaan (SGP4…
• Voimamallin validointiKshanan täyden voimamallin moottori (src/precise_od.rs) sovitettuna todellisiin virastojen tarkkoihin ratatuotteisiin, rehellisin…
• Aurinkokunta ja muut kappaleetSatelliittitähdistön suunnittelutyyppi käyttää samaa luetteloa rakentaakseen tähdistöjä minkä tahansa näiden kappaleiden ympärille…
• Kuun vertailuasemaMODELLED. Todetuin oletuksin (satelliittitähdistö, sen signaali avaruudessa -virhe, aseman kartoitus…
• Avaruuskäyttäjän navigointi (gnss-ssv)Vain ohjeellinen. Mallinnetut tulokset todetuista syötteistä ja simuloidusta totuudesta; ei sertifiointi, ei…
• Kuun kiertorata ja pinta infrastruktuurinaSuunnitelmat, syötteet ja kynnykset lukittiin tiedostossa xval/lunar-infra/PREREGISTRATION.md (kirjattu ennen kuin mitään tutkimusta…
• Tehtäväketju: laukaisusta paluuseenOhjeellinen ohjelmisto, ei sertifioitu navigointilaite.
• Tehtäväketju: kuusegmenttiNeljä skenaariotyyppiä, jotka ovat kukin myös tehtäväketjurajapinnan vaihetyyppi (src/mission_thread/): ne…

Matalan Maan kiertoradan (LEO) navigointi

• LEO-paikannus, -navigointi ja -ajanmääritysLEO-PNT on paikannusta, navigointia ja ajanmääritystä (PNT) matalalla Maan kiertoradalla (LEO) olevilta satelliiteilta, rinnakkain tai…
• LEO-signaalisuunnitelmatleo-signal-skenaariotyyppi analysoi matalan Maan kiertoradan (LEO) paikannus-, navigointi- ja ajanmääritys (PNT) -signaaleja.
• LEO-ylilento ja linkkibudjettiLEO-PNT on paikannusta, navigointia ja ajanmääritystä (PNT) matalalla Maan kiertoradalla (LEO) olevilta satelliiteilta.
• LEO-navigointiviestileo-navmsg-skenaariotyyppi rakentaa matalan Maan kiertoradan (LEO) lähetetyn efemeridi- ja kelloviestin…
• Yhdistetty MEO- ja LEO-paikannusKolme skenaariotyyppiä tarjoaa paikannusta, navigointia ja ajanmääritystä (PNT) matalan Maan kiertoradan satelliiteilla…
• Satelliittitähdistön suunnitteluSatelliittitähdistön suunnittelutyyppi rakentaa yhden tai useamman satelliittitähdistön Maan, Kuun, Marsin ympärille…

Kvanttianturit

• KvanttianturimallitKshana on PNT-kestävyyssimulaattori (PNT: paikannus, navigointi ja ajanmääritys), jossa on kvanttianturi…
• Kylmäatomi-interferometriSuurin osa Kshanasta ohjaa kvanttianturinsa julkaistuilla Allanin/kohinakertoimilla — datalehtihauilla (katso…

API:t ja integraatiot

• Python-rajapintaKshana toimitetaan ensiluokkaisen Python-ohjelmointirajapinnan (API) kanssa, joka on rakennettu PyO3:lla ja maturinilla.
• npm ja WebAssemblyKshana toistaa häirinnän, harhautuksen ja kellon holdoverin, kun GNSS-signaalit (maailmanlaajuinen satelliittinavigointijärjestelmä)…
• Rust-crateKshana toistaa häirinnän, harhautuksen ja kellon holdoverin, kun GNSS-signaalit (maailmanlaajuinen satelliittinavigointijärjestelmä)…
• MCP-palvelinkshana-mcp on Model Context Protocol (MCP) -palvelin Kshanalle, avoimen lähdekoodin simulaattorille PNT:lle…
• MCP-palvelin: kaikki asennuskanavatOhjeellinen, ei tyyppihyväksytty navigointilaite: käyttäjä vastaa edelleen navigoinnista.
• MCP-palvelin: itse ylläpidetty HTTP-tilaKshana ei isännöi päätepistettä. Jaettua kshana-palvelinta, johon asiakkaan voisi osoittaa, ei ole.
• Kshanan käyttö agentistaAgentille (tai agenttia ohjaavalle henkilölle): mitä työkalua kutsutaan mihinkin kysymykseen, mitä työkalut tekevät ja…
• Mistä kukin ominaisuus on tavoitettavissaJokainen ominaisuus on käytettävissä pinnoilla, joilla se on järkevä; jos jokin pinta ei voi kantaa ominaisuutta…
• JetBrains-liitännäinenNatiivi liitännäinen, joka ajaa Kshana PNT-kestävyyssimulaattoria mistä tahansa JetBrains-IDE:stä (IntelliJ IDEA…
• Missä Kshana toimiiLaajuuden raja kirjattuna muistiin, jotta kukaan ei löydä sitä sitoumuksena kokouksessa.
• ArkkitehtuuriKshana on yksi moottori, joka on jäsennelty kerroksiin yhteisen ytimen päälle: anturipaketit (kello, inertia…
• Missä Kshana sijaitseeKshana on avoin, toistettava PNT:n (paikannus, navigointi ja ajanmääritys) kestävyyden todistemoottori.

Projekti

• MuutoslokiKaikki Kshanan merkittävät muutokset on dokumentoitu tähän.
• LisensointiKshana on kaksoislisensoitu. Voit käyttää avointa moottoria joko avoimella lisenssilla (AGPL-3.0) tai…
• TietoturvaÄlä avaa julkista issuea tietoturvaherkistä ilmoituksista.
• OsallistuminenKiitos kiinnostuksestasi. Kshana pyrkii olemaan puolueeton, toistettava, rehellisesti validoitu vertailukohta…
• HallintoTämä asiakirja kuvaa, miten Kshanaa hallitaan: kuka tekee päätökset, miten, ja mitä projekti ottaa vastaan ja mitä ei…
• KäytösohjeMe jäseninä, osallistujina ja johtajina lupaamme tehdä osallistumisesta yhteisössämme häirinnästä vapaata…

Skenaariotyyppien perheet

• Kampanjat1 skenaariotyyppi moottorissa v0.40.0. Ohjeellinen: tutkimus- ja suunnittelutyökalun analyysitulos; ei…
• Kellot, ajoitus ja holdover9 skenaariotyyppiä moottorissa v0.40.0. Ohjeellinen: tutkimus- ja suunnittelutyökalun analyysitulos; ei…
• Satelliittitähdistöt, kattavuus ja geometria7 skenaariotyyppiä moottorissa v0.40.0. Ohjeellinen: tutkimus- ja suunnittelutyökalun analyysitulos; ei…
• GNSS-mittaukset, paikannus ja eheys6 skenaariotyyppiä moottorissa v0.40.0. Ohjeellinen: tutkimus- ja suunnittelutyökalun analyysitulos; ei…
• GPS-yhteydettömät vaihtoehtoiset PNT-menetelmät5 skenaariotyyppiä moottorissa v0.40.0. Ohjeellinen: tutkimus- ja suunnittelutyökalun analyysitulos; ei…
• Inertiayhdistely ja kvanttianturit9 skenaariotyyppiä moottorissa v0.40.0. Ohjeellinen: tutkimus- ja suunnittelutyökalun analyysitulos; ei…
• Häirintä, harhautus ja spektri6 skenaariotyyppiä moottorissa v0.40.0. Ohjeellinen: tutkimus- ja suunnittelutyökalun analyysitulos; ei…
• Matalan Maan kiertoradan navigointi7 skenaariotyyppiä moottorissa v0.40.0. Ohjeellinen: tutkimus- ja suunnittelutyökalun analyysitulos; ei…
• Kuu ja kuunläheinen avaruus24 skenaariotyyppiä moottorissa v0.40.0. Ohjeellinen: tutkimus- ja suunnittelutyökalun analyysitulos; ei…
• Tehtäväanalyysi, linkit ja avaruusoperaatiot14 skenaariotyyppiä moottorissa v0.40.0. Ohjeellinen: tutkimus- ja suunnittelutyökalun analyysitulos; ei…
• Tehtäväketjut1 skenaariotyyppi moottorissa v0.40.0. Ohjeellinen: tutkimus- ja suunnittelutyökalun analyysitulos; ei…
• Optinen PNT2 skenaariotyyppiä moottorissa v0.40.0. Ohjeellinen: tutkimus- ja suunnittelutyökalun analyysitulos; ei…
• Avaruuskäyttäjän navigointi1 skenaariotyyppi moottorissa v0.40.0. Ohjeellinen: tutkimus- ja suunnittelutyökalun analyysitulos; ei…

Skenaariotyyppisivut

92 sivua, yksi kutakin skenaariotyyppiä kohti, linkitettynä sivulta Jokainen skenaariotyyppi perheittäin.

Ei mukana

Ylläpitäjien prosessiasiakirjat pysyvät repositoriossa: docs/RELEASING.md (julkaisumenettely); docs/WHEEL_TAGS.md (paketoinnin yksityiskohdat); docs/revisions/ (sisäiset muutosmuistiinpanot); docs/design/ (sisäiset suunnittelumuistiinpanot); README.pypi.md (PyPI-sivu; Python-rajapinnan dokumentti kattaa sen); .github/-mallipohjat; docs/integrations.md (jäsennelty nimettyjen kolmannen osapuolen tekoälytuotteiden ympärille, joita tämä sivusto ei nimeä).