Suite y Estación de Trabajo Integral para Astrofotografía de Paisaje, Cielo Profundo y Eventos Astronómicos
📖 Manual de Usuario • 📝 Registro de Cambios • 🤝 Contribuir • 🗺️ Hoja de Ruta
AstroLoom es una suite de posprocesado astronómico no destructivo diseñada específicamente para fotógrafos nocturnos, astrofotógrafos de paisaje (nightscapes), cazadores de eclipses y amantes de las circumpolares y panorámicas de gran campo.
Impulsada por una arquitectura híbrida que combina una interfaz gráfica reactiva en Python (PySide6) con un potente motor de cómputo nativo en Rust (astroloom_rs), AstroLoom ofrece máxima fidelidad matemática en coma flotante de 32 bits con renderizado a más de 160 FPS y un consumo mínimo de memoria RAM.
-
Renderizado Directo a Memoria Qt: Volcado en búfer contiguo plano
BGRA8888a >160 FPS (~6 ms en 4K), sin copias intermedias en Python ni recolección de basura (GC). -
Kernels Vectorizados SIMD & Rayon: Apilado Kappa-Sigma (
$2.77\times$ más rápido que Numba JIT), interpolación elástica TPS connalgebra, y modos de fusión de capas a máxima velocidad de CPU. - Calibración RAW In-Place: Calibración matemática pura pre-debayer directamente sobre la matriz de fotodiodos del RAW (0 bytes de memoria RAM adicional).
-
E/S y Códecs Nativos: Lectores/escritores nativos en Rust para FITS (<15 ms en 60 MP), PSD multicapa de 16 bits (sin dependencias de
pytoshop), e ingesta multihilo de cabeceras RAW.
| Módulo | Descripción y Capacidades Clave |
|---|---|
| 1. Apilador (Stacker) | Apilado dual cielo/suelo con alineación estelar subpíxel, corrección elástica TPS para gran angular, segmentación semántica de horizonte con IA (U²-Net) y rechazo Kappa-Sigma con relleno reflectivo BORDER_REFLECT. |
| 2. Revelador / Editor | Procesado no destructivo de 32 bits: Estirado Hiperbólico (GHS), separación de estrellas por IA (StarNet++ v2 DirectML), curvas tonales por capa, supresión de contaminación lumínica (RBF 2D y modelo elíptico), balance fotométrico Gaia (PCC) y paletas Dual-Band OSC. |
| 3. Eclipses (HDR) | Fusión HDR de series de bracketing solar/lunar con traspaso gradual anti-anillos. Arsenal coronal completo (Steerable G2, Larson-Sekanina, SWAP, WOW Bilateral, NAFE, NRGF, MGN) y exportación a PSD multicapa de 16 bits. |
| 4. Eclipses (Collage) | Montaje cronológico automatizado de fases sobre paisajes con trayectorias geométricas (diagonal, arco, romboide), espaciado regular y fusión transparente. |
| 5. Startrails | Circumpolares continuas o efecto cometa en streaming |
| 6. Lluvias de Meteoros | Detección algorítmica de bólidos, cribado en galería interactiva, filtros anti-aviones/satélites y reproyección al radiante celeste con flujo neto. |
| 7. Panorámicas (Mosaicos) | Cosido 2D multifila de ultra-alta resolución, alineación por asterismos en Rust (<2 ms), fusión híbrida Dual-Zone (árboles nítidos sin efecto fantasma) y auto-recorte rectangular |
- Purga Inteligente Anti-Satélites por Transformada de Hough (Startrails): Detección geométrica lineal rápida a escala 50% con evaluación monocanal de alta velocidad; suprime con precisión estelas de satélites artificiales y aviones en circumpolares preservando las trazas estelares naturales.
- Integración de Tecnologías Seti Astro en el Revelador: Estirado Estadístico Adaptativo (Statistical Stretch) basado en MAD, Claridad de Textura (Texture Clarity) para realce de micro-contraste en nebulosas y polvo galáctico, Extracción Automática de Fondo (ABE) mediante superficie polinomial 2D y modulación fotométrica de capas.
- Ondículas Multiescala (Wavelets B3-Spline): Panel de enfoque ampliado con descomposición frecuencial multiescala: deslizador de Estructura para enfatizar filamentos y estructuras medias sin levantar ruido, y Atenuar Fondo para profundizar los negros cósmicos.
- Pipeline de Exportación Zero-Copy en Rust e In-Place: Grafo de capas evaluado en registros nativos de CPU en Rust (
astroloom_rs), eliminando copias intermedias de memoria y volcando a enterosuint16in-place para una exportación ultrarrápida de proyectos.devloomy archivos PSD multicapa de 16 bits. - Barra de Progreso Unificada en Lienzo (
CanvasFooterBar): Estandarización ergonómica transversal en todos los visores y módulos (Revelador, Circumpolares, Meteoros, Panorámicas, Eclipses, Collage y Apilador), con seguimiento porcentual en tiempo real y cancelación reactiva inmediata. - Visor de Inspección Secuencial (Blink Viewer): Inspección rápida fotograma a fotograma de series temporales con ajuste de cadencia (FPS), zoom/pan sincronizado y descarte ágil de tomas con nubes o defectos.
- Discriminación de Balizas Aeronáuticas y Resalte Multitrazas (Meteoros): Detección inteligente de luces de navegación y balizas intermitentes para evitar falsos positivos, junto a previsualización global sincronizada de múltiples trazas sobre la imagen compuesta.
-
Máscara de Enfoque y Nitidez (Sharpening / USM): Nuevo motor de microcontraste y altas frecuencias espaciales en el Revelador con controles de Cantidad, Radio, Detalle y Máscara de bordes estilo Lightroom, incluyendo previsualización monocroma interactiva (
Alt-drag) y restricción por ámbito (Solo Suelo,Cielo sin EstrellasoGlobal). - Purga Integral de Numba y Unificación en Rust Rayon: Eliminación definitiva de dependencias LLVM/Numba con reducción neta de 2.36 s en el arranque en frío, LUT display mapping a >4.000 FPS en Rust y cálculo de histograma multihilo en OpenCV C++.
-
Aceleración Nativa en Rust para Eclipses: Centrado de disco solar (
center_solar_disc_rs), estirado Asinh Luma preservando color y fusión coronal HDR adaptativa multiescala en paralelo. -
Resiliencia de Hardware y Caché de Búferes LRU: Fallback en caliente GPU
$\rightarrow$ CPU ante saturación de VRAM, caché persistente de grafos ONNX y presupuesto estricto de memoria RAM en el pipeline para evitar fugas al procesar archivos 4K/8K. - Cabecera de Telemetría y Supresión de Barra de Estado: Monitor de RAM en tiempo real (% y GB), alerta de degradación de hardware y acceso al Registro de Actividad ubicados directamente en la esquina superior de pestañas, ganando valiosa superficie vertical de lienzo.
- Galería Visual de Presets: Panel rediseñado por tarjetas interactivas y guardado seguro que excluye máscaras locales de usuario para prevenir colisiones.
AstroLoom integra un sistema integral de composición profesional no destructiva con capas ráster y de ajuste:
- Máscaras Vectoriales Analíticas en Rust: Filtros de Gradiente Lineal (polución lumínica, viñeteo) y Gradiente Radial / Elíptico (centro galáctico, nebulosas) con gizmos interactivos directos sobre el lienzo a 60 FPS y restricción espacial automática a Cielo o Suelo (Edge-Snapping).
-
Pincel Acelerado en Rust y Dirty-Rects a 60–144 FPS (v0.15.1): Estampado continuo interpolado mediante
stamp_brush_stroke_rsy actualización selectiva in-place por rectángulos sucios (dirty rects) en el lienzo, eliminando lag y tirones de GPU/CPU al pintar sobre imágenes de alta resolución. -
Curvas Selectivas Hue/Luma Fusionadas en Rust (v0.15.1): Evaluación en registros paralelos (
apply_hue_luma_curves_fused_rs) más de$10\times$ más rápida al prescindir de conversiones de color intermedias. - Transformación Espacial 2D de Capas Ráster: Desplazamiento interactivo en el lienzo, escalado (con rueda de ratón o parámetros numéricos) y rotación libre para capas ráster importadas.
- Miniaturas Duales Estilo Pro: Edición independiente de la imagen o de su máscara con un solo clic.
- Gestor Avanzado de Presets: Modulación continua de intensidad (0% a 150%), previsualización en tiempo real y detección automática de dependencias (StarNet++ y máscara de horizonte).
- Reducción de Ruido IA Multiescala: NAFNet optimizado con descomposición de croma en dos escalas (1.0x luminancia, 0.5x color YCrCb), pre-estirado analítico MTF invertible para preservar fotometría lineal y caché de sesiones ONNX.
- Modos de Fusión Profesionales y Exportación PSD: Normal, Trama (Screen), Luminosidad, Luz Suave, Superponer y Multiplicar en Rust Rayon; exportación completa a PSD de 16 bits preservando transformaciones espaciales y máscaras.
- En Windows: Haz doble clic en
astroloom.baten la carpeta principal del proyecto (detectará tu entorno virtual Python o la instalación del sistema y lanzará la interfaz sin consolas secundarias). - En Linux / macOS: Ejecuta
./astroloom.shdesde la terminal.
-
Clonar el Repositorio:
git clone https://github.com/shilmar/AstroLoom.git cd AstroLoom -
Instalar Dependencias de Python:
pip install -r requirements.txt
-
Compilar el Motor Nativo Rust (Recomendado para Máximo Rendimiento):
pip install maturin cd astroloom_rs maturin develop --release cd ..
(Si no se compila el módulo nativo, AstroLoom activará automáticamente su modo de reserva transparente en Python/NumPy sin interrumpir el funcionamiento).
-
Aceleración por GPU (Opcional - NVIDIA CUDA):
# Para CUDA 12.x: pip install cupy-cuda12x -
Iniciar la Aplicación:
python run_app.py
flowchart LR
A["1. Captura RAW"] --> B["2. Apilador (Cielo/Suelo)"]
B --> C["3. Revelador (GHS + StarNet AI)"]
C --> D["4. Capas y Curvas Tonales"]
D --> E["5. Exportar (TIFF 16/32-bit o PSD)"]
📖 Para una guía detallada paso a paso de cada módulo, parámetros y atajos de teclado, consulta el Manual de Usuario Oficial.
AstroLoom/
├── astroloom_rs/ # Núcleo nativo de alto rendimiento en Rust (PyO3 + Rayon + SIMD)
│ ├── src/ # Kernels de apilado, RBF, blend modes, deconv, FITS, PSD...
│ └── Cargo.toml # Configuración del paquete nativo
├── core/ # Lógica astronómica en Python (calibración, AI, máscaras, PCC...)
├── gui/ # Interfaz gráfica moderna en PySide6 (Qt)
│ ├── developer/ # Pipeline de renderizado y estado del revelador
│ ├── widgets/ # Lienzo interactivo, gestor de capas, curvas, histograma...
│ └── tab_*.py # Pestañas de Apilador, Revelador, Eclipses, Startrails, Panos...
├── locales/ # Soporte multilingüe (español e inglés)
├── MANUAL_DE_USUARIO.md # Guía detallada y completa para usuarios
├── CHANGELOG.md # Historial de versiones y cambios
└── run_app.py # Punto de entrada de la aplicación
Las contribuciones son bienvenidas. Si deseas colaborar:
- Revisa nuestra Guía de Contribución.
- Cumple con el Código de Conducta.
- Asegúrate de que las pruebas automatizadas pasen (
pytest).
AstroLoom integra ideas y algoritmos inspirados en investigaciones pioneras de la comunidad astrofotográfica y científica:
- Agentic-Eclipse-Library por Pere Guerra (PeterWar): Algoritmos de fusión coronal HDR, normalización y filtrado de eclipses solares.
- StarNet++ por Nikita Misiura: Red neuronal pionera para el desacoplo de estrellas.
- Miloslav Druckmüller: Fundamentos matemáticos de filtrado multiescala (MGN) y ecualización adaptativa difusa (NAFE).
Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.