Manual Varray Astro Merge

# Manual Técnico y de Operación: AstroMerge & Convert Pro

1. Introducción y Propósito

AstroMerge & Convert Pro es una herramienta de ingeniería de software diseñada para el procesamiento de flujos de video astronómico. Su función principal es la ingesta de archivos de video estándar (.mp4, .avi) para su consolidación y conversión al formato científico SER (Standardized Efficient Record)[cite: 1]. Este formato es el estándar para astrofotografía debido a su capacidad de almacenar datos en bruto (RAW) y metadatos integrados necesarios para el post-procesamiento.

2. Arquitectura del Software

La aplicación Varray Astro Merge.py está construida bajo una arquitectura de Separación de Preocupaciones (SoC) utilizando los siguientes componentes:

Frontend: Desarrollado con PySide6, proporcionando una interfaz gráfica (GUI) reactiva y basada en eventos[cite: 1].
Motor de Procesamiento (VideoWorker): Implementado mediante QThread para garantizar operaciones asíncronas y no bloqueantes de la UI[cite: 1].
Gestión de Datos: El motor utiliza OpenCV para la decodificación de cuadros y manipulación de matrices de píxeles (numpy)[cite: 1].
Flujo de Memoria: La aplicación procesa los datos frame a frame, lo que permite manejar archivos de gran tamaño sin saturar la memoria RAM disponible[cite: 1].

3. Especificaciones del Formato SER

La aplicación implementa una escritura manual del encabezado binario (header) de 178 bytes para cumplir con la especificación técnica del formato SER[cite: 1]. Los parámetros configurados en el archivo Varray Astro Merge.py son:

FileID: LUCAM-RECORDER[cite: 1].
ColorID: 0 (Configurado como Mono para uso astronómico estándar)[cite: 1].
Endianness: 1 (Little Endian)[cite: 1].
Profundidad de Píxel: 8 bits[cite: 1].
Metadatos de Resolución: El ancho y alto de imagen se extraen dinámicamente del video de origen[cite: 1].
Conteo de Frames: Se actualiza en el offset 38 del archivo binario una vez finalizado el proceso de unión o conversión[cite: 1].

4. Requisitos del Entorno

Para ejecutar o compilar el código fuente, se requiere el siguiente stack tecnológico:

Intérprete: Python 3.10 o superior.
Librerías: PySide6, opencv-python (cv2) y numpy[cite: 1].
Instalación: pip install PySide6 opencv-python numpy.

5. Manual de Operación

5.1 Modos de Procesamiento

La herramienta ofrece tres modos lógicos de operación seleccionables desde la interfaz[cite: 1]:

Unir y Convertir a SER: Consolida múltiples videos en un único archivo científico .ser con conversión automática a escala de grises[cite: 1].
Solo Unir (Mismo formato): Unión de videos manteniendo el contenedor original mediante el códec XVID[cite: 1].
Convertir individualmente a SER: Transformación de formato de archivos individuales a .ser sin concatenación.

5.2 Flujo de Trabajo

1. Carga de Archivos: Utilice el botón "Añadir Videos" para seleccionar los archivos de origen (.mp4 o .avi)[cite: 1].
2. Configuración: Seleccione el modo de acción deseado en el menú desplegable superior[cite: 1].
3. Destino: Al pulsar "EJECUTAR PROCESAMIENTO", defina la ruta y nombre del archivo de salida[cite: 1].
4. Procesamiento: El sistema iniciará la ejecución asíncrona; el estado se reflejará en la barra de progreso y en las etiquetas de texto en tiempo real[cite: 1].

6 Módulo de Reducción de Ruido (Denoise)

Este módulo está dedicado al post-procesamiento de imágenes fijas (formato H-alpha), permitiendo una limpieza efectiva de la señal sin degradar la información estructural solar.

Algoritmo de Variación Total (TV Chambolle): Utiliza la minimización de la variación total de Chambolle (skimage.restoration.denoise_tv_chambolle). Este método es superior a los filtros de desenfoque gaussianos estándar, ya que elimina el ruido de fondo manteniendo la integridad de los bordes (necesario para definir los filamentos solares).

Control de Parámetros: La interfaz incluye un QSlider que permite ajustar la intensidad (weight) del filtro. El rango operativo es de 0.001 a 0.050. Este control permite un ajuste preciso: valores bajos preservan el detalle fino, mientras que valores altos suavizan texturas de fondo más densas.

Vista Previa en Tiempo Real: El sistema genera una previsualización de 400x300 píxeles cada vez que se mueve el slider, permitiendo validar el impacto del filtro antes de aplicar el proceso a la imagen en resolución completa.

6.1 Procesamiento de Imágenes (Denoise)

1. Selección de archivo: En la pestaña "Noise Exterminator", seleccione la imagen H-alpha de origen. El sistema la cargará en memoria para su análisis.

2. Ajuste de Intensidad: Deslice la barra de "Dureza Denoise". Observe la vista previa en la interfaz para encontrar el punto donde el ruido de fondo se reduce sin que el filamento solar pierda contraste o nitidez.

3. Procesado y Guardado: Pulse el botón de acción final. Se abrirá un selector de archivos donde podrá elegir entre guardar el resultado en formato .png o .tif. El sistema aplicará el algoritmo a la resolución original del archivo y exportará la matriz resultante tras el filtrado.

6.3 Notas de Troubleshooting para Denoise

Imagen demasiado plana: Si tras aplicar el filtro los filamentos pierden definición (efecto "acuarela"), significa que el valor del slider es demasiado alto. Reduzca el valor para recuperar detalle.

• Error de memoria: Si la imagen de origen es extremadamente grande (varios cientos de megapíxeles), asegúrese de tener suficiente memoria RAM, ya que el cálculo de denoise_tv_chambolle es computacionalmente intensivo durante la fase de conversión a float32.