Ideal Transformer

Single-phase ideal two-winding transformer. Enforces V2/V1 = 1/n and I2/I1 = -n, where n is the turns ratio. Use for level-shifting and isolation in voltage / control studies.

Category: Transformers

Ports

Name	Direction	Value type	Notes
p1	electrical	double
p2	electrical	double
s1	electrical	double
s2	electrical	double

Parameters

Config

Name	Label	Type	Default	Units	Description
turns_ratio	n	double	1	—	Turns ratio N1:N2 = n:1. V_p1p2 = n * V_s1s2 and I_p = -I_s / n.
measure_current	Measure current	enum (Off / On)	0	—	Emit primary branch current as a simulator observable.

Current Monitoring

Name	Label	Type	Default	Units	Description
current_name	Current name	string	I	—	Signal name for the measured primary current. Change the default `I` when you have multiple measured components — duplicate ids collide.

Observables

Signal	Type	Default name	Enable	Description
branchCurrent	signal	from current_name	measure_current	Primary branch current through the transformer (A).