Strojový překlad, nekontrolovaný rodilým mluvčím. Referenční je anglická verze.

API a integraceUpravit na GitHubuZdroj: README.crates.md

Kshana: značka, kompasový zaměřovací kříž označující přesný okamžik, vedle slovní značky kshanaKshana: značka, kompasový zaměřovací kříž označující přesný okamžik, vedle slovní značky kshana

Kshana · क्षण · přesný okamžik
Open-source simulátor odolnosti PNT (určování polohy, navigace a času).

Vydání v0.40.0 176 z 401 schopností ověřeno proti nezávislým vnějším orákulům Pokrytí řádků zhruba 95 %, v nepřetržité integraci s hranicí 85 % Licence: AGPL-3.0-only, nebo komerční licence DOI 10.5281/zenodo.20528627

Nacvičte minutu, kdy GNSS zhasne: konzole mise Kshana, vykreslená ze skutečného běhu enginu, zřetězená kampaň s rušením, podvržením signálu, holdoverem a integritou nad 102 družicemi GPS, Galileo, BeiDou a GLONASSNacvičte minutu, kdy GNSS zhasne: konzole mise Kshana, vykreslená ze skutečného běhu enginu, zřetězená kampaň s rušením, podvržením signálu, holdoverem a integritou nad 102 družicemi GPS, Galileo, BeiDou a GLONASS

Nacvičte minutu, kdy GNSS zhasne#

Kshana přehrává rušení, spoofing a holdover hodin, když signály GNSS (globální družicový navigační systém) selžou, a říká, jak dlouho systém udrží čas a polohu v rámci svého rozpočtu a které hodiny nebo senzor přinesou největší rezervu. Toto je crate v Rustu: engine jako knihovna a příkaz kshana. Každý běh je bit po bitu reprodukovatelný ze scénáře, seedu a verze enginu.

Vyzkoušejte jej nejdřív bez jakékoli instalace: Kshana Studio spouští celý engine ve vašem prohlížeči, přeložený do WebAssembly, a nic nenahrává.

Důkazy#

176 z 401 schopností ověřeno proti nezávislým vnějším orákulům; 221 poctivě označeno jako modelované, 4 ve vlastnictví partnera. Každá schopnost nese jedno označení ve strojově kontrolovaném registru: VALIDATED (souhlasí nezávislé vnější orákulum: skutečná data, nezávislá implementace nebo zveřejněné referenční vektory), MODELLED (vnitřně konzistentní, a řečeno otevřeně) nebo PARTNER (vlastní ho hardwarový partner). Mezi kontrolami: všech 666 vektorů SGP4 (Simplified General Perturbations 4) podle AIAA (American Institute of Aeronautics and Astronautics) 2006-6753 na 4,12 mm a model sil Cowell na 0,08 m proti Orekit 12,2.

Jak schopnost získává své označení: schopnost, orákulum, test, označení v registru. Stav ověření napříč všemi 401 schopnostmi: 176 ověřeno, 221 modelováno, 4 ve vlastnictví partneraJak schopnost získává své označení: schopnost, orákulum, test, označení v registru. Stav ověření napříč všemi 401 schopnostmi: 176 ověřeno, 221 modelováno, 4 ve vlastnictví partnera

Instalace#

cargo add kshana            # use the engine as a library
cargo install kshana        # or install the command-line interface (CLI)

Použití — knihovna#

