OEM 에페메리스 데이터 제공 - AWS Ground Station
개요OEM 에페메리스 형식KVN 형식의 OEM 에페메리스 예제OEM 에페메리스 생성예: S3 버킷에서 OEM 에페메리스 데이터 업로드

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

OEM 에페메리스 데이터 제공

중요

에페메리스 API는 현재 프리뷰 상태입니다

에페메리스 API에 대한 액세스는 필요에 따라 제공됩니다. 사용자 지정 에페메리스 데이터를 업로드하는 기능이 필요한 경우 에 문의해야 합니다.

개요

Orbit Ephemeris Message(OEM)는 우주선 궤적 데이터를 나타내는 표준화된 형식입니다. Ephemeris API를 사용하면 OEM 에페메리스를 AWS Ground Station 에 업로드하여 위성과 함께 사용할 수 있습니다. 이러한 에페메리스는 스페이스 트랙의 기본 에페메리스를 재정의합니다( 참조기본 에페메리스 데이터).

AWS Ground Station 는 에페메리스를 개별화된 사용 데이터로 처리합니다. 이 선택적 기능을 사용하는 경우 AWS 는 에페메리스 데이터를 사용하여 문제 해결 지원을 제공합니다.

사용자 지정 OEM 에페메리스를 업로드하면 추적 품질을 개선하고, 스페이스 트랙 에페메리스를 사용할 수 없는 초기 작업을 처리하고 AWS Ground Station, 조작을 고려할 수 있습니다.

참고

위성 카탈로그 번호가 위성에 할당되기 전에 사용자 지정 에페메리스를 제공하는 경우 OEM의 satelliteId OBJECT_ID 부분에를 사용할 수 있습니다.

OEMsOEM 에페메리스 형식.

OEM 에페메리스 형식

AWS Ground Station 는 몇 가지 추가 제한과 함께 CCSDS 표준에 따라 OEM 고객 제공 에페메리스를 처리합니다. OEM 파일은 KVN 형식이어야 합니다. 다음 표에는 OEM의 다양한 필드와가 CCSDS 표준과 어떻게 AWS Ground Station 다른지 요약되어 있습니다.

섹션 Field CCSDS 필요 AWS Ground Station 필수 참고
헤더 CCSDS_OEM_VERS 예 예 필수 값: 2.0
COMMENT 아니요 아니요
분류 아니요 아니요
CREATION_DATE 예 예
오리진이터 예 예
MESSAGE_ID 아니요 아니요
메타데이터 META_START 예 예
COMMENT 아니요 아니요
OBJECT_NAME 예 예
OBJECT_ID 예 예
CENTER_NAME 예 예 필수 값: 지구
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 가 접촉에 대한 정확한 가리킴 각도를 생성하는 데 필요합니다.
인터폴레이션_도 아니요 예 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_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"
      }
    }
  }
}