# Three-Winding Nonlinear Transformer

**Libraries:**

Simscape /
Electrical /
Passive /
Transformers

## Description

The Three-Winding Nonlinear Transformer block represents a single-phase, nonlinear, three-winding transformer with a nonideal core. A core may be nonideal due to its magnetic properties or dimensions. This figure shows the equivalent circuit topology:

where:

*R1*is the primary winding resistance.*L1*is the primary leakage inductance.*R2*is the first secondary winding resistance.*L2*is the first secondary leakage inductance.*R3*is the second secondary winding resistance.*L3*is the second secondary leakage inductance.*Rm*is the magnetization resistance.*Lm*is the magnetization inductance.

The block provides the following parameterization options for the nonlinear magnetization inductance:

`Single inductance (linear)`

`Single saturation point`

`Magnetic flux versus current characteristic`

`Magnetic flux density versus magnetic field strength characteristic`

`Magnetic flux density versus magnetic field strength characteristic with hysteresis`

For more information, see the Nonlinear Inductor block reference page.

## Ports

### Conserving

**1+** — Line 1 positive terminal

electrical

Electrical conserving port associated with the positive terminal of line 1.

**1-** — Line 1 negative terminal

electrical

Electrical conserving port associated with the negative terminal of line 1.

**2+** — Line 2 positive terminal

electrical

Electrical conserving port associated with the positive terminal of line 2.

**2-** — Line 2 negative terminal

electrical

Electrical conserving port associated with the negative terminal of line 2.

**3+** — Line 3 positive terminal

electrical

Electrical conserving port associated with the positive terminal of line 3.

**3-** — Line 3 negative terminal

electrical

Electrical conserving port associated with the negative terminal of line 3.

## Parameters

### Main

**Primary number of turns** — Winding 1 primary turns number

`100`

(default) | positive scalar integer

Number of turns of wire on the first primary winding of the transformer.

**First secondary number of turns** — Winding 2 turns number

`200`

(default) | positive scalar integer

Number of turns of wire on the first secondary winding of the transformer.

**Second secondary number of turns** — Winding 3 turns number

`200`

(default) | positive scalar integer

Number of turns of wire on the second secondary winding of the transformer.

**Primary winding resistance** — Winding 1 resistance

`0.01`

`Ohm`

(default) | nonnegative scalar

Resistance for *R1*, which represents the power loss
of the primary winding.

**Primary leakage inductance** — Winding 1 leakage inductance

`0.0001`

`H`

(default) | nonnegative scalar

Inductance for *L1*, which represents the magnetic flux loss of the
primary winding.

**First secondary winding resistance** — Winding 2 resistance

`0.01`

`Ohm`

(default) | nonnegative scalar

Resistance for *R2*, which represents the power loss
of the first secondary winding.

**First secondary leakage inductance** — Winding 2 leakage inductance

`0.0001`

`H`

(default) | nonnegative scalar

Inductance for *L2*, which represents the magnetic flux loss of the
first secondary winding.

**Second secondary winding resistance** — Winding 3 resistance

`0.01`

`Ohm`

(default) | nonnegative scalar

Resistance for *R3*, which represents the power loss
of the second secondary winding.

**Second secondary leakage inductance** — Winding 3 leakage inductance

`0.0001`

`H`

(default) | nonnegative scalar

Inductance for *L3*, which represents the magnetic flux loss of the
second secondary winding.

### Magnetization

**Magnetization resistance** — Magnetization resistance

`100`

`Ohm`

(default)

Resistance for *Rm*, which represents the magnetic losses in the
transformer core.

**Magnetization inductance parameterized by** — Nonlinear magnetization inductance parameterization

```
Single saturation
point
```

(default) | `Single inductance (linear)`

| ```
Magnetic flux versus current
characteristic
```

| ```
Magnetic flux density versus field strength
characteristic
```

| ```
Magnetic flux density versus field strength
characteristic with hysteresis
```

Method of the nonlinear magnetization inductance parameterization:

`Single inductance (linear)`

— Provide the unsaturated inductance value.`Single saturation point`

— Provide the values for the unsaturated and saturated inductances, as well as saturation magnetic flux. This is the default option.`Magnetic flux versus current characteristic`

— Provide the current vector and the magnetic flux vector, and then populate the magnetic flux versus current lookup table.`Magnetic flux density versus field strength characteristic`

— Provide the values for effective core length, cross-sectional area, magnetic field strength vector and the magnetic flux density vector, and then populate the magnetic flux density versus magnetic field strength lookup table.`Magnetic flux density versus field strength characteristic with hysteresis`

— Define magnetic flux density as a function or both the current value and the history of the field strength by providing the number of turns, the effective core length and cross-sectional area, the initial anhysteretic B-H curve gradient, the magnetic flux density and field strength at a certain point on the B-H curve, the coefficient for the reversible magnetization, the bulk coupling coefficient, and the inter-domain coupling factor.

**Unsaturated inductance** — Unsaturated inductance

`4e-2`

`H`

(default)

Value of inductance used when the magnetization inductance *Lm* is
operating in its linear region.

#### Dependencies

