提供自訂暫時性資料

焦點模式

提供自訂暫時性資料 - AWS Ground Station

概觀 OEM ephemeris 格式 KVN 格式的範例 OEM ephemeris 建立自訂暫時性資料範例：透過 API 建立雙行元素 (TLE) 集合暫時性資料範例：從 S3 儲存貯體上傳 Ephemeris 資料範例：搭配使用客戶提供的暫時性資料 AWS Ground Station

重要

ephemeris API 目前處於預覽狀態

僅在需要時提供對 Ephemeris API 的存取。如果您需要上傳自訂暫時性資料的能力，您應該聯絡 <aws-groundstation@amazon.com>。 AWS Ground Station 會將暫時性資料視為個人化用量資料。如果您使用此選用功能，AWS 將使用 ephemeris 資料來提供故障診斷支援。

概觀

Ephemeris API 允許將自訂的暫時性資料上傳到 AWS Ground Station ，以便與衛星搭配使用。這些暫時性物質會覆寫來自 Space-Track 的預設暫時性物質（請參閱：預設暫時性資料)。我們支援以 Orbit Ephemeris Message (OEM) 和兩行元素 (TLE) 格式接收暫時性資料。

上傳自訂的暫時化可以改善追蹤品質、處理沒有可用 Space-Track 暫時化項目的早期操作 AWS Ground Station，以及考慮操作。

注意

在為衛星指派衛星目錄號碼之前提供自訂 ephemeris 時，您可以將 00000 用於 TLE 的衛星目錄號碼欄位，並將 000 用於 TLE 或 OEM 中繼資料之國際指標欄位的啟動號碼部分（例如，2024 年啟動的車輛為 24000A)。

如需 TLEs 格式的詳細資訊，請參閱雙行元素集。如需 OEMs 格式的詳細資訊，請參閱 OEM ephemeris 格式。

OEM ephemeris 格式

AWS Ground Station 會根據 CCSDS 標準處理 OEM 客戶提供的 Ephemerides，但有一些額外的限制。OEM 檔案應為 KVN 格式。下表概述 OEM 中的不同欄位，以及與 CCSDS 標準 AWS Ground Station 的差異。

章節	欄位	需要 CCSDS	AWS Ground Station 必要	備註
標頭	CCSDS_OEM_VERS	是	是	必要值：2.0
	COMMENT	否	否
	分類	否	否
	CREATION_DATE	是	是
	原始伺服器	是	是
	MESSAGE_ID	否	否
中繼資料	META_START	是	是
	COMMENT	否	否
	OBJECT_NAME	是	是
	OBJECT_ID	是	是
	CENTER_NAME	是	是	必要值：地球
	REF_FRAME	是	是	接受的值：EME2000, ITRF2000
	REF_FRAME_EPOCH	否	不支援*	不需要，因為接受的 REF_FRAMEs 具有隱含 epoch
	TIME_SYSTEM	是	是	必要值：UTC
	START_TIME	是	是
	USEABLE_START_TIME	否	否
	USEABLE_STOP_TIME	否	否
	STOP_TIME	是	是
	插補	否	是	必要，因此 AWS Ground Station 可以為聯絡人產生準確的指向角度。
	INTERPOLATION_DEGREE	否	是	必要，因此 AWS Ground Station 可以為聯絡人產生準確的指向角度。
	META_STOP	是	是
資料	X	是	是	在中代表 `km`
	Y	是	是	在中代表 `km`
	Z	是	是	在中代表 `km`
	X_DOT	是	是	在中代表 `km/s`
	Y_DOT	是	是	在中代表 `km/s`
	Z_DOT	是	是	在中代表 `km/s`
	X_DDOT	否	否	在中代表 `km/s^2`
	Y_DDOT	否	否	在中代表 `km/s^2`
	Z_DDOT	否	否	在中代表 `km/s^2`
共變數矩陣	轉移_開始	否	否
	EPOCH	否	否
	DISC_REF_FRAME	否	否
	樞紐分析_停止	否	否

* 如果提供 OEM 中 AWS Ground Station 包含不支援的任何資料列，OEM 將驗證失敗。

與的 CCSDS 標準的重要偏差 AWS Ground Station 為：

CCSDS_OEM_VERS 必須是 2.0。
REF_FRAME 必須是 EME2000或 ITRF2000。
不支援 REF_FRAME_EPOCH AWS Ground Station。
CENTER_NAME 必須是 Earth。
TIME_SYSTEM 必須是 UTC。
CPE AWS Ground Station 需要 INTERPOLATION 和 INTERPOLATION_DEGREE。

KVN 格式的範例 OEM ephemeris

以下是 JPSS-1 公有廣播者衛星的 KVN 格式 OEM ephemeris 截斷範例。



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

建立自訂暫時性資料

您可以使用 API 中的 AWS Ground Station CreateEphemeris 動作來建立自訂暫時性資料。此動作將使用請求內文中的資料或從指定的 S3 儲存貯體上傳暫時性資料。

