Siril Astro Processing

Herramientas reproducibles para procesar imágenes astronómicas con Siril desde Windows, automatizar ejecuciones y conservar la trazabilidad de cada integración. El código común vive en este repositorio; las imágenes, configuraciones de cada objeto y resultados permanecen normalmente en espacios de trabajo externos. La única excepción es un conjunto de cinco tomas FITS saneadas y licenciadas que permite comprobar el recorrido completo sin aportar datos propios.

Estado

La versión pública v0.1.1 contiene el núcleo Python, las rutas portables, los manifiestos, el gestor Windows/WSL, el ejemplo reproducible de cinco tomas y la entrega FITS compatible con el orden de filas de PixInsight.

Qué resuelve

• configura cada conjunto de datos mediante JSON;
• genera y, opcionalmente, ejecuta scripts de Siril;
• permite reutilizar secuencias registradas y volver a integrar una selección;
• genera informes HTML de calidad;
• registra en cada ejecución la versión de la herramienta y la huella SHA-256 de las configuraciones usadas;
• incluye la base del puente de Astrometry.net en WSL2 para Siril en Windows.
• instala, diagnostica y retira el puente mediante siril-astro bridge sin distribuir binarios de Windows.
• prepara copias FITS compatibles con el orden de filas esperado por PixInsight.

No se incluyen resultados astronómicos, rutas personales, ajustes globales de Siril ni archivos de trabajo privados. Las cinco tomas de ejemplo de la Cadena de Markarian son una excepción revisada: no contienen ubicación ni identificador del telescopio y tienen licencia propia CC BY 4.0.

Instalación del núcleo

Requiere Python 3.11 o posterior y una instalación de Siril accesible desde Windows.

py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install .
siril-astro --version

Configuración portable

Las rutas relativas de un conjunto de datos con schema_version: 1 se resuelven desde la carpeta que contiene su JSON, no desde la carpeta desde la que se lance el comando:

{
  "schema_version": 1,
  "dataset_id": "mi-objeto-2026",
  "object_id": "mi-objeto",
  "name": "Mi objeto",
  "lights_dir": "../data/lights",
  "work_root": "../workspace",
  "output_root": "../outputs"
}

Una preparación sin lanzar Siril:

siril-astro run --dataset C:\astro\mi-trabajo\configs\dataset.json `
  --pipeline C:\astro\siril-astro-processing\configs\pipelines\lights_only_register_stack.json

Añade --execute para ejecutar Siril. Se puede indicar su ubicación con --siril C:\ruta\a\siril-cli.exe; si se omite, se busca en PATH y en las ubicaciones habituales de Windows. Las rutas del JSON también pueden sustituirse con --lights-dir, --work-root y --output-root.

Consulta la instalación en Windows y la guía de problemas frecuentes antes de probar el puente de Astrometry.net.

La secuencia recomendada para el puente es:

siril-astro bridge setup --distro Ubuntu
siril-astro bridge doctor

Ejemplo reproducible incluido

Después de completar el diagnóstico del puente, usa el ejemplo de cinco tomas de la Cadena de Markarian. La guía separa una preparación inspeccionable de la ejecución real, escribe todos los resultados fuera del checkout y explica cómo sustituir las tomas por datos propios.

Los procesos que contienen -localasnet generan después un INI de Siril dentro de su propia carpeta de ejecución. No se modifica el perfil global de Siril.

Entrega a PixInsight

PixInsight puede mostrar invertido verticalmente un FITS generado por Siril si la cabecera no declara el orden de sus filas. Prepara una copia independiente antes de abrir la integración en PixInsight:

siril-astro prepare-pixinsight-fits C:\astro\integracion.fit

El resultado predeterminado se llama integracion_pixinsight.fit y declara ROWORDER='BOTTOM-UP'. La operación no gira ni reproyecta la imagen: conserva los bytes de imagen y el WCS, no modifica el FITS de origen y elimina CHECKSUM/DATASUM obsoletos de la copia porque la cabecera ha cambiado. Usa siril-astro prepare-pixinsight-fits --help para indicar otro destino, procesar varios archivos o reemplazar conscientemente una copia existente. El destino se reemplaza solo después de completar la nueva copia, por lo que un fallo no deja un FITS parcial ni destruye una salida anterior.

Procedencia y licencia

El puente WSL2 se inspira y adapta ideas de luzbel/fake-ansvr-in-wsl2-for-nina, publicado bajo GPL-2.0. La atribución detallada se conserva en CREDITS.md y en la propia carpeta del puente.

El código y la documentación del repositorio se distribuyen bajo GPL-2.0-only. Las cinco imágenes FITS de ejemplo se distribuyen por separado bajo CC BY 4.0; consulta su README y REUSE.toml para la atribución exacta.