Appearance
Ideal Transformer (1-phase)
Single-phase ideal two-winding transformer. Enforces V2/V1 = 1/n and I2/I1 = -n, where n is the turns ratio. Primary and secondary winding currents can each be monitored with a '+ve in' / '+ve out' sign convention, shown by a blue arrow on the winding's dotted lead. Use for level-shifting and isolation in voltage / control studies.
Category: Transformers
Ports
| Port | Kind | Signal | Notes |
|---|---|---|---|
p1 | Electrical terminal | — | |
p2 | Electrical terminal | — | |
s1 | Electrical terminal | — | |
s2 | Electrical terminal | — |
Parameters
Config
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| n | Number | 1 | — | Turns ratio N1:N2 = n:1. V_p1p2 = n * V_s1s2 and I_p = -I_s / n. | turns_ratio |
| Current monitoring - primary winding | Choice: Off / On | Off | — | Emit the primary winding current (at the dotted terminal p1) as a simulator observable. | measure_current |
| Primary positive direction | Choice: +ve in / +ve out | +ve in | — | Sign convention for the monitored primary current. '+ve in' = positive when current flows into the winding at p1; '+ve out' = positive when it flows out of p1. | current_dir |
| Current monitoring - secondary winding | Choice: Off / On | Off | — | Emit the secondary winding current (at the dotted terminal s1) as a simulator observable. | measure_current_s |
| Secondary positive direction | Choice: +ve in / +ve out | +ve out | — | Sign convention for the monitored secondary current. '+ve in' = positive when current flows into the winding at s1; '+ve out' = positive when it flows out of s1. With primary '+ve in' and secondary '+ve out', I_s = n * I_p. | current_dir_s |
Current Monitoring
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Primary current name | Text | I | — | Signal name for the monitored primary winding current. Change the default `I` when you have multiple measured components — duplicate ids collide. | current_name |
| Secondary current name | Text | Is | — | Signal name for the monitored secondary winding current. Change the default `I_s` when you have multiple measured components — duplicate ids collide. | current_name_s |
Observables
| Default name | Kind | Recorded when | Description | ID |
|---|---|---|---|---|
| set by Primary current name | Signal | Current monitoring - primary winding is on | Primary winding current at p1 (A). Positive into p1 for '+ve in' (default), out of p1 for '+ve out'. | primaryCurrent |
| set by Secondary current name | Signal | Current monitoring - secondary winding is on | Secondary winding current at s1 (A). Positive out of s1 for '+ve out' (default), into s1 for '+ve in'. | secondaryCurrent |