Fournir des données d'éphémérides OEM - AWS Ground Station
AperçuFormat d'éphéméride OEMExemple d'éphéméride OEM au format KVNCréation d'une éphéméride OEMExemple : téléchargement de données d'éphémérides OEM depuis un compartiment S3

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.

Fournir des données d'éphémérides OEM

Important

L'API ephemeris est actuellement en version préliminaire

L'accès à l'API Ephemeris n'est fourni qu'en cas de besoin.

Aperçu

Le message OEM (Orbit Ephemeris Message) est un format normalisé pour représenter les données de trajectoire des engins spatiaux. L'API Ephemeris permet de télécharger des éphémérides OEM pour les utiliser avec un satellite AWS Ground Station . Ces éphémérides remplacent les éphémérides par défaut de Space-Track (voir :). Données d'éphémérides par défaut

AWS Ground Station traite les éphémérides comme des données d'utilisation individualisées. Si vous utilisez cette fonctionnalité facultative, AWS nous utiliserons les données de vos éphémérides pour fournir une assistance en matière de dépannage.

Le téléchargement d'éphémérides OEM personnalisées peut améliorer la qualité du suivi, gérer les premières opérations lorsqu'aucune éphéméride Space-Track n'est disponible et prendre en compte les manœuvres. AWS Ground Station

Note

Lorsque vous fournissez des éphémérides personnalisées avant qu'un numéro de catalogue satellite ne soit attribué à votre satellite, vous pouvez l'utiliser satelliteId pour la OBJECT_ID partie de l'OEM.

Pour plus d'informations sur le format de OEMs, consultezFormat d'éphéméride OEM.

Format d'éphéméride OEM

AWS Ground Station traite les éphémérides fournies par le client OEM conformément à la norme CCSDS avec quelques restrictions supplémentaires. Les fichiers OEM doivent être au format KVN. Le tableau suivant décrit les différents champs d'un OEM et explique en quoi il AWS Ground Station diffère de la norme CCSDS.

Section Champ CCSDS requis AWS Ground Station requis Remarques
En-tête CCSDS_OEM_VERS Oui Oui Valeur requise : 2,0
COMMENT Non Non
CLASSIFICATION Non Non
DATE DE CRÉATION Oui Oui
AUTEUR Oui Oui
IDENTIFIANT DU MESSAGE Non Non
Métadonnées META_START Oui Oui
COMMENT Non Non
NOM_OBJET Oui Oui
IDENTIFIANT_OBJET Oui Oui
NOM_CENTRE Oui Oui Valeur requise : Terre
REF_FRAME Oui Oui Valeurs acceptées : EME2 000 ITRF2 000
REF_FRAME_EPOCH Non Non pris en charge* Pas nécessaire car les REF_ acceptés FRAMEs ont une époque implicite
TIME_SYSTEM Oui Oui Valeur requise : UTC
HEURE DE DÉBUT Oui Oui
HEURE_DE_DÉBUT UTILISABLE Non Non
TIME_STOP_UTILE Non Non
STOP_TIME Oui Oui
INTERPOLATION Non Oui Nécessaire pour AWS Ground Station générer des angles de pointage précis pour les contacts.
DEGRÉ_D'INTERPOLATION Non Oui Nécessaire pour AWS Ground Station générer des angles de pointage précis pour les contacts.
META_STOP Oui Oui
Données X Oui Oui Représenté dans km
Y Oui Oui Représenté dans km
Z Oui Oui Représenté dans km
X_POINT Oui Oui Représenté dans km/s
Y_POINT Oui Oui Représenté dans km/s
Z_POINT Oui Oui Représenté dans km/s
X_DOT Non Non Représenté dans km/s^2
Y_DDOT Non Non Représenté dans km/s^2
Z_DDOT Non Non Représenté dans km/s^2
Matrice de covariance COVARIANCE_START Non Non
EPOCH Non Non
COV_REF_FRAME Non Non
COVARIANCE_STOP Non Non

* Si des lignes non prises en charge par AWS Ground Station sont incluses dans l'OEM fourni, celui-ci échouera à la validation.

Les écarts importants par rapport à la norme CCSDS sont les AWS Ground Station suivants :

  • CCSDS_OEM_VERSest tenu de l'être2.0.

  • REF_FRAMEdoit être l'un EME2000 ou l'autre ITRF2000.

  • REF_FRAME_EPOCHn'est pas pris en charge par AWS Ground Station.

  • CENTER_NAMEest tenu de l'êtreEarth.

  • TIME_SYSTEMest tenu de l'êtreUTC.

  • INTERPOLATIONet INTERPOLATION_DEGREE sont tous deux requis pour les AWS Ground Station éphémérides fournies par le client.

Exemple d'éphéméride OEM au format KVN

Voici un exemple tronqué d'éphéméride OEM au format KVN pour le satellite de diffusion public 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

Création d'une éphéméride OEM

Une éphéméride OEM peut être créée à l'aide de l'CreateEphemerisaction de l' AWS Ground Station API. Cette action téléchargera une éphéméride en utilisant les données contenues dans le corps de la demande ou provenant d'un compartiment S3 spécifié.

Il est important de noter que le téléchargement d'une éphéméride définit l'éphéméride et lance un flux de travail asynchrone qui validera VALIDATING et générera des contacts potentiels à partir de votre éphéméride. Ce n'est qu'une fois qu'une éphéméride aura passé ce flux de travail et ENABLED sera devenue qu'elle sera utilisée pour les contacts. Vous devez effectuer un sondage DescribeEphemerispour connaître le statut des éphémérides ou utiliser des CloudWatch événements pour suivre les changements de statut des éphémérides.

Pour résoudre le problème d'une éphéméride non valide, consultez : Résoudre les problèmes liés aux éphémérides non valides

Exemple : téléchargement de données d'éphémérides OEM depuis un compartiment S3

Il est également possible de télécharger un fichier d'éphéméride OEM directement depuis un compartiment S3 en pointant sur le compartiment et la clé d'objet. AWS Ground Station récupérera l'objet en votre nom. Les informations sur le cryptage des données au repos AWS Ground Station sont détaillées dans :Chiffrement des données au repos pour AWS Ground Station.

Vous trouverez ci-dessous un exemple de téléchargement d'un fichier d'éphémérides OEM à partir d'un compartiment 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']}")

Vous trouverez ci-dessous un exemple de données renvoyées par l'DescribeEphemerisaction appelée pour les éphémérides OEM téléchargées dans le bloc d'exemple de code précédent. 

{
  "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"
      }
    }
  }
}