Generador de Campos Planos y Uniformidad (ISO 17957)
1. Identificación y Propósito General
- Identificador en rotEngine:
uniformity - Módulo / Directorio Fuente:
ImageQA_Uniformity_Suite_v1 - Versión: 1.0.0
- Propósito: Generación determinista de imágenes de campo plano (flat-field) con proporción fija afectadas por patrones metrológicamente controlados de viñeteado óptico (shading de luminancia), variación cromática espacial (color shading), gradientes de iluminación, deformaciones polinómicas de superficie y perturbaciones locales de sensor/óptica.
- Rol en la Suite ImageQA: Actúa como banco de calibración primario y oráculo cuantitativo inobjetable para verificar algoritmos de corrección de campo plano (flat-field correction), evaluando directamente las métricas normalizadas por la norma ISO 17957:2015 () y proxies de uniformidad patrimonial ISO 19264-1 sobre píxeles cuantificados de 8 y 16 bits.
2. Fundamento Científico y Modelado Matemático
2.1. Geometría Física del Sensor y Preservación Métrica 3:2
A diferencia de aproximaciones computacionales que normalizan independientemente los ejes e deformando el perfil circular natural del cono de luz de la lente en una elipse espuria, esta suite preserva la métrica física euclidiana correspondiente a un sensor con proporción 3:2 (ej. formato estándar full-frame ).
Dadas las coordenadas de píxel sobre una matriz de tamaño (con ):
El radio métrico físico euclidiano respecto al centro óptico es:
El radio máximo hacia las cuatro esquinas del sensor es:
El radio radial normalizado adimensional es .
2.2. Modelos de Viñeteado y Caída de Iluminación
1. Viñeteado Cuadrático Simple (quadratic)
Caída parabólica de reflectancia lineal con porcentaje de atenuación máximo :
2. Viñeteado Polinómico de Orden Superior (polynomial)
Combina componentes radiales pares para modelar curvas complejas de transmisión pupilar:
3. Viñeteado Radiométrico Natural: Ley (cos4)
Modela la atenuación geométrica pura de la radiancia sobre el plano focal para una lente ideal de distancia focal :
4. Gradiente Direccional (gradient)
Inclinación lineal plana de la iluminación con ángulo de orientación y porcentaje de diferencia pico a pico :
5. Deformaciones Locales Gaussianas Anisótropas (local_defects)
Modela manchas de polvo en sensor, condensación o defectos zonales:
2.3. Modelos de Variación Cromática Espacial (Color Shading)
1. Color Shading en Espacio CIELAB (lab_radial)
Modela el viraje angular de coloración en bordes producido por filtros de interferencia IR (hot mirror) y microlentes del sensor. Modifica continuamente las componentes cromáticas preservando de forma exacta la luminosidad :
2. Ganancias Desacopladas de Canal RGB (channel_gains)
Atenuación diferencial multiplicativa independiente por canal:
Si preserve_y = true, la componente de luminancia global se normaliza analíticamente para mantener constante la luminosidad media.
2.4. Métricas Normalizadas ISO 17957:2015
La evaluación oficial se calcula sobre una rejilla regular de bloques de análisis distribuidos homogéneamente sobre el campo útil:
- No Uniformidad de Luminancia ():
- No Uniformidad de Luminosidad ():
- No Uniformidad de Cromaticidad (): Máxima desviación cromática euclidiana de cualquier bloque respecto al centroide cromático medio :
- No Uniformidad Total de Color ():
- Coeficiente de Variación de Luminosidad ():
3. Inventario Completo de Parámetros de Entrada
A continuación se detalla la configuración jerárquica del generador:
3.1. Bloque image (Dimensiones y Codificación)
| Parámetro | Tipo | Opciones / Rango | Default | Unidades | Significado Técnico |
|---|---|---|---|---|---|
width | int | (múltiplo 1.5) | 900 | píxeles | Anchura de la imagen generada. |
height | int | 600 | píxeles | Altura de la imagen generada (relación 3:2 fija). | |
bit_depth | int | 8, 16 | 16 | bits/canal | Profundidad de cuantificación del archivo exportado. |
format | str | 'PNG', 'TIFF' | 'PNG' | formato | Formato de archivo de imagen sin pérdidas. |
3.2. Bloque spatial (Modelado Geométrico de Viñeteado)
| Parámetro | Tipo | Opciones / Rango | Default | Unidades | Significado Técnico |
|---|---|---|---|---|---|
model | str | 'uniform', 'quadratic', 'polynomial', 'cos4', 'gradient' | 'uniform' | modelo | Función matemática que gobierna la caída radial o direccional de iluminación. |
falloff_percent | float | 0.0 | % | Porcentaje máximo de pérdida de iluminación en las esquinas (). | |
center_offset | list[float] | [0.0, 0.0] | relativo | Desplazamiento del eje óptico respecto al centro geométrico del fotograma. | |
poly_coeffs | list[float] | 3 flotantes | [1.0, 0.0, 0.0] | ponderación | Coeficientes para viñeteado polynomial. |
focal_length_mm | float | 50.0 | milímetros | Distancia focal equivalente para la ley física cos4. | |
gradient_angle | float | 0.0 | grados (°) | Ángulo de orientación de la rampa si model='gradient'. |
3.3. Bloque color_shading (Variación Cromática Espacial)
| Parámetro | Tipo | Opciones / Rango | Default | Unidades | Significado Técnico |
|---|---|---|---|---|---|
model | str | 'none', 'lab_radial', 'channel_gains' | 'none' | modelo | Mecanismo de viraje de color en bordes. |
delta_a_corner | float | 0.0 | unidades | Desplazamiento cromático en eje rojo-verde en la esquina extrema. | |
delta_b_corner | float | 0.0 | unidades | Desplazamiento cromático en eje amarillo-azul en la esquina extrema. | |
falloff_rgb | list[float] | 3 flotantes | [0.0, 0.0, 0.0] | % | Caída diferencial de viñeteado independiente por canal. |
preserve_y | bool | true, false | true | - | Si es true, normaliza la luminancia física media tras alterar los canales RGB. |
3.4. Bloque output y General
| Parámetro | Tipo | Rango | Default | Unidades | Significado Técnico |
|---|---|---|---|---|---|
save_float_maps | bool | true, false | false | - | Exporta matrices continuas en coma flotante comprimidas en archivo .npz. |
test_id | str | Cadena alfanumérica | 'U_WEB' | identificador | Código único de experimento asignado al trabajo. |
seed | int | 12345 | semilla | Semilla del generador determinista pseudoaleatorio. |
4. Configuración JSON en rotEngine
Esquema JSON por defecto cargado en la aplicación web:
{
"test_id": "U_WEB",
"image": {
"width": 900,
"height": 600,
"bit_depth": 16,
"format": "PNG"
},
"output": {
"save_float_maps": false
},
"spatial": {
"model": "uniform"
},
"seed": 12345
}
5. Productos de Salida y Metadatos de Respuesta
Al ejecutarse, el generador produce:
- Archivo de Imagen (
.pngo.tiff): Campo plano rasterizado a 8 o 16 bits sin pérdidas. reference.json: Metadatos analíticos teóricos y métricas normalizadas recalculadas sobre los códigos enteros cuantificados:
{
"test_id": "U_WEB",
"image": {
"width": 900,
"height": 600,
"bit_depth": 16,
"format": "PNG"
},
"iso_17957_metrics": {
"dy_percent": 24.35,
"dl_units": 8.12,
"dc_units": 1.45,
"d_total_units": 8.25,
"cv_l_percent": 3.82,
"grid_blocks": "11x11"
},
"continuous_ground_truth": {
"center_luminance": 0.8000,
"corner_luminance": 0.6052,
"analytical_falloff_percent": 24.35
},
"sha256": "4b5d2a..."
}
maps.npz(opcional): Archivo NumPy con los planos continuos teóricos , , , y el mapa de cuantización efectiva.
6. Licencias, Derechos de Autor y Atribuciones
- Licencia: Licencia permisiva ImageQA · Marcas registradas por sus respectivos titulares.
- Copyright: Copyright © 2026 ImageQA Contributors.
- Atribución Normativa: Las ecuaciones de cálculo de no-uniformidad implementan fielmente las especificaciones de la norma internacional ISO 17957:2015.
7. Citas Bibliográficas y Normativas
- ISO 17957:2015. Photography — Digital cameras — Shading measurements. International Organization for Standardization. https://www.iso.org/standard/61057.html.
- ISO 19264-1:2021. Photography — Archival systems — Image quality analysis — Part 1: Reflective originals. International Organization for Standardization.
- Ray, S. F. (2002). Applied Photographic Optics: Lenses and optical systems for photography, film, video, electronic and digital imaging (3rd ed.). Focal Press.
- EMVA 1288 Standard (Release 4.0). Standard for Characterization of Image Sensors and Cameras. European Machine Vision Association.