lemonergy· battery engineering courses

Lemonergy · Studio block

N-D lookup table

Interpolates a calibration table along its input axes.

Implementation ID
native-lookup-nd
Reviewed
2026-10-27

Behavior

1-D: y = (1 − f) table[k] + f table[k + 1]. N-D: y = sum of corner values weighted by the product of each axis weight. The worked example connects this operation to signals in Lemonergy Studio.

Interface

N-D lookup table interfaceInputs or arguments on the left, observed outputs on the right. Conserving terminals appear below the component. The tables give units and behavior.N-D lookup tableStudio blockin0in1in2out0
Original Lemonergy interface view. Lines identify ports; they are not a completed simulation circuit.
Ports and observed outputs
NameDirectionUnitMeaning
in0input1x; real scalar.
in1input1y; real scalar.
in2input1z; real scalar.
out0output1Value; real scalar.

Parameters

Defaults are initial model values. Select values for your own model and operating conditions.

Configuration fields
ParameterUnitDefaultMeaning and limits
Outside table
params[0]		100 clamp to end values; 1 linear extrapolation.
x breakpoints
tables[0]		1[0, 1]Configured coefficients or initial values in column-major order.
y breakpoints
tables[1]		1[0, 1]Configured coefficients or initial values in column-major order.
z breakpoints
tables[2]		1[0, 1]Configured coefficients or initial values in column-major order.
Table values
tables[3]		1[0, 1, 2, 3, 4, 5, 6, 7]Up to six dimensions, multilinear interpolation.

Equations and rules

  • 1-D: y = (1 − f) table[k] + f table[k + 1]
  • N-D: y = sum of corner values weighted by the product of each axis weight

Worked example

N-D lookup table — worked example

x = 0.5; y = 0.5; z = 0.5. Value at 0 s = 3.5.

Open Studio example after release →
Numerical checks for the bundled synthetic example
OutputTime (s)Expected valueUnitAbsolute tolerance
Value
out0		03.511e-08

Explore the recorded outputs

N-D lookup table recorded example

N-D lookup table
N-D lookup table against timeRecorded synthetic simulation values. Time in seconds; output in —.303.250.253.50.53.750.7541—Time (s)
N-D lookup table: 3.5 — at 0 s

2 actual recorded samples. Lines are visual guides between samples. Synthetic example, not measured cell data.

Download the recorded samples (JSON) · Open this Studio example after release

Use in a workflow

N-D lookup table — worked example

Interpolates a calibration table along its input axes.

  1. N-D lookup table: 1-D: y = (1 − f) table[k] + f table[k + 1]. N-D: y = sum of corner values weighted by the product of each axis weight. The worked example connects this operation to signals in Lemonergy Studio.
    • Use the block reference for settings and connections.
    • Implementation tested locally; public release pending.
Open Studio example after release

Connected concepts

Limits and interpretation

  • Up to6 dimensions; strict increasing breakpoints; multilinear interpolation; clamp or linear extrapolation.
  • Shapes and element types are explicit. Values must be finite; automatic reshaping and unit conversion are not performed.

Scientific and mathematical references

These sources explain the scientific and mathematical background. The behavior, interface and limits above define the Lemonergy implementation; a citation does not imply every model option in the source is implemented.

  1. NIST Digital Library of Mathematical Functions, §3.3 Interpolation

    National Institute of Standards and Technology

    Technical reference · Interpolation formulas, including linear interpolation equation 3.3.14.

Implementation sources

This reference follows the public interface and locally verified numerical checks for an upcoming release.

Contract: Lemonergy Studio public contract · Verification record: verification-2026-10-27

  • docs/glossary/native-block-verification.json

This implementation and its workflow uses (JSON) · Knowledge graph (JSON-LD)