Proporcionar datos de efemérides personalizados - AWS Ground Station
Información generalOEMformato de efeméridesEjemplo de OEM efemérides en formato KVNCrear una efeméride personalizadaEjemplo: cree un conjunto de efemérides de dos líneas () mediante TLE APIEjemplo: cargar datos de Ephemeris desde un bucket de S3Ejemplo: usar efemérides proporcionadas por el cliente con AWS Ground Station

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Proporcionar datos de efemérides personalizados

importante

La efeméride se API encuentra actualmente en estado de vista previa

El acceso a las efemérides se proporciona solo cuando API es necesario.

Información general

Las efemérides API permiten cargar efemérides personalizadas para usarlas con un satélite. AWS Ground Station Estas efemérides anulan las efemérides predeterminadas de Space-Track (consulte:). Datos de efemérides predeterminados Admitimos la recepción de datos de efemérides en los formatos Orbit Ephemeris Message () y elementos de dos líneas (). OEM TLE

La carga de efemérides personalizadas permite mejorar la calidad del seguimiento, gestionar las primeras operaciones cuando no se dispone de efemérides de Space-Track y contabilizar las maniobras. AWS Ground Station

nota

Al proporcionar efemérides personalizadas antes de asignar un número de catálogo de satélites a su satélite, puede utilizar 00000 para el campo de número de catálogo de satélites del TLE y 000 para la parte del número de lanzamiento del campo de designación internacional de los OEM metadatos TLE o (por ejemplo, 24000A para un vehículo lanzado en 2024).

Para obtener más información sobre el formato de, consulte Conjunto de elementos de dos TLEs líneas. Para obtener más información sobre el formato deOEMs, consulteOEMformato de efemérides.

OEMformato de efemérides

AWS Ground Station procesa las efemérides proporcionadas por el OEM cliente de acuerdo con el CCSDSestándar con algunas restricciones adicionales. OEMlos archivos deben estar en formato. KVN En la siguiente tabla se describen los diferentes campos de una CCSDS norma OEM y en qué AWS Ground Station se diferencian de ella.

Sección Campo CCSDSobligatorio AWS Ground Station obligatorio Notas
Encabezado CCSDS_OEM_VERS Sí Sí Valor requerido: 2.0
COMMENT No No
CLASSIFICATION No No
CREATION_DATE Sí Sí
ORIGINATOR Sí Sí
MESSAGE_ID No No
Metadatos META_START Sí Sí
COMMENT No No
OBJECT_NAME Sí Sí
OBJECT_ID Sí Sí
CENTER_NAME Sí Sí Valor obligatorio: Tierra
REF_FRAME Sí Sí Valores aceptados: EME2 000, ITRF2 000
REF_FRAME_EPOCH No No compatible* No es necesario porque los REF _ aceptados FRAMEs tienen una época implícita
TIME_SYSTEM Sí Sí Valor obligatorio: UTC
START_TIME Sí Sí
USEABLE_START_TIME No No
USEABLE_STOP_TIME No No
STOP_TIME Sí Sí
INTERPOLATION No Sí Necesario para AWS Ground Station poder generar ángulos de puntería precisos para los contactos.
INTERPOLATION_DEGREES No Sí Necesario para AWS Ground Station poder generar ángulos de puntería precisos para los contactos.
META_STOP Sí Sí
Datos X Sí Sí Representado en km
Y Sí Sí Representado en km
Z Sí Sí Representado en km
X_ DOT Sí Sí Representado en km/s
Y_ DOT Sí Sí Representado en km/s
Z_ DOT Sí Sí Representado en km/s
X_ DDOT No No Representado en km/s^2
Y_ DDOT No No Representado en km/s^2
Z_ DDOT No No Representado en km/s^2
Matriz de covarianzas COVARIANCE_START No No
EPOCH No No
COV_REF_FRAME No No
COVARIANCE_STOP No No

* Si en la información proporcionada AWS Ground Station se incluye alguna fila que no sea compatibleOEM, no se OEM podrá validar.

