Appearance
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.
Aliases: SimCompElecTransformer
Category: Transformers
Keywords: 1-phase, 1-ph, 1 ph, 1ph, single, single-phase, single phase, phase, ph, trafo, TX, tx, winding, primary, secondary, turns ratio, isolation
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 | — | Observable id 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). |
Implemented in C++ class SimCompElecTransformer (components/electrical/sim_comp_elec_transformer/sim_comp_elec_transformer.h).