Příklad je úplný program: nese vlastní scénář zapsaný v TOML (Tom's Obvious, Minimal Language), takže po cargo add kshana běží jako src/main.rs nového projektu cargo new a na disku není potřeba nic jiného.

use kshana::api;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // A complete scenario, not a sketch: scenarios/clock-holdover.toml without its
    // comment lines. It runs 2 h, 10 min of GNSS then about 1.8 h with GNSS denied, and
    // asks how long a strontium optical clock and a chip-scale atomic clock (CSAC) each
    // hold time to within 20 ns. sigma_y(1s) is a clock's Allan deviation at an averaging
    // time of one second; q_wf, the white-frequency-noise intensity, is its square.
    let toml = r#"
seed = 42
threshold_ns = 20.0

[time]
step_s = 10.0
duration_s = 7200.0

[gnss]
windows = [
  { t0 = 0.0,    t1 = 600.0,  state = "nominal" },
  { t0 = 600.0,  t1 = 7200.0, state = "denied" },
]

[clock_quantum]
id = "optical-sr-lattice"
provenance = "Strontium optical lattice clock, space-oriented goal sigma_y(1s)=1e-15 (Origlia/Schiller/Bongs et al., arXiv:1503.08457); q_wf=sigma_y(1s)^2; ground-demonstrator maturity, not flown; flicker/aging not modeled"
y0   = 5.0e-17
q_wf = 1.0e-30
q_rw = 0.0

[clock_classical]
id = "csac-sa45s"
provenance = "Microchip SA65 / SA.45s CSAC datasheet sigma_y(1s)=3e-10; q_wf=sigma_y(1s)^2; flicker/aging not modeled"
y0   = 5.0e-10
q_wf = 9.0e-20
q_rw = 0.0
"#;
    let out = api::run_toml(toml)?; // RunOutput { json, svg, summary, csv }
    println!("{}", out.summary); // the one-line result string
    std::fs::write("clock-holdover.result.json", &out.json)?; // the full result document
    Ok(())
}

out.json je dokument výsledku ve formátu JSON (JavaScript Object Notation), out.svg graf ve formátu SVG (Scalable Vector Graphics) a out.csv je u druhů, které publikují tabulku, tato tabulka ve formátu CSV (hodnoty oddělené čárkami).

Referenční příručka API, generovaná ze src/api.rs#

Každá veřejná funkce kshana::api v enginu v0.40.0, načtená ze zdroje při sestavení.

