Saltar al contenido principal

Generador de Rango Dinámico ISO 21550

1. Identificación y Propósito General​

  • Identificador en rotEngine: dynamic-range
  • Módulo / Directorio Fuente: vendor/dynamic_range_simulator (v1.0.0)
  • Propósito: Generación metrológica y reproducible de escalas monocromas de densidades conocidas (kodak_q13, iso_21550, iso_transmissive), transformadas mediante una función optoelectrónica (OECF) configurable y perturbadas con ruido estocástico calibrado para verificar algoritmos de cálculo de rango dinámico basados en la relación señal-ruido incremental (SNRi\text{SNRi}) de ISO 21550:2004.
  • Alcance metrológico: Produce imágenes digitales sintéticas para contrastar estimadores numéricos; no constituye una carta física certificada, ni una medición densitométrica ni un ensayo de conformidad de un escáner físico.

Deben distinguirse tres magnitudes que el módulo registra por separado:

  1. Cobertura tonal de la carta: diferencia entre densidades nominales extremas (Dmax⁡−Dmin⁡D_{\max} - D_{\min}); depende de la carta y su distribución, no de la amplitud del ruido.
  2. Rango dinámico objetivo: profundidad de exposición en la que el modelo analítico de SNRi\text{SNRi} alcanza el umbral solicitado.
  3. Rango dinámico observado: punto de cruce estimado a partir de medias y desviaciones típicas medidas sobre las ROI de los píxeles sintéticos; puede diferir del objetivo por fluctuaciones estadísticas, interpolación lineal, cuantización o recorte.

:::note Modo sin ruido Sin ruido (noise.model = 'none') y sin pérdida de ganancia incremental, la imagen tiene una cobertura tonal finita, pero no se obtiene un límite SNRi=1\text{SNRi} = 1. En ese caso effective_dr_is_defined es false y no debe atribuirse un rango dinámico ISO numérico. :::


2. Referencias Científicas y Normalización​

2.1. ISO 21550:2004​

Photography — Electronic scanners for photographic images — Dynamic range measurements:

  • §4: naturaleza y disposición de las cartas reflectantes y transparentes; número de niveles y condiciones de densidad.
  • §6.1: adquisición de al menos 10 realizaciones independientes para determinar la OECF y uso de regiones de interés (ROI) de 64×6464 \times 64 píxeles para medir los niveles de salida.
  • §7.2–7.3: cálculo del intervalo dinámico, SNR\text{SNR} incremental y estimación de ganancia incremental mediante diferencias finitas de la OECF (Ecuación 7).
  • Anexo A: secuencias de densidades nominales para patrones de reflexión y transmisión.

En la implementación de rotEngine, la profundidad de exposición se expresa desde la menor densidad incluida en la carta (Dmin⁡D_{\min}), sin efectuar una detección independiente del límite de saturación superior.

2.2. Williams, Burns y Dupin (2006)​

Williams, D.; Burns, P. D.; Dupin, M. (2006). "Statistical Interpretation of ISO TC42 Dynamic Range: Risky Business". Proc. SPIE-IS&T Electronic Imaging, vol. 6059, pp. 207–214.

Justifica el uso de la SNR\text{SNR} incremental como criterio operativo y analiza sus límites estadísticos: un umbral SNRi=1\text{SNRi} = 1 no garantiza discriminación inequívoca sin considerar tamaño muestral, riesgos estadísticos (α,β\alpha, \beta) y correlación espacial / espectro de potencia de ruido (NPS).

2.3. Referencias Complementarias​

  • ISO 14524:2009: procedimientos de medición de funciones optoelectrónicas (OECF).
  • ISO 5-2 / ISO 5-4: condiciones geométricas de densitometría de transmisión y reflexión (aplicables a cartas físicas).
  • EMVA 1288 (Release 4.0): marco físico para distinguir ruido electrónico de lectura y ruido fotónico (shot noise).
  • Kodak Q-13: escala de 20 pasos de densidad nominal aproximada en incrementos de 0.1 D0.1\text{ D}.

