View a markdown version of this page

Proporcione datos de efemérides OEM - AWS Ground Station
Descripción general deFormato de efemérides OEMEjemplo de efemérides OEM en formato KVNCreación de una efeméride OEMEjemplo: cargar datos de efemérides OEM desde un bucket de S3

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.

Proporcione datos de efemérides OEM

importante

La API de efemérides se encuentra actualmente en estado de previsualización.

El acceso a la API de Efemérides solo se proporciona en función de las necesidades. Si necesita poder cargar datos de efemérides personalizados, abra un AWS Support ticket a través del. AWS Support Center Console Nuestro equipo trabajará con usted para habilitar esta capacidad para sus requisitos específicos.

Descripción general de

El mensaje de efemérides orbitales (OEM) es un formato estandarizado para representar los datos de trayectoria de las naves espaciales. La API Ephemeris permite cargar las efemérides de los OEM para usarlas con un satélite. AWS Ground Station Estas efemérides anulan las efemérides predeterminadas de (consulte:). Space-Track Datos de efemérides predeterminados

AWS Ground Station trata las efemérides como datos de uso individualizados. https://aws.amazon.com/service-terms Si usa esta función opcional, AWS utilizará sus datos de efemérides para brindar asistencia para la solución de problemas.

Subir efemérides OEM personalizadas puede mejorar la calidad del seguimiento, gestionar las operaciones iniciales cuando no haya Space-Track efemérides disponibles y tener en cuenta las maniobras. AWS Ground Station

nota

Al proporcionar efemérides personalizadas antes de asignar un número de catálogo de satélites a su satélite, puede utilizarlas para la parte del OEM. satelliteId OBJECT_ID

Para obtener más información sobre el formato de los OEM, consulte. Formato de efemérides OEM

Formato de efemérides OEM

AWS Ground Station procesa las efemérides OEM proporcionadas por el cliente de acuerdo con el estándar CCSDS con algunas restricciones adicionales. Los archivos OEM deben estar en formato KVN. En la siguiente tabla se describen los distintos campos de un OEM y en qué AWS Ground Station se diferencian del estándar CCSDS.

Sección Campo Se requiere el CCSDS AWS Ground Station obligatorio Notas
Encabezado CCSDS_OEM_VERS Sí Sí Valor requerido: 2.0
COMMENT No No
CLASIFICACIÓN No No
CREATION_DATE Sí Sí
ORIGINADOR Sí Sí
MESSAGE_ID No No
Metadatos META_START Sí Sí
COMMENT No No
NOMBRE_OBJETO Sí Sí
OBJECT_ID Sí Sí
NOMBRE_CENTRO Sí Sí Valor obligatorio: Tierra
REF_FRAME Sí Sí Valores aceptados: EME2000, ITRF2000
REF_FRAME_EPOCH No No compatible* No es necesario porque los REF_FRAMES aceptados tienen una época implícita
TIME_SYSTEM Sí Sí Valor obligatorio: UTC
HORA DE INICIO Sí Sí
HORA_DE_INICIO UTILIZABLE No No
USEABLE_STOP_TIME No No
STOP_TIME Sí Sí
INTERPOLACIÓN No Sí Necesario para AWS Ground Station poder generar ángulos de puntería precisos para los contactos.
GRADO DE INTERPOLACIÓN No Sí Necesario para AWS Ground Station poder generar ángulos de puntería precisos para los contactos. Si es posible, se utilizará el grado especificado, pero se utilizará un grado inferior si no hay suficientes datos en el segmento.
META_STOP Sí Sí
Datos X Sí Sí Representado en km
Y Sí Sí Representado en km
Z Sí Sí Representado en km
X_DOT Sí Sí Representado en km/s
Y_DOT Sí Sí Representado en km/s
Z_DOT Sí Sí Representado en km/s
X_DDOT No No Representado en km/s^2
Y_DDOT No No Representado en km/s^2
Z_DDOT No No Representado en km/s^2
Matriz de covarianzas COVARIANCE_START No No
EPOCH No No
COV_REF_FRAME No No
COVARIANCE_STOP No No

* Si en el OEM proporcionado AWS Ground Station se incluye alguna fila que no sea compatible con, el OEM no superará la validación.

