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 nach Bedarf gewährt. Wenn Sie die Möglichkeit benötigen, benutzerdefinierte Ephemeridendaten hochzuladen, öffnen Sie bitte ein Ticket über die. 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 (siehe:). [ Space-Track ](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](https://aws.amazon.com/service-terms) Wenn Sie diese optionale Funktion verwenden, verwenden AWS wir Ihre Ephemeridendaten, um Unterstützung bei der Fehlerbehebung bereitzustellen. Durch das Hochladen benutzerdefinierter OEM-Ephemeriden kann die Qualität der Ortung verbessert, frühe Operationen, für die keine [ Space-Track ](https://www.space-track.org/) Ephemeriden 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 OEM-Teil verwenden. `satelliteId` `OBJECT_ID` Weitere Informationen zum Format von OEMs finden Sie unter. [OEM-Ephemeriden-Format](#oem-ephemeris-format) ## OEM-Ephemeriden-Format AWS Ground Station verarbeitet vom OEM vom Kunden bereitgestellte Ephemeriden gemäß dem [ CCSDS-Standard mit einigen zusätzlichen Einschränkungen. ](https://ccsds.org/Pubs/502x0b3e1.pdf) OEM-Dateien sollten im KVN-Format vorliegen. In der folgenden Tabelle werden die verschiedenen Felder in einem OEM beschrieben und die AWS Ground Station Unterschiede zum CCSDS-Standard erläutert. - **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:** ZENTRUM\_NAME / **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:** NUTZBARE\_STARTZEIT / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** - **Feld:** NUTZBARE\_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, um genaue Ausrichtungswinkel für Kontakte generieren zu AWS Ground Station können. - **Feld:** GRAD DER INTERPOLATION / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Ja / **Hinweise:** Erforderlich, damit genaue Ausrichtungswinkel 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:** KOVARIANZ\_STOPP / **CCSDS erforderlich:** Nein / **AWS Ground Station erforderlich:** Nein / **Hinweise:** \* Wenn Zeilen, die von nicht unterstützt werden, im angegebenen OEM enthalten AWS Ground Station sind, schlägt der OEM bei der Validierung fehl. Die wichtigsten Abweichungen vom CCSDS-Standard für AWS Ground Station sind: + `CCSDS_OEM_VERS`muss es 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 ab, indem OEM-Datenblöcke zugelassen werden, die nicht genügend Ephemeridendatensätze enthalten, um die Interpolation mit den angegebenen Werten durchzuführen. `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 öffentlich-rechtlichen 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 Diese Aktion lädt eine Ephemeride mithilfe von Daten entweder im Anforderungstext oder aus einem angegebenen S3-Bucket hoch. Es ist wichtig zu beachten, dass beim Hochladen einer Ephemeride die Ephemeride auf einen asynchronen Workflow gesetzt ` VALIDATING` und gestartet wird, der potenzielle Kontakte aus Ihrer Ephemeride validiert und generiert. Erst wenn eine Ephemeride diesen Workflow bestanden hat und zu ihr geworden ist, wird sie für Kontakte verwendet. `ENABLED` Sie sollten den Status der Ephemeride [ DescribeEphemeris ](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) abfragen oder CloudWatch Ereignisse verwenden, um die Statusänderungen der Ephemeride zu verfolgen. Informationen zur Behebung 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-Ephemeridendatei 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 von Daten im AWS Ground Station Ruhezustand finden Sie unter:[Datenverschlüsselung im Ruhezustand für AWS Ground Station](security.encryption-at-rest.md). Unten 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']}") ``` Unten 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" } } } } ```