Solucionar problemas de efemérides no válidas - AWS Ground Station
Descripción de los errores de validación de efeméridesErrores de validación comunes para las efemérides TLEErrores de validación comunes en las efemérides OEMErrores de validación comunes para las efemérides de elevación azimutalPasos para la solución de problemasReferencia completa del código de error

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Solucionar problemas de efemérides no válidas

Al cargar datos de efemérides en, estos pasan por un flujo de trabajo de AWS Ground Station validación asíncrono. Si se produce un error en la validación, el estado de las efemérides cambiará a. INVALID El mensaje de error de la DescribeEphemerisrespuesta proporciona información detallada para ayudarle a identificar y resolver el problema.

Descripción de los errores de validación de efemérides

Cuando una efeméride no pasa la validación, la respuesta de la DescribeEphemerisAPI incluye dos campos para ayudar a diagnosticar el problema:

errorCode

Un código legible por máquina que identifica el error de validación específico. Se puede utilizar para la gestión de errores programáticos.

errorMessage

Una descripción legible para los humanos del error de validación con detalles específicos sobre lo que salió mal y orientación sobre cómo solucionarlo.

Ejemplo de DescribeEphemerisrespuesta para una efeméride no válida: 

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

Errores de validación comunes para las efemérides TLE

Los siguientes son errores de validación comunes que se producen al cargar las efemérides de TLE:

El número de catálogo de satélites no coincide

Error: «El número de catálogo de satélites presente en las efemérides no coincide con el número de catálogo de satélites del satélite asociado»

Solución: compruebe que el número de ID/satellite catálogo del NORAD de las líneas TLE coincide con el número de catálogo de satélites del satélite. 00000Utilícelo para satélites sin un número de catálogo asignado.

Movimiento medio no válido

Error: «El movimiento medio de las efemérides proporcionadas difiere demasiado del movimiento de las efemérides de referencia más recientes»

Solución: compruebe que los datos de TLE son correctos y representan una órbita válida. Ground Station utiliza las efemérides de Space-Track como referencia durante la validación.

Errores de validación comunes en las efemérides OEM

Los siguientes son errores de validación comunes que se producen al cargar efemérides OEM:

Marco de referencia no válido

Error: «El REF_FRAME no es compatible»

Solución: actualice el archivo OEM para utilizar uno de los marcos de referencia compatibles: EME2 000 o ITRF2 000.

Faltan campos obligatorios

Error: «Falta el campo de metadatos: INTERPOLACIÓN»

Solución: añada los campos INTERPOLATION e INTERPOLATION_DEGREE a la sección de metadatos OEM. Estos son necesarios para generar ángulos de orientación de antena AWS Ground Station precisos.

Sistema de tiempo no compatible

Error: «El TIME_SYSTEM no es compatible»

Solución: asegúrese de que su archivo OEM utilice UTC como sistema horario.

Versión OEM no compatible

Error: «El CCSDS_OEM_VERS no es compatible»

Solución: asegúrese de que su archivo OEM utilice la versión 2.0 del CCSDS OEM.

Errores de validación comunes para las efemérides de elevación azimutal

Los siguientes son errores de validación comunes que se producen al cargar efemérides de elevación azimutal:

Faltan datos azimuth/elevation

Error: «No había TimeAzEl campos en al menos uno AzElSegment»

Solución: asegúrese de que cada segmento de los datos de elevación del acimut contenga al menos un par marcado con el tiempo. azimuth/elevation

Rango de ángulos acimutales (grados) no válido

Error: «AzEl az debe ser mayor o igual a -180 y menor o igual a 360 grados»

Solución: compruebe que los ángulos acimutales estén dentro de [-180, 360] grados.

Rango de ángulos de elevación (grados) no válido

Error: «AzEl el debe ser mayor o igual a -90 y menor o igual a 90 grados»

Solución: compruebe que los ángulos de elevación estén dentro de [-90, 90] grados.

Rango de ángulos de acimut (radianes) no válido

Error: «AzEl az debe ser mayor o igual que -pi y menor o igual que 2pi radianes»

Solución: compruebe que los ángulos acimutales estén dentro de [-π, 2π] radianes.

Rango de ángulos de elevación (radianes) no válido

