RadProc WEB — Procesador espectral de agua y suelo
Guía rápida de usuario — Versión 0.3.2
1. Propósito y alcance
RadProc WEB es una herramienta desarrollada por la Comisión Nacional de Actividades Espaciales (CONAE) para el procesamiento espectral de mediciones radiométricas obtenidas con radiómetros de campo.
El sistema permite realizar el procesamiento de datos espectrales de agua y suelo desde una interfaz web unificada, incorporando herramientas de validación, configuración dinámica, visualización de resultados y trazabilidad de ejecución.
La aplicación automatiza tareas de conversión de radiancia a reflectancia, aplica controles de coherencia sobre las configuraciones del usuario y genera productos listos para etapas posteriores de análisis.
2. Flujo general de operación
El flujo recomendado de trabajo dentro de RadProc WEB sigue una secuencia diseñada para minimizar errores y garantizar la coherencia del procesamiento.
- Seleccionar el tipo de datos: Agua o Suelo.
- Ingresar al panel de Configuraciones para revisar o ajustar parámetros técnicos.
- Cargar el archivo ZIP con las mediciones de campo.
- Ejecutar la herramienta “Validar set de datos” antes de procesar.
- Si corresponde, adjuntar un archivo Spectralon personalizado.
- Presionar “Procesar y descargar”.
- Explorar los resultados desde el visor de resultados.
Por políticas de seguridad del navegador, si se carga un archivo ZIP y luego se navega al panel de configuraciones, el archivo deberá cargarse nuevamente.
- Primero seleccionar el tipo de datos.
- Luego revisar las configuraciones.
- Finalmente cargar el ZIP y ejecutar.
3. Interfaz principal
La interfaz principal concentra todos los controles necesarios para ejecutar una corrida completa.
- Selector de tipo de datos: permite trabajar con mediciones de agua o suelo.
- Carga de ZIP: recibe las mediciones radiométricas obtenidas en campo.
- Validar set de datos: ejecuta una validación preventiva del dataset antes del procesamiento.
- Archivo Spectralon: permite utilizar una referencia alternativa durante la sesión.
- Procesar y descargar: inicia el pipeline de procesamiento y genera el ZIP final.
- Área de mensajes: muestra advertencias, validaciones y resultados de cada ejecución.
- Visor de resultados: permite visualizar la última corrida procesada y también ZIPs de resultados generados previamente por la aplicación.
- Botones auxiliares: permiten limpiar sesión, abrir configuraciones, alternar modo visual y acceder a esta guía.
4. Selección del tipo de datos a procesar
Antes de acceder a cualquier configuración o procesamiento, el usuario debe indicar si trabajará con datos de agua o de suelo.
Esta selección determina:
- las reglas de validación,
- las configuraciones disponibles,
- el contexto operativo de la sesión.
Sin una selección válida, el panel de configuraciones permanecerá bloqueado.
5. Configuraciones de procesamiento
El panel de configuraciones permite ajustar temporalmente parámetros técnicos utilizados durante el procesamiento.
Estas configuraciones afectan únicamente la sesión actual.
5.1 Parámetro spectrum
Define la cantidad de espectros individuales que conforman una unidad muestral.
Si el valor configurado no coincide con la estructura real del dataset, el sistema interrumpirá el procesamiento.
5.2 Parámetro meas_order
Define el orden de adquisición de las mediciones dentro de cada bloque espectral.
Este orden es utilizado para asociar correctamente:
- cielo,
- Spectralon,
- target.
5.3 Parámetro target_list
Define la lista de identificadores utilizados para las unidades muestrales.
Estos nombres se utilizan para organizar e identificar los productos generados.
5.4 Incorporación de coordenadas GPS
La interfaz permite asociar coordenadas GPS a las mediciones configuradas, siempre que la corrida requiera registrar puntos geográficos.
La cantidad de puntos disponibles dependerá de la configuración de
target_list.
Cuando se incorporan puntos GPS, la información queda incluida en los archivos de salida de la corrida.
5.5 Consideraciones generales
- Las configuraciones se aplican únicamente durante la sesión activa.
- Configuraciones inconsistentes impedirán el procesamiento.
- La opción “Limpiar” restablece los valores por defecto.
6. Validación previa de datasets
RadProc WEB incorpora una herramienta independiente de validación preventiva.
Esta funcionalidad permite verificar la coherencia estructural del dataset antes de ejecutar el procesamiento principal.
6.1 ¿Qué valida el sistema?
- Estructura del archivo ZIP.
- Carpetas esperadas.
- Archivos
.txt. - Archivos vacíos.
- Problemas de codificación.
- Datasets corruptos.
- Datos numéricos inválidos.
6.2 Resultado de validación
El sistema informa:
- errores críticos,
- advertencias,
- estado general del dataset.
7. Archivo Spectralon (referencia)
El archivo Spectralon se utiliza como referencia para el cálculo de reflectancias.
El sistema permite:
- usar el archivo institucional por defecto,
- cargar un Spectralon temporal,
- editar parámetros temporalmente.
Las modificaciones no se almacenan permanentemente.
8. Estructura de datos recomendada
Los datasets deben respetar una estructura estandarizada.
8.1 Mediciones de agua
123-20240513-SUS/
Radiometría/
Texto Rad CorrPar/
*.txt
8.2 Mediciones de suelo
183-20220816-SG/
Radiometría/
Texto Rad CorrPar/
*.txt
Se recomienda no modificar los nombres originales ni agregar archivos ajenos al protocolo de adquisición.
9. Procesamiento, resultados y registro
Al ejecutar una corrida, el sistema:
- valida dataset y configuraciones,
- ejecuta el procesamiento espectral,
- genera productos científicos,
- construye metadata y logs de ejecución.
El resultado final se entrega como un archivo ZIP autocontenido.
9.1 Registro técnico y trazabilidad
Cada corrida genera archivos de registro y metadata asociados al procesamiento.
metadata.json: metadata general de la corrida.processing.log: registro técnico de ejecución.
Estos archivos permiten reconstruir las condiciones de ejecución, mantener la trazabilidad del procesamiento y conservar información contextual asociada a la corrida.
Cuando la corrida incorpora puntos GPS, el ZIP de resultados incluye
además una carpeta puntos_gps/ con la información exportada
en distintos formatos.
-
gps_points.json: listado estructurado de puntos GPS. -
gps_points.csv: tabla compatible con planillas de cálculo. -
gps_points.geojson: formato geoespacial compatible con visores GIS.
La carpeta puntos_gps/ solo se genera cuando la corrida
incorpora coordenadas GPS durante la configuración.
10. Visor de resultados
RadProc WEB incorpora un visor desacoplado del procesamiento principal.
Esta herramienta permite consultar resultados procesados previamente por la aplicación sin volver a ejecutar el procesamiento.
10.1 Funcionalidades principales
- visualización de la última corrida procesada,
- carga manual de ZIPs de resultados generados previamente,
- organización automática de productos por target detectado,
- visualización de productos gráficos y archivos TXT,
- lectura automática de metadata y registros asociados.
10.2 Carga de ZIPs de resultados
El usuario puede cargar manualmente ZIPs de resultados generados previamente por RadProc WEB.
El sistema verificará automáticamente:
- estructura válida del ZIP,
- presencia de productos compatibles,
- archivos reconocidos por el visor.
Si el ZIP cargado no corresponde a resultados compatibles, el visor mostrará un mensaje de advertencia y no intentará renderizar el contenido.
10.3 Alcance del visor
El visor está orientado a la consulta visual de productos ya generados.
No modifica los archivos cargados, no reprocesa datasets originales y no genera nuevos productos.
11. Resultados y productos generados
Cada corrida genera productos numéricos, gráficos y metadata asociada. Estos elementos se entregan en un ZIP de resultados que debe conservarse completo para mantener la trazabilidad de la corrida.
11.1 Productos científicos generados
- Reflectancia promedio.
- Radiancia promedio.
- Reflectancia agua.
- Archivos de error o dispersión.
- Gráficos PNG asociados a los productos.
11.2 Archivos incluidos en el ZIP
.txt: productos numéricos y archivos de salida..png: gráficos generados por el procesamiento.metadata.json: metadata general de la corrida.processing.log: registro técnico de ejecución.-
puntos_gps/: carpeta opcional generada únicamente cuando la corrida incorpora coordenadas GPS.
Cuando existen puntos GPS, la carpeta puntos_gps/ puede
incluir archivos en formato .json, .csv y
.geojson.
Se recomienda conservar el ZIP completo sin modificar su estructura interna para asegurar la trazabilidad y compatibilidad con el visor de resultados.
12. Errores comunes y recomendaciones
- No se seleccionó tipo de datos: debe elegirse Agua o Suelo antes de continuar.
- ZIP inválido: el sistema rechazará archivos incompatibles o corruptos.
- ZIP de resultados no compatible: el visor solo puede mostrar resultados generados previamente por RadProc WEB.
- Configuraciones incoherentes: la corrida será interrumpida automáticamente.
- Spectralon inválido: utilizar un archivo compatible o el institucional.
- Pérdida del archivo al cambiar de vista: volver a cargar el ZIP antes de ejecutar.
13. Contacto y soporte técnico
Ante dudas o inconvenientes, puede comunicarse con el equipo de desarrollo: