사용자 지정 ephemeris 데이터 제공 - AWS Ground Station
개요OEM ephemeris 형식KVN 형식OEM의 임시 예시사용자 지정 ephemeris 생성예: 를 통해 2줄 요소(TLE) 세트 ephemeris 생성 API예: S3 버킷에서 Ephemeris 데이터 업로드예: 에서 고객 제공 에페메라이드 사용 AWS Ground Station

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

사용자 지정 ephemeris 데이터 제공

중요

ephemerisAPI가 현재 미리 보기 상태입니다.

Ephemeris에 대한 액세스API는 필요에 따라 제공됩니다. 사용자 지정 에페메리스 데이터를 업로드하는 기능이 필요한 경우 에 문의해야 합니다. 는 에페메리스를 개별화된 사용 데이터 로 AWS Ground Station 취급합니다. 이 선택적 기능을 사용하는 경우 AWS는 ephemeris 데이터를 사용하여 문제 해결 지원을 제공합니다.

개요

Ephemeris를 API 사용하면 위성과 함께 사용할 수 있도록 사용자 지정 에페메리드를 AWS Ground Station 에 업로드할 수 있습니다. 이러한 에페메리드는 Space-Track의 기본 에페메리드를 재정의합니다( 참조기본 에페메리스 데이터). Orbit Ephemeris 메시지(OEM) 및 2줄 요소(TLE) 형식으로 ephemeris 데이터 수신을 지원합니다.

사용자 지정 에페메리드를 업로드하면 추적 품질을 개선하고, 에 사용할 수 있는 Space-Track 에페메리드가 없는 초기 작업을 처리하고 AWS Ground Station, 조작을 설명할 수 있습니다.

참고

위성 카탈로그 번호가 위성에 할당되기 전에 사용자 지정 임시 사용자를 제공할 때 의 위성 카탈로그 번호 필드에는 00000을 사용하고 TLE또는 TLE OEM 메타데이터의 국제 지정자 필드의 시작 번호 부분에는 000을 사용할 수 있습니다(예: 2024년에 시작된 차량의 경우 24000A).

형식에 대한 자세한 내용은 2줄 요소 세트 를 TLEs참조하세요. 형식에 대한 자세한 내용은 섹션을 OEMs참조하세요OEM ephemeris 형식.

OEM ephemeris 형식

AWS Ground Station 는 몇 가지 추가 제한 사항이 있는 CCSDS 표준에 따라 OEM Customer provided Ephemerides를 처리합니다. OEM 파일은 KVN 형식이어야 합니다. 다음 표에는 의 다양한 필드OEM와 이 CCSDS 표준과 어떻게 AWS Ground Station 다른지 요약되어 있습니다.

섹션 필드 CCSDS 필수 AWS Ground Station 필수 참고
헤더 CCSDS_OEM_VERS 예 예 필수 값: 2.0
COMMENT 아니요 아니요
CLASSIFICATION 아니요 아니요
CREATION_DATE 예 예
ORIGINATOR 예 예
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 예 예
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의 임시 예시

다음은 OEM JPSS-1 퍼블릭 브로드캐스터 위성에 대한 KVN 형식의 ephemeris의 잘린 예입니다.


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

사용자 지정 ephemeris 생성

의 CreateEphemeris 작업을 사용하여 사용자 지정 임시 사용자를 생성할 수 있습니다 AWS Ground Station API. 이 작업은 요청 본문 또는 지정된 S3 버킷의 데이터를 사용하여 에페메리스를 업로드합니다.

한 가지 주의할 점은 에피메리스를 업로드하면 에피메리스가 VALIDATING로 설정되고 비동기 워크플로가 시작되어 에피메리스를 검증하고 이로부터 잠재적 접촉을 생성하는 비동기 워크플로가 시작된다는 점입니다. 임시 저장소가 이 워크플로를 통과한 후 ENABLED가 된 후에만 접촉에 사용됩니다. 에페메리스 상태를 DescribeEphemeris 폴링하거나 CloudWatch 이벤트를 사용하여 에페메리스의 상태 변화를 추적해야 합니다.

잘못된 임시 문제를 해결하려면 다음을 참조하세요. 잘못된 에페메리드 문제 해결

예: 를 통해 2줄 요소(TLE) 세트 ephemeris 생성 API

AWS SDKs, 및 는 CreateEphemeris 호출을 AWS Ground Station 통해 임시로 설정된 두 줄 요소(TLE)를 업로드하는 데 사용할 CLI 수 있습니다. 이 에페메리스는 위성의 기본 에페메리스 데이터 대신 사용됩니다(기본 에페메리스 데이터 참조). 이 예제에서는 AWS SDK Python용 (Boto3)을 사용하여 이 작업을 수행하는 방법을 보여줍니다.

TLE 집합은 하나 이상의 문자열을 TLEs 함께 사용하여 연속 궤적을 구성하는 JSON 형식이 지정된 객체입니다. 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의 시간 범위는 유효하고 지속적인 궤적이 되려면 정확히 일치해야 합니다.

다음과 같이 AWS Ground Station boto3 클라이언트를 통해 TLE 세트를 업로드할 수 있습니다.

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}}]"
    }
  }
}

비동기 검증 워크플로를 거쳐야 하고 로 설정되고 를 사용하여 고객 응대를 예약 ENABLED 및 실행할 수 있게 되므로 업로드된 ephemeris의 상태를 추적하기 위해 DescribeEphemeris 라우팅을 폴링하거나 CloudWatch 이벤트를 사용하는 것이 좋습니다.

위 예제25994에서 TLEs TLE 세트의 모든 NORAD ID는 위성이 Space-Track 데이터베이스에 할당된 NORAD ID와 일치해야 합니다.

예: S3 버킷에서 Ephemeris 데이터 업로드

버킷과 객체 키를 가리키면 S3 버킷에서 직접 ephemeris 파일을 업로드할 수도 있습니다. AWS Ground Station 는 사용자를 대신하여 객체를 검색합니다. 의 저장 데이터 암호화에 대한 자세한 내용은 에서 AWS Ground Station 확인할 수 있습니다. Data Encryption At Rest For AWS Ground Station

다음은 S3 버킷에서 OEM ephemeris 파일을 업로드하는 예제입니다.

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(및 연결된 GitHub 리포지토리 aws-samples/aws-groundstation-cpe)을 AWS Ground Station참조하세요.