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 en órbita (OEM) es un formato estandarizado para representar los datos de trayectoria de las naves espaciales. La API de efemérides permite cargar efemérides OEM para usarlas con un satélite. AWS Ground Station Estas efemérides anulan las efemérides predeterminadas de Space-Track (consulte:). Datos de efemérides predeterminados

AWS Ground Station trata las efemérides como datos de uso individualizados. Si utiliza esta función opcional, AWS utilizará sus datos de efemérides para proporcionar asistencia en la resolución de problemas.

La carga de efemérides OEM personalizadas permite mejorar la calidad del seguimiento, gestionar las primeras operaciones en las que no se dispone de efemérides de Space-Track 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 al satélite, puede utilizarlas para la parte del OEM. satelliteId OBJECT_ID

Para obtener más información sobre el formato de OEMs, 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. La siguiente tabla describe los diferentes campos de un OEM y en qué AWS Ground Station se diferencian del estándar CCSDS.

Sección Campo Se requiere CCSDS AWS Ground Station obligatorio Notas
Encabezado CCSDS_OEM_VERS Sí Sí Valor requerido: 2.0
COMMENT No No
CLASIFICACIÓN No No
FECHA DE CREACIÓN Sí Sí
INICIADOR 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
SISTEMA_TIEMPO Sí Sí Valor obligatorio: UTC
HORA_INICIO Sí Sí
HORA_INICIO UTILIZABLE No No
TIEMPO_DE_PARADA UTILIZABLE 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.
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, el OEM no pasará la validación.

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

  • CCSDS_OEM_VERSse requiere que sea. 2.0

  • REF_FRAMEse requiere que sea uno EME2000 de los dos ITRF2000.

  • REF_FRAME_EPOCHno es compatible con AWS Ground Station.

  • CENTER_NAMEse requiere que lo seaEarth.

  • TIME_SYSTEMse requiere que lo seaUTC.

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

Ejemplo de efemérides OEM en formato KVN

A continuación se presenta un ejemplo truncado de una efeméride OEM en formato KVN para el 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 OEM mediante la CreateEphemerisacció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 DescribeEphemerispara hacer un seguimiento de los cambios de estado de las efemérides.

Para solucionar problemas relacionados con una efeméride no válida, consulta: 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 depósito de S3 apuntando al depósito 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"
      }
    }
  }
}