기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # OEM 에페메리스 데이터 제공 **중요** 에페메리스 API는 현재 프리뷰 상태입니다 에페메리스 API에 대한 액세스는 필요에 따라 제공됩니다. 사용자 지정 에페메리스 데이터를 업로드하는 기능이 필요한 경우를 통해 AWS Support 티켓을 개설하세요[AWS Support Center Console](https://console.aws.amazon.com/support). 당사 팀은 고객과 협력하여 특정 요구 사항에 맞게이 기능을 활성화합니다. ## 개요 Orbit Ephemeris Message(OEM)는 우주선 궤적 데이터를 나타내는 표준화된 형식입니다. Ephemeris API를 사용하면 OEM 에페메리스를 AWS Ground Station 에 업로드하여 위성과 함께 사용할 수 있습니다. 이러한 에페메리스는 [스페이스 트랙](https://www.space-track.org/)의 기본 에페메리스를 재정의합니다( 참조[기본 에페메리스 데이터](default-ephemeris-data.md)). AWS Ground Station 는 에페메리스를 [개별화된 사용 데이터](https://aws.amazon.com/service-terms)로 취급합니다. 이 선택적 기능을 사용하는 경우 AWS 는 에페메리스 데이터를 사용하여 문제 해결 지원을 제공합니다. 사용자 지정 OEM 에페메리스를 업로드하면 추적 품질을 개선하고, [스페이스 트랙](https://www.space-track.org/) 에페메리스를 사용할 수 없는 초기 작업을 처리하고 AWS Ground Station, 조작을 고려할 수 있습니다. **참고** 위성 카탈로그 번호가 위성에 할당되기 전에 사용자 지정 에페메리스를 제공하는 경우 OEM의 `satelliteId` `OBJECT_ID` 부분에를 사용할 수 있습니다. OEMs의 형식에 대한 자세한 내용은 단원을 참조하십시오[OEM 에페메리스 형식](#oem-ephemeris-format). ## OEM 에페메리스 형식 AWS Ground Station 는 몇 가지 추가 제한과 함께 [CCSDS 표준에](https://ccsds.org/Pubs/502x0b3e1.pdf) 따라 OEM 고객 제공 에페메리스를 처리합니다. OEM 파일은 KVN 형식이어야 합니다. 다음 표에는 OEM의 다양한 필드와가 CCSDS 표준과 어떻게 AWS Ground Station 다른지 요약되어 있습니다. - **헤더** - **Field:** CCSDS\_OEM\_VERS / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** 필수 값: 2.0 - **Field:** COMMENT / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 아니요 / **참고:** - **Field:** 분류 / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 아니요 / **참고:** - **Field:** CREATION\_DATE / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** - **Field:** 생성자 / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** - **Field:** MESSAGE\_ID / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 아니요 / **참고:** - **Metadata** - **Field:** META\_START / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** - **Field:** COMMENT / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 아니요 / **참고:** - **Field:** OBJECT\_NAME / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** - **Field:** OBJECT\_ID / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** - **Field:** CENTER\_NAME / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** 필수 값: 지구 - **Field:** REF\_FRAME / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** 허용되는 값: EME2000, ITRF2000 - **Field:** REF\_FRAME\_EPOCH / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 지원되지 않음\* / **참고:** 허용되는 REF\_FRAMEs에는 암시적 에포크가 있으므로 필요하지 않음 - **Field:** TIME\_SYSTEM / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** 필수 값: UTC - **Field:** START\_TIME / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** - **Field:** USEABLE\_START\_TIME / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 아니요 / **참고:** - **Field:** USEABLE\_STOP\_TIME / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 아니요 / **참고:** - **Field:** STOP\_TIME / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** - **Field:** 보간 / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 예 / **참고:** 가 접촉에 대한 정확한 방향 각도를 생성할 AWS Ground Station 수 있도록 필요합니다. - **Field:** 인터폴레이션\_도 / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 예 / **참고:** 가 접촉에 대한 정확한 방향 각도를 생성할 AWS Ground Station 수 있도록 필요합니다. 가능하면 지정된 정도가 사용되지만 세그먼트에 데이터가 충분하지 않은 경우 더 낮은 정도가 사용됩니다. - **Field:** META\_STOP / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** - **데이터** - **Field:** X / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** 에서 표시됨 km - **Field:** Y / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** 에서 표시됨 km - **Field:** Z / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** 에서 표시됨 km - **Field:** X\_DOT / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** 에서 표시됨 km/s - **Field:** Y\_DOT / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** 에서 표시됨 km/s - **Field:** Z\_DOT / **CCSDS 필요:** 예 / **AWS Ground Station 필수:** 예 / **참고:** 에서 표시됨 km/s - **Field:** X\_DDOT / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 아니요 / **참고:** 에서 표시됨 km/s^2 - **Field:** Y\_DDOT / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 아니요 / **참고:** 에서 표시됨 km/s^2 - **Field:** Z\_DDOT / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 아니요 / **참고:** 에서 표시됨 km/s^2 - **공분산 행렬** - **Field:** COVARIANCE\_START / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 아니요 / **참고:** - **Field:** EPOCH / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 아니요 / **참고:** - **Field:** COV\_REF\_FRAME / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 아니요 / **참고:** - **Field:** COVARIANCE\_STOP / **CCSDS 필요:** 아니요 / **AWS Ground Station 필수:** 아니요 / **참고:** \*에서 지원하지 않는 행 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 고객이 제공한 에페메리스에 모두 필요합니다. + AWS Ground Station 는 지정된에서 보간을 수행하기에 충분한 에페메리스 데이터 레코드가 포함되지 않은 OEM 데이터 블록을 허용하여 CCSDS 5.2.4.7을 벗어납니다`INTERPOLATION_DEGREE`. 이 경우는 지정된 보다 작거나 같은 가장 높은 보간 정도를 AWS Ground Station 사용합니다`INTERPOLATION_DEGREE`. ## 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](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html) 작업을 사용하여 생성할 수 있습니다 AWS Ground Station . 이 작업은 요청 본문 또는 지정된 S3 버킷의 데이터를 사용하여 에페메리스를 업로드합니다. 한 가지 주의할 점은 에피메리스를 업로드하면 에피메리스가 ` VALIDATING`로 설정되고 비동기 워크플로가 시작되어 에피메리스를 검증하고 이로부터 잠재적 접촉을 생성하는 비동기 워크플로가 시작된다는 점입니다. 임시 저장소가 이 워크플로를 통과한 후 `ENABLED`가 된 후에만 접촉에 사용됩니다. 에페메리스 상태에 대해 [DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)를 폴링하거나 CloudWatch 이벤트를 사용하여 에페메리스의 상태 변경을 추적해야 합니다. 잘못된 에페메리스 문제를 해결하려면 다음을 참조하세요. [잘못된 에페메리스 문제 해결](troubleshooting-invalid-ephemerides.md) ## 예: S3 버킷에서 OEM 에페메리스 데이터 업로드 버킷 및 객체 키를 가리켜 S3 버킷에서 OEM 에페메리스 파일을 직접 업로드할 수도 있습니다. AWS Ground Station 는 사용자를 대신하여 객체를 검색합니다. 의 저장 데이터 암호화에 대한 자세한 내용은 단원을 AWS Ground Station 참조하십시오[에 대한 저장 데이터 암호화 AWS Ground Station](security.encryption-at-rest.md). 다음은 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](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) 작업에서 반환된 데이터의 예입니다. ``` { "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" } } } } ```