Saltar al contenido principal

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 3:23:2 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 (DL,DY,DC,DTotalD_L, D_Y, D_C, D_{\text{Total}}) 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 XX e YY 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 36×24 mm36 \times 24\,\text{mm}).

Dadas las coordenadas de píxel (x,y)(x, y) sobre una matriz de tamaño W×HW \times H (con W/H=1.5W/H = 1.5):

xmm=(x−cx⋅WW)⋅Wsensor,ymm=(y−cy⋅HH)⋅Hsensorx_{\text{mm}} = \left(\frac{x - c_x \cdot W}{W}\right) \cdot W_{\text{sensor}}, \quad y_{\text{mm}} = \left(\frac{y - c_y \cdot H}{H}\right) \cdot H_{\text{sensor}}

El radio métrico físico euclidiano respecto al centro óptico (cx,cy)(c_x, c_y) es:

r=xmm2+ymm2r = \sqrt{x_{\text{mm}}^2 + y_{\text{mm}}^2}

El radio máximo hacia las cuatro esquinas del sensor es:

Rcorner=12Wsensor2+Hsensor2≈21.633 mmR_{\text{corner}} = \frac{1}{2}\sqrt{W_{\text{sensor}}^2 + H_{\text{sensor}}^2} \approx 21.633\,\text{mm}

El radio radial normalizado adimensional es rn=r/Rcorner∈[0,1]r_n = r / R_{\text{corner}} \in [0, 1].

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 f∈[0,100]f \in [0, 100]:

V(rn)=1.0−(f100)⋅rn2V(r_n) = 1.0 - \left(\frac{f}{100}\right) \cdot r_n^2

2. Viñeteado Polinómico de Orden Superior (polynomial)​

Combina componentes radiales pares para modelar curvas complejas de transmisión pupilar:

V(rn)=1.0−(f100)⋅a2rn2+a4rn4+a6rn6a2+a4+a6V(r_n) = 1.0 - \left(\frac{f}{100}\right) \cdot \frac{a_2 r_n^2 + a_4 r_n^4 + a_6 r_n^6}{a_2 + a_4 + a_6}

3. Viñeteado Radiométrico Natural: Ley cos⁡4(θ)\cos^4(\theta) (cos4)​

Modela la atenuación geométrica pura de la radiancia sobre el plano focal para una lente ideal de distancia focal flenf_{\text{len}}:

tan⁡(θ)=rflen  ⟹  cos⁡(θ)=11+(rflen)2\tan(\theta) = \frac{r}{f_{\text{len}}} \implies \cos(\theta) = \frac{1}{\sqrt{1 + \left(\frac{r}{f_{\text{len}}}\right)^2}}

V(r)=[cos⁡(θ)]4=1(1+(rflen)2)2V(r) = \left[\cos(\theta)\right]^4 = \frac{1}{\left(1 + \left(\frac{r}{f_{\text{len}}}\right)^2\right)^2}

4. Gradiente Direccional (gradient)​

Inclinación lineal plana de la iluminación con ángulo de orientación α\alpha y porcentaje de diferencia pico a pico Δgrad\Delta_{\text{grad}}:

u=xncos⁡(α)+ynsin⁡(α)∈[−umax⁡,umax⁡]u = x_n \cos(\alpha) + y_n \sin(\alpha) \in [-u_{\max}, u_{\max}]

G(u)=1.0+Δgrad100⋅(u2umax⁡)G(u) = 1.0 + \frac{\Delta_{\text{grad}}}{100} \cdot \left(\frac{u}{2 u_{\max}}\right)

5. Deformaciones Locales Gaussianas Anisótropas (local_defects)​

Modela manchas de polvo en sensor, condensación o defectos zonales:

ΔIdefect(x,y)=−Adefect⋅exp⁡(−12[(u′σu)2+(v′σv)2])\Delta I_{\text{defect}}(x, y) = -A_{\text{defect}} \cdot \exp\left(-\frac{1}{2} \left[ \left(\frac{u'}{\sigma_u}\right)^2 + \left(\frac{v'}{\sigma_v}\right)^2 \right]\right)

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 a∗,b∗a^*, b^* preservando de forma exacta la luminosidad L∗L^*:

a∗(rn)=a0∗+Δacorner⋅rnp,b∗(rn)=b0∗+Δbcorner⋅rnp,L∗(rn)=L0∗a^*(r_n) = a^*_0 + \Delta a_{\text{corner}} \cdot r_n^p, \quad b^*(r_n) = b^*_0 + \Delta b_{\text{corner}} \cdot r_n^p, \quad L^*(r_n) = L^*_0

2. Ganancias Desacopladas de Canal RGB (channel_gains)​

Atenuación diferencial multiplicativa independiente por canal:

IR=IR,0⋅(1−fRrn2),IG=IG,0⋅(1−fGrn2),IB=IB,0⋅(1−fBrn2)I_R = I_{R,0} \cdot \left(1 - f_R r_n^2\right), \quad I_G = I_{G,0} \cdot \left(1 - f_G r_n^2\right), \quad I_B = I_{B,0} \cdot \left(1 - f_B r_n^2\right)