Las desviaciones importantes con respecto al CCSDS estándar AWS Ground Station son las siguientes:

  • CCSDSSe requiere VERS que OEM _ _ sea2.0.

  • REF_ FRAME debe ser uno de los dos EME2000ITRF2000.

  • REF_ FRAME _ no EPOCH es compatible con AWS Ground Station.

  • CENTER_ NAME debe serEarth.

  • TIME_ SYSTEM debe serUTC.

  • INTERPOLATIONy INTERPOLATION _ DEGREES son necesarios para AWS Ground Station CPE.

Ejemplo de OEM efemérides en formato KVN

A continuación se presenta un ejemplo truncado de una OEM efeméride en KVN formato para el satélite de radiodifusión pública -1. JPSS 


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

Crear una efeméride personalizada

Se puede crear una efeméride personalizada mediante la acción de CreateEphemeris. AWS Ground Station API Esta acción cargará una efeméride utilizando los datos del cuerpo de la solicitud o de un bucket de S3 específico.

Es importante tener en cuenta que al cargar una efeméride ésta se establece en VALIDATING e inicia un flujo de trabajo asíncrono que validará y generará contactos potenciales a partir de la efeméride. Solo se podrá utilizar para contactos cuando la efeméride haya superado este flujo de trabajo y esté ENABLED. Deberías sondear el estado de las efemérides o usar CloudWatch eventos DescribeEphemerispara hacer un seguimiento de los cambios de estado de las efemérides.

Para solucionar problemas relacionados con una efeméride no válida, consulta: Solución de problemas de efemérides no válidas

Ejemplo: cree un conjunto de efemérides de dos líneas () mediante TLE API

El AWS SDKs, y se CLI puede usar para cargar un conjunto de efemérides de dos líneas (TLE) mediante la llamada. AWS Ground Station CreateEphemeris Se utilizará esta efeméride en lugar de los datos de efemérides predeterminados para un satélite (consulte Datos de efemérides predeterminados). En este ejemplo se muestra cómo hacerlo con Python (Boto3).AWS SDK

Un TLE conjunto es un objeto JSON formateado que TLEs une uno o más para construir una trayectoria continua. Lo que está TLEs en el TLE conjunto debe formar un conjunto continuo que podamos usar para construir una trayectoria (es decir, sin intervalos de tiempo intermedios TLEs en un TLE conjunto). A continuación TLE se muestra un conjunto de ejemplos: 

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

Los intervalos de tiempo TLEs de un TLE conjunto deben coincidir exactamente para que sea una trayectoria continua y válida.

Se puede cargar un TLE conjunto a través del cliente AWS Ground Station boto3 de la siguiente manera: 

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

Esta llamada devolverá una ephemerisId que se puede utilizar para hacer referencia a las efemérides en el futuro. Por ejemplo, podemos usar la información proporcionada ephemerisId en la llamada anterior para sondear el estado de las efemérides: 

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

A continuación se muestra un ejemplo de la respuesta de la DescribeEphemerisacción 

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

Se recomienda sondear la DescribeEphemerisruta o utilizar CloudWatch eventos para rastrear el estado de las efemérides cargadas, ya que deben pasar por un flujo de trabajo de validación asíncrono antes de configurarse y poder utilizarse para ENABLED programar y ejecutar contactos.

Tenga en cuenta que el NORAD ID de todo el TLE conjunto, TLEs 25994 en los ejemplos anteriores, debe coincidir con el NORAD ID asignado a su satélite en la base de datos Space-Track.

Ejemplo: cargar datos de Ephemeris desde un bucket de S3

También es posible cargar un archivo de efemérides directamente desde un depósito de S3 apuntando al depósito y a la clave del objeto. AWS Ground Station recuperará el objeto en tu nombre. La información sobre el cifrado de datos en reposo AWS Ground Station se detalla en: Data Encryption At Rest For AWS Ground Station

A continuación se muestra un ejemplo de cómo cargar un archivo de OEM efemérides desde un bucket de S3 

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

A continuación se muestra un ejemplo de los datos devueltos por la DescribeEphemerisacción que se está realizando para las OEM efemérides subidas en el bloque anterior del código de ejemplo. 

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

Ejemplo: usar efemérides proporcionadas por el cliente con AWS Ground Station

Para obtener instrucciones más detalladas sobre el uso de efemérides proporcionadas por el cliente AWS Ground Station, consulte Uso de efemérides proporcionadas por el cliente con (y su repositorio asociado aws-samples/) AWS Ground Station GitHub aws-groundstation-cpe