Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Stellen Sie OEM-Ephemeridendaten bereit **Wichtig** Die Ephemeriden-API befindet sich derzeit im Vorschaustatus Der Zugriff auf die Ephemeris-API wird nur bei Bedarf gewährt. Wenn Sie die Möglichkeit benötigen, benutzerdefinierte Ephemeridendaten hochzuladen, öffnen Sie bitte ein Ticket über. AWS Support [AWS Support Center Console](https://console.aws.amazon.com/support) Unser Team wird mit Ihnen zusammenarbeiten, um diese Funktion für Ihre spezifischen Anforderungen zu aktivieren. ## -Übersicht Orbit Ephemeris Message (OEM) ist ein standardisiertes Format zur Darstellung von Flugbahndaten von Raumfahrzeugen. Die Ephemeris-API ermöglicht das Hochladen von OEM-Ephemeriden zur Verwendung mit einem Satelliten. AWS Ground Station [Diese Ephemeriden überschreiben die Standard-Ephemeriden von Space-Track (siehe:).](https://www.space-track.org/) [Standard-Ephemeridendaten](default-ephemeris-data.md) AWS Ground Station [behandelt Ephemeriden als individualisierte Nutzungsdaten.](https://aws.amazon.com/service-terms) Wenn Sie diese optionale Funktion verwenden, AWS werden Ihre Ephemeridendaten verwendet, um Unterstützung bei der Fehlerbehebung zu bieten. Durch das Hochladen benutzerdefinierter OEM-Ephemeriden kann die Qualität der Ortung verbessert, frühe Einsätze, für die keine [Space-Track-Ephemeriden](https://www.space-track.org/) verfügbar sind, durchgeführt und Manöver berücksichtigt werden. AWS Ground Station **Anmerkung** Wenn Sie benutzerdefinierte Ephemeriden bereitstellen, bevor Ihrem Satelliten eine Satellitenkatalognummer zugewiesen wird, können Sie diese für den Teil des OEM verwenden. `satelliteId` `OBJECT_ID` Weitere Informationen zum Format von OEMs finden Sie unter. [OEM-Format für Ephemeriden](#oem-ephemeris-format) ## OEM-Format für Ephemeriden AWS Ground Station verarbeitet vom OEM-Kunden bereitgestellte Ephemeriden gemäß dem [CCSDS-Standard](https://ccsds.org/Pubs/502x0b3e1.pdf) mit einigen zusätzlichen Einschränkungen. OEM-Dateien sollten im KVN-Format vorliegen. In der folgenden Tabelle werden die verschiedenen Felder in einem OEM und die AWS Ground Station Unterschiede zum CCSDS-Standard beschrieben. - **Header** - **Feld:** CCSDS\_OEM\_VERS / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** Erforderlicher Wert: 2,0 - **Feld:** COMMENT / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** - **Feld:** EINSTUFUNG / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** - **Feld:** ERSTELLUNGSDATUM / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** - **Feld:** URHEBER / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** - **Feld:** NACHRICHTEN-ID / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** - **Metadaten** - **Feld:** META\_START / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** - **Feld:** COMMENT / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** - **Feld:** OBJEKTNAME / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** - **Feld:** OBJEKT-ID / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** - **Feld:** NAME DES ZENTRUMS / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** Erforderlicher Wert: Erde - **Feld:** REF\_FRAME / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** Zulässige Werte:, EME2000 ITRF2000 - **Feld:** REF\_FRAME\_EPOCH / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nicht unterstützt\* / **Hinweise:** Nicht erforderlich, da die akzeptierten REF\_ FRAMEs eine implizite Epoche haben - **Feld:** TIME\_SYSTEM / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** Erforderlicher Wert: UTC - **Feld:** START\_TIME / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** - **Feld:** VERWENDBARE\_STARTZEIT / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** - **Feld:** VERWENDBARE\_STOPPZEIT / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** - **Feld:** STOPPZEIT / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** - **Feld:** INTERPOLATION / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Ja / **Hinweise:** Erforderlich, AWS Ground Station damit genaue Zeigewinkel für Kontakte generiert werden können. - **Feld:** INTERPOLATION\_DEGREE / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Ja / **Hinweise:** Erforderlich, damit genaue Zeigewinkel für Kontakte generiert werden AWS Ground Station können. Wenn möglich, wird der angegebene Grad verwendet, aber ein niedrigerer Grad wird verwendet, wenn das Segment nicht genügend Daten enthält. - **Feld:** META\_STOP / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** - **Daten** - **Feld:** X / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** Vertreten in km - **Feld:** Y / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** Vertreten in km - **Feld:** Z / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** Vertreten in km - **Feld:** X\_DOT / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** Vertreten in km/s - **Feld:** Y\_DOT / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** Vertreten in km/s - **Feld:** Z\_DOT / **CCSDS erforderlich:** Ja / **AWS Ground Station erforderlich:** Ja / **Hinweise:** Vertreten in km/s - **Feld:** X\_DDOT / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** Vertreten in km/s^2 - **Feld:** Y\_DDOT / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** Vertreten in km/s^2 - **Feld:** Z\_DDOT / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** Vertreten in km/s^2 - **Kovarianzmatrix** - **Feld:** KOVARIANZ\_START / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** - **Feld:** EPOCHE / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** - **Feld:** COV\_REF\_FRAME / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** - **Feld:** KOVARIANZSTOPP / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** \* Wenn Zeilen, die von nicht unterstützt werden, im bereitgestellten OEM enthalten AWS Ground Station sind, schlägt der OEM die Validierung fehl. Die wichtigsten Abweichungen vom CCSDS-Standard für AWS Ground Station sind: + `CCSDS_OEM_VERS`muss sein. `2.0` + `REF_FRAME`muss entweder `EME2000` oder sein` ITRF2000`. + `REF_FRAME_EPOCH`wird nicht unterstützt von AWS Ground Station. + `CENTER_NAME`muss sein`Earth`. + `TIME_SYSTEM`muss sein`UTC`. + `INTERPOLATION`und `INTERPOLATION_DEGREE` sind beide für vom AWS Ground Station Kunden bereitgestellte Ephemeriden erforderlich. + AWS Ground Station weicht von CCSDS 5.2.4.7 dadurch ab, dass OEM-Datenblöcke, die nicht genügend Ephemeridendatensätze enthalten, die Interpolation an der spezifizierten Stelle durchführen können. `INTERPOLATION_DEGREE` In diesem Fall AWS Ground Station wird der höchstmögliche Interpolationsgrad verwendet, der kleiner oder gleich dem angegebenen Wert ist. `INTERPOLATION_DEGREE` ## Beispiel für eine OEM-Ephemeride im KVN-Format Im Folgenden finden Sie ein gekürztes Beispiel für eine OEM-Ephemeride im KVN-Format für den öffentlichen Rundfunksatelliten 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 ``` ## Erstellen einer OEM-Ephemeride Eine OEM-Ephemeride kann mithilfe der [CreateEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html)Aktion in der API erstellt werden. AWS Ground Station Bei dieser Aktion wird eine Ephemeride mithilfe von Daten hochgeladen, die entweder im Anfragetext oder aus einem bestimmten S3-Bucket enthalten sind. Es ist wichtig zu beachten, dass durch das Hochladen einer Ephemeride die Ephemeride in einen asynchronen Workflow umgewandelt ` VALIDATING` und gestartet wird, der potenzielle Kontakte anhand Ihrer Ephemeride validiert und generiert. Erst wenn eine Ephemeride diesen Workflow bestanden hat und geworden ist, wird sie für Kontakte verwendet. `ENABLED` Sie sollten den Ephemeridenstatus [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)abfragen oder CloudWatch Ereignisse verwenden, um die Statusänderungen der Ephemeriden nachzuverfolgen. Informationen zur Fehlerbehebung bei einer ungültigen Ephemeride finden Sie unter: [Fehlerbehebung bei ungültigen Ephemeriden](troubleshooting-invalid-ephemerides.md) ## Beispiel: OEM-Ephemeridendaten aus einem S3-Bucket hochladen Es ist auch möglich, eine OEM-Ephemeriden-Datei direkt aus einem S3-Bucket hochzuladen, indem Sie auf den Bucket und den Objektschlüssel zeigen. AWS Ground Station ruft das Objekt in Ihrem Namen ab. Informationen zur Verschlüsselung ruhender Daten in AWS Ground Station finden Sie in:[Datenverschlüsselung im Ruhezustand für AWS Ground Station](security.encryption-at-rest.md). Im Folgenden finden Sie ein Beispiel für das Hochladen einer OEM-Ephemeridendatei aus einem S3-Bucket ``` 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']}") ``` Im Folgenden finden Sie ein Beispiel für zurückgegebene Daten aus der [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)Aktion, die für die OEM-Ephemeride aufgerufen wurde, die im vorherigen Beispielcodeblock hochgeladen wurde. ``` { "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" } } } } ```