3. Fundamento Matemático y Físico​

3.1. Magnitudes y Conversión de Unidades​

Sea DiD_i la densidad óptica del parche ii y Dmin⁡D_{\min} la menor densidad de la carta. Se define la exposición relativa normalizada TiT_i:

Ti=10−(Di−Dmin⁡),T(Dmin⁡)=1T_i = 10^{-(D_i - D_{\min})}, \qquad T(D_{\min}) = 1

La profundidad de exposición desde el nivel de referencia en pasos (EV) es:

ei=(Di−Dmin⁡)log⁡2(10)[EV]e_i = (D_i - D_{\min}) \log_2(10) \quad [\text{EV}]

Conversiones implementadas entre EV, densidad óptica (DD), contraste (CC) y decibelios (dB\text{dB}):

DREV=DRDlog⁡2(10)≈3.321928⋅DRD\text{DR}_{\text{EV}} = \text{DR}_D \log_2(10) \approx 3.321928 \cdot \text{DR}_D

DRD=DREVlog⁡2(10),C=2DREV:1\text{DR}_D = \frac{\text{DR}_{\text{EV}}}{\log_2(10)}, \qquad C = 2^{\text{DR}_{\text{EV}}}:1

DRdB=20log⁡10(2DREV)≈6.020600⋅DREV\text{DR}_{\text{dB}} = 20 \log_{10}\left(2^{\text{DR}_{\text{EV}}}\right) \approx 6.020600 \cdot \text{DR}_{\text{EV}}

:::info Convención de decibelios El simulador utiliza la convención de relación de amplitudes 20log⁡10(razoˊn de intensidades normalizadas)20 \log_{10}(\text{razón de intensidades normalizadas}), equivalente a 6.0206 dB/EV6.0206\text{ dB/EV}. :::

Intervalo (EV\text{EV})Densidad óptica (D\text{D})Contraste (CC)Decibelios (dB\text{dB})
5 EV5\text{ EV}1.505151.5051532:132:130.10330.103
8 EV8\text{ EV}2.408242.40824256:1256:148.16548.165
10 EV10\text{ EV}3.010303.010301024:11024:160.20660.206
12 EV12\text{ EV}3.612363.612364096:14096:172.24772.247

3.2. Cartas Soportadas (≥20\ge 20 parches)​

El simulador se integra con el catálogo de cartas de rotEngine (card_catalog.json y color_references.json) y solo acepta cartas con 20 parches o más:

  • kodak_q13 (Kodak Q-13, 20 parches): tira horizontal de 1×201 \times 20 parches. En modo nominal utiliza las densidades de referencia registradas en color_references.json (cobertura ≈6.05 EV\approx 6.05\text{ EV}).
  • iso_21550 (ISO 21550:2004 Reflexión, 24 parches): matriz apaisada de 4 filas×6 columnas4 \text{ filas} \times 6 \text{ columnas} (relación de aspecto 3:23:2 / 1.51.5) dispuesta con el parche más denso en la esquina superior izquierda y el menos denso en la esquina inferior derecha. Sus valores nominales siguen el Anexo A de reflexión: [Dmax⁡,Dmax⁡,2.0,1.9,…,0.1,Dmin⁡,Dmin⁡][D_{\max}, D_{\max}, 2.0, 1.9, \ldots, 0.1, D_{\min}, D_{\min}] (por defecto Dmin⁡=0.05D_{\min}=0.05, Dmax⁡=2.10D_{\max}=2.10, cobertura ≈6.81 EV\approx 6.81\text{ EV}).
  • iso_transmissive (ISO 21550:2004 Transmisión, 24 parches): misma geometría 4×64 \times 6 con las densidades nominales del Anexo A de transmisión ordenadas de mayor a menor densidad: [4.3,4.1,…,0.7,0.5,0.4,0.3,0.2,0.1][4.3, 4.1, \ldots, 0.7, 0.5, 0.4, 0.3, 0.2, 0.1] (cobertura ≈13.95 EV\approx 13.95\text{ EV}).
  • Distribución scaled: redistribuye linealmente los NN parches (2020 o 2424) entre dmin (por defecto 0.00.0) y dmax. Si no se indica dmax y hay ruido activo, extiende el rango hasta DRobjetivo+1 EV\text{DR}_{\text{objetivo}} + 1\text{ EV} para garantizar que el umbral SNRi\text{SNRi} caiga dentro de la carta.

