View a markdown version of this page

Fournir des données d'éphémérides OEM - AWS Ground Station
Vue d’ensembleFormat d'éphéméride OEMExemple d'éphémérides 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 des éphémérides est actuellement en état de prévisualisation

L'accès à l'API Ephemeris est fourni uniquement en fonction des besoins. Si vous souhaitez pouvoir télécharger des données d'éphémérides personnalisées, veuillez ouvrir un AWS Support ticket via le. AWS Support Center Console Notre équipe travaillera avec vous pour activer cette fonctionnalité en fonction de vos besoins spécifiques.

Vue d’ensemble

Le message d'éphémérides orbitales (OEM) 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 (voir :). Space-Track 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é optionnelle, AWS nous utiliserons vos données d'é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 Space-Track éphémérides n'est disponible et tenir compte des 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 utiliser satelliteId pour la OBJECT_ID partie OEM.

Pour plus d'informations sur le format des OEM, 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 https://ccsds.org/Pubs/502x0b3e1.pdf 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 ils AWS Ground Station diffèrent 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
CLASSEMENT Non Non
DATE_DE CRÉATION Oui Oui
INITIATEUR Oui Oui
IDENTIFIANT_MESSAGE Non Non
Métadonnées META_START Oui Oui
COMMENT Non Non
NOM_OBJET Oui Oui
ID_OBJET Oui Oui
NOM_CENTRE Oui Oui Valeur requise : Terre
CADRE DE RÉFÉRENCE Oui Oui Valeurs acceptées : EME2000, ITRF2000
REF_FRAME_EPOCH Non Non pris en charge* Inutile car les REF_Frames acceptés ont une époque implicite
SYSTÈME_HORAIRE Oui Oui Valeur requise : UTC
HEURE_DE_DÉBUT Oui Oui
HEURE_DE_DÉBUT UTILISABLE Non Non
HORAIRE_D'ARRÊT UTILISABLE Non Non
HORAIRE_D'ARRÊT 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. Le degré spécifié sera utilisé si possible, mais un degré inférieur sera utilisé s'il n'y a pas suffisamment de données dans le segment.
MÉTA_ARRÊT Oui Oui
Données X Oui Oui Représenté dans km
O Oui Oui Représenté dans km
Z Oui Oui Représenté dans km
X_POINT Oui Oui Représenté dans km/s
POINT Y Oui Oui Représenté dans km/s
Z_POINT Oui Oui Représenté dans km/s
X_POINT Non Non Représenté dans km/s^2
Y_DPOINT Non Non Représenté dans km/s^2
Z_DPOINT Non Non Représenté dans km/s^2
Matrice de covariance COVARIANCE_DÉBUT Non Non
EPOCH Non Non
CADRE DE RÉFÉRENCE COV Non Non
ARRÊT DE COVARIANCE Non Non

* Si des lignes qui ne sont pas prises en charge par AWS Ground Station sont incluses dans l'OEM fourni, la validation de l'OEM échouera.

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

  • CCSDS_OEM_VERSdoit 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_NAMEdoit l'êtreEarth.

  • TIME_SYSTEMdoit l'êtreUTC.

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

  • AWS Ground Station s'écarte du CCSDS 5.2.4.7 en autorisant les blocs de données OEM qui ne contiennent pas suffisamment d'enregistrements de données d'éphémérides à effectuer une interpolation à la valeur spécifiée. INTERPOLATION_DEGREE Dans ce cas, AWS Ground Station utilisera le degré d'interpolation le plus élevé possible, inférieur ou égal au niveau spécifié. INTERPOLATION_DEGREE

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

Voici un exemple tronqué d'éphéméride OEM au format KVN pour le satellite de radiodiffusion 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 des données contenues dans le corps de la requête 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 vos éphémérides. Ce n'est qu'une fois qu'une éphéméride aura dépassé ce flux de travail et ENABLED sera devenue qu'elle sera utilisée pour les contacts. Vous devez effectuer un sondage DescribeEphemeris pour connaître l'état des éphémérides ou utiliser des CloudWatch événements pour suivre les changements de statut des éphémérides.

Pour résoudre les problèmes liés à 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érides OEM directement depuis un compartiment S3 en pointant sur le compartiment et la clé de l'objet. AWS Ground Station récupérera l'objet en votre nom. Les informations sur le cryptage des données AWS Ground Station stockées 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 chargées dans le bloc précédent d'exemple de code. 

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