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 () 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:
- Cobertura tonal de la carta: diferencia entre densidades nominales extremas (); depende de la carta y su distribución, no de la amplitud del ruido.
- Rango dinámico objetivo: profundidad de exposición en la que el modelo analítico de alcanza el umbral solicitado.
- 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 . 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 píxeles para medir los niveles de salida.
- §7.2–7.3: cálculo del intervalo dinámico, 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 (), 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 incremental como criterio operativo y analiza sus límites estadísticos: un umbral no garantiza discriminación inequívoca sin considerar tamaño muestral, riesgos estadísticos () 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 .
3. Fundamento Matemático y Físico
3.1. Magnitudes y Conversión de Unidades
Sea la densidad óptica del parche y la menor densidad de la carta. Se define la exposición relativa normalizada :
La profundidad de exposición desde el nivel de referencia en pasos (EV) es:
Conversiones implementadas entre EV, densidad óptica (), contraste () y decibelios ():
:::info Convención de decibelios El simulador utiliza la convención de relación de amplitudes , equivalente a . :::
| Intervalo () | Densidad óptica () | Contraste () | Decibelios () |
|---|---|---|---|
3.2. Cartas Soportadas ( 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 parches. En modonominalutiliza las densidades de referencia registradas encolor_references.json(cobertura ).iso_21550(ISO 21550:2004 Reflexión, 24 parches): matriz apaisada de (relación de aspecto / ) 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: (por defecto , , cobertura ).iso_transmissive(ISO 21550:2004 Transmisión, 24 parches): misma geometría con las densidades nominales del Anexo A de transmisión ordenadas de mayor a menor densidad: (cobertura ).- Distribución
scaled: redistribuye linealmente los parches ( o ) entredmin(por defecto ) ydmax. Si no se indicadmaxy hay ruido activo, extiende el rango hasta para garantizar que el umbral caiga dentro de la carta.
:::warning Disposición espacial anti-flare
La carta iso_21550 utiliza una cuadrícula compacta para validar algoritmos digitales de lectura de parches y cálculo de ; 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 y nivel digital normalizado :
- Lineal (
linear): - Potencia (
power):
Las restricciones de validación exigen , y . Los archivos TIFF exportados conservan el dominio lineal de la OECF sin codificación sRGB adicional.
3.4. Modelo de SNR Incremental () y Ruido
La señal incremental y la relación señal-ruido incremental en el parche se definen como:
Dado el rango dinámico objetivo y el umbral (por defecto ), la exposición límite es y se calibra la varianza de lectura para cumplir :
- Ruido gaussiano constante (
gaussian): - Ruido dependiente de señal (
signal_dependent): varianza heterocedástica , con : - Ruido correlacionado (
correlated): ruido normal blanco filtrado con un núcleo gaussiano de desviacióncorrelation_sigma_pxy renormalizado por parche para preservar alterando la autocorrelación espacial (NPS). - Sin ruido (
none): parches deterministas (, sujeto únicamente a cuantización de salida).
3.5. Calibración Analítica vs. Empírica y Estimadores de Medida
- Calibración
analytical: resuelve directamente mediante las ecuaciones anteriores. - Calibración
empirical: ejecuta una simulación auxiliar independiente de campos con el formato de bits elegido y ajusta un factor multiplicativo sobre la amplitud de ruido mediantescipy.optimize.brentqusando la ganancia OECF analítica (evitando circularidad con el estimador de diferencias finitas). - Observadores reportados en el JSON de salida:
observed.finite_difference: estima 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 junto con las desviaciones típicas medidas en las ROI de píxeles.- El cruce con el umbral 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 Interfaz | Clave JSON (config) | Campo API (SimulationConfig) | Tipo | Predeterminado | Valores admitidos / Descripción |
|---|---|---|---|---|---|
| Tipo de escala tonal | chart.kind | chart | str | '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 densidades | chart.distribution | distribution | str | 'nominal' | 'nominal' (densidades estándar de la carta) o 'scaled' (densidades equiespaciadas sintéticas). |
| Densidad mínima (Dmin) | chart.dmin | dmin | float | null | null | Límite inferior en scaled ( por defecto) o extremo en iso_21550 nominal. No permitido en kodak_q13 nominal. |
| Densidad máxima (Dmax) | chart.dmax | dmax | float | null | null | Límite superior en scaled (si es null con ruido, se ajusta a objetivo + 1 EV) o extremo en iso_21550 nominal. |
4.2. Pestaña «Simulación de Sensor» (simulation)
| Etiqueta en Interfaz | Clave JSON (config) | Campo API (SimulationConfig) | Tipo | Predeterminado | Valores admitidos / Descripción |
|---|---|---|---|---|---|
| Rango dinámico objetivo | simulation.dynamic_range | dynamic_range | float | 5.0 | Rango dinámico objetivo; convertido a EV debe ser finito y estar en . |
| Unidad | simulation.unit | unit | str | 'EV' | 'EV', 'density' (densidad óptica D) o 'dB' (convención de amplitud ). |
| Umbral SNRi | simulation.snr_threshold | snr_threshold | float | 1.0 | Umbral positivo y finito de SNR incremental (). ISO 21550 emplea . |
| Calibración de ruido | simulation.calibration | calibration | str | 'analytical' | 'analytical' (fórmula cerrada) o 'empirical' (búsqueda brentq en campos ; requiere ruido). |
| Permitir extrapolación | simulation.allow_extrapolation | allow_extrapolation | bool | false | Permite generar aunque el objetivo supere la cobertura de la carta (el cruce medido puede resultar null). |
| Realizaciones (frames) | simulation.realizations | realizations | int | 1 | Número de imágenes TIFF independientes generadas ( a ). |
| Semilla | simulation.seed | seed | int | 42 | Semilla del generador pseudoaleatorio para reproducibilidad exacta. |
4.3. Pestaña «Modelo de Ruido» (noise)
| Etiqueta en Interfaz | Clave JSON (config) | Campo API (SimulationConfig) | Tipo | Predeterminado | Valores admitidos / Descripción |
|---|---|---|---|---|---|
| Modelo | noise.model | noise_model | str | 'gaussian' | 'none', 'gaussian', 'signal_dependent' o 'correlated'. |
| Coeficiente de varianza shot | noise.shot_variance_coefficient | shot_variance_coefficient | float | 0.0 | Coeficiente de varianza proporcional a ; solo actúa en signal_dependent. |
| Sigma de correlación (px) | noise.correlation_sigma_px | correlation_sigma_px | float | 1.5 | Desviación típica del filtro gaussiano espacial (); solo actúa en correlated. |
4.4. Pestaña «OECF y Respuesta» (oecf)
| Etiqueta en Interfaz | Clave JSON (config) | Campo API (SimulationConfig) | Tipo | Predeterminado | Valores admitidos / Descripción |
|---|---|---|---|---|---|
| Modelo | oecf.model | oecf | str | 'linear' | 'linear' () o 'power' (). |
| Gamma | oecf.gamma | gamma | float | 1.0 | Exponente ; debe ser 1.0 cuando oecf.model = 'linear'. |
| Ganancia | oecf.gain | gain | float | 0.75 | Ganancia normalizada , cumpliendo . |
| Offset | oecf.offset | offset | float | 0.10 | Nivel digital basal aplicado también al fondo exterior de la carta. |
4.5. Pestaña «Opciones de Salida» (output)
| Etiqueta en Interfaz | Clave JSON (config) | Campo API (SimulationConfig) | Tipo | Predeterminado | Valores admitidos / Descripción |
|---|---|---|---|---|---|
| Profundidad de bits | output.bit_depth | bit_depth | int | str | 16 | 8 (uint8), 10, 12, 16 (uint16 recortado a ) o '32f' (float32 sin recorte, ideal para validación numérica). |
| Tamaño de parche (px) | output.patch_size | patch_size | int | 80 | Lado de cada parche cuadrado en píxeles (mínimo 64 para alojar la ROI centrada de ). |
| Separación entre parches (px) | output.gap | gap | int | 8 | Separación horizontal y vertical entre parches (). |
| Margen exterior (px) | output.margin | margin | int | 24 | Margen perimetral de fondo (). 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:
- Vista previa PNG (
*_dynamic_range_<carta>_<dr><unit>_seed-<seed>.png): imagen de 8 bits para previsualización directa en el navegador. - Realizaciones TIFF (
*_dynamic_range_001.tiff…*_dynamic_range_NNN.tiff): imágenes monocromas lineales (photometric='minisblack') en la profundidad de bits configurada (uint8,uint16ofloat32). - Manifiesto JSON (
*_dynamic_range.json): contieneconfig,chart(disposición, densidades, cobertura tonal y cajasroi_boxes_y0_x0_y1_x1),target(EV, densidad, contraste, dB, umbral y exposición límite),noise,observed.finite_difference,observed.analytic_gain_oracleywarnings. - Tabla CSV por parche (
*_dynamic_range_patches.csv): incluye por cada parchepatch,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 coordenadasroi_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 como referencia de exposición .
- La geometría
iso_21550() 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 sobre EV (no sobre ).
- El modo
signal_dependentemplea una aproximación gaussiana heterocedástica (no Poisson discreto en electrones) ycorrelatedaplica un filtro gaussiano espacial sin modelo óptico de NPS de escáner real.