請務必注意，上傳 ephemeris 會將 ephemeris 設定為，VALIDATING並啟動非同步工作流程，以驗證和產生來自 ephemeris 的潛在聯絡人。只有在暫時性事件已通過此工作流程，並成為聯絡人時，ENABLED才會將其用於聯絡。您應該輪詢 DescribeEphemeris 以取得暫時狀態，或使用 CloudWatch 事件來追蹤暫時狀態變更。

若要對無效的暫時性事件進行故障診斷，請參閱：故障診斷無效的短暫性事件

範例：透過 API 建立雙行元素 (TLE) 集合暫時性資料

AWS SDKs 和 CLI 可用來 AWS Ground Station 透過 CreateEphemeris 呼叫，將雙行元素 (TLE) 集合 ephemeris 上傳至。此暫時性資料將用於取代衛星的預設暫時性資料（請參閱預設暫時性資料)。此範例說明如何使用AWS 適用於 Python 的 SDK (Boto3) 來執行此操作。

TLE 集是 JSON 格式的物件，可將一或多個 TLEs 串連在一起，以建構連續軌跡。TLEs 集中的 TLE 必須形成連續集，我們可用來建構軌跡（即 TLE 集中 TLEs之間的時間沒有差距）。範例 TLE 集如下所示：


# 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
        }
    }
]

注意

TLEs 集中 TLE 的時間範圍必須完全相符，才能成為有效且連續的軌跡。

您可以透過 boto3 AWS Ground Station 用戶端上傳 TLE 集，如下所示：


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)
                }
            }
        ]
      }
    })

此呼叫將傳回 ephemerisId，可用於將來參考 ephemeris。例如，我們可以使用上述呼叫中提供的 ephemerisId 來輪詢 ephemeris 的狀態：


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

以下提供 DescribeEphemeris 動作的範例回應


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

建議您輪詢 DescribeEphemeris 路由或使用 CloudWatch 事件來追蹤上傳的暫時性事件的狀態，因為它必須先經過非同步驗證工作流程，才能將其設定為 ENABLED，並可用於排程和執行聯絡。

請注意，在上述25994範例中，TLEs 集中所有 TLE 中的 NORAD ID 必須與 Space-Track 資料庫中已指派衛星的 NORAD ID 相符。

範例：從 S3 儲存貯體上傳 Ephemeris 資料

您也可以透過指向儲存貯體和物件金鑰，直接從 S3 儲存貯體上傳 ephemeris 檔案。 AWS Ground Station 將代表您擷取物件。有關中靜態資料加密的詳細資訊 AWS Ground Station ，請參閱：AWS Ground Station 的靜態資料加密

以下是從 S3 儲存貯體上傳 OEM ephemeris 檔案的範例


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",
            }
        }
    })

以下是從 DescribeEphemeris 動作傳回的資料範例，該動作是針對上一個範例程式碼區塊中上傳的 OEM ephemeris 所呼叫。


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

範例：搭配使用客戶提供的暫時性資料 AWS Ground Station

如需搭配使用客戶提供的暫時性資料的詳細指示 AWS Ground Station，請參閱搭配使用客戶提供的暫時性資料 AWS Ground Station（及其相關聯的 GitHub 儲存庫 aws-samples/aws-groundstation-cpe)

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

預設暫時性資料

了解使用哪些 ephemeris

下一個主題：

了解使用哪些 ephemeris

上一個主題：

預設暫時性資料

需要協助？

在本頁面

此頁面是否有幫助？

提供意見回饋

隱私權網站條款 Cookie 偏好設定

選取您的 Cookie 偏好設定

自訂 Cookie 偏好設定

必要

效能

功能

廣告

無法儲存 Cookie 偏好設定

提供自訂暫時性資料

重要

概觀

注意

OEM ephemeris 格式

KVN 格式的範例 OEM ephemeris

建立自訂暫時性資料

範例：透過 API 建立雙行元素 (TLE) 集合暫時性資料

注意

範例：從 S3 儲存貯體上傳 Ephemeris 資料

範例：搭配使用客戶提供的暫時性資料 AWS Ground Station

下一個主題：

上一個主題：

需要協助？

在本頁面

此頁面是否有幫助？

選取您的 Cookie 偏好設定

提供自訂暫時性資料

重要

概觀

注意

OEM ephemeris 格式

KVN 格式的範例 OEM ephemeris

建立自訂暫時性資料

範例：透過 API 建立雙行元素 (TLE) 集合暫時性資料

注意

範例：從 S3 儲存貯體上傳 Ephemeris 資料

範例：搭配 使用客戶提供的暫時性資料 AWS Ground Station

下一個主題：

上一個主題：

需要協助？

在本頁面

此頁面是否有幫助？

範例：搭配使用客戶提供的暫時性資料 AWS Ground Station