passes (tipo de escenario)
Tipo de escenario del motor v0.40.0, familia Constelaciones, cobertura y geometría. Consultivo: salida de análisis de una herramienta de investigación e ingeniería, no un equipo de navegación homologado ni un servicio de seguridad de la vida humana. Toda etiqueta de aquí es la del motor o la de la matriz de verificación; un tipo de escenario es MODELLED salvo que la matriz diga otra cosa (cómo se gana una etiqueta: la sección Evidence del README).
Qué hace#
Predicción de pases sobre una estación terrestre: los pases de visibilidad en el dominio del tiempo (AOS/TCA/LOS, elevación aparente máxima, duración) de una órbita circular, como elementos medios SGP4 al inicio de la ventana, sobre una estación por encima de una máscara de elevación a lo largo de una ventana, con el tiempo total de acceso. Propagación SGP4/SDP4 en el marco fijo a la Tierra IAU 2006/2000A (UT1 - UTC y movimiento polar opcionales), refracción troposférica ITU-R P.834-9 y tiempo de luz del enlace descendente (ambos activados por defecto), cruces resueltos hasta 1e-7 s y la culminación mediante búsqueda por sección áurea. La geometría de los pases está VALIDATED frente a Orekit 13.1.8 en estaciones a nivel del mar; la órbita y la estación del escenario son entradas ilustrativas.
Una ejecución de scenarios/passes.toml se resume así: passes: 5 pase(s) de una órbita de 550 km / 97,6° sobre (52,2°, 4,4°) > 10° en 24 h; 1659 s de acceso total (MODELLED)
Entradas#
Del esquema (kshana kinds --json):
- Campos obligatorios: ninguno
- Campos opcionales:
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
El ejemplo scenarios/passes.toml establece, entre otros:
| Campo | Valor | Unidad |
|---|---|---|
altitude_km |
550 | km |
arg_lat_deg |
0 | deg |
duration_hours |
24 | h |
epoch |
[2024, 1, 1, 0, 0, 0] | no indicado |
inclination_deg |
97.6 | deg |
kind |
passes | texto |
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 |
Ejecútelo#
kshana scenarios/passes.toml
Qué proporciona#
Los resultados escalares de esa ejecución, con las unidades que indica el motor:
| Resultado | Valor | Unidad |
|---|---|---|
altitude_km |
550 | km |
best_max_elevation_deg |
70.081649 | deg |
duration_hours |
24 | h |
evidence.id_rule |
el identificador estable de la fila de la matriz (el ID | texto |
evidence.matrix |
docs/VERIFICATION-MATRIX.md | texto |
evidence.tier |
MODELLED | texto |
inclination_deg |
97.6 | deg |
light_time |
true | indicador |
mask_deg |
10 | deg |
pass_count |
5 | recuento |
Etiqueta del resultado (la del motor): MODELLED — predicción de pases sobre una estación terrestre en el dominio del tiempo; propagación SGP4/SDP4, marco fijo a la Tierra IAU 2006/2000A (UT1 = UTC, sin movimiento polar salvo que se den parámetros de orientación terrestre), elevación aparente con refracción ITU-R P.834-9 y tiempo de luz cuando se activan, cruces y culminación refin
Evidencias#
MODELLED 2 · VALIDATED 2: las filas de la matriz de verificación que nombran este tipo de escenario.
- VALIDATED Pases de visibilidad en el dominio del tiempo (AOS/TCA/LOS, elevación máxima, duración) de un propagador del motor sobre una estación por encima de una máscara de elevación, con cruces interpolados de salida y puesta y acceso total: passes::predict_passes, el planificador geométrico (sin Pruebas: ground_station_pass_prediction_reference.rs.
- VALIDATED Pases de visibilidad (AOS, TCA, LOS, elevación aparente máxima, duración) de un conjunto de elementos SGP4 sobre una estación WGS-84 en la vía de órbita terrestre validada (IAU 2006/2000A, parámetros de orientación terrestre opcionales), con troposférica ITU-R P.834-9 Pruebas: pass_predictor_on_path_orekit_oracle.rs.
- MODELLED Es/N0 del enlace descendente a lo largo de cada paso de un satélite sobre una estación (EIRP, pérdida en espacio libre, pérdida atmosférica con ley de cosecante, otras pérdidas, G/T, constante de Boltzmann, velocidad de símbolo), el MODCOD de DVB-S2 más eficiente que supera su umbral de ETSI EN 302 307-
- MODELLED Una ejecución toma un plan de contactos (una lista de ventanas aos_s/los_s, cada una de las cuales solicita a la apertura navegación o comunicaciones — el mismo vocabulario de ventanas que emite
passes::predict_passes, convertido poraperture_duty::windows_from_passes), una apert
Las filas que la propia ejecución puso a prueba, con la referencia independiente que da la matriz a cada una (las fuentes públicas se nombran allí):
- MODELLED Determinista, con hash de escenario, SBOM + barreras golden multiplataforma. Referencia independiente (ExternalDataset): ajuste a la norma del SBOM al esquema JSON oficial de CycloneDX 1,5 (+ identificadores SPDX válidos) — un estándar externo publicado, cero errores de validación en todo el grafo de dependencias; la parte de determinismo de FoM / reproducibilidad byte a byte sigue siendo una comprobación de autoconsistencia fijada, por lo que la fila sigue siendo MODELLED
- VALIDATED Pases de visibilidad en el dominio del tiempo (AOS/TCA/LOS, elevación máxima, duración) de un propagador del motor sobre una estación por encima de una máscara de elevación, con salida y puesta interpoladas . Referencia independiente (ExternalDataset): Orekit 12,2 (CS GROUP, Apache-2.0) + Hipparchus 3,1: una biblioteca independiente de dinámica de vuelo: ElevationDetector (buscador de raíces de Brent) + EventsLogger sobre una efeméride ITRF, con la estación como TopocentricFrame WGS-84. AOS/LOS/elevación máxima/número de pases/acceso total coinciden con órbita, estación, máscara y ventana idénticas (archivo de prueba confirmado; controlador xval/orekit-passes)
Limitaciones#
Lo que el propio informe de la ejecución dice que no está modelado o no está validado:
- MODELLED — predicción de pases sobre una estación terrestre en el dominio del tiempo; propagación SGP4/SDP4, marco fijo a la Tierra IAU 2006/2000A (UT1 = UTC, sin movimiento polar salvo que se den parámetros de orientación terrestre), elevación aparente con refracción ITU-R P.834-9 y tiempo de luz cuando se activan, cruces y culminación refinados por debajo del paso (resultado
label) - La reproducibilidad y el aseguramiento del software son MODELLED, no están validados: una subafirmación se comprueba externamente, pero la capacidad completa compone piezas modeladas, por lo que la capacidad sigue siendo modelada. (matriz de verificación (docs/MODELLED-RATIONALE.md))
Véase también#
- Página de familia: Constelaciones, cobertura y geometría
- Todos los tipos de escenario: KINDS.md
- Página de tema: CONTACT-SCHEDULING.md