:::warning Disposición espacial anti-flare La carta iso_21550 utiliza una cuadrícula compacta 4×64 \times 6 para validar algoritmos digitales de lectura de parches y cálculo de SNRi\text{SNRi}; no reproduce la distribución espacial anti-flare de la Figura 1 de ISO 21550:2004 ni modela luz parásita óptica. :::

3.3. Modelo OECF​

Relación entre exposición relativa TT y nivel digital normalizado Y∈[0,1]Y \in [0, 1]:

  • Lineal (linear): Y(T)=offset+gain⋅T,g(T)=dYdT=gainY(T) = \text{offset} + \text{gain} \cdot T, \qquad g(T) = \frac{dY}{dT} = \text{gain}
  • Potencia (power): Y(T)=offset+gain⋅Tγ,g(T)=gain⋅γ⋅Tγ−1Y(T) = \text{offset} + \text{gain} \cdot T^{\gamma}, \qquad g(T) = \text{gain} \cdot \gamma \cdot T^{\gamma - 1}

Las restricciones de validación exigen 0<gain≤10 < \text{gain} \le 1, 0≤offset<10 \le \text{offset} < 1 y gain+offset≤1\text{gain} + \text{offset} \le 1. Los archivos TIFF exportados conservan el dominio lineal de la OECF sin codificación sRGB adicional.

3.4. Modelo de SNR Incremental (SNRi\text{SNRi}) y Ruido​

La señal incremental y la relación señal-ruido incremental en el parche ii se definen como:

Si=Ti g(Ti),SNRi(Ti)=Ti g(Ti)σiS_i = T_i \, g(T_i), \qquad \text{SNRi}(T_i) = \frac{T_i \, g(T_i)}{\sigma_i}

Dado el rango dinámico objetivo DREV\text{DR}_{\text{EV}} y el umbral q=snr_thresholdq = \text{snr\_threshold} (por defecto 1.01.0), la exposición límite es Tlim⁡=2−DREVT_{\lim} = 2^{-\text{DR}_{\text{EV}}} y se calibra la varianza de lectura σr2\sigma_r^2 para cumplir SNRi(Tlim⁡)=q\text{SNRi}(T_{\lim}) = q:

  1. Ruido gaussiano constante (gaussian): σr=Tlim⁡ g(Tlim⁡)q\sigma_r = \frac{T_{\lim} \, g(T_{\lim})}{q}
  2. Ruido dependiente de señal (signal_dependent): varianza heterocedástica σ2(T)=σr2+kT\sigma^2(T) = \sigma_r^2 + k T, con k=shot_variance_coefficient≥0k = \text{shot\_variance\_coefficient} \ge 0: σr2=(Tlim⁡ g(Tlim⁡)q)2−kTlim⁡≥0\sigma_r^2 = \left(\frac{T_{\lim} \, g(T_{\lim})}{q}\right)^2 - k T_{\lim} \ge 0
  3. Ruido correlacionado (correlated): ruido normal blanco filtrado con un núcleo gaussiano de desviación correlation_sigma_px y renormalizado por parche para preservar σi\sigma_i alterando la autocorrelación espacial (NPS).
  4. Sin ruido (none): parches deterministas (σr=0\sigma_r = 0, sujeto únicamente a cuantización de salida).

