orbit-tracker-utn

Repositorio para el código python de orbit-tracker-utn.

El orbit-tracker es un proceso que sirve para seguir en tiempo real (o diferido) la pasada de un satélite sobre una ubicación dada, para poder generar con eso un archivo de salida que sirva para mover una antena a lo largo de su trayectoria.

Instalación

Para usar orbit-tracker primero se deben instalar sus requerimientos:

1. (Opcional) Crear un ambiente virtual (venv) con `python -m venv {venv}` (lo puesto entre llaves puede ser cualquier nombre, acá usaremos venv.
    a. Iniciar el ambiente virtual: `source {venv}/bin/activate`
2. Instalar los requerimientos: `python -m pip install -r requirements.txt`

Uso

Orbit-tracker funciona con argumentos programados con argparse, por lo que para saber como usar qué se puede usar el comando python -m tracker --help. Aun así, el uso más básico es el siguiente:

    python -m tracker --satid SATID --lat LAT --long LONG --elev ELEV

En el cual se está ejecutando el tracker para seguir el satélite SATID (número del NORAD), y latitud, longitud y elevación de la locación desde donde se analiza. Por ejemplo, desde la sede de Lugano de la UTN FRBA (latitud -34.6591, longitud -58.4775, y elevación (aproximada) de 3 mts), para seguir el satélite SAOCOM 1B (ID 46265) se puede poner el siguiente comando:

    python -m tracker --satid 46265 --lat -34.6591 --long -58.4775 --elev 3

A lo cual el proceso se ejecutará, buscará la próxima pasada y comenzará a brindar información de la siguiente forma:

2026-05-11 18:05:17,118 - INFO - [*] Iniciando componentes de orbit-predictor.
2026-05-11 18:05:18,317 - INFO - [*] No se informó la pasada a seguir, se utilizará la próxima pasada a partir de 2026-05-11 18:05:18.317136-03:00
2026-05-11 18:05:18,318 - INFO - [*] Se recibieron los parámetros correctamente.
2026-05-11 18:05:18,318 - INFO -     Se va a perseguir el satélite 46265.
2026-05-11 18:05:18,318 - INFO -     Este se va a seguir desde 18:10:42 hasta 18:23:48 en 79 pasos de 10.0 segundos cada uno.
2026-05-11 18:05:18,318 - INFO - [*] Posición en el momento 2026-05-11 18:10:42.701955-03:00 de 46265: (4356.9, -5315.4, -1356.2)
2026-05-11 18:05:18,318 - INFO -  -  Azimuth y elevación de 46265 con respecto a loc: 
2026-05-11 18:05:18,319 - INFO -     Azimuth: 0.32921237572091044 rad | 18.8624796922833 deg 
2026-05-11 18:05:18,319 - INFO -     Elevación: 0.00025091467742677264 rad | 0.01437635203444054 deg
...

Donde se informará por cada salto de 10 segundos el azimuth y la elevación del momento dado.

Opciones adicionales.

A su vez, se pueden especificar otras opciones tales como:

• --dt: Cantidad de segundos entre cada paso.
• --aos y --los: Tiempo (en formato ISO) de una pasada especifica que se quiera seccionar en partes (útil para analizar pasadas anteriores y futuras).
• --min-elev: Si no se elige una pasada exacta, se puede solicitar la próxima pasada que tenga un mínimo de elevación en grados.
• --esperar: Si se quiere esperar a que el satélite comience a pasar para seguirlo.
• --real: Si se quiere procesar cada paso en tiempo real (esperando el dt indicado entre paso y paso).
• --diferido: Si se quiere procesar todo el recorrido directamente.
• --archivo y --formato: Para seleccionar un archivo de salida en un formato específico (en este momento solo funciona Easycomm-II).