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](https://console.aws.amazon.com/support) 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 ](https://www.space-track.org/) [Dati predefiniti sulle effemeridi](default-ephemeris-data.md) AWS Ground Station tratta le effemeridi come dati di utilizzo personalizzati. [https://aws.amazon.com/service-terms](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 ](https://www.space-track.org/) 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](#oem-ephemeris-format) ## Formato delle effemeridi OEM AWS Ground Station elabora le effemeridi fornite dal cliente OEM secondo lo standard [ CCSDS con alcune restrizioni aggiuntive. ](https://ccsds.org/Pubs/502x0b3e1.pdf) 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. - **Header** - **Campo:** CCSDS\_OEM\_VERS / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** Valore richiesto: 2.0 - **Campo:** COMMENT / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** No / **Note:** - **Campo:** CLASSIFICAZIONE / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** No / **Note:** - **Campo:** DATA\_CREAZIONE / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** - **Campo:** ORIGINATORE / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** - **Campo:** MESSAGE\_ID / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** No / **Note:** - **Metadati** - **Campo:** META\_START / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** - **Campo:** COMMENT / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** No / **Note:** - **Campo:** NOME\_OGGETTO / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** - **Campo:** OBJECT\_ID / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** - **Campo:** NOME\_CENTRO / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** Valore richiesto: Terra - **Campo:** REF\_FRAME / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** Valori accettati: EME2000, ITRF2000 - **Campo:** REF\_FRAME\_EPOCH / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** Non supportato\* / **Note:** Non necessario perché i REF\_frame accettati hanno un'epoca implicita - **Campo:** TIME\_SYSTEM / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** Valore richiesto: UTC - **Campo:** INIZIO\_ORARIO / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** - **Campo:** ORA\_DI\_INIZIO UTILIZZABILE / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** No / **Note:** - **Campo:** TIME\_STOP\_UTILIZZABILE / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** No / **Note:** - **Campo:** TEMPO\_ARRESTO / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** - **Campo:** INTERPOLAZIONE / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** Sì / **Note:** Necessaria per AWS Ground Station generare angoli di puntamento accurati per i contatti. - **Campo:** GRADO\_DI INTERPOLAZIONE / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** Sì / **Note:** 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. - **Campo:** META\_STOP / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** - **Dati** - **Campo:** X / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** Rappresentato in km - **Campo:** Y / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** Rappresentato in km - **Campo:** Z / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** Rappresentato in km - **Campo:** X\_DOT / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** Rappresentato in km/s - **Campo:** Y\_DOT / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** Rappresentato in km/s - **Campo:** Z\_DOT / **CCSDS richiesto:** Sì / **AWS Ground Station richiesto:** Sì / **Note:** Rappresentato in km/s - **Campo:** X\_DDOT / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** No / **Note:** Rappresentato in km/s^2 - **Campo:** Y\_DDOT / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** No / **Note:** Rappresentato in km/s^2 - **Campo:** Z\_DDOT / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** No / **Note:** Rappresentato in km/s^2 - **Matrice di covarianza** - **Campo:** COVARIANCE\_START / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** No / **Note:** - **Campo:** EPOCA / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** No / **Note:** - **Campo:** COV\_REF\_FRAME / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** No / **Note:** - **Campo:** COVARIANCE\_STOP / **CCSDS richiesto:** No / **AWS Ground Station richiesto:** No / **Note:** \* 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_VERS`deve essere. `2.0` + `REF_FRAME`deve essere uno `EME2000` o` ITRF2000`. + `REF_FRAME_EPOCH`non è supportato da AWS Ground Station. + `CENTER_NAME`deve essere`Earth`. + `TIME_SYSTEM`è richiesto di essere`UTC`. + `INTERPOLATION`e `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 ](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateEphemeris.html) 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 ](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html) 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](troubleshooting-invalid-ephemerides.md) ## 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](security.encryption-at-rest.md). 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'[DescribeEphemeris](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DescribeEphemeris.html)azione 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" } } } } ```