lemonergy· battery engineering courses

Lemonergy · Studio block

Independent electrothermal battery

Evolves independent state of charge from signed terminal current, using linear OCV and temperature-dependent resistance while delivering Joule heat at h.

Implementation ID
electrothermal-battery
Reviewed
2026-10-30

Behavior

Evolves independent state of charge from signed terminal current, using linear OCV and temperature-dependent resistance while delivering Joule heat at h.

Interface

Batterypconserving · electricalnconserving · electricalhconserving · thermalvoltageoutput · Vcurrentoutput · Apoweroutput · Wsoc Signaloutput · fractiontemperatureoutput · Kocvoutput · Vresistanceoutput · Ωlossoutput · Wchemical Energyoutput · J
Select a terminal or signal to inspect its meaning. This is a conceptual interface, not simulation output.
Ports and observed outputs
NameDirectionUnitMeaning
pconservingelectricalPositive voltage-reference terminal
nconservingelectricalNegative voltage-reference terminal
hconservingthermalBulk-temperature and Joule-heat contact
voltageoutputVDirected output available to compatible consumers: voltage.
currentoutputADirected output available to compatible consumers: current.
poweroutputWDirected output available to compatible consumers: power.
soc SignaloutputfractionDirected output available to compatible consumers: soc Signal.
temperatureoutputKDirected output available to compatible consumers: temperature.
ocvoutputVDirected output available to compatible consumers: ocv.
resistanceoutputΩDirected output available to compatible consumers: resistance.
lossoutputWDirected output available to compatible consumers: loss.
chemical EnergyoutputJDirected output available to compatible consumers: chemical Energy.

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
PinDirectionUnit or domainMeaning
voltageoutputVDirected output available to compatible consumers: voltage.
currentoutputADirected output available to compatible consumers: current.
poweroutputWDirected output available to compatible consumers: power.
soc SignaloutputfractionDirected output available to compatible consumers: soc Signal.
temperatureoutputKDirected output available to compatible consumers: temperature.
ocvoutputVDirected output available to compatible consumers: ocv.
resistanceoutputΩDirected output available to compatible consumers: resistance.
lossoutputWDirected output available to compatible consumers: loss.
chemical EnergyoutputJDirected output available to compatible consumers: chemical Energy.

Parameters

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

Configuration fields
ParameterUnitDefaultMeaning and limits
capacityAh
capacityAh		Ah100Declared authoring field: capacityAh.
Minimum 1e-06; Maximum 1000000000
initialSoc
initialSoc		fraction0.8Declared authoring field: initialSoc.
Minimum 0; Maximum 1
emptyVoltageV
emptyVoltageV		V300Declared authoring field: emptyVoltageV.
Minimum 0.01; Maximum 1000000
fullVoltageV
fullVoltageV		V420Declared authoring field: fullVoltageV.
Minimum 0.01; Maximum 1000000
resistanceOhm
resistanceOhm		ohm0.08Declared authoring field: resistanceOhm.
Minimum 1e-08; Maximum 1000000
capacitySoh
capacitySoh		fraction1Declared authoring field: capacitySoh.
Minimum 0.01; Maximum 1
resistanceMultiplier
resistanceMultiplier		multiplier1Declared authoring field: resistanceMultiplier.
Minimum 0.01; Maximum 1000
referenceTemperatureK
referenceTemperatureK		K298.15Declared authoring field: referenceTemperatureK.
Minimum 1; Maximum 2000
resistanceTemperatureCoefficient
resistanceTemperatureCoefficient		1/K0Declared authoring field: resistanceTemperatureCoefficient.
Minimum -0.01; Maximum 0.1
initialThroughputAh
initialThroughputAh		Ah0Declared authoring field: initialThroughputAh.
Minimum 0; Maximum 1000000000000

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

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: 0a28f1a0a75a0447903b868cbcc734133a77a847

  • 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: 0a28f1a0a75a0447903b868cbcc734133a77a847. File content hashes in the public descriptor catalog identify the exact source snapshot. Existing numerical checks above retain their own verification scope.