Fornisci dati sulle effemeridi OEM - AWS Ground Station
PanoramicaFormato delle effemeridi OEMEsempio di effemeridi OEM in formato KVNCreazione di un'effemeride OEMEsempio: caricamento di dati sulle effemeridi OEM da un bucket S3

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Fornisci dati sulle effemeridi OEM

Importante

L'API ephemeris è attualmente in uno stato di anteprima

L'accesso all'API Ephemeris viene fornito solo in base alle necessità.

Panoramica

Orbit Ephemeris Message (OEM) è un formato standardizzato per la rappresentazione dei dati di traiettoria dei veicoli spaziali. L'API Ephemeris consente di caricare effemeridi OEM per utilizzarle con un satellite. AWS Ground Station Queste effemeridi sostituiscono le effemeridi predefinite di Space-Track (vedi:). Dati predefiniti sulle effemeridi

AWS Ground Station tratta le effemeridi come dati di utilizzo personalizzati. Se utilizzi questa funzionalità opzionale, AWS utilizzerà i tuoi dati sulle effemeridi per fornire supporto per la risoluzione dei problemi.

Il caricamento di effemeridi OEM personalizzate può migliorare la qualità del tracciamento, gestire le operazioni iniziali laddove non sono disponibili effemeridi Space-Track e tenere conto delle manovre. AWS Ground Station

Nota

Quando si forniscono effemeridi personalizzate prima che venga assegnato un numero di catalogo satellitare al satellite, è possibile utilizzarle per la parte dell'OEM. satelliteId OBJECT_ID

Per ulteriori informazioni sul formato di, vedere. OEMs Formato delle effemeridi OEM

Formato delle effemeridi OEM

AWS Ground Station elabora le effemeridi fornite dal cliente OEM secondo lo standard CCSDS con alcune restrizioni aggiuntive. I file OEM devono essere in formato KVN. La tabella seguente illustra i diversi campi di un OEM e le AWS Ground Station differenze rispetto allo standard CCSDS.

Sezione Campo CCSDS richiesto AWS Ground Station richiesto Note
Header CCSDS_OEM_VERS Sì Sì Valore richiesto: 2.0
COMMENT No No
CLASSIFICAZIONE No No
DATA_CREAZIONE Sì Sì
ARTEFICE Sì Sì
ID_MESSAGGIO No No
Metadati META_START Sì Sì
COMMENT No No
NOME_OGGETTO Sì Sì
ID_OGGETTO Sì Sì
NOME_CENTRO Sì Sì Valore richiesto: Terra
REF_FRAME Sì Sì Valori accettati: EME2 000.000 ITRF2
REF_FRAME_EPOCH No Non supportato* Non necessario perché i REF_ accettati FRAMEs hanno un'epoca implicita
SISTEMA_ORARIO Sì Sì Valore richiesto: UTC
ORA DI INIZIO Sì Sì
ORA_DI_INIZIO_UTILIZZABILE No No
TEMPO_STOP_UTILIZZABILE No No
STOP_TIME Sì Sì
INTERPOLAZIONE No Sì Necessario in modo da AWS Ground Station poter generare angoli di puntamento accurati per i contatti.
GRADO_INTERPOLAZIONE No Sì Necessario in modo da AWS Ground Station poter generare angoli di puntamento accurati per i contatti.
META_STOP Sì Sì
Dati X Sì Sì Rappresentato in km
Y Sì Sì Rappresentato in km
Z Sì Sì Rappresentato in km
X_DOT Sì Sì Rappresentato in km/s
Y_DOT Sì Sì Rappresentato in km/s
Z_DOT Sì Sì Rappresentato in km/s
X_DDOT No No Rappresentato in km/s^2
Y_DDOT No No Rappresentato in km/s^2
Z_DDOT No No Rappresentato in km/s^2
Matrice di covarianza COVARIANZA_INIZIO No No
EPOCA No No
COV_REF_FRAME No No
COVARIANZA_STOP No No

* Se nell'OEM fornito AWS Ground Station sono incluse righe non supportate da, l'OEM non procederà alla convalida.

Le deviazioni importanti dallo standard CCSDS per sono: AWS Ground Station

  • CCSDS_OEM_VERSdeve esserlo. 2.0

  • REF_FRAMEdeve essere uno dei due EME2000 ITRF2000.

  • REF_FRAME_EPOCHnon è supportato da AWS Ground Station.

  • CENTER_NAMEdeve esserloEarth.

  • TIME_SYSTEMdeve esserloUTC.

  • INTERPOLATIONe INTERPOLATION_DEGREE sono entrambi obbligatori per le effemeridi fornite dal AWS Ground Station cliente.

Esempio di effemeridi OEM in formato KVN

Di seguito è riportato un esempio troncato di effemeridi OEM in formato KVN per l'emittente satellitare pubblica 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

Creazione di un'effemeride OEM

È possibile creare un'effemeride OEM utilizzando l'azione nell'API. CreateEphemeris AWS Ground Station Questa azione caricherà un'effemeride utilizzando i dati nel corpo della richiesta o da un bucket S3 specificato.

È importante notare che il caricamento di un'effemeride imposta le effemeridi e avvia un flusso di lavoro asincrono che convaliderà VALIDATING e genererà potenziali contatti a partire dalle effemeridi. Solo dopo che un'effemeride avrà superato questo flusso di lavoro e sarà diventata tale, verrà utilizzata per i contatti. ENABLED È necessario eseguire un sondaggio DescribeEphemerisper verificare lo stato delle effemeridi o utilizzare CloudWatch gli eventi per tenere traccia delle modifiche allo stato delle effemeridi.

Per risolvere un problema di effemeridi non valido, consulta: Risoluzione dei problemi relativi alle effemeridi non valide

Esempio: caricamento di dati sulle effemeridi OEM da un bucket S3

È anche possibile caricare un file di effemeridi OEM direttamente da un bucket S3 puntando al bucket e alla chiave dell'oggetto. AWS Ground Station recupererà l'oggetto per tuo conto. Le informazioni sulla crittografia dei dati archiviati AWS Ground Station sono dettagliate in:Crittografia dei dati a riposo per AWS Ground Station.

Di seguito è riportato un esempio di caricamento di un file di effemeridi OEM da un 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']}")

Di seguito è riportato un esempio di dati restituiti dall'DescribeEphemerisazione richiesta per le effemeridi OEM caricate nel precedente blocco di codice di esempio. 

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