Las principales desviaciones con respecto al estándar CCSDS son las siguientes: AWS Ground Station

  • CCSDS_OEM_VERSse requiere que sea. 2.0

  • REF_FRAMEse requiere que sea EME2000 o ITRF2000.

  • REF_FRAME_EPOCHno es compatible con AWS Ground Station.

  • CENTER_NAMEes obligatorio que seaEarth.

  • TIME_SYSTEMse requiere que seaUTC.

  • INTERPOLATIONy ambos INTERPOLATION_DEGREE son obligatorios para las efemérides proporcionadas por el AWS Ground Station cliente.

  • AWS Ground Station se desvía de la versión 5.2.4.7 del CCSDS al permitir que los bloques de datos OEM que no contienen suficientes registros de datos de efemérides realicen la interpolación según lo especificado. INTERPOLATION_DEGREE En este caso, AWS Ground Station utilizará el grado de interpolación más alto posible, que sea inferior o igual al especificado. INTERPOLATION_DEGREE

Ejemplo de efemérides OEM en formato KVN

El siguiente es un ejemplo truncado de una efeméride OEM en formato KVN para un satélite de radiodifusión pública. JPSS-1 

CCSDS_OEM_VERS = 2.0

COMMENT Orbit data are consistent with planetary ephemeris DE-430

CREATION_DATE  = 2024-07-22T05:20:59
ORIGINATOR     = Raytheon-JPSS/CGS

META_START
OBJECT_NAME          = J1
OBJECT_ID            = 2017-073A
CENTER_NAME          = Earth
REF_FRAME            = EME2000
TIME_SYSTEM          = UTC
START_TIME           = 2024-07-22T00:00:00.000000
STOP_TIME            = 2024-07-22T00:06:00.000000
INTERPOLATION        = Lagrange
INTERPOLATION_DEGREE = 5
META_STOP

2024-07-22T00:00:00.000000   5.905147360000000e+02  -1.860082793999999e+03  -6.944807075000000e+03  -5.784245796000000e+00   4.347501391999999e+00  -1.657256863000000e+00
2024-07-22T00:01:00.000000   2.425572045154201e+02  -1.595860765983339e+03  -7.030938457373539e+03  -5.810660250794190e+00   4.457103652219009e+00  -1.212889340333023e+00
2024-07-22T00:02:00.000000  -1.063224256538050e+02  -1.325569732497146e+03  -7.090262617183503e+03  -5.814973972202444e+00   4.549739160042560e+00  -7.639633689161465e-01
2024-07-22T00:03:00.000000  -4.547973959231161e+02  -1.050238305712201e+03  -7.122556683227951e+03  -5.797176562437553e+00   4.625064829516728e+00  -3.121687831090774e-01
2024-07-22T00:04:00.000000  -8.015427368657785e+02  -7.709137891269565e+02  -7.127699477194810e+03  -5.757338007808417e+00   4.682800822515077e+00   1.407953645161997e-01
2024-07-22T00:05:00.000000  -1.145240083085062e+03  -4.886583601179489e+02  -7.105671911254255e+03  -5.695608435738609e+00   4.722731329786999e+00   5.932259682105052e-01
2024-07-22T00:06:00.000000  -1.484582479061495e+03  -2.045451985605701e+02  -7.056557069672793e+03  -5.612218005854990e+00   4.744705579872771e+00   1.043421397392599e+00

Creación de una efeméride OEM

Se puede crear una efeméride de OEM mediante la CreateEphemeris acción de la API. AWS Ground Station Esta acción cargará una efeméride utilizando los datos del cuerpo de la solicitud o de un bucket de S3 específico.

Es importante tener en cuenta que al cargar una efeméride ésta se establece en VALIDATING e inicia un flujo de trabajo asíncrono que validará y generará contactos potenciales a partir de la efeméride. Solo se podrá utilizar para contactos cuando la efeméride haya superado este flujo de trabajo y esté ENABLED. Deberías sondear el estado de las efemérides o usar CloudWatch eventos DescribeEphemeris para realizar un seguimiento de los cambios de estado de las efemérides.

Para solucionar problemas relacionados con una efeméride no válida, consulte: Solucionar problemas de efemérides no válidas

Ejemplo: cargar datos de efemérides OEM desde un bucket de S3

También es posible cargar un archivo de efemérides OEM directamente desde un bucket de S3 apuntando al bucket y a la clave del objeto. AWS Ground Station recuperará el objeto en tu nombre. La información sobre el cifrado de los datos en reposo AWS Ground Station se detalla en:Cifrado de datos en reposo para AWS Ground Station.

