Motor#

Induction Motor group

Common Parameters: u, name

Available models: Motor3, Motor5

Motor3#

Third-order induction motor model.

See "Power System Modelling and Scripting" by F. Milano.

To simulate motor startup, set the motor status u to 0 and use a Toggle to control the model.

Parameters#

Name

Symbol

Description

Default

Unit

Properties

idx

unique device idx

u

\(u\)

connection status

1

bool

name

device name

bus

interface bus id

mandatory

Sn

\(S_n\)

Power rating

100

Vn

\(V_n\)

AC voltage rating

110

fn

\(f\)

rated frequency

60

rs

\(r_s\)

rotor resistance

0.010

non_zero,z

xs

\(x_s\)

rotor reactance

0.150

non_zero,z

rr1

\(r_{R1}\)

1st cage rotor resistance

0.050

non_zero,z

xr1

\(x_{R1}\)

1st cage rotor reactance

0.150

non_zero,z

rr2

\(r_{R2}\)

2st cage rotor resistance

0.001

non_zero,z

xr2

\(x_{R2}\)

2st cage rotor reactance

0.040

non_zero,z

xm

\(x_m\)

magnetization reactance

5

non_zero,z

Hm

\(H_m\)

Inertia constant

3

kWs/KVA

power

c1

\(c_1\)

1st coeff. of Tm(w)

0.100

c2

\(c_2\)

2nd coeff. of Tm(w)

0.020

c3

\(c_3\)

3rd coeff. of Tm(w)

0.020

zb

\(z_b\)

Allow working as brake

1

Variables#

Name

Symbol

Type

Description

Unit

Properties

slip

\(slip\)

State

v_str

e1d

\(e1d\)

State

real part of 1st cage voltage

v_str

e1q

\(e1q\)

State

imaginary part of 1st cage voltage

v_str

vd

\(vd\)

Algeb

d-axis voltage

vq

\(vq\)

Algeb

q-axis voltage

p

\(p\)

Algeb

v_str

q

\(q\)

Algeb

v_str

Id

\(Id\)

Algeb

v_str

Iq

\(Iq\)

Algeb

te

\(te\)

Algeb

v_str

tm

\(tm\)

Algeb

v_str

a

\(a\)

ExtAlgeb

Bus voltage phase angle

v

\(v\)

ExtAlgeb

Bus voltage magnitude

Initialization Equations#

Name

Symbol

Type

Initial Value

slip

\(slip\)

State

\(1.0 u\)

e1d

\(e1d\)

State

\(0.05 u\)

e1q

\(e1q\)

State

\(0.9 u\)

vd

\(vd\)

Algeb

vq

\(vq\)

Algeb

p

\(p\)

Algeb

\(u \left(Id vd + Iq vq\right)\)

q

\(q\)

Algeb

\(u \left(Id vq - Iq vd\right)\)

Id

\(Id\)

Algeb

\(1\)

Iq

\(Iq\)

Algeb

te

\(te\)

Algeb

\(u \left(Id e1d + Iq e1q\right)\)

tm

\(tm\)

Algeb

\(u \left(aa + bb slip + c_{2} slip^{2}\right)\)

a

\(a\)

ExtAlgeb

v

\(v\)

ExtAlgeb

Differential Equations#

Name

Symbol

Type

RHS of Equation "T x' = f(x, y)"

T (LHS)

slip

\(slip\)

State

\(u \left(- te + tm\right)\)

\(M\)

e1d

\(e1d\)

State

\(u \left(e1q slip wb - \frac{Iq \left(x_{0} - x_{1}\right) + e1d}{T_{10}}\right)\)

e1q

\(e1q\)

State

\(u \left(- e1d slip wb - \frac{- Id \left(x_{0} - x_{1}\right) + e1q}{T_{10}}\right)\)

Algebraic Equations#

Name

Symbol

Type

RHS of Equation "0 = g(x, y)"

vd

\(vd\)

Algeb

\(- u v \sin{\left(a \right)} - vd\)

vq

\(vq\)

Algeb

\(u v \cos{\left(a \right)} - vq\)

p

\(p\)

Algeb

\(- p + u \left(Id vd + Iq vq\right)\)

q

\(q\)

Algeb

\(- q + u \left(Id vq - Iq vd\right)\)

Id

\(Id\)

