Lemonergy · Studio block

Average bidirectional source converter

Transfers average power between source p/n and bus s/t with signed direction, current limits and conversion losses delivered to its heat contact.

Implementation ID: source-converter
Reviewed: 2026-10-30

Behavior

Transfers average power between source p/n and bus s/t with signed direction, current limits and conversion losses delivered to its heat contact.

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
`p`	conserving	electrical	Positive voltage-reference terminal
`n`	conserving	electrical	Negative voltage-reference terminal
`s`	conserving	electrical	Bus positive voltage-reference terminal
`t`	conserving	electrical	Bus negative voltage-reference terminal
`h`	conserving	thermal	Conversion-loss thermal contact
`Source and bus terminals`	input	W	Source and bus terminals is a directed power input to this component, expressed in W. Its binding supplies information; it is not a conserving connection.
`Operating permission`	input	1	Operating permission is a directed dimensionless input to this component, expressed in 1. Its binding supplies information; it is not a conserving connection.
`voltage`	output	V	Directed output available to compatible consumers: voltage.
`current`	output	A	Directed output available to compatible consumers: current.
`power`	output	W	Directed output available to compatible consumers: power.
`source Power`	output	W	Directed output available to compatible consumers: source Power.
`bus Power`	output	W	Directed output available to compatible consumers: bus Power.
`loss`	output	W	Directed output available to compatible consumers: loss.
`bus Current`	output	A	Directed output available to compatible consumers: bus Current.

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
Source and bus terminals	input	W	Source and bus terminals is a directed power input to this component, expressed in W. Its binding supplies information; it is not a conserving connection.
Operating permission	input	1	Operating permission is a directed dimensionless input to this component, expressed in 1. Its binding supplies information; it is not a conserving connection.
voltage	output	V	Directed output available to compatible consumers: voltage.
current	output	A	Directed output available to compatible consumers: current.
power	output	W	Directed output available to compatible consumers: power.
source Power	output	W	Directed output available to compatible consumers: source Power.
bus Power	output	W	Directed output available to compatible consumers: bus Power.
loss	output	W	Directed output available to compatible consumers: loss.
bus Current	output	A	Directed output available to compatible consumers: bus Current.

Parameters

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

Configuration fields
Parameter	Unit	Default	Meaning and limits
powerW `powerW`	W source to bus; negative reverse	1000	Declared authoring field: powerW. Minimum -1000000000; Maximum 1000000000
forwardEfficiency `forwardEfficiency`	fraction	0.95	Declared authoring field: forwardEfficiency. Minimum 0.01; Maximum 1
reverseEfficiency `reverseEfficiency`	fraction	0.95	Declared authoring field: reverseEfficiency. Minimum 0.01; Maximum 1
maxPowerW `maxPowerW`	W	100000	Declared authoring field: maxPowerW. Minimum 0; Maximum 1000000000
maxSourceA `maxSourceA`	A	500	Declared authoring field: maxSourceA. Minimum 0; Maximum 1000000
maxBusA `maxBusA`	A	500	Declared authoring field: maxBusA. Minimum 0; Maximum 1000000
minimumVoltageV `minimumVoltageV`	V	10	Declared authoring field: minimumVoltageV. Minimum 0.01; Maximum 1000000

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.