Fournir des données d'éphémérides personnalisées

Avertissement

L'API ephemeris est actuellement en version préliminaire

L'accès à l'API Ephemeris n'est fourni qu'en cas de besoin. Les clients souhaitant pouvoir télécharger des données d'éphémérides personnalisées doivent contacter [e-mail].

Présentation

L'API Ephemeris permet de télécharger des éphémérides personnalisées pour une utilisation avec un satellite AWS Ground Station . Ces éphémérides remplacent les éphémérides par défaut de Space Track (voir : Données d'éphémérides par défaut).

Le téléchargement des éphémérides des clients peut améliorer la qualité du suivi, gérer les premières opérations lorsque aucune éphéméride Space Track n'est disponible et prendre AWS Ground Station en compte les manœuvres.

Création d'une éphéméride personnalisée

Une éphéméride personnalisée peut être créée à l'aide de l'CreateEphemerisaction de l' AWS Ground Station API. Cette action téléchargera une éphéméride en utilisant les données contenues dans le corps de la demande ou provenant d'un compartiment S3 spécifié.

Il est important de noter que le téléchargement d'une éphéméride définit l'éphéméride et lance un flux de travail asynchrone qui validera VALIDATING et générera des contacts potentiels à partir de votre éphéméride. Ce n'est qu'une fois qu'une éphéméride aura passé ce flux de travail et ENABLED sera devenue qu'elle sera utilisée pour les contacts. Vous devez effectuer un sondage DescribeEphemeris pour connaître le statut des éphémérides ou utiliser les événements Cloudwatch pour suivre les changements de statut des éphémérides.

Pour résoudre le problème d'une éphéméride non valide, voir : Résolution des éphémérides non valides

Création d'un ensemble d'éphémérides TLE via une API

Le client AWS Ground Station boto3 peut être utilisé pour télécharger un ensemble d'éphémérides d'un élément à deux lignes (TLE) via l' AWS Ground Station appel. CreateEphemeris Cette éphéméride sera utilisée à la place des données d'éphémérides par défaut pour un satellite (voir Données d'éphémérides par défaut).

Un ensemble TLE est un objet au format JSON qui associe un ou plusieurs TLE pour construire une trajectoire continue. Les TLE de l'ensemble TLE doivent former un ensemble continu que nous pouvons utiliser pour construire une trajectoire (c'est-à-dire aucun intervalle de temps entre les TLE d'un ensemble TLE). Un exemple d'ensemble TLE est illustré ci-dessous :

# 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
        }
    }
]

Note

Les plages de temps des TLE d'un ensemble de TLE doivent correspondre exactement pour constituer une trajectoire continue valide.

Un ensemble TLE peut être téléchargé via le client AWS Ground Station boto3 comme suit :

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

Cet appel renverra un identifiant d'éphéméride qui pourra être utilisé pour référencer l'éphéméride à l'avenir. Par exemple, nous pouvons utiliser l'identifiant d'éphéméride fourni lors de l'appel ci-dessus pour connaître le statut de l'éphéméride :

client.describe_ephemeris(ephemerisId=tle_ephemeris_id['ephemerisId'])

Un exemple de réponse à l'DescribeEphemerisaction est fourni ci-dessous.

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

Il est recommandé d'interroger l'DescribeEphemerisitinéraire ou d'utiliser les événements Cloudwatch pour suivre l'état des éphémérides téléchargées, car elles doivent passer par un flux de travail de validation asynchrone avant d'être définies et de devenir utilisables pour la planification ENABLED et l'exécution des contacts.

Notez que l'identifiant NORAD de tous les TLE de l'ensemble TLE, 25994 dans les exemples ci-dessus, doit correspondre à l'identifiant NORAD attribué à votre satellite dans la base de données Space Track.

Téléchargement de données Ephemeris depuis un compartiment S3

Il est également possible de télécharger un fichier éphéméride directement depuis un compartiment S3 en pointant sur le compartiment et la clé d'objet. AWS Ground Station récupérera l'objet en votre nom. Les informations sur le chiffrement des données au repos AWS Ground Station sont détaillées dans : Data Encryption At Rest For AWS Ground Station

Vous trouverez ci-dessous un exemple de téléchargement d'un fichier d'éphémérides OEM à partir d'un compartiment S3.

s3_oem_ephemeris_id = customer_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",
            }
        }
    })

Vous trouverez ci-dessous un exemple de données renvoyées par l'DescribeEphemerisaction appelée pour les éphémérides OEM téléchargées dans le bloc d'exemple de code précédent.

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