lemonergy· battery engineering courses

Lemonergy · Studio block

Sampled hysteresis relay

Switches between two output levels using separate on and off thresholds.

Implementation ID
native-sampled-relay
Reviewed
2026-10-27

Behavior

Turn on at u ≥ on threshold; turn off at u ≤ off threshold; retain state between. The worked example connects this operation to signals in Lemonergy Studio.

Interface

Sampled hysteresis relay interfaceInputs or arguments on the left, observed outputs on the right. Conserving terminals appear below the component. The tables give units and behavior.Sampled hysteresis relayStudio blockin0out0
Original Lemonergy interface view. Lines identify ports; they are not a completed simulation circuit.
Ports and observed outputs
NameDirectionUnitMeaning
in0input1Value; real scalar.
out0output1Output; real scalar.

Parameters

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

Configuration fields
ParameterUnitDefaultMeaning and limits
Sample period
sampleTimeS		s0.1Exact sample grid period. Elapsed-time integration begins after initialization.
Minimum 1e-06
Switch-on threshold
params[0]		12Configured finite numerical parameter.
Switch-off threshold
params[1]		11Configured finite numerical parameter.
On value
params[2]		15Configured finite numerical parameter.
Off value
params[3]		10Configured finite numerical parameter.
Initially on
tables[0]		1[0]0 or 1.

Equations and rules

  • Turn on at u ≥ on threshold; turn off at u ≤ off threshold; retain state between

Worked example

Sampled hysteresis relay — worked example

Value = 3. Output at 0 s = 5.

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

Explore the recorded outputs

Sampled hysteresis relay recorded example

Sampled hysteresis relay
Sampled hysteresis relay against timeRecorded synthetic simulation values. Time in seconds; output in —.4.504.750.2550.55.250.755.51—Time (s)
Sampled hysteresis relay: 5 — at 0 s

11 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

Sampled hysteresis relay — worked example

Switches between two output levels using separate on and off thresholds.

  1. Sampled hysteresis relay: Turn on at u ≥ on threshold; turn off at u ≤ off threshold; retain state between. 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

  • Hysteresis commits on configured sample instants. Continuous threshold event localization is not implemented.
  • 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)