概要:OEM エフェメリス形式 KVN 形式の OEM エフェメリスの例 OEM エフェメリスの作成例: S3 バケットから OEM エフェメリスデータをアップロードする

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

重要

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

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

概要:

軌道エフェメリスメッセージ (OEM) は、宇宙機の軌道データを表すための標準化された形式です。Ephemeris API を使用すると、OEM エフェメリスをにアップロード AWS Ground Station して衛星で使用できます。これらのエフェメリスは、Space-Track のデフォルトのエフェメリスを上書きします (「」を参照デフォルトのエフェメリスデータ)。

AWS Ground Station はエフェメリスを個別の使用状況データとして扱います。このオプション機能を使用する場合、 AWS はエフェメリスデータを使用してトラブルシューティングサポートを提供します。

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

注記

衛星に衛星カタログ番号が割り当てられる前にカスタムエフェメリスを提供する場合、OEM の satelliteId OBJECT_ID 部分にを使用できます。

OEMs「」を参照してください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_SYSTEM	はい	はい	必須値: UTC
	START_TIME	はい	はい
	USEABLE_START_TIME	いいえ	不可
	USEABLE_STOP_TIME	いいえ	不可
	STOP_TIME	はい	はい
	解釈	不可	あり	AWS Ground Station がコンタクトの正確なポインティング角度を生成できるようにするために必要です。
	INTERPOLATION_DEGREE	不可	あり	AWS Ground Station がコンタクトの正確なポインティング角度を生成できるようにするために必要です。
	META_STOP	はい	はい
データ	X	はい	はい	で表される `km`
	はい	はい	はい	で表される `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_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

OEM エフェメリスの作成

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

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

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

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

バケットとオブジェクトキーを指すことで、S3 バケットから直接 OEM エフェメリスファイルをアップロードすることもできます。 AWS Ground Station はユーザーに代わってオブジェクトを取得します。で保管中のデータの暗号化の詳細については AWS Ground Station 、「」を参照してくださいの保管時のデータ暗号化 AWS Ground Station。

以下は、S3 バケットから OEM エフェメリスファイルをアップロードする例です。


import boto3
from datetime import datetime, timedelta, timezone

# Create AWS clients
s3_client = boto3.client("s3")
ground_station_client = boto3.client("groundstation")

# Define S3 bucket and key
bucket_name = "ephemeris-bucket"
object_key = "test_data.oem"

# Create sample OEM data in KVN format
oem_data = """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
"""

# Upload sample OEM data to S3
print(f"Uploading OEM data to s3://{bucket_name}/{object_key}")

s3_client.put_object(
    Bucket=bucket_name, Key=object_key, Body=oem_data, ContentType="text/plain"
)

print("OEM data uploaded successfully to S3")

# Create OEM ephemeris from S3
print("Creating OEM ephemeris from S3...")

s3_oem_ephemeris = ground_station_client.create_ephemeris(
    name="2024-07-22 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": bucket_name, "key": object_key}}},
)

print(f"Created OEM ephemeris with ID: {s3_oem_ephemeris['ephemerisId']}")

以下は、前のコード例のブロックでアップロードされた 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"
      }
    }
  }
}

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

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

ドキュメントの表記規則

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

方位高度エフェメリスデータを提供する