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

カスタムエフェメリスデータを提供する

重要

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

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

概要

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

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

注記

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

TLEs」を参照してください。 https://en.wikipedia.org/wiki/Two-line_element_setOEMs「」を参照してくださいOEM エフェメリス形式。

OEM エフェメリス形式

AWS Ground Station は、CCSDS 標準に従って OEM のお客様が提供したエフェメリスを処理しますが、いくつかの追加の制限があります。OEM ファイルは KVN 形式である必要があります。次の表は、OEM のさまざまなフィールドと、と CCSDS 標準 AWS Ground Station の違いの概要を示しています。

セクション	フィールド	CCSDS が必要	AWS Ground Station 必須	メモ
ヘッダー	CCSDS_OEM_VERS	あり	あり	必須値: 2.0
	COMMENT	いいえ	いいえ
	分類	いいえ	いいえ
	CREATION_DATE	あり	あり
	発信者	あり	あり
	メッセージ ID	いいえ	いいえ
メタデータ	META_START	あり	あり
	COMMENT	いいえ	いいえ
	オブジェクト名	あり	あり
	オブジェクト ID	あり	あり
	CENTER_NAME	あり	あり	必須値: Earth
	REF_FRAME	あり	あり	使用できる値: EME2000, ITRF2000
	REF_FRAME_EPOCH	いいえ	サポートされていない*	承認された REF_FRAMEs には暗黙的なエポックがあるため、不要
	TIME_システム	あり	あり	必須値: 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`
共分散行列	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。
CPE には、INTERPOLATION と INTERPOLATION_DEGREE AWS Ground Station の両方が必要です。

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

以下は、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

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

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

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

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

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

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

TLE セットは JSON 形式のオブジェクトで、1 つ以上の TLE をつなぎ合わせて連続した軌道を構築します。TLE セット内の TLE は、軌道の構築に使用できる連続したセットを形成する (つまり、TLE セット内の TLE 間に時間的なギャップがない) 必要があります。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 セット内の TLE の時間範囲は、有効で連続的な軌道になるためには正確に一致する必要があります。

TLE セットは、次のように boto3 AWS Ground Station クライアント経由でアップロードできます。


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例では、TLEs セット内のすべての TLE の NORAD ID は、衛星が Space-Track データベースで割り当てられている NORAD ID と一致する必要があることに注意してください。

例: S3 バケットからエフェメリスデータをアップロードする

バケットとオブジェクトキーをポイントして、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 を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

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

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