Lemonergy · Core equation

nominal_energy_wh

Calculate nominal stored-energy rating from capacity and voltage.

Implementation ID
nominal_energy_wh
Reviewed
2026-10-27

Behavior

Both inputs must be finite and positive. The result is a nominal rating; delivered energy requires a voltage trajectory and operating constraints.

Interface

nominal_energy_wh interfaceInputs or arguments on the left, observed outputs on the right. Conserving terminals appear below the component. The tables give units and behavior.nominal_energy_whCore equationnominal_capacity_ahnominal_voltage_vreturn
Original Lemonergy interface view. Lines identify ports; they are not a completed simulation circuit.
Ports and observed outputs
NameDirectionUnitMeaning
returnoutputWhScalar float or NumPy array following broadcasting.

Parameters

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

Configuration fields
ParameterUnitDefaultMeaning and limits
nominal capacity ah
nominal_capacity_ah
AhSupplied by the userPositive nominal capacity.
nominal voltage v
nominal_voltage_v
VSupplied by the userPositive nominal voltage.

Equations and rules

  • E_Wh = Q_Ah * V_nominal

Worked example

Estimate nominal energy

A 5 Ah cell rated 3.6 V has 18 Wh nominal energy. Ten identical cells contain 180 Wh nominally.

Open the worked lesson →

Use in a workflow

Estimate nominal energy

Lemonergy Core evaluates this relation.

  1. nominal_energy_wh: Core equation
    • Capacity (Ah)
    • Nominal voltage (V)
Open the worked lesson

Connected concepts

Limits and interpretation

Implementation sources

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

Repository: battery-core · Revision: main

  • src/battery_core/capacity.py

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