Error: «AzEl el debe ser mayor o igual que -pi/2 y menor o igual que pi/2 radianes»

Solución: compruebe que los ángulos de elevación estén dentro de [-π 2, π /2] radianes.

Valores de tiempo no monótonos

Error: «Los TimeAzEl artículos incluidos en a AzElSegment deben estar en orden temporalmente»

Solución: asegúrese de que los valores de tiempo de cada segmento aumenten estrictamente.

Segmentos fuera de orden

Error: «AzElSegments debe estar temporalmente en orden»

Solución: asegúrese de que los segmentos estén organizados en orden cronológico.

Segmentos superpuestos

Error: «El intervalo de tiempo de al menos un segmento se superpone con otros intervalos de tiempo del segmento»

Solución: asegúrese de que cada segmento tenga un rango de tiempo único que no se superponga. El endTime de un segmento no debe superar el startTime del siguiente segmento.

Pasos para la solución de problemas

Si tu efeméride no pasa la validación, sigue estos pasos para resolver el problema:

  1. Llama DescribeEphemeriscon tu identificador de efemérides para recuperar la y. errorCode errorMessage

  2. Revisa el mensaje de error para obtener detalles específicos sobre qué comprobación de validación ha fallado.

  3. Corrija los problemas identificados en los datos de efemérides.

  4. Cargue una nueva efeméride con los datos corregidos utilizando. CreateEphemeris

  5. Supervisa el estado de la nueva efeméride hasta que alcance el estado. ENABLED

  6. Elimine las efemérides no válidas utilizando DeleteEphemerissi ya no son necesarias.

Referencia completa del código de error

Las siguientes secciones proporcionan un mapeo completo de todos los errorCode valores que pueden devolverse cuando se produce un error en la validación de las efemérides, organizados por categoría de alto nivelinvalidReason.

Motivo no válido: METADATA_INVALID

Estos errores se producen cuando faltan campos de metadatos obligatorios, tienen un formato incorrecto o contienen valores no admitidos en los datos de efemérides.

Código de error Mensaje de error
_SATCAT_ID NO COINCIDE El número de catálogo de satélites presente en las efemérides de la TLE no coincide con el número de catálogo de satélites del satélite asociado
OEM_VERSION_UNSUPPORTED No se admiten las CCSDS_OEM_VERS efemérides del OEM. Valores admitidos: [] 2.0
ORIGINATOR_MISSING Falta el campo de ORIGINATOR encabezado en las efemérides del OEM
FALTA LA FECHA DE CREACIÓN Falta el campo de CREATION_DATE encabezado en las efemérides del OEM
FALTA EL NOMBRE_OBJETO Falta el campo de OBJECT_NAME metadatos en las efemérides del OEM
OBJECT_ID_MISSING Falta el campo de OBJECT_ID metadatos en las efemérides del OEM
REF_FRAME_UNSUPPORTED No se admiten las REF_FRAME efemérides del OEM. Valores admitidos: [,] EME2000 ITRF2000
REF_FRAME_EPOCH_UNSUPPORTED No se admite el campo de REF_FRAME_EPOCH metadatos de las efemérides OEM. Elimine este campo de las efemérides
TIME_SYSTEM_UNSUPPORTED No se admiten las TIME_SYSTEM efemérides del OEM. Valores admitidos: [] UTC
CENTER_BODY_UNSUPPORTED No se admiten las CENTER_BODY efemérides del OEM. Valores admitidos: [] Earth
FALTA INTERPOLACIÓN_ Falta el campo de INTERPOLATION metadatos en las efemérides del OEM
GRADO DE INTERPOLACIÓN NO VÁLIDO El grado de interpolación de las efemérides OEM debe ser superior a 0 para el método de interpolación
AZ_EL_SEGMENT_LIST_MISSING Falta el campo azElSegmentList
INSUFICIENT_TIME_AZ_EL No había ningún campo en al menos una TimeAzElazElSegmentList

Motivo no válido: TIME_RANGE_INVALID

Estos errores se producen cuando las efemérides contienen intervalos de tiempo no válidos, como problemas con los start/end tiempos, el orden de los segmentos, la superposición de segmentos o las incoherencias temporales.

