Lemonergy · Studio block

Ideal transformer

Ideal lossless voltage/current transformation; each winding needs a voltage reference

Implementation ID
ideal-transformer
Reviewed
2026-10-27

Behavior

Conserving component solved simultaneously with the connected network. Ideal lossless voltage/current transformation; each winding needs a voltage reference

Interface

Ideal transformer interfaceInputs or arguments on the left, observed outputs on the right. Conserving terminals appear below the component. The tables give units and behavior.Ideal transformerStudio blockvoltageSecondarycurrentSecondarycurrentpnst
Original Lemonergy interface view. Lines identify ports; they are not a completed simulation circuit.
Ports and observed outputs
NameDirectionUnitMeaning
pterminalV; Aelectrical conserving connection; voltage across and current through the connected branch.
nterminalV; Aelectrical conserving connection; voltage across and current through the connected branch.
sterminalV; Aelectrical conserving connection; voltage across and current through the connected branch.
tterminalV; Aelectrical conserving connection; voltage across and current through the connected branch.
voltageSecondaryoutputVRecorded voltage on the secondary port measurement from the conserving simulation.
currentSecondaryoutputARecorded current on the secondary port measurement from the conserving simulation.
currentoutputARecorded current measurement from the conserving simulation.

Parameters

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

Configuration fields
ParameterUnitDefaultMeaning and limits
Turns ratio
turnsRatio
primary/secondary turns2Primary turns divided by secondary turns.
Minimum 1e-06; Maximum 1000000

Equations and rules

  • Vp = n Vs
  • Is = −n Ip
  • Vp Ip + Vs Is = 0

Worked example

Ideal transformer worked example

Editable first-party network. supply: voltageV=1; load: resistanceOhm=4. Checks below were verified in the native execution engine.

Open Studio example after release →
Numerical checks for the bundled synthetic example
OutputTime (s)Expected valueUnitAbsolute tolerance
voltageSecondary
target/voltageSecondary
10.5V5e-07
currentSecondary
target/currentSecondary
1-0.125A1.25e-07
current
target/current
10.0625A6.25e-08

Use in a workflow

Ideal transformer worked example

Ideal lossless voltage/current transformation; each winding needs a voltage reference

  1. Ideal transformer: Conserving component solved simultaneously with the connected network. Ideal lossless voltage/current transformation; each winding needs a voltage reference
    • Use the block reference for settings and connections.
    • Implementation tested locally; public release pending.
Open Studio example after release

Connected concepts

Limits and interpretation

  • Ideal lossless voltage/current transformation; each winding needs a voltage reference
  • Demonstration parameters are not calibrated hardware data. Singular or incompatible ideal constraints and unsupported state ranges stop the run.

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. Transformers

    OpenStax, Rice University

    Technical reference · Underlying physical law or reduced-model basis; Lemonergy implementation choices and limits are documented separately.

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)