lemonergy· battery engineering courses

Lemonergy · Studio block

Pulse power capability

Quasi-static voltage/current/SOC envelope for an explicit prediction horizon.

Implementation ID
battery-power-capability
Reviewed
2026-10-27

Behavior

Combines a constant open-circuit voltage, effective resistance, voltage/current limits and available charge over a prediction horizon. It returns separate charge and discharge current and terminal-power magnitudes.

Interface

Pulse power capability interfaceInputs or arguments on the left, observed outputs on the right. Conserving terminals appear below the component. The tables give units and behavior.Pulse power capabilityStudio blockocvresistancesocdischargechargedischargePowerchargePower
Original Lemonergy interface view. Lines identify ports; they are not a completed simulation circuit.
Ports and observed outputs
NameDirectionUnitMeaning
ocvinputVOpen-circuit voltage; scalar.
resistanceinput1Effective pulse resistance (ohm); scalar.
socinput1 (fraction)State of charge; scalar.
dischargeoutputADischarge-current limit; scalar.
chargeoutputACharge-current magnitude limit; scalar.
dischargePoweroutputWDischarge power; scalar.
chargePoweroutputWCharge power; scalar.

Parameters

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

Configuration fields
ParameterUnitDefaultMeaning and limits
Charge capacity (Ah)
capacityAh		Ah2Charge capacity (Ah). This is an editable model input; the default belongs to the synthetic worked example.
Prediction horizon (s)
horizonS		s60Prediction horizon (s). This is an editable model input; the default belongs to the synthetic worked example.
Minimum voltage (V)
minVoltageV		V3Minimum voltage (V). This is an editable model input; the default belongs to the synthetic worked example.
Maximum voltage (V)
maxVoltageV		V4.2Maximum voltage (V). This is an editable model input; the default belongs to the synthetic worked example.
Maximum discharge current (A)
maxDischargeA		A5Maximum discharge current (A). This is an editable model input; the default belongs to the synthetic worked example.
Maximum charge current (A)
maxChargeA		A3Maximum charge current (A). This is an editable model input; the default belongs to the synthetic worked example.
Minimum SOC (0–1)
minSoc		0–10.2Minimum SOC (0–1). This is an editable model input; the default belongs to the synthetic worked example.
Maximum SOC (0–1)
maxSoc		0–10.8Maximum SOC (0–1). This is an editable model input; the default belongs to the synthetic worked example.

Equations and rules

  • Vterminal = OCV - I * R
  • discharge charge-budget limit = 3600 * capacityAh * (SOC - minSOC) / horizonS
  • Pdischarge = Idischarge * (OCV - Idischarge * R)

Worked example

Pulse power capability worked example

Use the defaults below with Open-circuit voltage = 3.8 V, Effective pulse resistance (ohm) = 0.1 1, State of charge = 0.5 1 (fraction). At 0 s, Discharge-current limit is 5 A. Additional checks are listed below.

Open Studio example after release →
Numerical checks for the bundled synthetic example
OutputTime (s)Expected valueUnitAbsolute tolerance
Discharge-current limit
discharge		05A1e-08
Charge-current magnitude limit
charge		03A1e-08
Discharge power
dischargePower		016.5W1e-08
Charge power
chargePower		012.3W1e-08

Explore the recorded outputs

Pulse power capability recorded example

Pulse power capability / Discharge-current limit
Pulse power capability / Discharge-current limit against timeRecorded synthetic simulation values. Time in seconds; output in A.4.504.750.2550.55.250.755.51ATime (s)
Pulse power capability / Discharge-current limit: 5 A 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

Pulse power capability worked example

Quasi-static voltage/current/SOC envelope for an explicit prediction horizon.

  1. Pulse power capability: Combines a constant open-circuit voltage, effective resistance, voltage/current limits and available charge over a prediction horizon. It returns separate charge and discharge current and terminal-power magnitudes.
    • Use the parameter values in the block reference.
    • Implementation tested locally; public release pending.
Open Studio example after release

Connected concepts

Limits and interpretation

  • This is a quasi-static bound. It excludes polarization dynamics, temperature evolution and weakest-cell limits in a pack.
  • The example verifies numerical behavior for synthetic parameters. Cell characterization and validation for an intended use are separate tasks.

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. Extended Kalman filtering for battery management systems of LiPB-based HEV battery packs: Part 2. Modeling and identification

    Gregory L. Plett · Journal of Power Sources · 2004

    Technical reference · Battery charge balance, open-circuit voltage, ohmic loss, polarization dynamics and model identification; parameters require cell-specific data.

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)