Risoluzione dei problemi relativi alle effemeridi non valide - AWS Ground Station
Comprensione degli errori di convalida delle effemeridiErrori di convalida comuni per le effemeridi TLEErrori di convalida comuni per le effemeridi OEMErrori di convalida comuni per le effemeridi di elevazione dell'azimutFasi per la risoluzione dei problemiRiferimento completo al codice di errore

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risoluzione dei problemi relativi alle effemeridi non valide

Quando carichi i dati sulle effemeridi su, questi vengono sottoposti a un flusso di lavoro di convalida asincrono. AWS Ground Station Se la convalida fallisce, lo stato delle effemeridi cambierà in. INVALID Il messaggio di errore contenuto nella DescribeEphemerisrisposta fornisce informazioni dettagliate per aiutarti a identificare e risolvere il problema.

Comprensione degli errori di convalida delle effemeridi

Quando la convalida di un'effemeride fallisce, la risposta dell'DescribeEphemerisAPI include due campi per facilitare la diagnosi del problema:

errorCode

Un codice leggibile da una macchina che identifica l'errore di convalida specifico. Può essere usato per la gestione degli errori programmatici.

errorMessage

Una descrizione leggibile dall'uomo dell'errore di convalida con dettagli specifici su cosa è andato storto e indicazioni su come correggerlo.

Esempio di DescribeEphemerisrisposta per un'effemeride non valida: 

{
    "ephemerisId": "abc12345-6789-def0-1234-567890abcdef",
    "name": "My Invalid Ephemeris",
    "status": "INVALID",
    "creationTime": 1620254718.765,
    "invalidReason": "METADATA_INVALID",
    "errorCode": "OBJECT_NAME_MISSING",
    "errorMessage": "Metadata field missing: OBJECT_NAME",
    "suppliedData": {
        "tle": {
            "ephemerisData": "[...]"
        }
    }
}

Errori di convalida comuni per le effemeridi TLE

Di seguito sono riportati gli errori di convalida più comuni riscontrati durante il caricamento delle effemeridi TLE:

Numero di catalogo satellitare non corrispondente

Errore: «Il numero di catalogo satellitare presente nelle effemeridi non corrisponde al numero di catalogo satellitare del satellite associato»

Soluzione: verificate che il numero di ID/satellite catalogo NORAD nelle vostre linee TLE corrisponda al numero di catalogo satellitare del vostro satellite. 00000Utilizzatelo per i satelliti senza un numero di catalogo assegnato.

Movimento medio non valido

Errore: «Il movimento medio delle effemeridi fornite differisce troppo dalle effemeridi di riferimento più recenti»

Soluzione: verificate che i dati TLE siano corretti e rappresentino un'orbita valida. Ground Station utilizza le effemeridi Space-Track come riferimento durante la convalida.

Errori di convalida comuni per le effemeridi OEM

Di seguito sono riportati gli errori di convalida più comuni riscontrati durante il caricamento di effemeridi OEM:

Quadro di riferimento non valido

Errore: «REF_FRAME non è supportato»

Soluzione: aggiornate il file OEM per utilizzare uno dei quadri di riferimento supportati: EME2 000 o 000. ITRF2

Campi obbligatori mancanti

Errore: «Campo di metadati mancante: INTERPOLAZIONE»

Soluzione: aggiungi i campi INTERPOLATION e INTERPOLATION_DEGREE alla sezione dei metadati OEM. Questi sono necessari per generare angoli di puntamento accurati dell'antenna. AWS Ground Station

Sistema orario non supportato

Errore: «Il TIME_SYSTEM non è supportato»

Soluzione: assicurati che il file OEM utilizzi l'UTC come sistema orario.

Versione OEM non supportata

Errore: «Il CCSDS_OEM_VERS non è supportato»

Soluzione: assicurati che il tuo file OEM utilizzi CCSDS OEM versione 2.0.

Errori di convalida comuni per le effemeridi di elevazione dell'azimut

Di seguito sono riportati gli errori di convalida più comuni riscontrati durante il caricamento di effemeridi di elevazione dell'azimut:

Dati mancanti azimuth/elevation

Errore: «Nessun TimeAzEl campo era presente in almeno uno AzElSegment»

Soluzione: assicurati che ogni segmento nei dati di elevazione azimutale contenga almeno una coppia con tag temporali azimuth/elevation .

Intervallo di angoli azimutali non valido (gradi)

Errore: "AzEl az deve essere maggiore o uguale a -180 e minore o uguale a 360 gradi»

Soluzione: verificate che gli angoli di azimut siano compresi tra [-180, 360] gradi.

Intervallo di angoli di elevazione non valido (gradi)

