📋

Lookup Table

Math
Lancer l’exemple en direct Gratuit · sans inscription · dans votre navigateur

Le bloc LookupTable implémente une table d'interpolation unidimensionnelle (LUT) avec méthodes d'interpolation linéaire ou par splines cubiques et d'extrapolation configurables. Il associe une entrée scalaire arbitraire uu à une valeur de sortie interpolée yy à l'aide de points de rupture strictement croissants (XX) et des valeurs de sortie associées (YY).

Dans l'Éditeur de Propriétés, les deux séries (XX et YY) sont éditées côte à côte dans une feuille de calcul de type Excel (Feuille de calcul (X / Y)) associée à un aperçu graphique en direct (y = f(x)) qui affiche immédiatement les points et le mode d'interpolation (linear ou spline). Vous pouvez également enregistrer et charger vos tables par export et import CSV (lut_data.csv), compatible avec les séparateurs virgule (,), point-virgule (;) et tabulation (\t).

Modèle Mathématique

Soit NN points de rupture d'entrée strictement croissants x0<x1<⋯<xN−1x_0 < x_1 < \dots < x_{N-1} et les valeurs de table associées y0,y1,…,yN−1y_0, y_1, \dots, y_{N-1} :

Pour une entrée uu appartenant à l'intervalle 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)

Lorsque interpolation est paramétré sur spline, le bloc construit une spline cubique naturelle passant par l'ensemble des points, assurant la continuité des dérivées première et seconde (continuité C2C^2) à travers les nœuds :

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

Lorsque l'entrée uu franchit les bornes de la table (u<x0u < x_0 ou u>xN−1u > x_{N-1}), la sortie est régie par le mode 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}

Entrées & Sorties

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

Paramètres

Paramètres Label Type Défaut Description
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

Exemples d'Utilisation

Exemple 1 : Linéarisation de sonde de température à thermistance CTN

Dans les circuits de mesure thermique, les thermistances à coefficient de température négatif (CTN) présentent une caractéristique exponentielle fortement non linéaire. Saisir les tensions ADC X=[0.5,1.2,2.1,3.3,4.2]X = [0.5, 1.2, 2.1, 3.3, 4.2] et les températures étalonnées Y=[−10,15,45,80,110]Y = [-10, 15, 45, 80, 110] dans la feuille de calcul du bloc LookupTable (ou les importer depuis un fichier CSV) fournit une mesure linéarisée précise en degrés Celsius (∘C^\circ\text{C}).

Exemple 2 : Coefficient de portance d'aile avec saturation au décrochage

Modélisation du coefficient aérodynamique de portance CLC_L en fonction de l'angle d'incidence α\alpha en degrés. Les points de rupture -15 -10 0 10 15 20 sont associés aux valeurs de table -0.8 -0.6 0.1 1.1 1.4 0.9. Le paramètre extrapolation = clip empêche les rafales de vent extrêmes de générer des efforts de portance supersoniques non physiques au-delà du décrochage.

Remarques & Bonnes Pratiques

  • Feuille de calcul interactive et aperçu en direct : Double-cliquez sur le bloc pour ouvrir la table à deux colonnes (X et Y) avec numérotation des lignes, bouton + Ajouter une ligne (Point) et aperçu graphique en temps réel.
  • Sauvegarde et chargement CSV (Import / Export) : Cliquez sur Exporter CSV pour télécharger la table sous lut_data.csv ou sur Importer CSV pour charger des mesures depuis Excel/CSV (séparateurs virgule, point-virgule ou tabulation).
  • Contrainte de monotonicité : Les valeurs de breakpoints (XX) sont automatiquement triées par ordre croissant (xk+1>xkx_{k+1} > x_k).
  • Recherche dichotomique rapide : Le moteur WebAssembly recourt à une partition binaire en O(log⁡N)O(\log N) pour localiser l'intervalle actif, assurant une exécution rapide même sur de grandes bases de données.
  • Régularité des dérivées : L'option spline élimine les discontinuités de pente aux nœuds, garantissant une intégration numérique stable avec les solveurs RK45 ou TR-BDF2.

Questions Fréquemment Posées (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.

Composants Associés

  • LookupTable2D: Table d'interpolation bidimensionnelle avec matrice interactive 2D et interpolation de surface bilinéaire/bicubique z=f(x,y)z = f(x, y).
  • MathFunction: Fonctions mathématiques usuelles (exp⁡\exp, ln⁡\ln, pow\text{pow}, round\text{round}).
  • Saturation: Limite l'amplitude d'un signal dynamique entre deux bornes fixes.