FunkceSignaturaCo dělá
kshana::api::without_figure_tiers(json: &str) -> Option<String>json s odstraněným závěrečným blokem figure_tiers, bajt po bajtu tak, jak byl dokument, než tento blok existoval; None, pokud dokument takový blok nemá nebo má blok, který není jeho posledním klíčem (což tento crate nikdy nevydává, takže jej má nástroj brát jako selhání, nikoli odstraňovat něco, co nedokáže vysvětlit).
kshana::api::list_scenario_kinds() -> Vec<ScenarioMeta>Vypíše každý vestavěný druh scénáře s jeho metadaty.
kshana::api::list_scenario_kinds_json() -> StringVestavěné druhy scénářů a jejich metadata jako pole JSON — forma, kterou jazykové vazby zpřístupňují pro programovou introspekci.
kshana::api::kind_description_in(lang: &crate::i18n::Lang, kind: &str) -> Option<String>Popis vestavěného druhu scénáře kind v jazyce lang z katalogu (anglicky, pokud jazyk nemá jeho překlad); None pro název, který není vestavěným druhem.
kshana::api::kind_description(kind: &str) -> Option<String>[kind_description_in] v aktuálním jazyce ([crate::i18n::current]).
kshana::api::list_scenario_kinds_json_lang(lang: &str) -> Result<String, String>[list_scenario_kinds_json] s každým popisem v jazyce lang (značka, jakou přijímá --lang, například de nebo zh-Hans); názvy a seznamy polí jsou v každém jazyce stejné a pro angličtinu je dokument bajt po bajtu shodný s [list_scenario_kinds_json].
kshana::api::kind_modules_json() -> String[KIND_MODULES] jako objekt JSON, druh na pole názvů modulů, v pořadí tabulky.
kshana::api::field_importance_json() -> String[HEADLINE_FIELDS] jako JSON: {kind: {"headline": [path, ...]}}, v pořadí tabulky.
kshana::api::scenarios_reference_md() -> StringVykreslí katalog vestavěných druhů scénářů jako samostatnou referenci v Markdownu (docs/SCENARIOS.md): každý druh, který lze spustit, s jednořádkovým popisem a jeho povinnými / volitelnými poli TOML.
kshana::api::validate_scenario(src: &str) -> Vec<String>Zkontroluje scénář TOML podle vlastní introspekce crate a vrátí seznam problémů — aby volající mohl zjistit, co je špatně, PŘED (případně dlouhým) během, místo aby narazil na pozdní selhání za běhu.
kshana::api::export_sp3(src: &str) -> Result<String, String>Exportuje propagovanou konstelaci scénáře oběžné dráhy / konstelace jako text SP3-c.
kshana::api::auto_export_sp3(src: &str) -> Result<Option<String>, String>Je-li src scénář oběžné dráhy s export_sp3 = true, vrátí jeho text SP3-c; jinak None.
kshana::api::export_omm(src: &str) -> Result<String, String>Exportuje střední elementy TLE scénáře oběžné dráhy jako katalog CCSDS OMM — jedna zpráva OMM (Orbit Mean-Elements Message) na každou družici definovanou TLE, ve formě KVN, s reálným katalogovým číslem NORAD, označením COSPAR a epochou z každého TLE.
kshana::api::auto_export_omm(src: &str) -> Result<Option<String>, String>Je-li src scénář oběžné dráhy s export_omm = true, vrátí jeho text katalogu OMM; jinak None.
kshana::api::export_oem(src: &str) -> Result<String, String>Exportuje propagovanou konstelaci scénáře oběžné dráhy jako text CCSDS OEM — časovou řadu inerciálního (TEME) stavu, polohu A rychlost, ve výměnném formátu efemerid kosmických lodí, který čtou nástroje letové dynamiky (GMAT/Orekit/STK).
kshana::api::auto_export_oem(src: &str) -> Result<Option<String>, String>Je-li src scénář oběžné dráhy s export_oem = true, vrátí jeho text OEM; jinak None.
kshana::api::inject_eop(src: &str, finals2000a_body: &str) -> Result<String, String>Vloží skutečné tělo IERS finals2000A do pole eop_finals2000a scénáře (cesta CLI --eop <file>) a vrátí sloučené TOML.
kshana::api::with_study_meta(json: &str, meta: &crate::report::StudyMeta) -> StringVloží blok metadat studie do již vykresleného dokumentu výsledku JSON a vrátí dokument s klíčem „meta“ nejvyšší úrovně vloženým hned za úvodní složenou závorku.
kshana::api::run_scenario(src: &str) -> Result<RunOutput, KshanaError>Spustí scénář a vrátí typovaný výsledek se strukturovanou chybou — vstupní bod, který by volající vazeb měli upřednostnit před [run_toml] s chybou v řetězci.
kshana::api::run_toml(src: &str) -> Result<RunOutput, String>Rozebere, přiřadí a spustí scénář zadaný jako řetězec TOML.
kshana::api::run_toml_lang(src: &str, lang: &str) -> Result<RunOutput, String>[run_toml] pro uživatele v jazyce lang (značka jako de, pt-BR, zh-Hans, en-XA).
kshana::api::run_toml_bilingual(src: &str, lang: &str) -> Result<(RunOutput, Option<RunOutput>), String>Dva běhy [run_toml_lang] držené odděleně: anglický běh, jehož json a csv jsou strojové soubory, a pro jiný jazyk běh v tomto jazyce pro vše, co čte člověk.
kshana::api::run_toml_human(src: &str, lang: &str) -> Result<HumanOutput, String>Druhý průchod [run_toml_bilingual] samostatně: spustí scénář jednou v jazyce lang a vrátí pouze to, co čte člověk.
kshana::api::run_scenario_lang(src: &str, lang: &str) -> Result<RunOutput, KshanaError>[run_scenario] pro uživatele v jazyce lang; viz [run_toml_lang].
kshana::api::error_info_json(src: &str, lang: &str) -> StringSpustí src v jazyce lang a pokud selže, popíše selhání jako objekt JSON {"kind": <kind_tag>, "code": <stabilní kód nebo null>, "message": <text v daném jazyce>}.
kshana::api::without_evidence(json: &str) -> Stringjson bez štítku důkazů ([crate::evidence_label]); beze změny, pokud žádný nenese.
kshana::api::without_evidence_labels(mut out: RunOutput) -> RunOutputout se štítkem důkazů odstraněným z jeho JSON, SVG a CSV, bajt po bajtu tak, jak je běh vytvořil, než štítek existoval; výstup bez štítku zůstává beze změny.
kshana::api::run_toml_untiered(src: &str) -> Result<RunOutput, String>[run_toml] bez bloku figure_tiers pro daný druh, který připojuje [run_toml_inner] (RM-04): pro běh, jehož dokument je vložen do výsledku jiného druhu (člen kampaně), takže vnější dokument zachová své bajty.
kshana::api::append_figure_tiers(json: &str, block: &serde_json::Value) -> Result<String, String>json s blokem připojeným jako poslední klíč, figure_tiers, bajt po bajtu tak, jak by jej serializoval obal Documented: odsazení po dvou mezerách, blok vnořený o jednu úroveň.