Errore: "AzEl el deve essere maggiore o uguale a -90 e minore o uguale a 90 gradi»

Soluzione: verificate che gli angoli di elevazione siano compresi tra [-90, 90] gradi.

Intervallo di angoli azimutali non valido (radianti)

Errore: "AzEl az deve essere maggiore o uguale a -pi e minore o uguale a 2pi radianti»

Soluzione: verificate che gli angoli di azimut siano compresi tra [-π, 2π] radianti.

Intervallo di angoli di elevazione non valido (radianti)

Errore: "AzEl el deve essere maggiore o uguale a -pi/2 e minore o uguale a pi/2 radianti»

Soluzione: verificate che gli angoli di elevazione siano compresi tra [-π, 2] radianti.

Valori temporali non monotonici

Errore: « TimeAzEl Gli elementi all'interno di un AzElSegment devono essere in ordine temporale»

Soluzione: assicurati che i valori temporali in ogni segmento aumentino rigorosamente.

Segmenti fuori ordine

Errore: "AzElSegments deve essere temporalmente in ordine»

Soluzione: assicuratevi che i segmenti siano disposti in ordine cronologico.

Segmenti sovrapposti

Errore: «L'intervallo di tempo di almeno un segmento si sovrappone a quello di altri segmenti»

Soluzione: assicurati che ogni segmento abbia un intervallo di tempo unico e non sovrapposto. Il valore endTime di un segmento non deve superare quello startTime del segmento successivo.

Fasi per la risoluzione dei problemi

Se le tue effemeridi non vengono convalidate, segui questi passaggi per risolvere il problema:

  1. Chiama DescribeEphemeriscon il tuo Ephemeris ID per recuperare l'and. errorCode errorMessage

  2. Controlla il messaggio di errore per dettagli specifici su quale controllo di convalida non è riuscito.

  3. Correggi i problemi identificati nei dati sulle effemeridi.

  4. Carica una nuova effemeride con i dati corretti utilizzando. CreateEphemeris

  5. Monitora il nuovo stato delle effemeridi finché non raggiunge lo stato. ENABLED

  6. Elimina le effemeridi non valide usando DeleteEphemerisse non sono più necessarie.

Riferimento completo al codice di errore

Le sezioni seguenti forniscono una mappatura completa di tutti i errorCode valori che possono essere restituiti quando la convalida delle effemeridi fallisce, organizzata per categoria di alto livello. invalidReason

Motivo non valido: METADATA_INVALID

Questi errori si verificano quando i campi di metadati obbligatori sono mancanti, sono formattati in modo errato o contengono valori non supportati nei dati delle effemeridi.

Codice di errore Messaggio di errore
MISMATCHED_SATCAT_ID Il numero di catalogo satellitare presente nelle effemeridi TLE non corrisponde al numero di catalogo satellitare del satellite associato
OEM_VERSION_UNSUPPORTED Le effemeridi in OEM non sono CCSDS_OEM_VERS supportate. Valori supportati: [] 2.0
ORIGINATOR_MISSING Il campo di ORIGINATOR intestazione non è presente nelle effemeridi OEM
DATA_CREAZIONE_MANCANTE Il campo di CREATION_DATE intestazione non è presente nelle effemeridi OEM
NOME_OGGETTO MANCANTE Il campo dei OBJECT_NAME metadati non è presente nelle effemeridi OEM
OBJECT_ID_MISSING Il campo dei OBJECT_ID metadati non è presente nelle effemeridi OEM
REF_FRAME_UNSUPPORTED Le effemeridi REF_FRAME in OEM non sono supportate. Valori supportati: [,] EME2000 ITRF2000
REF_FRAME_EPOCH_UNSUPPORTED Il campo dei REF_FRAME_EPOCH metadati nelle effemeridi OEM non è supportato. Rimuovi questo campo dalle effemeridi
TIME_SYSTEM_UNSUPPORTED Le effemeridi TIME_SYSTEM in OEM non sono supportate. Valori supportati: [] UTC
CENTER_BODY_UNSUPPORTED Le effemeridi CENTER_BODY in OEM non sono supportate. Valori supportati: [] Earth
INTERPOLAZIONE_MANCANTE Il campo dei INTERPOLATION metadati non è presente nelle effemeridi OEM
INTERPOLATION_DEGREE_INVALID Il grado di interpolazione nelle effemeridi OEM deve essere maggiore di 0 per il metodo di interpolazione
AZ_EL_SEGMENT_LIST_MISSING Il campo è mancante azElSegmentList
INSUFFICIENT_TIME_AZ_EL Nessun campo TimeAzElera presente in almeno uno azElSegmentList

Motivo non valido: TIME_RANGE_INVALID

