passes (scenariotyp)
Scenariotyp i motor v0.40.0, familj Konstellationer, täckning och geometri. Rådgivande: analysutdata från ett forsknings- och ingenjörsverktyg, inte typgodkänd navigationsutrustning och inte en livräddande säkerhetstjänst. Varje etikett här är motorns eller verifieringsmatrisens; en typ är MODELLED om inte matrisen säger något annat (hur en etikett förtjänas: avsnittet Evidens i README).
Vad den gör#
Prediktion av passager över en markstation: passagerna med sikt i tidsdomänen (AOS/TCA/LOS, maximal skenbar elevation, varaktighet) för en cirkulär bana, som SGP4-medelelement vid fönstrets start, över en station ovanför en elevationsmask under ett fönster, med total åtkomsttid. SGP4/SDP4-propagering i det jordfasta systemet IAU 2006/2000A (valfritt UT1 - UTC och polrörelse), troposfärisk refraktion enligt ITU-R P.834-9 och nedlänkens ljustid (båda på som standard), korsningar lösta till 1e-7 s och kulminationen med gyllene snittet-sökning. Passagegeometrin är VALIDATED mot Orekit 13.1.8 vid stationer på havsnivå; scenariots bana och station är illustrativa indata.
En körning av scenarios/passes.toml sammanfattas som: 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)
Indata#
Från schemat (kshana kinds --json):
- Obligatoriska fält: inga
- Valfria fält:
altitude_km,inclination_deg,raan_deg,arg_lat_deg,station_lat_deg,station_lon_deg,station_alt_m,epoch,mask_deg,duration_hours,step_s,refraction,light_time,ut1_minus_utc_s,xp_arcsec,yp_arcsec
Exemplet scenarios/passes.toml anger bland annat:
| Fält | Värde | Enhet |
|---|---|---|
altitude_km |
550 | km |
arg_lat_deg |
0 | deg |
duration_hours |
24 | hr |
epoch |
[2024, 1, 1, 0, 0, 0] | inte angivet |
inclination_deg |
97.6 | deg |
kind |
passes | text |
mask_deg |
10 | deg |
raan_deg |
0 | deg |
station_alt_m |
0 | m |
station_lat_deg |
52.2 | deg |
station_lon_deg |
4.4 | deg |
step_s |
10 | s |
Kör den#
kshana scenarios/passes.toml
Vad den ger#
De skalära resultaten av den körningen, med de enheter som motorn anger:
| Resultat | Värde | Enhet |
|---|---|---|
altitude_km |
550 | km |
best_max_elevation_deg |
70.081649 | deg |
duration_hours |
24 | hr |
evidence.id_rule |
det stabila id:t för matrisraden (ID | text |
evidence.matrix |
docs/VERIFICATION-MATRIX.md | text |
evidence.tier |
MODELLED | text |
inclination_deg |
97.6 | deg |
light_time |
true | flagga |
mask_deg |
10 | deg |
pass_count |
5 | antal |
Resultatetikett (motorns egen): MODELLED — prediktion av passager över en markstation i tidsdomänen; SGP4/SDP4-propagering, jordfast system IAU 2006/2000A (UT1 = UTC, ingen polrörelse om inte jordorienteringsparametrar anges), skenbar elevation med refraktion enligt ITU-R P.834-9 och ljustid när de slås på, korsningar och kulmination förfinade under steget
Evidens#
MODELLED 2 · VALIDATED 2: raderna i verifieringsmatrisen som nämner den här typen.
- VALIDATED Passager med sikt i tidsdomänen (AOS/TCA/LOS, maximal elevation, varaktighet) för en motorpropagator över en station ovanför en elevationsmask, med interpolerade uppgångs-/nedgångskorsningar och total åtkomst: passes::predict_passes, den geometriska schemaläggaren (ingen Tester: ground_station_pass_prediction_reference.rs.
- VALIDATED Passager med sikt (AOS, TCA, LOS, maximal skenbar elevation, varaktighet) för en SGP4-elementmängd över en WGS-84-station på den validerade vägen för jordbanor (IAU 2006/2000A, valfria jordorienteringsparametrar), med troposfärisk ITU-R P.834-9 Tester: pass_predictor_on_path_orekit_oracle.rs.
- MODELLED Nedlänkens Es/N0 längs varje överflygning av en satellit över en station (EIRP, fri-rymdsdämpning, atmosfärsdämpning enligt cosekantlagen, övriga förluster, G/T, Boltzmanns konstant, symbolhastighet), den effektivaste DVB-S2 MODCOD som klarar sin ETSI EN 302 307-
- MODELLED En körning tar en kontaktplan (en lista med aos_s/los_s-fönster, vart och ett med begäran till aperturen om navigering eller kommunikation — samma fönstervokabulär som
passes::predict_passesger, omvandlad avaperture_duty::windows_from_passes), ett antal aperturer
De rader som själva körningen använde, med den oberoende referens som matrisen anger för var och en (de offentliga källorna nämns där):
- MODELLED Deterministisk, scenario-hashad, SBOM + golden-grindar över flera plattformar. Oberoende referens (ExternalDataset): SBOM som följer det officiella CycloneDX 1,5 JSON Schema (+ giltiga SPDX-identifierare) — en extern publicerad standard, noll valideringsfel över hela beroendegrafen; delen om FoM-determinism / byte-reproducerbarhet förblir en fastlåst kontroll av inre samstämmighet, så raden förblir MODELLED
- VALIDATED Passager med sikt i tidsdomänen (AOS/TCA/LOS, maximal elevation, varaktighet) för en motorpropagator över en station ovanför en elevationsmask, med interpolerade uppgångs-/nedgångs. Oberoende referens (ExternalDataset): Orekit 12,2 (CS GROUP, Apache-2.0) + Hipparchus 3,1 — ett oberoende flygdynamikbibliotek: ElevationDetector (Brent-rotfinnare) + EventsLogger över en ITRF-efemerid, station som en WGS-84 TopocentricFrame. AOS/LOS/maximal elevation/antal passager/total åtkomst stämde för identisk bana+station+mask+fönster (incheckad fixtur; drivrutin xval/orekit-passes)
Begränsningar#
Vad körningens egen rapport säger inte är modellerat eller inte validerat:
- MODELLED — prediktion av passager över en markstation i tidsdomänen; SGP4/SDP4-propagering, jordfast system IAU 2006/2000A (UT1 = UTC, ingen polrörelse om inte jordorienteringsparametrar anges), skenbar elevation med refraktion enligt ITU-R P.834-9 och ljustid när de slås på, korsningar och kulmination förfinade under steget (resultat
label) - Reproducerbarhet och programvarusäkring är MODELLED, inte validerad: ett delpåstående kontrolleras externt, men hela förmågan sätts ihop av modellerade delar, så förmågan förblir Modelled. (verifieringsmatris (docs/MODELLED-RATIONALE.md))
Se även#
- Familjesida: Konstellationer, täckning och geometri
- Alla typer: KINDS.md
- Ämnessida: CONTACT-SCHEDULING.md