Výměnné formáty v crate: parser a zapisovač CCSDS Tracking Data Message (TDM) (kshana::ccsds_tdm); Kshana Interchange Format (KIF) (kshana::interchange).

Použití — CLI#

Instalace z registru nemá adresář scenarios/, takže CLI nese referenční scénáře s sebou; kshana example je vypíše a uvede těch několik, která vynechává, s důvodem (každý čte jen data dodávaná s repozitářem nebo následuje předvolbu, kterou vydání může zadržet).

kshana example clock-holdover > clock-holdover.toml   # write a bundled scenario to a file
kshana clock-holdover.toml                            # run it
kshana --validate clock-holdover.toml                 # lint it without running
kshana example                                        # list every bundled scenario
kshana kinds                                          # list every scenario kind

kshana example orbit-sgp4-gps > orbit-sgp4-gps.toml   # the GPS constellation, real orbital elements
kshana orbit-sgp4-gps.toml --export list              # which exchange formats apply
kshana orbit-sgp4-gps.toml --export all               # every exchange file that applies
kshana orbit-sgp4-gps.toml --animate html             # a self-contained animation page

Běh se řídí kind scénáře a vedle souboru scénáře zapíše <scenario>.result.json, .chart.svg, .report.html (tisknutelnou stránku zprávy v HTML, HyperText Markup Language) a .report.json (tutéž zprávu ve strojově čitelné podobě), plus .table.csv u druhů, které publikují tabulku. --export přidává výměnné soubory: CZML (Cesium Language) a KML (Keyhole Markup Language) pro prohlížeče glóbu, GeoJSON pro mapy, soubory efemerid STK (Systems Tool Kit) a nahrávky SigMF (Signal Metadata Format) pro druh spectrum. --animate přidává animaci SVG, HTML nebo po jednotlivých snímcích.

Z klonu repozitáře berou stejné příkazy soubory přímo z scenarios/, včetně studie s více scénáři (kshana --study scenarios/quantum-pnt-demonstrator.suite.toml) a lunar-llr-datum, jediného scénáře, který čte skutečná data laserového měření vzdálenosti dodávaná jen s repozitářem.

Každá schopnost ve verifikační matici je označena jako ověřená (zkontrolovaná proti nezávislému vnějšímu orákulu), modelovaná nebo ve vlastnictví partnera; údaje o optických hodinách jsou cíle pro vesmír na pozemním hardwaru (žádné optické hodiny se stronciem dosud nelétaly). Zralost není napříč oblastmi jednotná – PNT pro Zemi je ověřeno proti skutečným datům; navigace v hlubokém vesmíru a na Marsu je modelovaná, přičemž proti vnějším orákulím jsou ověřeny jen její stavební bloky (světelný čas, polohy planet); skutečné OD (určování oběžné dráhy) pro mise v hlubokém vesmíru je na plánu rozvoje.

Schopnosti#