3.5. Calibración Analítica vs. Empírica y Estimadores de Medida​

  • Calibración analytical: resuelve σr2\sigma_r^2 directamente mediante las ecuaciones anteriores.
  • Calibración empirical: ejecuta una simulación auxiliar independiente de campos 64×6464 \times 64 con el formato de bits elegido y ajusta un factor multiplicativo sobre la amplitud de ruido mediante scipy.optimize.brentq usando la ganancia OECF analítica (evitando circularidad con el estimador de diferencias finitas).
  • Observadores reportados en el JSON de salida:
    • observed.finite_difference: estima g(T)g(T) a partir de las medias medidas de los parches mediante diferencias finitas centradas (ISO 21550 §7.3, Ec. 7), promediando primero exposiciones duplicadas.
    • observed.analytic_gain_oracle: utiliza la derivada exacta g(T)g(T) junto con las desviaciones típicas medidas en las ROI de 64×6464 \times 64 píxeles.
    • El cruce con el umbral SNRi\text{SNRi} se interpola linealmente en EV entre parches consecutivos ordenados por exposición.

4. Inventario de Parámetros en la Interfaz de rotEngine​

Los parámetros están agrupados en las 5 pestañas de la interfaz gráfica del generador Rango Dinámico ISO 21550.

4.1. Pestaña «Carta de Prueba» (chart)​

Etiqueta en InterfazClave JSON (config)Campo API (SimulationConfig)TipoPredeterminadoValores admitidos / Descripción
Tipo de escala tonalchart.kindchartstr'kodak_q13''kodak_q13' (20 parches, 1×20), 'iso_21550' (24 parches, 4×6 reflexión), 'iso_transmissive' (24 parches, 4×6 transmisión).
Distribución de densidadeschart.distributiondistributionstr'nominal''nominal' (densidades estándar de la carta) o 'scaled' (densidades equiespaciadas sintéticas).
Densidad mínima (Dmin)chart.dmindminfloat | nullnullLímite inferior en scaled (0.00.0 por defecto) o extremo Dmin⁡∈[0,0.1]D_{\min} \in [0, 0.1] en iso_21550 nominal. No permitido en kodak_q13 nominal.
Densidad máxima (Dmax)chart.dmaxdmaxfloat | nullnullLímite superior en scaled (si es null con ruido, se ajusta a objetivo + 1 EV) o extremo Dmax⁡≥2.0D_{\max} \ge 2.0 en iso_21550 nominal.

4.2. Pestaña «Simulación de Sensor» (simulation)​

Etiqueta en InterfazClave JSON (config)Campo API (SimulationConfig)TipoPredeterminadoValores admitidos / Descripción
Rango dinámico objetivosimulation.dynamic_rangedynamic_rangefloat5.0Rango dinámico objetivo; convertido a EV debe ser finito y estar en (0,30)(0, 30).
Unidadsimulation.unitunitstr'EV''EV', 'density' (densidad óptica D) o 'dB' (convención de amplitud 20log⁡1020\log_{10}).
Umbral SNRisimulation.snr_thresholdsnr_thresholdfloat1.0Umbral positivo y finito de SNR incremental (>0> 0). ISO 21550 emplea 1.01.0.
Calibración de ruidosimulation.calibrationcalibrationstr'analytical''analytical' (fórmula cerrada) o 'empirical' (búsqueda brentq en campos 64×6464 \times 64; requiere ruido).
Permitir extrapolaciónsimulation.allow_extrapolationallow_extrapolationboolfalsePermite generar aunque el objetivo supere la cobertura de la carta (el cruce medido puede resultar null).
Realizaciones (frames)simulation.realizationsrealizationsint1Número de imágenes TIFF independientes generadas (11 a 10001000).
Semillasimulation.seedseedint42Semilla del generador pseudoaleatorio para reproducibilidad exacta.

4.3. Pestaña «Modelo de Ruido» (noise)​

Etiqueta en InterfazClave JSON (config)Campo API (SimulationConfig)TipoPredeterminadoValores admitidos / Descripción
Modelonoise.modelnoise_modelstr'gaussian''none', 'gaussian', 'signal_dependent' o 'correlated'.
Coeficiente de varianza shotnoise.shot_variance_coefficientshot_variance_coefficientfloat0.0Coeficiente k≥0k \ge 0 de varianza proporcional a TT; solo actúa en signal_dependent.
Sigma de correlación (px)noise.correlation_sigma_pxcorrelation_sigma_pxfloat1.5Desviación típica del filtro gaussiano espacial (>0> 0); solo actúa en correlated.

