Stellen Sie benutzerdefinierte Ephemeridendaten bereit - AWS Ground Station
ÜbersichtOEMEphemeridenformatBeispiel für eine OEM Ephemeride im Format KVNEine benutzerdefinierte Ephemeride erstellenBeispiel: Erstellen Sie ein zweizeiliges Element (TLE) und setzen Sie Ephemeriden über APIBeispiel: Hochladen von Ephemeridendaten aus einem S3-BucketBeispiel: Verwendung von vom Kunden bereitgestellten Ephemeriden mit AWS Ground Station

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 benutzerdefinierte Ephemeridendaten bereit

Wichtig

Die Ephemeride API befindet sich derzeit im Vorschaustatus

Der Zugriff auf die Ephemeride API wird nur bei Bedarf gewährt. AWS Ground Station behandelt Ephemeriden als individualisierte Nutzungsdaten. Wenn Sie diese optionale Funktion verwenden, AWS werden Ihre Ephemeridendaten verwendet, um Unterstützung bei der Fehlerbehebung zu bieten.

Übersicht

Mit der Ephemeride API können benutzerdefinierte Ephemeriden zur Verwendung mit einem Satelliten hochgeladen werden. AWS Ground Station Diese Ephemeriden überschreiben die Standard-Ephemeriden von Space-Track (siehe:). Standard-Ephemeridendaten Wir unterstützen den Empfang von Ephemeridendaten in den Formaten Orbit Ephemeris Message () und zweizeiliges Element (). OEM TLE

Das Hochladen benutzerdefinierter Ephemeriden kann die Qualität der Ortung verbessern, frühe Operationen abwickeln, für die keine Space-Track-Ephemeriden verfügbar sind, und Manöver berücksichtigen. AWS Ground Station

Anmerkung

Wenn Sie benutzerdefinierte Ephemeriden angeben, bevor Ihrem Satelliten eine Satellitenkatalognummer zugewiesen wird, können Sie 00000 für das Satellitenkatalognummernfeld der TLE und 000 für die Startnummer des internationalen Kennzeichnungsfeldes der TLE OEM OR-Metadaten verwenden (z. B. 24000A für ein Fahrzeug, das 2024 gestartet wurde).

Weitere Informationen zum Format von finden Sie unter Zweizeiliger Elementsatz. TLEs Weitere Informationen zum Format von finden Sie OEMs unterOEMEphemeridenformat.

OEMEphemeridenformat

AWS Ground Station verarbeitet vom OEM Kunden bereitgestellte Ephemeriden gemäß dem CCSDSStandard mit einigen zusätzlichen Einschränkungen. OEMDateien sollten im Format sein. KVN In der folgenden Tabelle werden die verschiedenen Felder in einem beschrieben OEM und wie sie AWS Ground Station sich vom CCSDS Standard unterscheiden.

Abschnitt Feld CCSDSerforderlich AWS Ground Station erforderlich Hinweise
Header CCSDS_OEM_VERS Ja Ja Erforderlicher Wert: 2,0
COMMENT Nein Nein
CLASSIFICATION Nein Nein
CREATION_DATE Ja Ja
ORIGINATOR Ja Ja
MESSAGE_ID Nein Nein
Metadaten META_START Ja Ja
COMMENT Nein Nein
OBJECT_NAME Ja Ja
OBJECT_ID Ja Ja
CENTER_NAME Ja Ja Erforderlicher Wert: Erde
REF_FRAME Ja Ja Zulässige Werte: EME2 000, ITRF2 000
REF_FRAME_EPOCH Nein Nicht unterstützt* Wird nicht benötigt, da die akzeptierten REF _ FRAMEs eine implizite Epoche haben
TIME_SYSTEM Ja Ja Erforderlicher Wert: UTC
START_TIME Ja Ja
USEABLE_START_TIME Nein Nein
USEABLE_STOP_TIME Nein Nein
STOP_TIME Ja Ja
INTERPOLATION Nein Ja Erforderlich, AWS Ground Station damit genaue Zeigewinkel für Kontakte generiert werden können.
INTERPOLATION_DEGREES Nein Ja Erforderlich, AWS Ground Station damit genaue Zeigewinkel für Kontakte generiert werden können.
META_STOP Ja Ja
Daten X Ja Ja Vertreten in km
Y Ja Ja Vertreten in km
Z Ja Ja Vertreten in km
X_ DOT Ja Ja Vertreten in km/s
Y_ DOT Ja Ja Vertreten in km/s
Z_ DOT Ja Ja Vertreten in km/s
X_ DDOT Nein Nein Vertreten in km/s^2
Y_ DDOT Nein Nein Vertreten in km/s^2
Z_ DDOT Nein Nein Vertreten in km/s^2
Kovarianzmatrix COVARIANCE_START Nein Nein
EPOCH Nein Nein
COV_REF_FRAME Nein Nein
COVARIANCE_STOP Nein Nein

