Résoudre les problèmes liés aux éphémérides non valides - AWS Ground Station
Comprendre les erreurs de validation des éphéméridesErreurs de validation courantes pour les éphémérides TLEErreurs de validation courantes pour les éphémérides OEMErreurs de validation courantes pour les éphémérides d'élévation d'azimutÉtapes de résolution des problèmesRéférence complète du code d'erreur

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Résoudre les problèmes liés aux éphémérides non valides

Lorsque vous chargez des données d'éphémérides vers AWS Ground Station, elles sont soumises à un flux de travail de validation asynchrone. Si la validation échoue, le statut de l'éphéméride passe à. INVALID Le message d'erreur contenu dans la DescribeEphemerisréponse fournit des informations détaillées pour vous aider à identifier et à résoudre le problème.

Comprendre les erreurs de validation des éphémérides

Lorsqu'une éphéméride échoue à la validation, la réponse de l'DescribeEphemerisAPI inclut deux champs pour aider à diagnostiquer le problème :

errorCode

Code lisible par machine identifiant l'erreur de validation spécifique. Cela peut être utilisé pour la gestion des erreurs de programmation.

errorMessage

Une description lisible par l'homme de l'erreur de validation avec des détails spécifiques sur ce qui s'est mal passé et des conseils pour y remédier.

Exemple de DescribeEphemerisréponse pour une éphéméride non valide : 

{
    "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": "[...]"
        }
    }
}

Erreurs de validation courantes pour les éphémérides TLE

Les erreurs de validation les plus courantes rencontrées lors du téléchargement d'éphémérides TLE sont les suivantes :

Numéro de catalogue satellite non concordant

Erreur : « Le numéro de catalogue satellite présent dans l'éphéméride ne correspond pas au numéro de catalogue satellite du satellite associé »

Solution : Vérifiez que le numéro de ID/satellite catalogue du NORAD figurant sur vos lignes TLE correspond au numéro de catalogue satellite de votre satellite. 00000À utiliser pour les satellites sans numéro de catalogue attribué.

Mouvement moyen non valide

Erreur : « Le mouvement moyen des éphémérides fournies est trop différent de celui des éphémérides de référence les plus récentes »

Solution : Vérifiez que vos données TLE sont correctes et représentent une orbite valide. Ground Station utilise les éphémérides Space-Track comme référence lors de la validation.

Erreurs de validation courantes pour les éphémérides OEM

Les erreurs de validation les plus courantes rencontrées lors du téléchargement d'éphémérides OEM sont les suivantes :

Cadre de référence non valide

Erreur : « Le REF_FRAME n'est pas pris en charge »

Solution : mettez à jour votre fichier OEM pour utiliser l'un des cadres de référence pris en charge : EME2 000 ou ITRF2 000.

Champs obligatoires manquants

Erreur : « Champ de métadonnées manquant : INTERPOLATION »

Solution : ajoutez les champs INTERPOLATION et INTERPOLATION_DEGREE à votre section de métadonnées OEM. Ils sont nécessaires pour AWS Ground Station générer des angles de pointage précis de l'antenne.

Système horaire non pris en charge

Erreur : « Le TIME_SYSTEM n'est pas pris en charge »

Solution : Assurez-vous que votre fichier OEM utilise l'UTC comme système horaire.

Version OEM non prise en charge

Erreur : « Le CCSDS_OEM_VERS n'est pas pris en charge »

Solution : Assurez-vous que votre fichier OEM utilise la version 2.0 de CCSDS OEM.

Erreurs de validation courantes pour les éphémérides d'élévation d'azimut

Les erreurs de validation les plus courantes rencontrées lors du téléchargement d'éphémérides d'élévation d'azimut sont les suivantes :

azimuth/elevation Données manquantes

Erreur : « Aucun TimeAzEl champ n'était présent dans au moins un AzElSegment »

Solution : Assurez-vous que chaque segment de vos données d'altitude azimutale contient au moins une paire horodatée. azimuth/elevation

Plage d'angles d'azimut non valide (degrés)

Erreur : « AzEl  az doit être supérieur ou égal à -180 et inférieur ou égal à 360 degrés »

Solution : Vérifiez que les angles d'azimut se situent dans les limites de [-180, 360] degrés.

Plage d'angles d'élévation non valide (degrés)

Erreur : « AzEl  el doit être supérieur ou égal à -90 et inférieur ou égal à 90 degrés »

Solution : Vérifiez que les angles d'élévation sont compris entre [-90, 90] degrés.

Plage d'angles d'azimut non valide (radians)

Erreur : « AzEl  az doit être supérieur ou égal à -pi et inférieur ou égal à 2 pi radians »