To enable this parameter, set the **Magnetization inductance parameterized
by** parameter to ```
Single inductance
(linear)
```

or ```
Single saturation
point
```

.

**Saturated inductance** — Saturated inductance

`1e-2`

`H`

(default)

Value of inductance used when the magnetization inductance *Lm* is
operating beyond its saturation point.

#### Dependencies

To enable this parameter, set the **Magnetization
inductance parameterized by** parameter to
`Single saturation point`

.

**Saturation magnetic flux** — Saturation magnetic flux

`1.6e-04`

`Wb`

(default)

Value of magnetic flux at which the magnetization inductance *Lm*
saturates.

#### Dependencies

To enable this parameter, set the **Magnetization
inductance parameterized by** parameter to
`Single saturation point`

.

**Current vector, i** — Current data

`[0, .4, .8, 1.2, 1.6, 2]`

`A`

(default)

Current data used to populate the magnetic flux versus current lookup table.

#### Dependencies

To enable this parameter, set the **Magnetization
inductance parameterized by** parameter to
```
Magnetic flux versus current
characteristic
```

.

**Magnetic flux vector, phi** — Magnetic flux vector

```
[0, .161, .25, .284, .295, .299] .*
1e-3
```

`Wb`

(default)

Magnetic flux data used to populate the magnetic flux versus current lookup table.

#### Dependencies

To enable this parameter, set the **Magnetization
inductance parameterized by** parameter to
```
Magnetic flux versus current
characteristic
```

.

**Magnetic field strength vector, H** — Magnetic field strength vector

`[0, 200, 400, 600, 800, 1000]`

`A/m`

(default)

Magnetic field strength data used to populate the magnetic flux density versus magnetic field strength lookup table.

#### Dependencies

To enable this parameter, set the **Magnetization
inductance parameterized by** parameter to
```
Magnetic flux density versus field strength
characteristic
```

.

**Magnetic flux density vector, B** — Magnetic flux density vector

`[0, .81, 1.25, 1.42, 1.48, 1.49]`

`T`

(default)

Magnetic flux density data used to populate the magnetic flux density versus magnetic field strength lookup table.

#### Dependencies

To enable this parameter, set the **Magnetization
inductance parameterized by** parameter to
```
Magnetic flux density versus field strength
characteristic
```

.

**Effective length** — Effective length

`0.2`

`m`

(default)

Effective core length, also defined as the average distance of the magnetic path around the transformer core.

#### Dependencies

To enable this parameter, set the **Magnetization
inductance parameterized by** parameter to
```
Magnetic flux density versus field strength
characteristic
```

.

**Effective cross-sectional area** — Effective cross-sectional area

`2e-4`

`m^2`

(default)

Effective core cross-sectional area, also defined as the average area of the magnetic path around the transformer core.

#### Dependencies

**Magnetization
inductance parameterized by** parameter to
```
Magnetic flux density versus field strength
characteristic
```

.

**Anhysteretic B-H gradient when H is zero** — Anhysteretic B-H gradient around zero field strength

`0.005`

`m*T/A`

(default)

Gradient of the anhysteretic B-H curve around zero field strength. Set this parameter to the average gradient of the positive-going and negative-going hysteresis curves.

#### Dependencies

To enable this parameter, set the **Magnetization
inductance parameterized by** parameter to
```
Magnetic flux density versus field strength
characteristic with hysteresis
```

.

**Flux density point on anhysteretic B-H curve** — Flux density point on anhysteretic B-H curve

`1.49`

`T`

(default)

Specify a point on the anhysteretic curve by providing its flux density value. Picking a point at high field strength where the positive-going and negative-going hysteresis curves align is the most accurate option.

#### Dependencies

To enable this parameter, set the **Magnetization
inductance parameterized by** parameter to
```
Magnetic flux density versus field strength
characteristic with hysteresis
```

.

**Corresponding field strength** — Corresponding field strength

`1000`

`A/m`

(default)

Corresponding field strength for the point defined by the **Flux density point
on anhysteretic B-H curve** parameter.

#### Dependencies

To enable this parameter, set the **Magnetization
inductance parameterized by** parameter to
```
Magnetic flux density versus field strength
characteristic with hysteresis
```

.

**Coefficient for reversible magnetization, c** — Coefficient for reversible magnetization

`0.1`

(default)

Proportion of the magnetization that is reversible. The value should be greater than zero and less than one.

#### Dependencies

**Magnetization
inductance parameterized by** parameter to
```
Magnetic flux density versus field strength
characteristic with hysteresis
```

.

**Bulk coupling coefficient, K** — Bulk coupling coefficient

`200`

`A/m`

(default)

Jiles-Atherton parameter that primarily controls the field strength magnitude at which the B-H curve crosses the zero flux density line.

#### Dependencies

**Magnetization
inductance parameterized by** parameter to
```
Magnetic flux density versus field strength
characteristic with hysteresis
```

.

**Inter-domain coupling factor, alpha** — Inter-domain coupling factor

`1e-4`

(default)

Jiles-Atherton parameter that primarily affects the points at which the B-H curves intersect the zero field strength line. Typical values are in the range of 1e-4 to 1e-3.