* Wenn Zeilen, die von nicht unterstützt werden, in der bereitgestellten Datei enthalten AWS Ground Station sindOEM, schlägt die Überprüfung OEM fehl.

Die wichtigsten Abweichungen vom CCSDS Standard für AWS Ground Station sind:

  • CCSDSOEM_ _ VERS muss sein2.0.

  • REF_ FRAME muss entweder EME2000 oder seinITRF2000.

  • REF_ FRAME _ EPOCH wird nicht unterstützt von AWS Ground Station.

  • CENTER_ NAME muss seinEarth.

  • TIME_ SYSTEM muss seinUTC.

  • INTERPOLATIONund INTERPOLATION _ DEGREES sind beide erforderlich für AWS Ground Station CPE.

Beispiel für eine OEM Ephemeride im Format KVN

Im Folgenden finden Sie ein gekürztes Beispiel für eine OEM Ephemeride im KVN Format für den JPSS öffentlichen Rundfunksatelliten -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

Eine benutzerdefinierte Ephemeride erstellen

Eine benutzerdefinierte Ephemeride kann mit der Aktion in der CreateEphemeriserstellt werden. AWS Ground Station API Diese Aktion lädt eine Ephemeride hoch, wobei Daten entweder im Anforderungstext oder aus einem angegebenen S3-Bucket verwendet werden.

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 Status der Ephemeriden DescribeEphemerisabfragen 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

Beispiel: Erstellen Sie ein zweizeiliges Element (TLE) und setzen Sie Ephemeriden über API

Das AWS SDKs, und CLI kann verwendet werden, um ein zweizeiliges Element (TLE), auf das Ephemeriden gesetzt wurde, über den Aufruf hochzuladen. AWS Ground Station CreateEphemeris Diese Ephemeride wird anstelle der Standard-Ephemeridendaten für einen Satelliten verwendet (siehe Standard-Ephemeridendaten). Dieses Beispiel zeigt, wie das mit AWS SDKfor Python (Boto3) gemacht wird.

Eine TLE Menge ist ein JSON formatiertes Objekt, das eines oder mehrere Objekte TLEs aneinanderreiht, um eine kontinuierliche Trajektorie zu konstruieren. Die TLEs in der TLE Menge enthaltenen Elemente müssen eine kontinuierliche Menge bilden, die wir verwenden können, um eine Trajektorie zu konstruieren (d. h. es gibt keine Zeitlücken dazwischen TLEs in einer Menge). TLE Ein TLE Beispielsatz ist unten dargestellt: 

# example_tle_set.json
[
    {
        "tleLine1": "1 25994U 99068A   20318.54719794  .00000075  00000-0  26688-4 0  9997",
        "tleLine2": "2 25994  98.2007  30.6589 0001234  89.2782  18.9934 14.57114995111906",
        "validTimeRange": {
            "startTime": 12345,
            "endTime": 12346
        }
    },
    {
        "tleLine1": "1 25994U 99068A   20318.54719794  .00000075  00000-0  26688-4 0  9997",
        "tleLine2": "2 25994  98.2007  30.6589 0001234  89.2782  18.9934 14.57114995111906",
        "validTimeRange": {
            "startTime": 12346,
            "endTime": 12347
        }
    }
]
Anmerkung

