翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

Ephemeris へのアクセスAPIは、必要に応じてのみ提供されます。カスタムエフェメリスデータをアップロードする必要がある場合は、<aws-groundstation@amazon.com> にお問い合わせください。

概要

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

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

OEM エフェメリス形式

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

* でサポートされていない行 AWS Ground Station が提供された に含まれている場合OEM、 は検証に失敗OEMします。

のCCSDS標準からの重要な逸脱 AWS Ground Station は次のとおりです。

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
  

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

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

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

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

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

、、および を使用して AWS SDKs、2 行要素 (TLE) セットのエフェメリスを CreateEphemeris呼び出し AWS Ground Station を介して にアップロード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 セットは、次のように 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) を参照してください。