rotEngine: Portal de Documentación Científica y Técnica
Bienvenido al Portal de Documentación de rotEngine, la plataforma de generación sintética de estímulos calibrados y patrones de prueba para la evaluación y validación metrológica de la calidad de imagen (ImageQA).
rotEngine centraliza el conocimiento metrológico, los fundamentos matemáticos y físicos, el inventario exhaustivo de parámetros de configuración y los esquemas de datos para los 7 generadores sintéticos integrados en la suite.
1. Arquitectura y Mapa General de la Suite
Cada módulo opera como un generador de estímulos sintéticos desacoplado y determinista con verdades fundamentales analíticas (ground truth), evitando la validación circular frente a los algoritmos de detección y análisis de ImageQA:
graph TD
App["Plataforma Unificada rotEngine"] --> M1["Resolución Espacial y MTF<br/>slanted-edge"]
App --> M2["Colorimetría y Gamut<br/>color"]
App --> M3["Uniformidad y Shading<br/>uniformity"]
App --> M4["Óptica y Distorsión de Lente<br/>lens"]
App --> M5["Ruido Estocástico y NPS<br/>noise"]
App --> M6["Banding y Frecuencia<br/>banding"]
App --> M7["Defectos de Sensor<br/>defective-pixels"]
App --> M8["Rango Dinámico ISO 21550<br/>dynamic-range"]
Índice de Generadores Sintéticos
| Generador | Slug / Ruta | Ámbito Metrológico Principal | Normas y Referencias Clave |
|---|---|---|---|
| Borde inclinado · MTF | /generadores/slanted-edge | Borde inclinado, MTF50 analítica, PSF gaussiana 2D separable. | ISO 12233, MTF Mapper (Frans van den Bergh). |
| Carta colorimétrica | /generadores/color | Fidelidad cromática, ColorChecker 24 parches, Bradford, CIEDE2000, CGATS.17 e ICC. | CIE 15:2018, Sharma et al. (2005), BabelColor, ANSI/CGATS.17. |
| Uniformidad | /generadores/uniformity | Campos planos 3:2, viñeteado óptico, decaimiento , gradientes, color shading y defectos locales. | ISO 17957:2015 (), ISO 19264-1. |
| Distorsión de lente | /generadores/lens | Cartas de discos, distorsión radial, Brown-Conrady, bigote, prisma y aberración cromática R/B vs G. | ISO 17850:2015, ISO 19084:2015, OpenCV, Fitzgibbon, Brown. |
| Ruido de sensor | /generadores/noise | Escalas Kodak Q-13 y CC-Gray, ruido Poisson-Gaussiano, PRNU, DSNU, NPS 2D y multicanal. | ISO 15739:2023, EMVA 1288, Foi et al. (2008), Janesick (2007). |
| Banding y cuantización | /generadores/banding | Falso contorno tonal/cromático, franjas senoidales X/Y, SNR de pico espectral y CAMBI. | Netflix CAMBI (PCS 2021), Tu et al. BBAND, IEC 61966-2-1. |
| Píxeles defectuosos | /generadores/defective-pixels | Píxeles muertos, calientes, fríos, RTS, clusters, líneas y transitorios con modelo de sensor. | EMVA 1288 Linear R4.0, ISO 15739, ESA/Pyxel, Baer (2006). |
| Rango Dinámico ISO 21550 | /generadores/dynamic-range | Escalas Kodak Q-13 e ISO 21550:2004 (4×6), OECF lineal/potencia y ruido calibrado para . | ISO 21550:2004, Williams et al. (2006), ISO 14524, EMVA 1288. |
2. Resumen Comparativo de Capacidades
| Módulo | Entrada Principal | Dominio Físico de Síntesis | Formatos Soportados | Archivos de Salida y Verdad Terreno |
|---|---|---|---|---|
| slanted-edge | o , ángulo, longitud, contraste | Intensidad lineal continua con integración normal analítica | PNG (16-bit lineal, 8-bit lineal, 8-bit sRGB) | Imagen rasterizada y metadatos JSON de ejecución |
| color | objetivo, métrica (CIEDE2000/CIE76), espacio RGB, tipo desviación | CIELAB D50 continuo con adaptación Bradford | PNG (8-bit con ICC incrustado), TIFF | Manifiesto JSON, archivo de intercambio CGATS.17 ASCII |
| uniformity | Modelo viñeteado, caída %, , targets ISO | Señal física continua por bloques de filas (chunk_rows) | TIFF (16-bit, 8-bit), PNG (16-bit, 8-bit) | reference.json, config_resolved.json, mapas comprimidos NPZ |
| lens | Geometría (), CA radial/tangencial, objetivo % | Coordenadas vectoriales subpíxel analíticas continuas | TIFF (16-bit, 8-bit), PNG (16-bit, 8-bit) | reference.json, dots_reference.csv, config_resolved.json |
| noise | Modelo de ruido, , SNR dB, parámetros de sensor ADC | Intensidad digital, electrones Poisson o CIELAB | TIFF (16-bit, 8-bit), PNG (8-bit) | manifest.json, effective_statistics_XXXX.json, mapa NPS, CGATS |
| banding | Niveles, dither, frecuencias , SNR pico dB, CAMBI target | sRGB codificado, lineal, , CIELAB | TIFF (16-bit, 8-bit), PNG (16-bit, 8-bit) | manifest.json, clean.tiff, preview.png, mapas NPZ |
| defective-pixels | Lista de defectos (tipo, recuento, colocación, ganancia/DN) | Conteo de electrones físicos o código digital DN | TIFF (16-bit, 8-bit), PNG (16-bit mono/RGB) | reference.json, catalog.csv, truth_XXXX.csv, máscaras PNG, NPZ |
| dynamic-range | objetivo (EV/D/dB), carta ( parches), OECF, ruido y umbral | Exposición relativa y nivel digital lineal normalizado | TIFF (8, 10, 12, 16-bit y 32f), PNG (vista previa 8-bit) | *_dynamic_range.json, *_dynamic_range_patches.csv, TIFFs por realización |
3. Principios Metrológicos de la Plataforma
Para garantizar que los estímulos generados sirvan como patrones científicos inobjetables, la plataforma implementa cuatro principios de diseño fundamentales:
3.1. Separación Estricta entre Estímulo y Analizador
Ningún generador reutiliza el código ni las heurísticas internas de detección de ImageQA. Las referencias geométricas, colorimétricas o espectrales se calculan analíticamente a partir de las ecuaciones fundamentales de definición o mediante librerías científicas universales independientes (scipy, numpy, LittleCMS).
3.2. Diferenciación entre Oráculo Analítico Continuo y Verdad Cuantificada
Toda imagen digital final almacenada en disco se cuantifica inevitablemente a una profundidad de enteros finita (8 o 16 bits por canal). Los generadores distinguen formalmente en sus esquemas de datos:
- Valor Teórico / Continuo (
theory,ideal_delta_e,metrics_continuous): El valor analítico infinito antes del redondeo entero o recorte de rango. - Valor Efectivo Observable (
effective_statistics,quantized_delta_e,metrics_effective_from_quantized_codes): El valor recalculado estrictamente sobre los códigos digitales enteros realmente presentes en la imagen exportada. Este es el oráculo contra el cual deben evaluarse las herramientas de análisis de QA.
3.3. Trazabilidad Criptográfica SHA-256
Cada imagen generada y cada archivo auxiliar de máscara o mapa NPZ cuenta con su huella digital criptográfica SHA-256 registrada de forma inmutable en el manifiesto JSON de salida.
3.4. Exclusión de Falsa Conformidad Normativa
Las herramientas se inspiran en las definiciones matemáticas de las normas internacionales (ISO 12233, ISO 17850, ISO 17957, ISO 19084, ISO 15739, EMVA 1288, IEC 61966-2-1), pero declaran explícitamente en sus metadatos que constituyen simulaciones computacionales de laboratorio y no reemplazan ensayos físicos de calibración de cámaras en bancos ópticos homologados.
4. Retención Temporal y Gestión de Almacenamiento
La aplicación web y el contenedor Docker implementan una política de ciclo de vida efímero para proteger la privacidad y optimizar el almacenamiento:
- Directorio de Trabajo (
STORAGE_ROOT): Los trabajos de generación se almacenan en un directorio temporal (/data/storageen Docker odata/storageen local). - Tiempo de Retención (
RETENTION_MINUTES): El valor por defecto es de 30 minutos. - Daemon de Purga Automática: Un hilo en segundo plano verifica periódicamente los directorios de trabajo y elimina automáticamente aquellos que han superado el tiempo de retención configurado.
- Acceso a Descargas: Los enlaces de descarga y previsualización se invalidan de forma segura una vez transcurrido el tiempo límite.
5. Licencias, Derechos de Autor y Declaración de Atribuciones
Los proyectos integrados en esta suite combinan desarrollos propios con algoritmos inspirados en fuentes científicas abiertas y datos normalizados:
slanted-edge(generate_rectangle_python): Licencia BSD de 2 cláusulas. Copyright © 2011 Frans van den Bergh (MTF Mapper / Council for Scientific and Industrial Research - CSIR).banding(ImageQA_Banding_Suite_v1): Licencia permisiva ImageQA · Marcas registradas por sus respectivos titulares (métrica perceptual CAMBI propiedad de Netflix). Copyright © 2026 ImageQA Banding Validation Suite contributors.color(imageqa_color_validation): Licencia permisiva ImageQA · Marcas registradas por sus respectivos titulares. Mediciones espectrofotométricas atribuidas a Danny Pascale (BabelColor, 2012), especificación ISO 12641:1997 / ANSI IT8.7/2 y normas ISO. Mención de ColorChecker registrada por Calibrite / X-Rite.defective-pixels(ImageQA_Defective_Pixel_Suite_v1): Licencia permisiva ImageQA · Marcas registradas por sus respectivos titulares. Copyright © 2026 ImageQA Synthetic Validation Suite contributors. Modelos de corriente oscura inspirados en ESA / Pyxel y Baer (2006).lens(ImageQA_Lens_Distortion_Suite_v1): Licencia permisiva ImageQA · Marcas registradas por sus respectivos titulares. Diseños de cartas inspirados en ISO 17850 e ISO 19084. Compatible con formalismos OpenCV.noise(ImageQA_Noise_Suite_v1): Licencia permisiva ImageQA · Marcas registradas por sus respectivos titulares. Copyright © 2026 ImageQA Contributors.uniformity(ImageQA_Uniformity_Suite_v1): Licencia permisiva ImageQA · Marcas registradas por sus respectivos titulares. Copyright © 2026 ImageQA Contributors. Ecuaciones conformes con la formulación publicada de ISO 17957:2015.