Si preserve_y = true, la componente de luminancia global YY 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 11×1111 \times 11 bloques de análisis distribuidos homogéneamente sobre el campo útil:

  1. No Uniformidad de Luminancia (DYD_Y): DY=Ymax⁡−Ymin⁡Ymax⁡⋅100[%]D_Y = \frac{Y_{\max} - Y_{\min}}{Y_{\max}} \cdot 100 \quad [\%]
  2. No Uniformidad de Luminosidad (DLD_L): DL=Lmax⁡∗−Lmin⁡∗[unidades L∗]D_L = L^*_{\max} - L^*_{\min} \quad [\text{unidades } L^*]
  3. No Uniformidad de Cromaticidad (DCD_C): Máxima desviación cromática euclidiana de cualquier bloque ii respecto al centroide cromático medio (aˉ∗,bˉ∗)(\bar{a}^*, \bar{b}^*): DC=max⁡i∈{1…121}(ai∗−aˉ∗)2+(bi∗−bˉ∗)2D_C = \max_{i \in \{1 \dots 121\}} \sqrt{(a^*_i - \bar{a}^*)^2 + (b^*_i - \bar{b}^*)^2}
  4. No Uniformidad Total de Color (DTotalD_{\text{Total}}): DTotal=max⁡i∈{1…121}(Li∗−Lˉ∗)2+(ai∗−aˉ∗)2+(bi∗−bˉ∗)2D_{\text{Total}} = \max_{i \in \{1 \dots 121\}} \sqrt{(L^*_i - \bar{L}^*)^2 + (a^*_i - \bar{a}^*)^2 + (b^*_i - \bar{b}^*)^2}
  5. Coeficiente de Variación de Luminosidad (CVL\text{CV}_L): CVL=σL∗Lˉ∗⋅100[%]\text{CV}_L = \frac{\sigma_{L^*}}{\bar{L}^*} \cdot 100 \quad [\%]

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ámetroTipoOpciones / RangoDefaultUnidadesSignificado Técnico
widthint≥48\ge 48 (múltiplo 1.5)900píxelesAnchura de la imagen generada.
heightint≥32\ge 32600píxelesAltura de la imagen generada (relación 3:2 fija).
bit_depthint8, 1616bits/canalProfundidad de cuantificación del archivo exportado.
formatstr'PNG', 'TIFF''PNG'formatoFormato de archivo de imagen sin pérdidas.

3.2. Bloque spatial (Modelado Geométrico de Viñeteado)​

ParámetroTipoOpciones / RangoDefaultUnidadesSignificado Técnico
modelstr'uniform', 'quadratic', 'polynomial', 'cos4', 'gradient''uniform'modeloFunción matemática que gobierna la caída radial o direccional de iluminación.
falloff_percentfloat[0.0,100.0][0.0, 100.0]0.0%Porcentaje máximo de pérdida de iluminación en las esquinas (rn=1.0r_n = 1.0).
center_offsetlist[float][cx,cy]∈[−0.2,0.2][c_x, c_y] \in [-0.2, 0.2][0.0, 0.0]relativoDesplazamiento del eje óptico respecto al centro geométrico del fotograma.
poly_coeffslist[float]3 flotantes [a2,a4,a6][a_2, a_4, a_6][1.0, 0.0, 0.0]ponderaciónCoeficientes para viñeteado polynomial.
focal_length_mmfloat>1.0> 1.050.0milímetrosDistancia focal equivalente para la ley física cos4.
gradient_anglefloat[0.0,360.0][0.0, 360.0]0.0grados (°)Ángulo de orientación de la rampa si model='gradient'.

3.3. Bloque color_shading (Variación Cromática Espacial)​

ParámetroTipoOpciones / RangoDefaultUnidadesSignificado Técnico
modelstr'none', 'lab_radial', 'channel_gains''none'modeloMecanismo de viraje de color en bordes.
delta_a_cornerfloat[−50.0,50.0][-50.0, 50.0]0.0unidades a∗a^*Desplazamiento cromático en eje rojo-verde en la esquina extrema.
delta_b_cornerfloat[−50.0,50.0][-50.0, 50.0]0.0unidades b∗b^*Desplazamiento cromático en eje amarillo-azul en la esquina extrema.
falloff_rgblist[float]3 flotantes [fR,fG,fB][f_R, f_G, f_B][0.0, 0.0, 0.0]%Caída diferencial de viñeteado independiente por canal.
preserve_ybooltrue, falsetrue-Si es true, normaliza la luminancia física YY media tras alterar los canales RGB.

3.4. Bloque output y General​

ParámetroTipoRangoDefaultUnidadesSignificado Técnico
save_float_mapsbooltrue, falsefalse-Exporta matrices continuas en coma flotante comprimidas en archivo .npz.
test_idstrCadena alfanumérica'U_WEB'identificadorCódigo único de experimento asignado al trabajo.
seedint≥0\ge 012345semillaSemilla 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:

  1. Archivo de Imagen (.png o .tiff): Campo plano rasterizado a 8 o 16 bits sin pérdidas.
  2. 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..."
}
  1. maps.npz (opcional): Archivo NumPy con los planos continuos teóricos YY, L∗L^*, a∗a^*, b∗b^* 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 DY,DL,DC,DTotalD_Y, D_L, D_C, D_{\text{Total}} implementan fielmente las especificaciones de la norma internacional ISO 17957:2015.

7. Citas Bibliográficas y Normativas​

  1. ISO 17957:2015. Photography — Digital cameras — Shading measurements. International Organization for Standardization. https://www.iso.org/standard/61057.html.
  2. ISO 19264-1:2021. Photography — Archival systems — Image quality analysis — Part 1: Reflective originals. International Organization for Standardization.
  3. Ray, S. F. (2002). Applied Photographic Optics: Lenses and optical systems for photography, film, video, electronic and digital imaging (3rd ed.). Focal Press.
  4. EMVA 1288 Standard (Release 4.0). Standard for Characterization of Image Sensors and Cameras. European Machine Vision Association.