概要 OEM エフェメリス形式 KVN 形式のOEMエフェメリスの例カスタムエフェメリスの作成例: を使用して 2 行要素 (TLE) セットエフェメリスを作成する API 例: S3 バケットから Ephemeris データをアップロードする例: でカスタマー提供のエフェメリドを使用する AWS Ground Station

カスタムエフェメリスデータの提供

重要

エフェメリスAPIは現在プレビュー状態です

Ephemeris へのアクセスAPIは、必要に応じてのみ提供されます。カスタムエフェメリスデータをアップロードする必要がある場合は、<aws-groundstation@amazon.com> にお問い合わせください。はエフェメリドを個別使用状況データとして AWS Ground Station 扱います。このオプション機能を使用する場合、 AWSはエフェメリスデータを使用してトラブルシューティングサポートを提供します。

概要

Ephemeris APIでは、衛星 AWS Ground Station で使用できるようにカスタムエフェメリドをにアップロードできます。これらのエフェメリドは、Space-Track のデフォルトのエフェメリドをオーバーライドします (「」を参照デフォルトのエフェメリスデータ）。Orbit Ephemeris Message (OEM) および 2 行要素 (TLE) 形式のエフェメリスデータの受信がサポートされています。

カスタムエフェメリドをアップロードすると、追跡の品質が向上し、Space-Track エフェメリドが利用できない早期オペレーションを処理し AWS Ground Station、操作を考慮できます。

注記

衛星にサテライトカタログ番号が割り当てられる前にカスタムエフェメリスを提供する場合、の衛星カタログ番号フィールドには 00,000TLE、 TLEまたは OEMメタデータの国際指定子フィールドの起動番号部分には 000 を使用できます (例: 2024 年に起動された車両では 224000A)。

の形式の詳細についてはTLEs、「2 行要素セット」を参照してください。の形式の詳細についてはOEMs、「」を参照してくださいOEM エフェメリス形式。

OEM エフェメリス形式

AWS Ground Station は、いくつかの追加の制限を課して、CCSDS標準に従って OEM Customer Provided Ephemerides を処理します。OEM ファイルは KVN形式である必要があります。次の表は、のさまざまなフィールドの概要OEMと、がCCSDS標準とどのように AWS Ground Station 異なるかを示しています。

セクション	フィールド	CCSDS 必須	AWS Ground Station 必須	メモ
[Header] (ヘッダー)	CCSDS_OEM_VERS	あり	可能	必須値: 2.0
	COMMENT	不可	いいえ
	CLASSIFICATION	いいえ	いいえ
	CREATION_DATE	はい	はい
	ORIGINATOR	はい	可能
	MESSAGE_ID	不可	なし
メタデータ	META_START	あり	はい
	COMMENT	いいえ	いいえ
	OBJECT_NAME	はい	可能
	OBJECT_ID	あり	はい
	CENTER_NAME	はい	可能	必須値: Earth
	REF_FRAME	あり	可能	許容値: EME2000, ITRF2000
	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。

KVN 形式のOEMエフェメリスの例

以下は、JPSS-1 パブリック放送衛星のOEMエフェメリスKVN形式の切り捨てられた例です。



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

カスタムエフェメリスの作成

カスタムエフェメリスは、の AWS Ground Station CreateEphemerisアクションを使用して作成できますAPI。このアクションによって、リクエスト本文または指定された S3 バケットのデータを使用してエフェメリスがアップロードされます。

エフェメリスがアップロードされると、エフェメリスが VALIDATING に設定されて非同期ワークフローが開始されることに注意してください。このワークフローでは、エフェメリスを検証し、そのエフェメリスを基に潜在的なコンタクトを生成します。エフェメリスは、このワークフローを実施して ENABLED になって初めて、コンタクトに使用されます。エフェメリスのステータスDescribeEphemerisをポーリングするか、 CloudWatch イベントを使用してエフェメリスのステータスの変化を追跡する必要があります。

無効なエフェメリスのトラブルシューティングについては、以下を参照してください。無効なエフェメリドのトラブルシューティング

例: を使用して 2 行要素 (TLE) セットエフェメリスを作成する API

AWS SDKsとを使用して、CreateEphemeris呼び出し AWS Ground Station を介して 2 行要素 (TLE) セットのエフェメリスをにアップロードCLIできます。このエフェメリスは、衛星用のデフォルトのエフェメリスデータの代わりに使用されます (「デフォルトのエフェメリスデータ」を参照)。この例では、 AWS SDK for Python (Boto3) を使用してこれを行う方法を示しています。

TLE セットは、1 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 から提供されたを使用して、エフェメリスのステータスをポーリングできます。


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 バケットから直接エフェメリスファイルをアップロードすることもできます。 AWS Ground Station はユーザーに代わってオブジェクトを取得します。に保存されているデータの暗号化の詳細については AWS Ground Station 、「Data Encryption At Rest for 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」 (および関連する GitHub リポジトリ aws-samples/aws-groundstation-cpe) を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

デフォルトのエフェメリスデータ

どのエフェメリスが使用されているかを理解する