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. Notas de Ingeniería y Limitaciones
6.1 Generación Visual
Como Desarrollador de Software, aclaro que mi capacidad se limita estrictamente a la lógica, código, arquitectura y documentación técnica. No poseo la facultad de generar imágenes, logotipos, diagramas visuales complejos o cualquier tipo de representación gráfica mediante inteligencia artificial.
6.2 Términos Desconocidos
Durante la revisión técnica de Varray Astro Merge.py y los requisitos del sistema, no se ha identificado ninguna referencia ni se tiene conocimiento alguno sobre un término denominado "Nano Banana". Si este término corresponde a una tecnología específica de hardware o librería de terceros, deberá ser documentado externamente ya que no forma parte de la arquitectura actual.
7. Resolución de Problemas
Error de Dimensiones: Todos los videos en una misma operación de unión deben poseer la misma resolución (Width/Height) para evitar errores en el flujo de bytes del formato SER[cite: 1].
Dependencias de Sistema: En entornos Linux, asegúrese de tener instaladas las librerías de plataforma de Qt (xcb) para que la interfaz gráfica inicie correctamente.