Código de error Mensaje de error
TIME_START_IN_FUTURE La hora de inicio de las efemérides está en el futuro, pero debe estar en el pasado
END_TIME_IN_PAST Efemérides: el fin del tiempo está en el pasado, pero debe estar en el futuro
CADUCIDAD DEMASIADO TEMPRANA La hora de caducidad proporcionada es anterior a la hora de finalización de la efeméride
START_TIME_METADATA_TOO_EARLY El valor de los START_TIME metadatos es anterior a la primera vez que aparece en los datos de efemérides del OEM
STOP_TIME_METADATA_TOO_LATE El valor de los STOP_TIME metadatos es posterior a la última vez que aparece en los datos de efemérides del OEM
AZ_EL_SEGMENT_END_TIME_BEFORE_START_TIME El de al menos un segmento de datos está antes del segmento endTimestartTime
AZ_EL_SEGMENT_TIMES_OVERLAP El intervalo de tiempo de al menos un segmento se superpone con otros intervalos de tiempo del segmento
AZ_EL_SEGMENTS_OUT_OF_ORDER Los segmentos no están ordenados temporalmente
TIME_AZ_EL_ITEMS_OUT_OF_ORDER Los artículos incluidos en un deben estar ordenados temporalmente TimeAzElAzElSegment
AZ_EL_SEGMENT_REFERENCE_EPOCH_INVALID La época de referencia de un segmento no es válida o tiene un formato incorrecto
AZ_EL_SEGMENT_START_TIME_INVALID La hora de inicio en el intervalo de tiempo válido de un segmento no comienza después del primer segmento
AZ_EL_SEGMENT_END_TIME_INVALID La hora de finalización en el intervalo de tiempo válido de un segmento no termina después del último segmento
AZ_EL_SEGMENT_VALID_TIME_RANGE_INVALID El intervalo de tiempo válido para un segmento no es válido
AZ_EL_SEGMENT_END_TIME_TOO_LATE La hora de finalización de un segmento supera la duración máxima permitida a partir de la época de referencia
AZ_EL_TOTAL_DURATION_EXCEEDED La duración total en todos los segmentos supera la duración máxima permitida del ángulo de puntería

Motivo no válido: TRAJECTORY_INVALID

Estos errores se producen cuando la efeméride contiene datos de trayectoria no válidos, incluidos problemas con los parámetros orbitales, los rangos de ángulos o las unidades.

Código de error Mensaje de error
MEAN_MOTION_INVALID El movimiento medio de las efemérides TLE proporcionadas difiere demasiado de las efemérides de referencia más recientes. Nota: Ground Station utiliza las efemérides de Space-Track como referencia durante la validación
TIME_AZ_EL_AZ_RADIAN_RANGE_INVALID AzEl azdebe ser mayor o igual a -π y menor o igual a 2π radianes
TIME_AZ_EL_EL_RADIAN_RANGE_INVALID AzEl eldebe ser mayor o igual que -π /2 y menor o igual que π /2 radianes
TIME_AZ_EL_AZ_DEGREE_RANGE_INVALID AzEl azdebe ser mayor o igual a -180 y menor o igual a 360 grados
TIME_AZ_EL_EL_DEGREE_RANGE_INVALID AzEl eldebe ser mayor o igual a -90 grados y menor o igual a 90 grados
TIME_AZ_EL_ANGLE_UNITS_INVALID Unidades de ángulo no válidas AzEl

Motivo no válido: KMS_KEY_INVALID

Estos errores se producen cuando hay problemas con la clave de AWS Key Management Service (KMS) utilizada para cifrar los datos de efemérides.

Código de error Mensaje de error
KMS_PERMISSIONS INSUFICIENTES Ground Station no tiene permisos suficientes para acceder a la clave KMS de esta efeméride

Motivo no válido: VALIDATION_ERROR

Estos errores se producen cuando hay problemas generales de validación con los datos de efemérides que no se incluyen en las otras categorías específicas.

Código de error Mensaje de error
INTERNAL_ERROR Se produjo un error interno durante la validación de las efemérides
FILE_FORMAT_INVALID El formato del archivo de efemérides no es válido o está dañado. Compruebe que el archivo se ajusta al formato esperado para el tipo de efemérides