View a markdown version of this page

Forneça dados de efemérides do OEM - AWS Ground Station
Visão geral doFormato de efemérides OEMExemplo de efemérides de OEM no formato KVNCriando uma efeméride de OEMExemplo: carregamento de dados de efemérides de OEM de um bucket S3

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Forneça dados de efemérides do OEM

Importante

A API Ephemeris está atualmente em um estado de visualização

O acesso à API Ephemeris é fornecido somente conforme a necessidade. Se você precisar fazer upload de dados de efemérides personalizados, abra um AWS Support ticket por meio do. AWS Support Center Console Nossa equipe trabalhará com você para habilitar esse recurso para suas necessidades específicas.

Visão geral do

Orbit Ephemeris Message (OEM) é um formato padronizado para representar dados de trajetória de espaçonaves. A API Ephemeris permite que efemérides OEM sejam enviadas para uso com um satélite. AWS Ground Station Essas efemérides substituem as efemérides padrão do Space-Track (consulte:). Dados de efemérides padrão

AWS Ground Station trata as efemérides como dados de uso individualizados. Se você usar esse recurso opcional, AWS usará seus dados de efemérides para fornecer suporte à solução de problemas.

O upload de efemérides OEM personalizadas pode melhorar a qualidade do rastreamento, lidar com operações iniciais em que não há efemérides do Space-Track disponíveis e contabilizar as manobras. AWS Ground Station

nota

Ao fornecer efemérides personalizadas antes que um número de catálogo de satélite seja atribuído ao seu satélite, você pode usar satelliteId para a OBJECT_ID parte do OEM.

Para obter mais informações sobre o formato do OEMs, consulteFormato de efemérides OEM.

Formato de efemérides OEM

AWS Ground Station processa efemérides fornecidas pelo cliente OEM de acordo com o padrão CCSDS com algumas restrições extras. Os arquivos OEM devem estar no formato KVN. A tabela a seguir descreve os diferentes campos em um OEM e como AWS Ground Station difere do padrão CCSDS.

Seção Campo É necessário o CCSDS AWS Ground Station requerido Observações
Cabeçalho CCSDS_OEM_VERS Sim Sim Valor exigido: 2,0
COMMENT Não Não
CLASSIFICAÇÃO Não Não
DATA_DE_CRIAÇÃO Sim Sim
ORIGINADORA Sim Sim
ID DA MENSAGEM Não Não
Metadados META_START Sim Sim
COMMENT Não Não
NOME_OBJETO Sim Sim
ID_OBJETO Sim Sim
NOME_CENTRAL Sim Sim Valor exigido: Terra
QUADRO_REFERÊNCIA Sim Sim Valores aceitos: EME2000, ITRF2000
REF_FRAME_EPOCH Não Não suportado* Não é necessário porque os REF_ aceitos FRAMEs têm uma época implícita
SISTEMA_TEMPO Sim Sim Valor exigido: UTC
HORÁRIO_INICIAL Sim Sim
HORÁRIO_DE_INÍCIO UTILIZÁVEL Não Não
HORÁRIO DE PARADA UTILIZÁVEL Não Não
HORÁRIO_DE_PARADA Sim Sim
INTERPOLAÇÃO Não Sim Necessário para AWS Ground Station gerar ângulos de apontamento precisos para contatos.
GRAU_DE_INTERPOLAÇÃO Não Sim Necessário para AWS Ground Station gerar ângulos de apontamento precisos para contatos.
META_STOP Sim Sim
Dados X Sim Sim Representado em km
S Sim Sim Representado em km
Z Sim Sim Representado em km
X_PONTO Sim Sim Representado em km/s
Y_DOT Sim Sim Representado em km/s
Z_DOT Sim Sim Representado em km/s
X_DDOT Não Não Representado em km/s^2
Y_DDOT Não Não Representado em km/s^2
Z_DDOT Não Não Representado em km/s^2
Matriz de covariância INÍCIO DA COVARIÂNCIA Não Não
EPOCH Não Não
COV_REF_FRAME Não Não
COVARIANCE_STOP Não Não

* Se alguma linha que não seja suportada pelo AWS Ground Station for incluída no OEM fornecido, o OEM falhará na validação.

Os desvios importantes do padrão CCSDS para são: AWS Ground Station

  • CCSDS_OEM_VERSé necessário que seja2.0.

  • REF_FRAMEé necessário que seja um EME2000 ou ITRF2000.

  • REF_FRAME_EPOCHnão é suportado pelo AWS Ground Station.

  • CENTER_NAMEé necessário que sejaEarth.

  • TIME_SYSTEMé necessário que sejaUTC.

  • INTERPOLATIONe ambos INTERPOLATION_DEGREE são necessários para AWS Ground Station efemérides fornecidas pelo cliente.

Exemplo de efemérides de OEM no formato KVN

A seguir está um exemplo truncado de uma efeméride OEM no formato KVN para o satélite de transmissão pública JPSS-1. 

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

Criando uma efeméride de OEM

Uma efeméride de OEM pode ser criada usando a CreateEphemerisação na API. AWS Ground Station Essa ação fará o upload de uma efeméride usando dados no corpo da solicitação ou de um bucket do S3 especificado.

É importante observar que o upload de uma efeméride define as efemérides como VALIDATING e inicia um fluxo de trabalho assíncrono que validará e gerará contatos potenciais a partir de suas efemérides. Somente quando uma efeméride passar por esse fluxo de trabalho e se tornar ENABLED, ela será usada para contatos. Você deve pesquisar o status das efemérides ou usar CloudWatch eventos DescribeEphemerispara rastrear as mudanças de status das efemérides.

Para solucionar uma efeméride inválida, consulte: Solucionar problemas de efemérides inválidas

Exemplo: carregamento de dados de efemérides de OEM de um bucket S3

Também é possível fazer upload de um arquivo de efemérides OEM diretamente de um bucket do S3 apontando para o bucket e a chave do objeto. AWS Ground Station recuperará o objeto em seu nome. As informações sobre a criptografia de dados em repouso AWS Ground Station estão detalhadas em:Criptografia de dados em repouso para AWS Ground Station.

Abaixo está um exemplo de upload de um arquivo de efemérides OEM de um bucket S3 

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

Abaixo está um exemplo de dados retornados da ação DescribeEphemeris que está sendo chamada para as efemérides do OEM carregadas no bloco anterior do código de exemplo. 

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