Solution : Vérifiez que les angles d'azimut sont compris entre [-π, 2π] radians.

Plage d'angles d'élévation non valide (radians)

Erreur : « AzEl  el doit être supérieur ou égal à -pi/2 et inférieur ou égal à pi/2 radians »

Solution : Vérifiez que les angles d'élévation sont compris entre [-π/2, π/2] radians.

Valeurs temporelles non monotones

Erreur : « Les TimeAzEl articles contenus dans un AzElSegment doivent être en ordre dans le temps »

Solution : assurez-vous que les valeurs temporelles de chaque segment augmentent strictement.

Segments hors ordre

Erreur : « AzElSegments  doit être temporairement en ordre »

Solution : Assurez-vous que les segments sont classés par ordre chronologique.

Segments qui se chevauchent

Erreur : « La plage de temps d'au moins un segment se chevauche avec d'autres plages temporelles de segment »

Solution : Assurez-vous que chaque segment possède une plage de temps unique qui ne se chevauche pas. Le endTime d'un segment ne doit pas dépasser celui startTime du segment suivant.

Étapes de résolution des problèmes

Si la validation de votre éphéméride échoue, procédez comme suit pour résoudre le problème :

  1. Appelez DescribeEphemerisavec votre identifiant d'éphéméride pour récupérer le errorCode et. errorMessage

  2. Consultez le message d'erreur pour obtenir des informations spécifiques sur le contrôle de validation qui a échoué.

  3. Corrigez les problèmes identifiés dans vos données d'éphémérides.

  4. Téléchargez une nouvelle éphéméride avec les données corrigées à l'aide de. CreateEphemeris

  5. Surveillez le nouvel état des éphémérides jusqu'à ce qu'il atteigne ENABLED cet état.

  6. Supprimez les éphémérides non valides en indiquant DeleteEphemerissi elles ne sont plus nécessaires.

Référence complète du code d'erreur

Les sections suivantes fournissent un mappage complet de toutes les errorCode valeurs qui peuvent être renvoyées en cas d'échec de la validation des éphémérides, organisées par catégorie de haut niveauinvalidReason.

Motif non valide : METADATA_INVALID

Ces erreurs se produisent lorsque les champs de métadonnées obligatoires sont manquants, mal formatés ou contiennent des valeurs non prises en charge dans les données d'éphémérides.

Code d’erreur Message d'erreur
IDENTIFIANT_SATCAT_ID NON CONCORDANT Le numéro de catalogue satellite présent dans les éphémérides TLE ne correspond pas au numéro de catalogue satellite du satellite associé
OEM_VERSION_NON PRISE EN CHARGE Les éphémérides présentes CCSDS_OEM_VERS dans l'OEM ne sont pas prises en charge. Valeurs prises en charge : [2.0]
ORIGINATEUR_MANQUANT Le champ ORIGINATOR d'en-tête est absent des éphémérides OEM
DATE_DE_CRÉATION_MANQUANTE Le champ CREATION_DATE d'en-tête est absent des éphémérides OEM
NOM_OBJET_MANQUANT Le champ de OBJECT_NAME métadonnées est absent des éphémérides OEM
IDENTIFIANT_OBJET MANQUANT Le champ de OBJECT_ID métadonnées est absent des éphémérides OEM
REF_FRAME_NON PRIS EN CHARGE Les éphémérides présentes REF_FRAME dans l'OEM ne sont pas prises en charge. Valeurs prises en charge : [EME2000,ITRF2000]
REF_FRAME_EPOCH_NON PRIS EN CHARGE Le champ de REF_FRAME_EPOCH métadonnées dans les éphémérides OEM n'est pas pris en charge. Veuillez supprimer ce champ de l'éphéméride
TIME_SYSTEM_UNSUPPORTED Les éphémérides présentes TIME_SYSTEM dans l'OEM ne sont pas prises en charge. Valeurs prises en charge : [UTC]
CENTER_BODY_UNSUPPORTED Les éphémérides présentes CENTER_BODY dans l'OEM ne sont pas prises en charge. Valeurs prises en charge : [Earth]
INTERPOLATION_MANQUANTE Le champ de INTERPOLATION métadonnées est absent des éphémérides OEM
DEGRÉ_INTERPOLATION_INCORRECT Le degré d'interpolation dans les éphémérides OEM doit être supérieur à 0 pour la méthode d'interpolation.
AZ_EL_SEGMENT_LIST_MISSING Le azElSegmentListchamp est manquant
INSUFFICIENT_TIME_AZ_EL Aucun TimeAzElchamp n'était présent dans au moins un azElSegmentList

Motif non valide : TIME_RANGE_INVALID

