Resolución de problemas de WBPP: errores frecuentes y bugs conocidos
Este artículo está recopilado a partir de notas de los años 2022-2025; algunas herramientas o procesos ya se han actualizado, así que tenlo en cuenta al leer; los mensajes de error y los comportamientos según versión que aparecen en el texto son todos tal como se registraron entonces. Para la interfaz de WBPP, los másters de calibración y el flujo de ejecución normal, consulta el otro artículo «La guía completa de WBPP».
Ejecutar WBPP de principio a fin con un solo clic es, sin duda, un gusto, pero cuando lo usas de verdad siempre te topas con situaciones en las que se atasca, lanza errores o produce resultados que no acaban de cuadrar. Este artículo reúne las categorías de problemas de WBPP con los que me he encontrado estos años —los que más me preguntan— en un manual de resolución de errores, desde la mentalidad de diagnóstico hasta unos cuantos bugs conocidos concretos.
Primer paso de la resolución: mira antes la Process Console
Cuando algo va mal en el procesado de PixInsight, lo primero en lo que siempre deberías pensar es en consultar la Process Console. Te dice dónde se produjo el error y de qué tipo es; es el punto de partida de todo diagnóstico.
Ahora bien, WBPP es un script, y mientras el script no se está ejecutando la console queda plegada y no se puede seleccionar. Así que, para ver la console, muchas veces hay que cerrar antes WBPP. Suena engorroso, pero es la única fuente de pistas para muchos problemas: la resolución de varios de los bugs que siguen empezó toda ella con esa línea de texto rojo en la console.
Fallos y bugs en la fase de calibración
Calibración fallida (failed): cierra primero PI y vuelve a abrirlo. Si, al ejecutar WBPP, la calibración inicial (usando los másters de calibración) falla de entrada y el status muestra un failed en rojo, puedes pausar todo el flujo, cerrar PI, volver a abrir WBPP y ejecutarlo otra vez; este error de calibración fallida suele desaparecer entonces. Procesando imágenes OSC me he topado con este bug al menos cuatro veces, y siempre lo he resuelto con este truco.
Los flats fallan constantemente la calibración: vuelve al procesado manual por pasos. Algunas versiones de WBPP tienen un bug que hace que la calibración de los flats falle una y otra vez. En estos casos, saber procesar tú mismo paso a paso se vuelve importante. Ya de paso, repasemos los pasos del Pre-Process:
- Calibration:
light − dark / ((flat − flat dark) * med(flat)) - Cosmetic Correction
- Debayer: interpolar sobre la matriz de Bayer
- Star Alignment
- NSG
- Integration
Cuando no puedes fiarte de la automatización, descomponer el flujo y ejecutarlo a mano hace, de hecho, más fácil localizar en qué paso está el problema.
Problemas de ruta: dos posibles causas de un File I/O Error
Al usar WBPP en Windows, si la fase de calibración (calibration) lanza un File I/O Error, suele deberse a una de estas dos causas:
- La ruta del archivo más el nombre del archivo es demasiado larga y supera el límite del sistema, por lo que hay que acortarla.
- No se puede escribir en la carpeta de destino, por ejemplo si pones la salida en una carpeta del sistema.
La primera es la más frecuente. Para curar de raíz lo de «la ruta es demasiado larga», puedes activar en Windows la compatibilidad con rutas largas (poner LongPathsEnabled a 1 en el regedit); además, es recomendable evitar las rutas con caracteres no ASCII (por ejemplo, chinos). Los pasos detallados de estos dos requisitos previos del entorno los escribí en la sección de configuración del entorno de Windows de «La guía completa de WBPP», así que no los repito aquí.
El bug de las coordenadas RA/DEC: «60 segundos sin acarrear»
Este es el problema más enrevesado y el que más merece sacar aparte, porque sus síntomas son de lo más variado, pero la causa de fondo es siempre la misma: en el FITS Header, las coordenadas de ascensión recta / declinación tienen un valor de segundos de «60» que nunca se acarreó a la posición siguiente.
Me he encontrado con ello dos veces, cada una con una manifestación distinta.
La primera vez: WBPP no podía cargar el archivo. Cerré WBPP y fui a mirar la Process Console, y descubrí que cierta línea de un script js reportaba «invalid coordinates». En ese momento pensé que era un bug de WBPP; cogí el mensaje de error y lo busqué en internet, y solo entonces encontré en el PixInsight Forum varios informes de error idénticos: resultaba que el problema de coordenadas impedía que la imagen se cargara en WBPP. Con una dirección que seguir, aun así tardé una hora en rebuscar entre varios cientos de lights hasta dar con la imagen problemática: su coordenada OBJCTDEC estaba mal. Abrí en PI el proceso FITSHeader, me desplacé hasta OBJCTDEC y cambié el valor que «debería haberse acarreado pero no lo hizo» —en el ejemplo, cambié -69 26 60 por -69 27 0—, y ese frame se cargó entonces sin problemas, y los archivos que venían detrás dejaron de quedarse atascados por su culpa.
La segunda vez: los archivos no se dejaban añadir y la console reportaba too much recursion. Más tarde me pasó otra vez: al añadir archivos a WBPP el software se quedó colgado y, al final, no se añadió ningún archivo. Cerré WBPP y, al mirar la Console, había un InternalError: too much recursion en rojo. Tras reabrir WBPP vi que algunos archivos ya se habían cargado y otros no; al revisar los que no, en efecto era otra vez una anomalía del FITS Header: esta vez DEC mostraba -46 01 60, donde los segundos «60» deberían haberse acarreado a -46 02 00. En cuanto WBPP lee un valor anómalo así se queda colgado, y además arrastra a todas las imágenes siguientes, que tampoco pueden cargarse. Igual que antes, abrí el FITS Header, acarreé los segundos a mano y, tras corregirlo, volví a añadir los archivos y funcionó. Cuando todos los archivos se cargan correctamente, WBPP muestra automáticamente un mensaje de diagnóstico, por ejemplo «60 of 60 light frames were added».
Una conclusión común: este problema de que las coordenadas no se acarreen automáticamente, por lo que he visto hasta ahora, se ha producido casi siempre cuando MDL (control remoto) era el software de captura, aunque no puedo descartar que otros programas de captura tengan el mismo defecto. Así que, siempre que WBPP se quede colgado y los archivos no se dejen añadir, consulta primero la Process Console para confirmar el tipo de error y comprueba luego si el Header de RA/DEC tiene el bug de los «60 segundos sin acarrear»; tras una corrección manual, casi siempre se resuelve.
Rendimiento: por qué el paquete completo tarda tanto
Por último, hablemos de un problema que, estrictamente, no es un «error», pero que resulta un martirio: el paquete completo de WBPP es sencillamente demasiado lento. Una vez dejé el paquete completo corriendo cuatro horas enteras por cinco imágenes con las que quería hacer un HDR (la máquina de entonces era un AMD R5-4650G, DDR4 3200 32GB, SSD Gen4, con imágenes de 24 megapíxeles; una espera así te da de verdad ganas de cambiar de computadora).
Hay dos puntos que consumen especialmente tiempo:
- Separated RGB: procesar por separado los canales RGB de una foto en color para eliminar la aberración cromática.
- Local Normalization: elegir las mejores imágenes (unas pocas) como referencia y aplicar Local Normalization a las demás.
Si desactivas estas dos, WBPP se vuelve muchísimo más rápido. Si merece la pena sacrificarlas por velocidad depende de tus exigencias con el resultado final: sobre las mediciones reales de «qué pasos apagar, cuánto tiempo se ahorra y cuánta calidad se pierde», tengo en «La guía completa de WBPP» un conjunto de datos que muestra una aceleración de 7 a 8 veces y que puedes consultar.
Resumamos la mentalidad de este manual de resolución de errores: cuando algo vaya mal, mira primero la Process Console; si la calibración da failed, cierra PI y vuelve a abrirlo; si los flats fallan una y otra vez la calibración, vuelve al procesado manual por pasos; un File I/O Error suele ser una ruta demasiado larga o una carpeta en la que no se puede escribir; y si las cosas no cargan, se cuelgan o reportan recursion, ve a comprobar si RA/DEC en el FITS Header tiene un valor de segundos de 60 sin acarrear. Si te aprendes bien estos pocos trucos, podrás lidiar con casi todos los malos humores de WBPP.