📋

Lookup Table

Math
Ejecutar el ejemplo en vivo Gratis · sin registro · funciona en tu navegador

El bloque LookupTable implementa una tabla de búsqueda unidimensional (LUT) con métodos configurables de interpolación lineal o por splines cúbicos y extrapolación. Mapea una señal de entrada escalar arbitraria uu a un valor de salida interpolado yy utilizando puntos de corte estrictamente crecientes (XX) y sus correspondientes valores de salida (YY).

En el Editor de Propiedades, ambas series (XX e YY) se editan directamente en una hoja de cálculo tipo Excel (Hoja de datos (X / Y)) acompañada de una vista previa gráfica en vivo (y = f(x)) que muestra al instante la curva y el modo de interpolación (linear o spline). Además, permite guardar y cargar tablas mediante exportación e importación CSV (lut_data.csv), admitiendo separadores de coma (,), punto y coma (;) y tabulador (\t).

Modelo Matemático

Dados NN puntos de corte estrictamente monótonos crecientes x0<x1<⋯<xN−1x_0 < x_1 < \dots < x_{N-1} y sus valores tabulados y0,y1,…,yN−1y_0, y_1, \dots, y_{N-1}:

Para una entrada uu comprendida en el intervalo xk≤u≤xk+1x_k \le u \le x_{k+1} (0≤k<N−10 \le k < N-1):

y(u)=yk+yk+1−ykxk+1−xk(u−xk)y(u) = y_k + \frac{y_{k+1} - y_k}{x_{k+1} - x_k} (u - x_k)

Cuando interpolation se ajusta a spline, el bloque genera un spline cúbico natural a través de todos los nodos, garantizando derivadas primera y segunda continuas (continuidad C2C^2):

y(u)=ak(u−xk)3+bk(u−xk)2+ck(u−xk)+dky(u) = a_k (u - x_k)^3 + b_k (u - x_k)^2 + c_k (u - x_k) + d_k

Si la entrada uu queda fuera del rango de puntos de corte (u<x0u < x_0 o u>xN−1u > x_{N-1}), la salida se rige según el modo extrapolation:

y(u)={y0,u<x0(extrapolation=clip)yN−1,u>xN−1(extrapolation=clip)y0+y1−y0x1−x0(u−x0),u<x0(extrapolation=linear)yN−1+yN−1−yN−2xN−1−xN−2(u−xN−1),u>xN−1(extrapolation=linear)y(u) = \begin{cases} y_0, & u < x_0 \quad (\text{extrapolation} = \text{clip}) \\ y_{N-1}, & u > x_{N-1} \quad (\text{extrapolation} = \text{clip}) \\ y_0 + \frac{y_1 - y_0}{x_1 - x_0}(u - x_0), & u < x_0 \quad (\text{extrapolation} = \text{linear}) \\ y_{N-1} + \frac{y_{N-1} - y_{N-2}}{x_{N-1} - x_{N-2}}(u - x_{N-1}), & u > x_{N-1} \quad (\text{extrapolation} = \text{linear}) \end{cases}

Entradas y Salidas

Direction ID Label Tipo Status
→ In in In number Required
← Out out Out number Output

Parámetros

Parámetros Label Tipo Por defecto Descripción
breakpoints Lookup Table (X / Y) table 0 1 2 3
tableData Table Data text 0 1 4 9
interpolation Interpolation select linear
extrapolation Extrapolation select clip

Ejemplos de Uso

Ejemplo 1: Linealización de sensor térmico por termistor NTC

En lazos de adquisición de temperatura, los termistores NTC exhiben una curva de resistencia exponencial acusadamente no lineal. Introducir las tensiones ADC X=[0.5,1.2,2.1,3.3,4.2]X = [0.5, 1.2, 2.1, 3.3, 4.2] y las temperaturas calibradas Y=[−10,15,45,80,110]Y = [-10, 15, 45, 80, 110] en la hoja de datos del bloque LookupTable (o importarlas desde un archivo CSV) produce una señal linealizada precisa en grados Celsius (∘C^\circ\text{C}).

Ejemplo 2: Curva de sustentación alar con saturación por entrada en pérdida

Modelado del coeficiente aerodinámico de sustentación CLC_L respecto al ángulo de ataque α\alpha en grados. Los puntos de corte -15 -10 0 10 15 20 se vinculan a la tabla -0.8 -0.6 0.1 1.1 1.4 0.9. El ajuste extrapolation = clip previene que rachas de viento extremas provoquen fuerzas de sustentación no físicas más allá de la entrada en pérdida.

Observaciones y Buenas Prácticas

  • Hoja de cálculo interactiva y vista previa en vivo: Al hacer doble clic en el bloque se abre una tabla de dos columnas (X e Y) con numeración de filas, botón + Añadir fila (Punto) y una gráfica en tiempo real de la curva LUT.
  • Guardar y cargar CSV (Importar / Exportar): Use Exportar CSV para descargar la tabla como lut_data.csv o Importar CSV para cargar datos desde archivos Excel/CSV (separados por comas, punto y coma o tabuladores).
  • Requisito de monotonicidad estricta: Los valores en breakpoints (XX) se ordenan automáticamente de forma creciente (xk+1>xkx_{k+1} > x_k).
  • Búsqueda binaria eficiente: El motor WebAssembly implementa una partición dicotómica con coste O(log⁡N)O(\log N), manteniendo una ejecución ultrarrápida incluso con tablas extensas.
  • Suavidad de derivadas: El modo spline evita quiebros angulares en los nodos, facilitando el trabajo a los solucionadores ODE de paso variable como RK45 o TR-BDF2.

Preguntas Frecuentes (FAQ)

Q: How does lookup table interpolation handle out-of-bounds input values?

BlockWerk clamps inputs to the table boundary limits [xmin⁡,xmax⁡][x_{\min}, x_{\max}] (flat extrapolation) by default. Flat clamping protects physical models (e.g. non-negative friction, engine torque maps, or fluid density) against runaway divergence, whereas unrestricted linear extrapolation can produce non-physical negative values that crash downstream ODE solvers.

Bloques Relacionados

  • LookupTable2D: Tabla de búsqueda bidimensional con matriz interactiva 2D e interpolación bilineal/bicúbica de superficies z=f(x,y)z = f(x, y).
  • MathFunction: Funciones matemáticas analíticas elementales (exp⁡\exp, ln⁡\ln, pow\text{pow}, round\text{round}).
  • Saturation: Limita señales continuas entre umbrales paramétricos fijos.