Algeb

\(u \left(- Id rs + Iq x_{1} - e1d + vd\right)\)

Iq

\(Iq\)

Algeb

\(u \left(- Id x_{1} - Iq rs - e1q + vq\right)\)

te

\(te\)

Algeb

\(- te + u \left(Id e1d + Iq e1q\right)\)

tm

\(tm\)

Algeb

\(- tm + u \left(aa + bb slip + c_{2} slip^{2}\right)\)

a

\(a\)

ExtAlgeb

\(p\)

v

\(v\)

ExtAlgeb

\(q\)

Services#

Name

Symbol

Equation

Type

wb

\(\omega_b\)

\(2 \pi fn\)

ConstService

x0

\(x_0\)

\(xm + xs\)

ConstService

x1

\(x'\)

\(\frac{xm xr_{1}}{xm + xr_{1}} + xs\)

ConstService

T10

\(T'_0\)

\(\frac{xm + xr_{1}}{rr_{1} wb}\)

ConstService

M

\(M\)

\(2 Hm\)

ConstService

aa

\(\alpha\)

\(c_{1} + c_{2} + c_{3}\)

ConstService

bb

\(\beta\)

\(- c_{2} - 2 c_{3}\)

ConstService

Config Fields in [Motor3]

Option

Symbol

Value

Info

Accepted values

allow_adjust

1

allow adjusting upper or lower limits

(0, 1)

adjust_lower

0

adjust lower limit

(0, 1)

adjust_upper

1

adjust upper limit

(0, 1)

Motor5#

Fifth-order induction motor model.

See "Power System Modelling and Scripting" by F. Milano.

To simulate motor startup, set the motor status u to 0 and use a Toggle to control the model.

Parameters#

Name

Symbol

Description

Default

Unit

Properties

idx

unique device idx

u

\(u\)

connection status

1

bool

name

device name

bus

interface bus id

mandatory

Sn

\(S_n\)

Power rating

100

Vn

\(V_n\)

AC voltage rating

110

fn

\(f\)

rated frequency

60

rs

\(r_s\)

rotor resistance

0.010

non_zero,z

xs

\(x_s\)

rotor reactance

0.150

non_zero,z

rr1

\(r_{R1}\)

1st cage rotor resistance

0.050

non_zero,z

xr1

\(x_{R1}\)

1st cage rotor reactance

0.150

non_zero,z

rr2

\(r_{R2}\)

2st cage rotor resistance

0.001

non_zero,z

xr2

\(x_{R2}\)

2st cage rotor reactance

0.040

non_zero,z

xm

\(x_m\)

magnetization reactance

5

non_zero,z

Hm

\(H_m\)

Inertia constant

3

kWs/KVA

power

c1

\(c_1\)

1st coeff. of Tm(w)

0.100

c2

\(c_2\)

2nd coeff. of Tm(w)

0.020

c3

\(c_3\)

3rd coeff. of Tm(w)

0.020

zb

\(z_b\)

Allow working as brake

1

Variables#

Name

Symbol

Type

Description

Unit

Properties

slip

\(slip\)

State

v_str

e1d

\(e1d\)

State

real part of 1st cage voltage

v_str

e1q

\(e1q\)

State

imaginary part of 1st cage voltage

v_str

e2d

\(e2d\)

State

real part of 2nd cage voltage

v_str

e2q

\(e2q\)

State

imag part of 2nd cage voltage

v_str

vd

\(vd\)

Algeb

d-axis voltage

vq

\(vq\)

Algeb

q-axis voltage

p

\(p\)

Algeb

v_str

q

\(q\)

Algeb

v_str

Id

\(Id\)

Algeb

v_str

Iq

\(Iq\)

Algeb

v_str

te

\(te\)

Algeb

v_str

tm

\(tm\)

Algeb

v_str

a

\(a\)

ExtAlgeb

Bus voltage phase angle

v

\(v\)

ExtAlgeb

Bus voltage magnitude

Initialization Equations#

Name

Symbol

Type

Initial Value

slip

\(slip\)

State

\(1.0 u\)

e1d

\(e1d\)

State

\(0.05 u\)

e1q

\(e1q\)

State

\(0.9 u\)

e2d

\(e2d\)

State

\(0.05 u\)

e2q

\(e2q\)

State

\(0.9 u\)

vd

\(vd\)

Algeb

vq

\(vq\)

Algeb

p

\(p\)

Algeb

\(u \left(Id vd + Iq vq\right)\)

q

\(q\)

Algeb

\(u \left(Id vq - Iq vd\right)\)

Id

\(Id\)

Algeb

\(0.9 u\)

Iq

\(Iq\)

Algeb

\(0.1 u\)

te

\(te\)

Algeb

\(u \left(Id e2d + Iq e2q\right)\)

tm

\(tm\)

Algeb

\(u \left(aa + bb slip + c_{2} slip^{2}\right)\)

a

\(a\)

ExtAlgeb

v

\(v\)

ExtAlgeb

Differential Equations#

Name

Symbol

Type

RHS of Equation "T x' = f(x, y)"

T (LHS)

slip

\(slip\)

State

\(u \left(- te + tm\right)\)

\(M\)

e1d

\(e1d\)

State

\(u \left(e1q slip wb - \frac{Iq \left(x_{0} - x_{1}\right) + e1d}{T_{10}}\right)\)

e1q

\(e1q\)

State

\(u \left(- e1d slip wb - \frac{- Id \left(x_{0} - x_{1}\right) + e1q}{T_{10}}\right)\)

e2d

\(e2d\)

State

\(u \left(e1q slip wb - slip wb \left(e1q - e2q\right) + \frac{- Iq \left(x_{1} - x_{2}\right) + e1d - e2d}{T_{20}} - \frac{Iq \left(x_{0} - x_{1}\right) + e1d}{T_{10}}\right)\)

e2q

\(e2q\)

State

\(u \left(- e1d slip wb + slip wb \left(e1d - e2d\right) + \frac{Id \left(x_{1} - x_{2}\right) + e1q - e2q}{T_{20}} - \frac{- Id \left(x_{0} - x_{1}\right) + e1q}{T_{10}}\right)\)

Algebraic Equations#

Name

Symbol

Type

RHS of Equation "0 = g(x, y)"

vd

\(vd\)

Algeb

\(- u v \sin{\left(a \right)} - vd\)

vq

\(vq\)

Algeb

\(u v \cos{\left(a \right)} - vq\)

p

\(p\)

Algeb

\(- p + u \left(Id vd + Iq vq\right)\)

q

\(q\)

Algeb

\(- q + u \left(Id vq - Iq vd\right)\)

Id

\(Id\)

Algeb

\(u \left(- Id rs + Iq x_{2} - e2d + vd\right)\)

Iq

\(Iq\)

Algeb

\(u \left(- Id x_{2} - Iq rs - e2q + vq\right)\)

te

\(te\)

Algeb

\(- te + u \left(Id e2d + Iq e2q\right)\)

tm

\(tm\)

Algeb

\(- tm + u \left(aa + bb slip + c_{2} slip^{2}\right)\)

a

\(a\)

ExtAlgeb

\(p\)

v

\(v\)

ExtAlgeb

\(q\)

Services#

Name

Symbol

Equation

Type

wb

\(\omega_b\)

\(2 \pi fn\)

ConstService

x0

\(x_0\)

\(xm + xs\)

ConstService

x1

\(x'\)

\(\frac{xm xr_{1}}{xm + xr_{1}} + xs\)

ConstService

T10

\(T'_0\)

\(\frac{xm + xr_{1}}{rr_{1} wb}\)

ConstService

M

\(M\)

\(2 Hm\)

ConstService

aa

\(\alpha\)

\(c_{1} + c_{2} + c_{3}\)

ConstService

bb

\(\beta\)

\(- c_{2} - 2 c_{3}\)

ConstService

x2

\(x''\)

\(\frac{xm xr_{1} xr_{2}}{xm xr_{1} + xm xr_{2} + xr_{1} xr_{2}} + xs\)

ConstService

T20

\(T''_0\)

\(\frac{\frac{xm xr_{1}}{xm + xr_{1}} + xr_{2}}{rr_{2} wb}\)

ConstService

Config Fields in [Motor5]

Option

Symbol

Value

Info

Accepted values

allow_adjust

1

allow adjusting upper or lower limits

(0, 1)

adjust_lower

0

adjust lower limit

(0, 1)

adjust_upper

1

adjust upper limit

(0, 1)