Iga käsk
kshana <scenario.toml> käitab stsenaariumi; kõik muud käsud on alamkäsud. kshana --help prindib neid kõiki kasutusjuhised ja iga alamkäsu oma --help loetleb selle lipud. Näited käitatakse väljavõetud koopiast.
| Käsk | Mida see teeb | Näide | Dokumentatsioon |
|---|---|---|---|
kshana <scenario.toml> |
käitab mis tahes liiki stsenaariumi ning kirjutab selle tulemuse, diagrammi ja aruande | kshana scenarios/clock-holdover.toml |
Stsenaariumid |
kshana --study <suite.toml> |
käitab stsenaariumide komplekti üheks koondatud, tembeldatud uuringuks | kshana --study scenarios/quantum-pnt-demonstrator.suite.toml |
Kasutus |
kshana --validate <scenario.toml> |
kontrollib stsenaariumi lintimisega ilma seda käitamata | kshana --validate scenarios/gnss-ins.toml |
Kasutus |
kshana kinds [--json] |
loetleb iga stsenaariumi liigi koos selle kohustuslike ja valikuliste väljadega | kshana kinds |
Liigid |
kshana example [<name>] |
prindib kaasasoleva stsenaariumi, millest alustada | kshana example clock-holdover > clock-holdover.toml |
Stsenaariumid |
kshana receiver-trust <scenario> |
hindab vastuvõtja logi, live hindab voogu, evidence kirjutab allkirjastatud paketi |
kshana receiver-trust examples/receiver-trust/session.toml |
Vastuvõtja usaldus |
kshana evidence keygen, verify, attach-timestamp, round-trip |
allkirjastab, kontrollib ja ajatempeldab tõendipakette ning seob labori käituse selle skooriga | kshana evidence keygen --out signer.key |
Tõendipaketid |
kshana jammertest import, score, locate-score |
reads the published Jammertest plan and scores a log against it; locate-score scores reported emitter locations against truth (row B2) |
kshana jammertest score --help |
Jammertest |
kshana trust-telemetry |
the trust stream as Prometheus, CEF, LEEF, OTLP or MQTT messages, and CAP 1.2 alerts written to a directory or posted to a signed webhook | kshana trust-telemetry --result session.result.json --print-metrics |
Usalduse telemeetria |
kshana imu-fit <imu.csv> |
sobitab hübriidsensori parameetrid paigalseisva IMU logi põhjal | kshana imu-fit still.csv --axis x --expected-mean 0 --id bench-imu |
Masinasisendid |
kshana ephem-export <horizons.txt> |
writes a JPL Horizons state table as a CCSDS OEM or OPM or an SPK kernel for flight-dynamics tools, and reads it back | kshana ephem-export capstone.txt --format spk --out capstone.bsp |
Flight-dynamics export |
kshana nmea-scenario <scenario> |
kirjutab sünteetilise sillal tekkiva NMEA skriptitud segamise ja spuufimisega ning juhendaja logi | kshana nmea-scenario scenarios/training/coastal-drag-off.toml --out drag.nmea |
NMEA koolitus |
kshana interference-map adsb, ais, daily, sensitivity, fetch-land, record |
builds interference maps and the observatory's daily product from aircraft and ship reports (record: from a local receiver, live) |
examples/interference-map/regenerate.sh |
Häirekaart, observatoorium |
kshana route-exposure |
kui suur osa marsruudist läbib halvenenud ruute | kshana route-exposure --route examples/interference-map/input/route-adsb.geojson --map examples/interference-map/output/ |
Häirekaart |
kshana bench spec, truth, cases, score, baseline, seal, reveal-check, manifest, verify-manifest, validate, leaderboard |
kshana-bench ülesanded, hindamine, suletud holdout ja edetabel | kshana bench baseline --task d --split test --out results/ |
Bench |
kshana bench-export <scenario> |
stsenaariumi sõiduki liikumine ja sündmused laborisimulaatorile (signaali ei kirjutata) | kshana bench-export scenarios/gnss-ins.toml --out run1 --epoch 2025-03-01T10:00:00Z |
Test bench |
kshana compliance-report |
millised avalike vastupidavusraamistike read käituste kogum toetab tõendeid (supports evidence for) | kshana compliance-report --mapping |
Compliance |
kshana lunanet-afs-check spec, symbols, generate |
kontrollib ja genereerib LunaNet AFS koode ja kaadreid | kshana lunanet-afs-check spec |
LunaNet AFS |
kshana standards-pack list, run, rows, tests |
hinnatud standardipaketid | kshana standards-pack run imo-circ-1575 |
Standardipaketid |
kshana partner check <submission.toml> |
kontrollib andmepartneri esituse vormingut ja metaandmeid ning loeb selle andmefaili mootori lugejatega; ei hinda midagi | kshana partner check examples/partner-submission/submission.toml |
Partneri andmed |
kshana scenario migrate <scenario.toml> [--in-place], version |
states a scenario file's schema version and upgrades older files; version prints the version this engine reads |
kshana scenario migrate scenarios/aocs-slew.toml |
Scenario versions |
kshana obs convert <log> --format <f> --station <station.toml>, obs live <file|-|tcp:host:port> --format <f> --station <station.toml>, obs check <file> |
writes a receiver log as a kshana.obs/1 observation file (live: from a stream as it arrives, the same epochs as a replay), and checks one; convert --format rtcm-ssr writes an RTCM 3 stream's SSR corrections (RTCM and IGS SSR) as correction records |
kshana obs convert examples/receiver-trust/illustrative-jamming.nmea --format nmea --station examples/obs/station.toml |
Observations |
kshana ntrip <host:port> [--mount <name>] [--user <u> --password-env <VAR>] [--gga <lat,lon[,h]>] [--out <file>] [--max-bytes <n>] [--seconds <s>] |
fetches an NTRIP stream (RTCM 3) from a caster, unchanged, and counts the frames that arrive intact; with no --mount, prints the source table |
kshana ntrip caster.example:2101 --mount TLL00EST0 --out tallinn.rtcm3 --seconds 60 |
NTRIP |
kshana clock-live --format <f> --from <-|tcp:host:port|file> |
follows a linuxptp, chrony or Linux PPS log and prints one JSON line per reading, kept exactly as a replay keeps it | kshana clock-live --format ptp4l --from tests/fixtures/clock_log/linuxptp_chrony/ptp4l.log |
Clock logs |
kshana sensor-live --kind imu --format <csv|euroc|ros2-csv> --from <-|tcp:host:port|file>, --kind n2k |
follows an IMU log and prints each sample with its integrated gyro heading, equal to a replay; or turns NMEA 2000 CAN frames (candump) into NMEA 0183 |
kshana sensor-live --kind imu --format csv --from still.csv |
Masinasisendid |
kshana device check <device.toml>, device decode <device.toml> --from <...> |
runs a device file's test vectors; decodes a binary sensor described by a kshana.device/1 file into JSON Lines for a connect mapping |
kshana device check examples/devices/example-monitor.device.toml |
Devices |
kshana bench-speed [--repeats <n>] [--json <out>] [--baseline <old.json>] |
times the live paths and prints the station sizing table; with a baseline, fails on a slowdown over 10 % | kshana bench-speed --quick |
Sizing |
kshana data-pack <out-dir> [--seed <n>] [--logs <n>] [--iq <n>] |
writes a synthetic labelled data pack (NMEA logs with spoofing labels, IQ scenes with natural impairments), the same bytes for the same seed | kshana data-pack pack --seed 1 --logs 2 --iq 4 --iq-seconds 0.5 |
Data packs |
kshana env-baseline <site-hours.json> |
environmental baseline per site and hour from Kp and F10.7: score 0 to 1 and quiet, elevated or disturbed (MODELLED) | kshana env-baseline hours.json |
B8 pre-registration |
kshana planner map|place <spec.json> |
monitoring-network planner: per site cell, detection probabilities and the TDOA location bound (DRMS, 95 % ellipse); chooses m stations from candidates (MODELLED) |
kshana planner map xval/planner/layout_circle.json |
Planner |
kshana area-trust <stations.json> |
one trust state for an area from several reference stations' states, per second, with alerts (JSON Lines) | kshana area-trust stations.json |
Area trust |
kshana station run <station.toml>, station check <station.toml>, station service <systemd|launchd|windows> <station.toml> |
runs a Kshana Station: every configured receiver stream as kshana.obs/1 files (the epochs a replay gives), rotated, with a local status port and an optional fleet report; check validates the configuration, service prints what installs it as a service |
kshana station check examples/station/station.toml |
Station |
kshana connect map <input> --mapping <connect.toml> --station <station.toml> |
maps any CSV, TSV, JSON or JSON Lines export to a kshana.obs/1 file through a mapping file, with no code |
kshana connect map examples/connect/timing-monitor.csv --mapping examples/connect/timing-monitor.connect.toml --station examples/obs/station.toml |
Connect |
kshana connect check <vector.toml|dir> [--bless] |
runs Connect conformance vectors (input, mapping or reader, expected obs/1 output) and fails on any byte difference, naming the first differing line | kshana connect check conformance/connect |
Connect |
kshana connect watch <dir> --mapping <connect.toml> --station <station.toml> [--suffix <.csv>] [--interval <s>] [--once] |
follows a directory of growing or rotating logs and prints new kshana.obs/1 records as JSON lines, reading the files as one continuous log |
kshana connect watch logs/ --mapping examples/connect/android-raw.connect.toml --station examples/obs/station.toml --once |
Connect |
kshana connect mqtt <host:port> --topic <filter> --mapping <connect.toml> --station <station.toml> [--header <row>] [--qos 0|1] [--user <name> --password-env <VAR>] [--client-id <id>] [--max-messages <n>] |
subscribes to an MQTT topic and prints kshana.obs/1 records as JSON lines as the published rows complete each epoch |
kshana connect mqtt 127.0.0.1:1883 --topic gnss/rx1/raw --mapping examples/connect/android-raw.connect.toml --station examples/obs/station.toml --header "$(grep '^type,' examples/connect/android-raw.csv)" |
Connect |
kshana connect nats <host:port> --subject <s> --mapping <connect.toml> --station <station.toml> [--header <row>] [--per-topic] [--user <name> --password-env <VAR> | --token-env <VAR>] [--max-messages <n>] |
subscribes to a NATS subject and prints kshana.obs/1 records as JSON lines |
kshana connect nats 127.0.0.1:4222 --subject 'gnss.*.raw' --per-topic --mapping examples/connect/timing-monitor.connect.toml --station examples/obs/station.toml --header "week;tow;lat;lon;alt_ft;G05;G12;G25;E11;agc;spoof" |
Connect |
kshana connect ws <ws://host:port/path> --mapping <connect.toml> --station <station.toml> [--header <row>] [--max-messages <n>] |
reads rows streamed over a WebSocket and prints kshana.obs/1 records as JSON lines; the server's close ends the run |
kshana connect ws ws://127.0.0.1:9000/raw --mapping examples/connect/android-raw.connect.toml --station examples/obs/station.toml --header "$(grep '^type,' examples/connect/android-raw.csv)" |
Connect |
kshana connect check-live <vector.toml|dir> [--json] |
replays the Connect conformance vectors over MQTT (with a forced reconnection), WebSocket and the directory watch; checks order, holding, reconnection and latency; exit 1 on any failure | kshana connect check-live conformance/connect |
Connect |
kshana connect load-test [--stations <n>] [--rate <Hz>] [--seconds <s>] [--via memory|mqtt] [--json] |
runs many synthetic stations through the live feeds (default 1,000 at 1 Hz for 10 s); reports capacity and time per message; exit 1 if it does not keep up | kshana connect load-test --via mqtt |
Connect |
kshana connect adapters <list|check> [<dir>] [--json] |
the adapter registry: lists the adapters that pass, or validates every manifest and runs every conformance vector (exit 1 on any failure) | kshana connect adapters check adapters |
Adapters |
kshana osnma verify <input> |
milliste satelliitide navigatsiooniandmeid vastuvõtja saab autentida | kshana osnma verify examples/osnma/pages-good.txt --public-key "$(cat examples/osnma/public-key.txt)" --json |
OSNMA |
kshana iq scene, acquire, track, sweep, labfit, campaign, conditions, frontend, monitor, inventory, info, extract, convert, decimate, record |
loob, loeb, teisendab ja töötleb baasribasalvestisi tarkvaralise vastuvõtjaga | kshana iq scene scene.sdrx --rate 2046000 --duration 1 --signal gps-l1ca --prn 3,11 --cn0 45 seejärel kshana iq acquire scene.sdrx --signal gps-l1ca --prn 3,11 |
IQ ja tarkvaraline vastuvõtja |
kshana sky <request> |
vaatejoone nähtavus, täpsuse halvenemise tegur ja kättesaadavus määratud silmapiiri korral | kshana sky --site 59.44,24.75 --systems gps-baseline,galileo --mask 10 |
Silmapiir |
kshana skyline |
sisseehitatud takistusprofiilid koos nende päritoluga | kshana skyline --presets |
Silmapiir |
kshana --help, --version |
iga käsu kasutusjuhend; mootori versioon | kshana --help |
Kasutus |