Engine má 92 druhů scénářů; kshana kinds je vypíše s jejich poli. Nově ve verzi 0.38.0: gnss-ssv (signály GNSS pro kosmické prostředky nad drahami GNSS, kolem nich i za nimi) a lunar-infrastructure (lunární oběžná dráha a povrch jako navigační a geodetická infrastruktura), obojí MODELLED, a holdover-test (záznam časové chyby proti maskám ITU-T).

  • Spektrum: jak jammer zabírá pásmo L GNSS, pásmo po pásmu.
  • Hodiny a časování: holdover proti prahu, přenos času a telekomunikační holdover proti maskám normalizačního sektoru Mezinárodní telekomunikační unie (ITU-T).
  • Konstelace kolem libovolného tělesa: pokrytí, faktor DOP (zhoršení přesnosti) a dostupnost kolem Země, Měsíce nebo Marsu a sluneční soustava v jedné epoše.
  • Navigace na nízké oběžné dráze: signál, přelet a spoj, navigační zpráva a fúzované zaměření, krok za krokem.
  • Kampaně: zřetězená mise, průchod parametrem nebo soubor Monte Carlo v jednom scénáři.
  • Zprávy, animace a exporty: každý údaj s jednotkou a štítkem; animovaný záznam běhu; soubory SP3 (Standard Product 3), orbitální zprávy CCSDS (Consultative Committee for Space Data Systems), CZML (Cesium Language), KML (Keyhole Markup Language), GeoJSON, STK (Systems Tool Kit) a SigMF (Signal Metadata Format).
  • Důvěra v GNSS plavidla (receiver_trust, včetně receiver_trust::live): skóre 0 až 100 s důvody z NMEA přijímače, živě nebo ze záznamu; pouze poradní charakter, nejde o typově schválené navigační zařízení.
  • Balíčky důkazů (evidence): podepsaný technický záznam okna záznamu, ověřitelný offline.
  • Telemetrie důvěry (telemetry): proud důvěry jako metriky Prometheus, události SIEM a volitelně OpenTelemetry.
  • Výcvikové proudy (nmea_synth): syntetické NMEA z můstku s předepsaným rušením a spoofingem a záznamem instruktora. Pouze text; nikdy pro živé navigační systémy plavidla.
  • Mapa interference (interference_map): souhrnné mapy zhoršené navigace a expozice trasy.
  • Testovací stolice a mapování compliance (interop::testbench, compliance): pohyb vozidla a události scénáře pro laboratorní simulátor GNSS a mapování na veřejné rámce vyplněné z dokumentů výsledků.
  • Laboratoř GNSS IQ (iq): scény, akvizice, sledování, monitory a kampaně na nahraném a syntetickém IQ.

Architektura#

Jeden otevřený engine uprostřed, kshana 0.40.0, s typovaným rozdělováním přes 75 druhů; kolem něj příkazová řádka, knihovna v Rustu, Python, WebAssembly a Kshana Studio, server MCP, obraz Docker a zásuvný modul JetBrains; pod ním Kshana Pro, proprietární nadstavba, která závisí na otevřeném enginu a nikdy jej nevětvíJeden otevřený engine uprostřed, kshana 0.40.0, s typovaným rozdělováním přes 75 druhů; kolem něj příkazová řádka, knihovna v Rustu, Python, WebAssembly a Kshana Studio, server MCP, obraz Docker a zásuvný modul JetBrains; pod ním Kshana Pro, proprietární nadstavba, která závisí na otevřeném enginu a nikdy jej nevětví

Tentýž soubor scénáře dává na každém rozhraní stejné bajty. MCP je Model Context Protocol: kshana-mcp umožňuje asistentovi s umělou inteligencí (AI) spouštět engine.

Výzkum#

Na otevřeném enginu je postaveno šest článků na arXiv, každý s příkazem, který za ním stojí: arXiv:2606,22054 (optimismus detektorů interference), arXiv:2606,24210 (podmíněná ochranná úroveň pro časování), arXiv:2607,05415 (jak stabilní je skóre odolnosti PNT), arXiv:2607,02566 (pozorovatelnost lunárních povrchových stanic pomocí interferometrie s velmi dlouhou základnou), arXiv:2607,06212 (geometrie jižního pólu Měsíce a povrchové majáky) a arXiv:2610,23871 (cislunární navigace jako problém pozorovatelnosti: délka oblouku, podmíněnost Gramiánu a Dopplerova páka). Viz Výzkum.

Edice#

Celý engine je zdarma pod AGPL-3.0. Kshana Pro, proprietární nadstavba, která závisí na otevřeném enginu a nikdy jej nevětví, a studie na zakázku jsou dostupné na smlouvu od Ashforde® OÜ: contact@ashforde.org. Žádné ceny se neuvádějí; viz docs/PRO.md.

Další informace#

Licence#

Svobodný a open source pod licencí GNU AGPL-3.0-only (GNU Affero General Public License, pouze verze 3). Komerční licence je k dispozici od Ashforde® OÜ (estonská společnost s ručením omezeným; OÜ = osaühing) pro uzavřenou integraci; viz LICENSING.md. Profesionálně vyvíjí a udržuje Ashforde® OÜ.