4.4. Pestaña «OECF y Respuesta» (oecf)​

Etiqueta en InterfazClave JSON (config)Campo API (SimulationConfig)TipoPredeterminadoValores admitidos / Descripción
Modelooecf.modeloecfstr'linear''linear' (Y=b+aTY = b + aT) o 'power' (Y=b+aTγY = b + aT^\gamma).
Gammaoecf.gammagammafloat1.0Exponente γ∈(0,5]\gamma \in (0, 5]; debe ser 1.0 cuando oecf.model = 'linear'.
Gananciaoecf.gaingainfloat0.75Ganancia normalizada a∈(0,1]a \in (0, 1], cumpliendo gain+offset≤1\text{gain} + \text{offset} \le 1.
Offsetoecf.offsetoffsetfloat0.10Nivel digital basal b∈[0,1)b \in [0, 1) aplicado también al fondo exterior de la carta.

4.5. Pestaña «Opciones de Salida» (output)​

Etiqueta en InterfazClave JSON (config)Campo API (SimulationConfig)TipoPredeterminadoValores admitidos / Descripción
Profundidad de bitsoutput.bit_depthbit_depthint | str168 (uint8), 10, 12, 16 (uint16 recortado a [0,1][0, 1]) o '32f' (float32 sin recorte, ideal para validación numérica).
Tamaño de parche (px)output.patch_sizepatch_sizeint80Lado de cada parche cuadrado en píxeles (mínimo 64 para alojar la ROI centrada de 64×6464 \times 64).
Separación entre parches (px)output.gapgapint8Separación horizontal y vertical entre parches (≥0\ge 0).
Margen exterior (px)output.marginmarginint24Margen perimetral de fondo (≥0\ge 0). La resolución total no debe superar MAX_IMAGE_SIDE (2000 px por defecto).

5. Archivos de Salida y Verdad Terreno​

Cada lote generado produce en la columna de resultados los siguientes artefactos trazables con el prefijo del lote:

  1. Vista previa PNG (*_dynamic_range_<carta>_<dr><unit>_seed-<seed>.png): imagen de 8 bits para previsualización directa en el navegador.
  2. Realizaciones TIFF (*_dynamic_range_001.tiff … *_dynamic_range_NNN.tiff): imágenes monocromas lineales (photometric='minisblack') en la profundidad de bits configurada (uint8, uint16 o float32).
  3. Manifiesto JSON (*_dynamic_range.json): contiene config, chart (disposición, densidades, cobertura tonal y cajas roi_boxes_y0_x0_y1_x1), target (EV, densidad, contraste, dB, umbral y exposición límite), noise, observed.finite_difference, observed.analytic_gain_oracle y warnings.
  4. Tabla CSV por parche (*_dynamic_range_patches.csv): incluye por cada parche patch, density_D, relative_exposure_EV, relative_transmission, valores esperados (expected_output_normalized, expected_sigma_normalized, expected_incremental_gain, expected_incremental_snr), estadísticas observadas (observed_mean_normalized, observed_sigma_normalized, observed_incremental_gain, observed_incremental_snr) y coordenadas roi_y0, roi_x0, roi_y1, roi_x1.

6. Limitaciones Declaradas (v1.0)​

  • No mide el límite superior de saturación física para reconstruir un rango dinámico ISO completo; toma Dmin⁡D_{\min} como referencia de exposición T=1T = 1.
  • La geometría iso_21550 (4×64 \times 6) no reproduce la disposición anti-flare de la Figura 1 de ISO 21550:2004.
  • Las imágenes son monocromas (sin canales RGB ni ponderación de luminancia visual).
  • La interpolación de cruce es lineal en SNRi\text{SNRi} sobre EV (no sobre log⁡SNRi\log \text{SNRi}).
  • El modo signal_dependent emplea una aproximación gaussiana heterocedástica (no Poisson discreto en electrones) y correlated aplica un filtro gaussiano espacial sin modelo óptico de NPS de escáner real.