A continuación se muestra un ejemplo de cómo cargar un archivo de efemérides OEM desde un bucket de S3 

import boto3
from datetime import datetime, timedelta, timezone

# Create AWS clients
s3_client = boto3.client("s3")
ground_station_client = boto3.client("groundstation")

# Define S3 bucket and key
bucket_name = "ephemeris-bucket"
object_key = "test_data.oem"

# Create sample OEM data in KVN format
oem_data = """CCSDS_OEM_VERS = 2.0

COMMENT Orbit data are consistent with planetary ephemeris DE-430

CREATION_DATE  = 2024-07-22T05:20:59
ORIGINATOR     = Raytheon-JPSS/CGS

META_START
OBJECT_NAME          = J1
OBJECT_ID            = 2017-073A
CENTER_NAME          = Earth
REF_FRAME            = EME2000
TIME_SYSTEM          = UTC
START_TIME           = 2024-07-22T00:00:00.000000
STOP_TIME            = 2024-07-22T00:06:00.000000
INTERPOLATION        = Lagrange
INTERPOLATION_DEGREE = 5
META_STOP

2024-07-22T00:00:00.000000   5.905147360000000e+02  -1.860082793999999e+03  -6.944807075000000e+03  -5.784245796000000e+00   4.347501391999999e+00  -1.657256863000000e+00
2024-07-22T00:01:00.000000   2.425572045154201e+02  -1.595860765983339e+03  -7.030938457373539e+03  -5.810660250794190e+00   4.457103652219009e+00  -1.212889340333023e+00
2024-07-22T00:02:00.000000  -1.063224256538050e+02  -1.325569732497146e+03  -7.090262617183503e+03  -5.814973972202444e+00   4.549739160042560e+00  -7.639633689161465e-01
2024-07-22T00:03:00.000000  -4.547973959231161e+02  -1.050238305712201e+03  -7.122556683227951e+03  -5.797176562437553e+00   4.625064829516728e+00  -3.121687831090774e-01
2024-07-22T00:04:00.000000  -8.015427368657785e+02  -7.709137891269565e+02  -7.127699477194810e+03  -5.757338007808417e+00   4.682800822515077e+00   1.407953645161997e-01
2024-07-22T00:05:00.000000  -1.145240083085062e+03  -4.886583601179489e+02  -7.105671911254255e+03  -5.695608435738609e+00   4.722731329786999e+00   5.932259682105052e-01
2024-07-22T00:06:00.000000  -1.484582479061495e+03  -2.045451985605701e+02  -7.056557069672793e+03  -5.612218005854990e+00   4.744705579872771e+00   1.043421397392599e+00
"""

# Upload sample OEM data to S3
print(f"Uploading OEM data to s3://{bucket_name}/{object_key}")

s3_client.put_object(
    Bucket=bucket_name, Key=object_key, Body=oem_data, ContentType="text/plain"
)

print("OEM data uploaded successfully to S3")

# Create OEM ephemeris from S3
print("Creating OEM ephemeris from S3...")

s3_oem_ephemeris = ground_station_client.create_ephemeris(
    name="2024-07-22 S3 OEM Upload",
    satelliteId="fde41049-14f7-413e-bd7b-EXAMPLE01",
    enabled=True,
    expirationTime=datetime.now(timezone.utc) + timedelta(days=5),
    priority=2,
    ephemeris={"oem": {"s3Object": {"bucket": bucket_name, "key": object_key}}},
)

print(f"Created OEM ephemeris with ID: {s3_oem_ephemeris['ephemerisId']}")

A continuación se muestra un ejemplo de los datos devueltos por la acción DescribeEphemeris a la que se llama para las efemérides OEM cargadas en el bloque anterior de código de ejemplo. 

{
  "creationTime": 1620254718.765,
  "enabled": true,
  "name": "Example Ephemeris",
  "ephemerisId": "fde41049-14f7-413e-bd7b-EXAMPLE02",
  "priority": 2,
  "status": "VALIDATING",
  "suppliedData": {
    "oem": {
      "sourceS3Object": {
          "bucket": "ephemeris-bucket-for-testing",
          "key": "test_data.oem"
      }
    }
  }
}