Questi errori si verificano quando le effemeridi contengono intervalli di tempo non validi, inclusi problemi relativi agli start/end orari, all'ordinamento dei segmenti, ai segmenti sovrapposti o alle incongruenze temporali.

Codice di errore Messaggio di errore
TEMPO_DI_INIZIO IN_FUTURO L'ora di inizio delle effemeridi è nel futuro, ma deve essere nel passato
TEMPO_FINE_IN_PASSATO Effemeridi: la fine dei tempi è nel passato, ma deve essere nel futuro
TIME_EXPIRATION_TOO_EARLY L'ora di scadenza fornita è precedente all'ora di fine delle effemeridi
TIME_START_METADATA_TOO_EARLY Il valore dei START_TIME metadati è precedente alla prima data presente nei dati sulle effemeridi OEM
STOP_TIME_METADATA_TOO_LATE Il valore dei STOP_TIME metadati è successivo all'ultima ora presente nei dati sulle effemeridi OEM
AZ_EL_SEGMENT_END_TIME_BEFORE_START_TIME Il valore di almeno un segmento di dati è precedente a quello del segmento endTimestartTime
AZ_EL_SEGMENT_TIMES_OVERLAP L'intervallo di tempo di almeno un segmento si sovrappone a quello di altri intervalli di tempo del segmento
AZ_EL_SEGMENTS_OUT_OF_ORDER I segmenti non sono ordinati temporalmente
TIME_AZ_EL_ITEMS_OUT_OF_ORDER Gli articoli all'interno di a devono essere temporaneamente in TimeAzElordine AzElSegment
AZ_EL_SEGMENT_REFERENCE_EPOCH_INVALID L'epoca di riferimento per un segmento non è valida o è formattata in modo errato
AZ_EL_SEGMENT_START_TIME_INVALID L'ora di inizio nell'intervallo di tempo valido di un segmento non inizia dopo il primo segmento
AZ_EL_SEGMENT_END_TIME_INVALID L'ora di fine nell'intervallo di tempo valido di un segmento non termina dopo l'ultimo segmento
AZ_EL_SEGMENT_VALID_TIME_RANGE_INVALID L'intervallo di tempo valido per un segmento non è valido
AZ_EL_SEGMENT_END_TIME_TOO_LATE L'ora di fine di un segmento supera la durata massima consentita dall'epoca di riferimento
AZ_EL_TOTAL_DURATION_EXCEEDED La durata totale su tutti i segmenti supera la durata massima consentita dell'angolo di puntamento

Motivo non valido: TRAJECTORY_INVALID

Questi errori si verificano quando le effemeridi contengono dati di traiettoria non validi, inclusi problemi con parametri orbitali, intervalli angolari o unità.

Codice di errore Messaggio di errore
MEAN_MOTION_INVALID Il movimento medio delle effemeridi TLE fornite differisce troppo dalle effemeridi di riferimento più recenti. Nota: Ground Station utilizza le effemeridi Space-Track come riferimento durante la convalida
TIME_AZ_EL_AZ_RADIAN_RANGE_INVALID AzEl azdeve essere maggiore o uguale a -π e minore o uguale a 2π radianti
TIME_AZ_EL_EL_RADIAN_RANGE_INVALID AzEl eldeve essere maggiore o uguale a -π /2 e minore o uguale a π /2 radianti
TIME_AZ_EL_AZ_DEGREE_RANGE_INVALID AzEl azdeve essere maggiore o uguale a -180 e minore o uguale a 360 gradi
TIME_AZ_EL_EL_DEGREE_RANGE_INVALID AzEl eldeve essere maggiore o uguale a -90 gradi e minore o uguale a 90 gradi
TIME_AZ_EL_ANGLE_UNITS_INVALID Unità angolari non valide AzEl

Motivo non valido: KMS_KEY_INVALID

Questi errori si verificano quando si verificano problemi con la chiave AWS Key Management Service (KMS) utilizzata per crittografare i dati delle effemeridi.

Codice di errore Messaggio di errore
INSUFFICIENT_KMS_PERMISSIONS Ground Station non dispone di autorizzazioni sufficienti per accedere alla chiave KMS di questa effemeride

Motivo non valido: VALIDATION_ERROR

Questi errori si verificano quando ci sono problemi generali di convalida con i dati sulle effemeridi che non rientrano nelle altre categorie specifiche.

Codice di errore Messaggio di errore
INTERNAL_ERROR Si è verificato un errore interno durante la convalida delle effemeridi
FILE_FORMAT_INVALID Il formato del file delle effemeridi non è valido o è danneggiato. Verifica che il file sia conforme al formato previsto per il tipo di effemeridi