Ces erreurs se produisent lorsque l'éphéméride contient des plages temporelles non valides, notamment des problèmes liés aux start/end heures, à l'ordre des segments, à des segments qui se chevauchent ou à des incohérences temporelles.

Code d’erreur Message d'erreur
HEURE DE DÉBUT DANS LE FUTUR L'heure de début des éphémérides est dans le futur, mais doit être dans le passé
END_TIME_IN_PAST La fin des éphémérides appartient au passé, mais elle doit l'être dans le futur
EXPIRATION_TIME_TROP TÔT Le délai d'expiration indiqué est antérieur à l'heure de fin de l'éphéméride
START_TIME_METADATA_TOO_EARLY La valeur START_TIME des métadonnées est antérieure à la première heure présente dans les données d'éphémérides OEM
STOP_TIME_METADATA_TOO_LATE La valeur STOP_TIME des métadonnées est postérieure à la dernière date de présence dans les données d'éphémérides OEM
AZ_EL_SEGMENT_END_TIME_BEFORE_START_TIME Le endTimed'au moins un segment de données se situe avant le segment startTime
AZ_EL_SEGMENT_TIMES_OVERLAP La plage de temps d'au moins un segment chevauche d'autres plages temporelles de segment
AZ_EL_SEGMENTS_OUT_OF_ORDER Les segments ne sont pas ordonnés dans le temps
TIME_AZ_EL_ITEMS_OUT_OF_ORDER Les TimeAzElarticles contenus dans un AzElSegmentdoivent être temporellement en ordre
AZ_EL_SEGMENT_REFERENCE_EPOCH_INVALID L'époque de référence d'un segment n'est pas valide ou n'est pas correctement formatée
AZ_EL_SEGMENT_START_TIME_INVALID L'heure de début comprise dans la plage horaire valide d'un segment ne commence pas après le premier segment
AZ_EL_SEGMENT_END_TIME_INVALID L'heure de fin comprise dans la plage horaire valide d'un segment ne se termine pas après le dernier segment
AZ_EL_SEGMENT_VALID_TIME_RANGE_INVALID La plage horaire valide pour un segment n'est pas valide
AZ_EL_SEGMENT_END_TIME_TOO_LATE L'heure de fin d'un segment dépasse la durée maximale autorisée par rapport à l'époque de référence
AZ_EL_TOTAL_DURATION_EXCEEDED La durée totale sur tous les segments dépasse la durée maximale autorisée de l'angle de pointage

Motif non valide : TRAJECTORY_INVALID

Ces erreurs se produisent lorsque l'éphéméride contient des données de trajectoire non valides, notamment des problèmes liés aux paramètres orbitaux, aux plages d'angles ou aux unités.

Code d’erreur Message d'erreur
MOTION_MOYEN_INCORRECT Le mouvement moyen des éphémérides TLE fournies est trop différent des éphémérides de référence les plus récentes. Remarque : Ground Station utilise les éphémérides Space-Track comme référence lors de la validation
TIME_AZ_EL_AZ_RADIAN_RANGE_INVALID AzEl azdoit être supérieur ou égal à -π et inférieur ou égal à 2π radians
TIME_AZ_EL_EL_RADIAN_RANGE_INVALID AzEl eldoit être supérieur ou égal à -π/2 et inférieur ou égal à π/2 radians
TIME_AZ_EL_AZ_DEGREE_RANGE_INVALID AzEl azdoit être supérieur ou égal à -180 et inférieur ou égal à 360 degrés
TIME_AZ_EL_EL_DEGREE_RANGE_INVALID AzEl eldoit être supérieur ou égal à -90 degrés et inférieur ou égal à 90 degrés
TIME_AZ_EL_ANGLE_UNITS_INVALID Unités AzEl angulaires non valides

Motif non valide : KMS_KEY_INVALID

Ces erreurs se produisent en cas de problème avec la clé AWS Key Management Service (KMS) utilisée pour chiffrer les données éphémérides.

Code d’erreur Message d'erreur
AUTORISATIONS_KMS_INSUFFISANTES Ground Station ne dispose pas des autorisations suffisantes pour accéder à la clé KMS de cet éphéméride

Motif non valide : VALIDATION_ERROR

Ces erreurs se produisent en cas de problèmes généraux de validation des données d'éphémérides qui n'entrent pas dans les autres catégories spécifiques.

Code d’erreur Message d'erreur
INTERNAL_ERROR Une erreur interne s'est produite lors de la validation des éphémérides
FORMAT_FICHIER_INVALIDE Le format de fichier éphéméride n'est pas valide ou est endommagé. Vérifiez que le fichier est conforme au format attendu pour le type d'éphéméride