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

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

提供自訂 ephemeris 資料

重要

ephemeris 目前API處於預覽狀態

僅在需要時API提供對 Ephemeris 的存取。如果您需要上傳自訂 ephemeris 資料的功能，請聯絡 。 會將 ephemerides AWS Ground Station 視為個人化使用資料。如果您使用此選用功能， AWS將使用 ephemeris 資料來提供故障診斷支援。

概觀

Ephemeris 允許將API自訂的 ephemeride 上傳到 AWS Ground Station ，以便與衛星搭配使用。這些短暫性停留會覆寫來自 Space-Track 的預設短暫性停留 （請參閱：預設星曆資料）。我們支援以 Orbit Ephemeris 訊息 （OEM） 和雙行元素 （TLE） 格式接收 ephemeris 資料。

上傳自訂環數可以改善追蹤品質、處理沒有 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 否 否
CLASSIFICATION 否 否
CREATION_DATE 是 是
ORIGINATOR 是 是
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 是 是
INTERPOLATION 否 是 為必要， AWS Ground Station 可以產生準確的聯絡人指向角度。
INTERPOLATION_DEGREES 否 是 為必要， 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
共變數矩陣 COVARIANCE_START 否 否
EPOCH 否 否
COV_REF_FRAME 否 否
COVARIANCE_STOP 否 否

* 如果 不支援的任何資料列 AWS Ground Station 包含在提供的 中OEM， 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。

  • INTERPOLATION 和 INTERPOLATION_DEGREES 都是 的必要項目 AWS Ground Station CPE。

KVN 格式的範例 OEM ephemeris

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


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

建立自訂 ephemeris

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

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

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

範例：透過 建立雙行元素 （TLE） 集 ephemeris API

AWS SDKs、 和 CLI可用來 AWS Ground Station 透過CreateEphemeris呼叫將兩個行元素 （TLE） 集短暫性上傳至 。此短暫性資料將用於取代衛星的預設短暫性資料 （請參閱預設短暫性資料 ）。此範例說明如何使用 AWS SDK for Python （Boto3） 執行此操作。

TLE 集合是JSON格式化的物件，可將一或多個串TLEs連在一起，以建構連續軌跡。TLE 集合TLEs中的 必須形成連續集合，我們可以用來建構軌跡 （即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
        }
    }
]
注意

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

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

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 ，可用於在未來參考短暫性腦缺血。例如，我們可以使用上述通話 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在上述範例中，TLE集合TLEs中所有 中的 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",
            }
        }
    })

以下是在上一個範例程式碼區塊中上傳的 OEMephemeris 所呼叫DescribeEphemeris動作傳回的資料範例。

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

範例：搭配 使用客戶提供的 ephemeride AWS Ground Station

如需搭配 使用客戶提供的短暫化，請參閱搭配 AWS Ground Station使用客戶提供的短暫化 （及其相關聯的 GitHub 儲存庫 aws-samples/aws-groundstation-cpe） AWS Ground Station