View a markdown version of this page

Fornisci dati sulle effemeridi OEM - AWS Ground Station
Panoramica diFormato 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 stato di anteprima

L'accesso all'API Ephemeris viene fornito solo in base alle necessità. Se hai bisogno della possibilità di caricare dati personalizzati sulle effemeridi, apri un ticket tramite il. Supporto AWS AWS Support Center Console Il nostro team lavorerà con te per abilitare questa funzionalità per le tue esigenze specifiche.

Panoramica di

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

AWS Ground Station tratta le effemeridi come dati di utilizzo personalizzati. https://aws.amazon.com/service-terms Se si utilizza questa funzionalità opzionale, AWS utilizzerà i dati relativi alle effemeridi per fornire assistenza nella risoluzione dei problemi.

Il caricamento di effemeridi OEM personalizzate può migliorare la qualità del tracciamento, gestire le operazioni iniziali laddove non sono disponibili Space-Track effemeridi 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 degli OEM, vedere. 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ì
ORIGINATORE Sì Sì
MESSAGE_ID No No
Metadati META_START Sì Sì
COMMENT No No
NOME_OGGETTO Sì Sì
OBJECT_ID Sì Sì
NOME_CENTRO Sì Sì Valore richiesto: Terra
REF_FRAME Sì Sì Valori accettati: EME2000, ITRF2000
REF_FRAME_EPOCH No Non supportato* Non necessario perché i REF_frame accettati hanno un'epoca implicita
TIME_SYSTEM Sì Sì Valore richiesto: UTC
INIZIO_ORARIO Sì Sì
ORA_DI_INIZIO UTILIZZABILE No No
TIME_STOP_UTILIZZABILE No No
TEMPO_ARRESTO Sì Sì
INTERPOLAZIONE No Sì Necessaria per AWS Ground Station generare angoli di puntamento accurati per i contatti.
GRADO_DI INTERPOLAZIONE No Sì Necessario per AWS Ground Station generare angoli di puntamento accurati per i contatti. Se possibile, verrà utilizzato il grado specificato, ma verrà utilizzato un grado inferiore se non ci sono dati sufficienti nel segmento.
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 COVARIANCE_START No No
EPOCA No No
COV_REF_FRAME No No
COVARIANCE_STOP No No

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

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

  • CCSDS_OEM_VERSdeve essere. 2.0

  • REF_FRAMEdeve essere uno EME2000 o ITRF2000.

  • REF_FRAME_EPOCHnon è supportato da AWS Ground Station.

  • CENTER_NAMEdeve essereEarth.

  • TIME_SYSTEMè richiesto di essereUTC.

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

  • AWS Ground Station si discosta dal CCSDS 5.2.4.7 in quanto consente ai blocchi di dati OEM che non contengono un numero sufficiente di record di dati relativi alle effemeridi di eseguire l'interpolazione nel valore specificato. INTERPOLATION_DEGREE In questo caso, AWS Ground Station utilizzerà il più alto grado di interpolazione possibile, inferiore o uguale a quello specificato. INTERPOLATION_DEGREE

Esempio di effemeridi OEM in formato KVN

Di seguito è riportato un esempio abbreviato di effemeridi OEM in formato KVN per l'emittente pubblica satellitare. 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 l'effemeride su e avvia un flusso di lavoro asincrono che convaliderà VALIDATING e genererà potenziali contatti a partire dalle effemeridi. Solo dopo aver superato questo flusso di lavoro, l'effemeride verrà utilizzata per i contatti. ENABLED È necessario verificare lo stato delle effemeridi o utilizzare CloudWatch gli eventi DescribeEphemeris per tenere traccia dei cambiamenti di stato delle effemeridi.

Per risolvere i problemi relativi a un'effemeride non valida, 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 sul bucket e sulla 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 effemeris 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 richiamata 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"
      }
    }
  }
}