#### Dependencies

**Magnetization
inductance parameterized by** parameter to
```
Magnetic flux density versus field strength
characteristic with hysteresis
```

.

**Interpolation option** — Interpolation option

`Linear`

(default) | `Smooth`

Lookup table interpolation option. Select one of the following interpolation methods:

`Linear`

— Select this option to get the best performance.`Smooth`

— Produce a continuous curve with continuous first-order derivatives.

For more information on interpolation algorithms, see the PS Lookup Table (1D) block reference page.

#### Dependencies

To enable this parameter, set the **Magnetization
inductance parameterized by** parameter to
```
Magnetic flux versus current
characteristic
```

or ```
Magnetic flux
density versus field strength characteristic
```

.

### Initial Conditions

**Primary leakage inductance initial current** — Primary leakage inductance initial current

`0`

`A`

(default)

Value of the current through the primary leakage inductance *L1* at
time zero.

**First secondary leakage inductance initial current** — First secondary leakage inductance initial current

`0`

`A`

(default)

Value of the current through the first secondary leakage inductance
*L2* at time zero.

**Second secondary leakage inductance initial current** — Second secondary leakage inductance initial current

`0`

`A`

(default)

Value of the current through the second secondary leakage inductance
*L3* at time zero.

**Specify magnetization inductance initial state by** — Initial state specification option

`Current`

(default) | `Magnetic flux`

Initial state specification.

`Current`

— Specify the initial state of the magnetization inductance*Lm*by the initial current.`Magnetic flux`

— Specify the initial state of the magnetization inductance*Lm*by the magnetic flux.

#### Dependencies

To enable this parameter, on the
**Magnetization** setting, set the
**Magnetization inductance parameterized by**
parameter to:

`Single inductance (linear)`

`Single saturation point`

`Magnetic flux versus current characteristic`

`Magnetic flux density versus field strength characteristic`

**Magnetization inductance initial current** — Magnetization inductance initial current

`0`

`A`

(default)

Initial current value used to calculate the value of magnetic flux within the
magnetization inductance *Lm* at time zero. This is the
current passing through the magnetization inductance
*Lm*. Total magnetization current consists of
current passing through the magnetization resistance
*Rm* and current passing through the magnetization
inductance *Lm*.

#### Dependencies

To enable this parameter, set the **Specify magnetization
inductance initial state by** parameter to
`Current`

**Magnetization inductance initial magnetic flux** — Magnetization inductance initial magnetic flux

`0`

`Wb`

(default)

Value of the magnetic flux in the magnetization inductance *Lm* at time
zero.

#### Dependencies

To enable this parameter, set the **Specify magnetization
inductance initial state by** parameter to
`Magnetic flux`

**Magnetization inductance initial magnetic flux density** — Magnetization inductance initial magnetic flux density

`0`

`T`

(default)

Value of magnetic flux density at time zero.

#### Dependencies

To enable this parameter, on the
**Magnetization** setting, set the
**Magnetization inductance parameterized by**
parameter to ```
Magnetic flux density versus field
strength characteristic with hysteresis
```

**Magnetization inductance initial field strength** — Magnetization inductance initial field strength

`0`

`A/m`

(default)

Value of magnetic field strength at time zero.

#### Dependencies

To enable this parameter, on the
**Magnetization** setting, set the
**Magnetization inductance parameterized by**
parameter to ```
Magnetic flux density versus field
strength characteristic with hysteresis
```

### Parasitics

**Primary leakage inductance parasitic parallel conductance** — Winding 1 leakage inductance parasitic parallel conductance

`1e-9`

`1/Ohm`

(default) | nonneagative scalar

Small parasitic effects in parallel to the primary leakage inductance
*L1*. A small parallel conductance may be required
for the simulation of some circuit topologies.

**First secondary leakage inductance parasitic parallel conductance** — Winding 2 leakage inductance parasitic parallel conductance

`1e-9`

`1/Ohm`

(default) | nonneagative scalar

Small parasitic effects in parallel to the first secondary leakage
inductance *L2*. A small parallel conductance may be
required for the simulation of some circuit topologies.

**Second secondary leakage inductance parasitic parallel conductance** — Winding 3 leakage inductance parasitic parallel conductance

`1e-9`

`1/Ohm`

(default) | nonneagative scalar

Small parasitic effects in parallel to the second secondary leakage
inductance *L3*. A small parallel conductance may be
required for the simulation of some circuit topologies.

## Extended Capabilities

### C/C++ Code Generation

Generate C and C++ code using Simulink® Coder™.

## Version History

**Introduced in R2019b**

## See Also

## MATLAB 명령

다음 MATLAB 명령에 해당하는 링크를 클릭했습니다.

명령을 실행하려면 MATLAB 명령 창에 입력하십시오. 웹 브라우저는 MATLAB 명령을 지원하지 않습니다.

Select a Web Site

Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .

You can also select a web site from the following list:

## How to Get Best Site Performance

Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.

### Americas

- América Latina (Español)
- Canada (English)
- United States (English)

### Europe

- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)

- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)