Bereitstellung benutzerdefinierter Ephemeridendaten

Wichtig

Die Ephemeride API befindet sich derzeit im Vorschaustatus

Der Zugriff auf die Ephemeride API wird nur bei Bedarf gewährt. <Wenn Sie die Möglichkeit benötigen, benutzerdefinierte Ephemeridendaten hochzuladen, wenden Sie sich an [e-mail].>

Übersicht

Die Ephemeride API ermöglicht das Hochladen benutzerdefinierter Ephemeriden zur Verwendung mit einem Satelliten. 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