Die Zeitbereiche TLEs in einem TLE Satz müssen exakt übereinstimmen, um eine gültige, kontinuierliche Trajektorie zu erhalten.

Ein TLE Set kann wie folgt über den AWS Ground Station boto3-Client hochgeladen werden: 

tle_ephemeris_id = ground_station_boto3_client.create_ephemeris( name="Example Ephemeris", satelliteId="2e925701-9485-4644-b031-EXAMPLE01", enabled=True, expirationTime=datetime.now(timezone.utc) + timedelta(days=3), priority=2,
    ephemeris = {
      "tle": {
        "tleData": [
            {
                "tleLine1": "1 25994U 99068A   20318.54719794  .00000075  00000-0  26688-4 0  9997",
                "tleLine2": "2 25994  98.2007  30.6589 0001234  89.2782  18.9934 14.57114995111906",
                "validTimeRange": {
                    "startTime": datetime.now(timezone.utc),
                    "endTime": datetime.now(timezone.utc) + timedelta(days=7)
                }
            }
        ]
      }
    })

Dieser Aufruf wird eine zurückgeben ephemerisId , mit der in future auf die Ephemeride verwiesen werden kann. Zum Beispiel können wir die ephemerisId aus dem obigen Aufruf bereitgestellten Daten verwenden, um den Status der Ephemeriden abzufragen: 

client.describe_ephemeris(ephemerisId=tle_ephemeris_id['ephemerisId'])

Im Folgenden finden Sie ein Beispiel für eine Antwort aus der DescribeEphemerisAktion 

{
  "creationTime": 1620254718.765,
  "enabled": true,
  "name": "Example Ephemeris",
  "ephemerisId": "fde41049-14f7-413e-bd7b-EXAMPLE01",
  "priority": 2,
  "status": "VALIDATING",
  "suppliedData": {
    "tle": {
      "ephemerisData": "[{\"tleLine1\": \"1 25994U 99068A   20318.54719794  .00000075  00000-0  26688-4 0  9997\",\"tleLine2": \"2 25994  98.2007  30.6589 0001234  89.2782  18.9934 14.57114995111906\",\"validTimeRange\": {\"startTime\": 1620254712000,\"endTime\": 1620859512000}}]"
    }
  }
}

Es wird empfohlen, die DescribeEphemerisRoute abzufragen oder CloudWatch Ereignisse zu verwenden, um den Status der hochgeladenen Ephemeriden zu verfolgen, da sie einen asynchronen Validierungsworkflow durchlaufen muss, bevor sie auf gesetzt wird ENABLED und für die Planung und Ausführung von Kontakten verwendet werden kann.

Beachten Sie, dass die gesamte NORAD ID im TLE Set, TLEs 25994 in den obigen Beispielen, mit der NORAD ID übereinstimmen muss, die Ihrem Satelliten in der Space-Track-Datenbank zugewiesen wurde.

Beispiel: Hochladen von Ephemeridendaten aus einem S3-Bucket

Es ist auch möglich, eine 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. Weitere Informationen zur Verschlüsselung ruhender Daten finden Sie in AWS Ground Station : Datenverschlüsselung im Ruhezustand für AWS Ground Station

Im Folgenden finden Sie ein Beispiel für das Hochladen einer OEM Ephemeriden-Datei aus einem S3-Bucket 

s3_oem_ephemeris_id = ground_station_client.create_ephemeris( name="2022-10-26 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": "ephemeris-bucket-for-testing",
                "key": "test_data.oem",
            }
        }
    })

Im Folgenden finden Sie ein Beispiel für zurückgegebene Daten aus der DescribeEphemerisAktion, die für die im vorherigen Beispielcodeblock hochgeladene OEM Ephemeride aufgerufen 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"
      }
    }
  }
}

Beispiel: Verwendung von vom Kunden bereitgestellten Ephemeriden mit AWS Ground Station

Eine detailliertere Anleitung zur Verwendung von vom Kunden bereitgestellten Ephemeriden mit finden Sie unter Vom Kunden bereitgestellte Ephemeriden verwenden mit ( AWS Ground Station und dem zugehörigen Repository aws-samples/) AWS Ground Station GitHub aws-groundstation-cpe