맞춤형 에페메리스 데이터 제공 - AWS Ground Station
개요OEM임시 형식형식의 OEM 이피메리스 예시 KVN사용자 지정 이피머리스 만들기예: 다음을 통해 두 줄로 된 요소 () 를 생성하십시오. TLE API 예: S3 버킷에서 이페메리스 데이터 업로드예: 고객이 제공한 에페메리데스 사용 AWS Ground Station

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

맞춤형 에페메리스 데이터 제공

중요

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

Ephemeris에 대한 API 액세스는 필요한 경우에만 제공됩니다.

개요

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

사용자 지정 에페메리드를 업로드하면 추적 품질이 향상되고, Space-Track 에페메리드를 사용할 수 없는 상황에서도 초기 작전을 처리할 수 있으며 기동성을 고려할 수 있습니다. AWS Ground Station

참고

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

형식에 대한 자세한 내용은 2줄 요소 집합을 참조하십시오. TLEs 형식에 대한 자세한 내용은 OEMs 을 참조하십시오OEM임시 형식.

OEM임시 형식

AWS Ground Station OEM고객이 제공한 에페메리데스를 표준에 따라 처리하고 몇 가지 추가 제한 사항을 적용합니다. CCSDS OEM파일은 형식이 맞아야 합니다. KVN 다음 표에는 an의 여러 필드와 표준과의 AWS Ground Station 차이점이 OEM 요약되어 있습니다. CCSDS

섹션 필드 CCSDS필수 AWS Ground Station 필수 참고
헤더 CCSDS_OEM_VERS 예 예 필수 값: 2.0
COMMENT 아니요 아니요
CLASSIFICATION 아니요 아니요
CREATION_DATE 예 예
ORIGINATOR 예 예
MESSAGE_아이디 아니요 아니요
메타데이터 META_START 예 예
COMMENT 아니요 아니요
OBJECT_NAME 예 예
OBJECT_아이디 예 예
CENTER_NAME 예 예 필수 값: 지구
REF_FRAME 예 예 허용되는 값: EME2 000, ITRF2 000
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 다음과 같습니다.

  • CCSDSOEM_ VERS _는 필수입니다. 2.0

  • REFFRAME_는 EME2000 또는 중 하나여야 ITRF2000 합니다.

  • REFFRAME_ EPOCH _는 지원되지 않습니다 AWS Ground Station.

  • CENTERNAME_는 필수입니다Earth.

  • TIMESYSTEM_는 필수입니다UTC.

  • INTERPOLATION와 INTERPOLATION DEGREES _는 모두 AWS Ground Station CPE 필수입니다.

형식의 OEM 이피메리스 예시 KVN

다음은 -1 OEM 공영 방송사 위성의 형식을 잘라낸 예제입니다. KVN JPSS 


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 이벤트를 사용하여 이피머리스의 상태 변화를 추적해야 합니다.

잘못된 이페머리스 문제를 해결하려면 다음을 참조하십시오. 잘못된 에페메리데스 문제 해결

예: 다음을 통해 두 줄로 된 요소 () 를 생성하십시오. TLE API

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

TLE집합은 하나 이상의 문자열을 TLEs 묶어 연속 궤적을 구성하는 JSON 형식이 지정된 객체입니다. TLEs집합의 TLE 집합은 궤적을 구성하는 데 사용할 수 있는 연속 집합을 형성해야 합니다 (즉, 집합 사이에 시간 간격이 없어야 함). TLEs TLE 예제 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

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 이벤트를 사용하여 업로드된 Epemeris의 상태를 추적하는 것이 좋습니다. 업로드된 Epemeris가 설정되고 연락처 예약 ENABLED 및 실행에 사용할 수 있게 되려면 비동기 검증 워크플로를 거쳐야 하기 때문입니다.

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

예: S3 버킷에서 이페메리스 데이터 업로드

또한 버킷과 객체 키를 가리키면 S3 버킷에서 직접 ephemeris 파일을 업로드할 수 있습니다. AWS Ground Station 사용자를 대신하여 객체를 검색합니다. 저장된 데이터의 암호화에 대한 자세한 내용은 AWSGround Station의 미사용 데이터 암호화에 자세히 설명되어 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-samples/) 을 참조하십시오. AWS Ground Station GitHub aws-groundstation-cpe