Lemonergy · Studio block

PI controller

Discrete PI on setpoint minus measurement with output bounds; the integral freezes while the output sits at a bound (anti-windup).

Implementation ID: pi-controller
Reviewed: 2026-10-30

Behavior

Discrete PI on setpoint minus measurement with output bounds; the integral freezes while the output sits at a bound (anti-windup).

Interface

Select a terminal or signal to inspect its meaning. This is a conceptual interface, not simulation output.

Ports and observed outputs
Name	Direction	Unit	Meaning
`Setpoint`	input	—	Number; Scalar; real. Received from a connected producer.
`Measurement`	input	—	Number; Scalar; real. Received from a connected producer.
`Output`	output	—	Number; Scalar; real. Produced for connected consumers.

Signal inputs

These directed signals carry information. Conserving terminals exchange the quantities of their physical domain.

Signal outputs

Outputs can supply compatible inputs. Connections and values are inspected in the model that owns them.

Current authoring interface
Pin	Direction	Unit or domain	Meaning
Setpoint	input	—	Number; Scalar; real. Received from a connected producer.
Measurement	input	—	Number; Scalar; real. Received from a connected producer.
Output	output	—	Number; Scalar; real. Produced for connected consumers.

Parameters

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

Configuration fields
Parameter	Unit	Default	Meaning and limits
Sample time `sampleTimeS`	s	0.01	Declared authoring field: Sample time.
Setpoint and measurement quantity `inputQuantity`		dimensionless	Declared authoring field: Setpoint and measurement quantity.
Proportional gain `kp`		1	Declared authoring field: Proportional gain.
Integral gain `ki`	1/s	0	Declared authoring field: Integral gain.
Output minimum `min`		-1	Declared authoring field: Output minimum.
Output maximum `max`		1	Declared authoring field: Output maximum.
Initial integral `initialIntegral`		0	Declared authoring field: Initial integral.

Equations and rules

The behavior and configured interface above define this authoring component. This reference does not add numerical equations beyond its source contract.

Use in Studio

Use this authoring component

Choose this component in the Studio library and configure its declared interface. This reference describes the authoring contract; it does not claim a standalone numerical validation or a measured result.

Open Studio →

Use in a workflow

Connected concepts

Feedback and feedforward control

Limits and interpretation

The symbolic diagram describes the component and its declared interface. It is not a solved circuit or simulated output.
Configured parameters and model connections determine the result. Check the complete model before interpreting its outputs.

Implementation sources

This reference follows Lemonergy implementation sources. Scientific articles support the linked concepts separately.

Repository: battery-design · Revision: e248d21a9902225f1075624f23e7628b54cdb7cc

docs/glossary/studio-help-catalog.json

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

Current authoring interface provenance

The interactive graphic is exported from the same Studio help descriptor. Source base: e248d21a9902225f1075624f23e7628b54cdb7cc. File content hashes in the public descriptor catalog identify the exact source snapshot. Existing numerical checks above retain their own verification scope.