提供自訂星曆資料 - AWS Ground Station
概觀OEM星曆格式格式的OEM星曆示例 KVN創建一個自定義星曆例如：創建一個雙線圖元 (TLE) 通過設置星曆 API範例：從 S3 儲存貯體上傳星曆資料範例：使用客戶提供的短暫動物 AWS Ground Station

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

提供自訂星曆資料

重要

星曆目前處於「預API覽」狀態

星曆表的訪問僅在需要API的基礎上提供。

概觀

星曆API允許上傳自訂星曆，以便與衛星搭配使用 AWS Ground Station 。這些短暫會覆蓋來自太空軌道的默認短暫動物（請參閱：）。 預設星曆資料我們支持以軌道星曆消息（OEM）和雙行元素（）格式接收星曆數據。TLE

上傳自訂的星曆可以提高追蹤品質、處理沒有太空軌道短暫動作的早期作業，以及考慮操作。 AWS Ground Station

注意

在為您的衛星伺服器指定衛星目錄號碼之前提供自訂星曆時，您可以使用 00000 作為的衛星目錄號碼欄位TLE，TLE或OEM中繼資料國際指示器欄位的啟動號碼部分使用 000 (例如，24000A 用於 2024 年啟動的車輛)。

如需有關的格式的詳細資訊TLEs，請參閱雙行圖元集。若要取得有關的格式的更多資訊OEMs，請參閱OEM星曆格式。

OEM星曆格式

AWS Ground Station 根據CCSDS標準處理「OEM客戶提供的短暫」，並有一些額外的限制。OEM文件應該是KVN格式。下表概述了中的不同欄位，以OEM及 AWS Ground Station 與CCSDS標準的不同之處。

章節 欄位 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 是 是 可接受EME2的值：ITRF2
REF_FRAME_EPOCH 否 不支援 * 不需要，因為接受的 REF _ FRAMEs 有一個隱含的時代
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。

格式的OEM星曆示例 KVN

以下是在KVN格式的OEM星曆的截斷的例子 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

創建一個自定義星曆

可以使用中的CreateEphemeris動作建立自訂星曆。 AWS Ground Station API此動作將使用請求主體中的資料或指定 S3 儲存貯體中的資料上傳星曆。

重要的是要注意，上傳星曆將星曆設置為並啟動異步工作流程，該工作流程將驗證VALIDATING並從星曆生成潛在的聯繫人。只有一旦星曆已通過此工作流程並成為ENABLED將其用於聯繫人。您應該輪DescribeEphemeris詢星曆狀態或使用 CloudWatch 事件來追蹤星曆狀態變更。

若要疑難排解無效星曆表，請參閱：疑難排解無效的短暫性

例如：創建一個雙線圖元 (TLE) 通過設置星曆 API

的 AWS SDKs，並且CLI可以用來上傳一個兩行元素 (TLE) AWS Ground Station 通過調用設置星曆。CreateEphemeris此星曆將用於取代衛星的預設星曆資料（請參閱預設星曆數據）。這個範例會示範如何使用 Python (Boto3) 來執行此作業。AWS SDK

一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 一個可用於在 future 引用星曆。例如，我們可以使用上面調用 ephemerisId 中提供的來輪詢星曆的狀態：

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和執行連絡人。

請注意，在上述範例TLEs中，所有TLE集合25994中的 NORAD ID 必須與您的衛星伺服器在太空軌道資料庫中指派的 ID 相符。NORAD

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

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

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

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

下面是一個示例代碼的前面塊中上傳的OEM星曆被調用的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"
      }
    }
  }
}

範例：使用客戶提供的短暫動物 AWS Ground Station

有關使用客戶提供的臨時效果的更多詳細說明 AWS Ground Station，請參閱使用客戶提供的臨時表（以及它的相 AWS Ground Station關存儲庫 aws-Samples/） GitHub aws-groundstation-cpe