lemonergy· battery engineering courses

Lemonergy · Studio block

Algebraic residual constraint

Solves a connected residual equation for an unknown, starting from a configured guess.

Implementation ID
native-algebraic-constraint
Reviewed
2026-10-27

Behavior

Find x such that connected residual F(x) = 0. The worked example connects this operation to signals in Lemonergy Studio.

Interface

Algebraic residual constraint interfaceInputs or arguments on the left, observed outputs on the right. Conserving terminals appear below the component. The tables give units and behavior.Algebraic residual constraintStudio blockin0out0
Original Lemonergy interface view. Lines identify ports; they are not a completed simulation circuit.
Ports and observed outputs
NameDirectionUnitMeaning
in0input1Residual; real scalar.
out0output1Unknown; real scalar.

Parameters

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

Configuration fields
ParameterUnitDefaultMeaning and limits
Initial unknown guess
tables[0]		1[2]Connect a residual expression depending on this output. Newton solves residual=0; inconsistent constraints stop the run.

Equations and rules

  • Find x such that connected residual F(x) = 0

Worked example

Algebraic residual constraint — worked example

The Studio example connects the unknown to the residual x² − 4 and starts from x=1. The native nonlinear solve reaches x=2 with residual zero; an inconsistent constraint stops with a diagnostic.

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

Explore the recorded outputs

Algebraic residual constraint recorded example

Algebraic residual constraint
Algebraic residual constraint against timeRecorded synthetic simulation values. Time in seconds; output in —.1.501.750.2520.52.250.752.51—Time (s)
Algebraic residual constraint: 2 — 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

Algebraic residual constraint — worked example

Solves a connected residual equation for an unknown, starting from a configured guess.

  1. Algebraic residual constraint: Find x such that connected residual F(x) = 0. 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

  • Explicit unknown with configured initial guess and connected residual. Dense damped Newton solution; inconsistent/singular residuals fail. This is not singular-DAE support.
  • Shapes and element types are explicit. Values must be finite; automatic reshaping and unit conversion are not performed.

Reference basis

This software operation and its numerical conventions are defined by the public contract and worked example; no external research result is claimed.

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)