def test_lvgate(self):
"""
Test `andes.core.discrete.LVGate`
"""
self.lv = LVGate(self.u1, self.u2)
self.lv.sl.list2array(self.n)
self.lv.sl.check_var()
np.testing.assert_almost_equal(self.lv.sl.s0, np.array([0, 0, 1, 1, 1]))
np.testing.assert_almost_equal(self.lv.sl.s1, np.array([1, 1, 1, 0, 0]))
def __init__(self, system, config):
TGBase.__init__(self, system, config)
self.gain = ConstService(
v_str='ue/R',
tex_name='G',
)
self.pref = Algeb(
info='Reference power input',
tex_name='P_{ref}',
v_str='tm0 * R',
e_str='pref0 * R - pref',
)
self.wd = Algeb(
info='Generator under speed',
unit='p.u.',
tex_name=r'\omega_{dev}',
v_str='0',
e_str='ue * (omega - wref) - wd',
)
self.pd = Algeb(info='Pref plus under speed times gain',
unit='p.u.',
tex_name="P_d",
v_str='ue * tm0',
e_str='ue*(- wd + pref + paux) * gain - pd')
self.v9 = Algeb(
tex_name=r'V_{9}',
info='V_9 for LVGate input',
v_str='ue * (AT + KT * (AT - tm0))',
e_str='ue * (AT + KT * (AT - LG3_y)) - v9',
)
self.LVG = LVGate(
u1=self.pd,
u2=self.v9,
info='LVGate',
)
self.LAG = LagAntiWindup(
u=self.LVG_y,
K=1,
T=self.T1,
lower=self.VMIN,
upper=self.VMAX,
)
self.LG2 = Lag(u=self.LAG_y, T=self.T2, K=1, info='Lag T2')
self.LG3 = Lag(u=self.LG2_y, T=self.T3, K=1, info='Lag T3')
self.pout.e_str = 'ue * (LG2_y - Dt * wd) - pout'
def __init__(self, system, config):
ExcBase.__init__(self, system, config)
ExcVsum.__init__(self)
self.UEL0.v_str = '-999'
self.OEL0.v_str = '999'
self.flags.nr_iter = True
# NOTE: e_str `KC*XadIfd / INT_y - IN` causes numerical inaccuracies
self.IN = Algeb(tex_name='I_N',
info='Input to FEX',
v_str='1',
v_iter='KC * XadIfd - INT_y * IN',
e_str='ue * (KC * XadIfd - INT_y * IN)',
diag_eps=True,
)
self.FEX = Piecewise(u=self.IN,
points=(0, 0.433, 0.75, 1),
funs=('1', '1 - 0.577*IN', 'sqrt(0.75 - IN ** 2)', '1.732*(1 - IN)', 0),
info='Piecewise function FEX',
)
self.FEX.y.v_str = '1'
self.FEX.y.v_iter = self.FEX.y.e_str
# control block begin
self.LG = Lag(self.v, T=self.TR, K=1,
info='Voltage transducer',
)
# input excitation voltages;
self.vi = Algeb(info='Total input voltages',
tex_name='V_i',
unit='p.u.',
e_str='ue * (-LG_y + vref + UEL + OEL + Vs - vi)',
v_str='-v + vref',
diag_eps=True,
)
self.LL = LeadLag(u=self.vi, T1=self.TC, T2=self.TB,
info='V_A, Lead-lag compensator',
zero_out=True,
) # LL_y == VA
self.VAMAXu = ConstService('VAMAX * ue + (1-ue) * 999')
self.VAMINu = ConstService('VAMIN * ue + (1-ue) * -999')
self.LA = LagAntiWindup(u=self.LL_y,
T=self.TA,
K=self.KA,
upper=self.VAMAXu,
lower=self.VAMINu,
info='V_A, Anti-windup lag',
) # LA_y == VA
self.HVG = HVGate(u1=self.UEL,
u2=self.LA_y,
info='HVGate for under excitation',
)
self.LVG = LVGate(u1=self.HVG_y,
u2=self.OEL,
info='HVGate for under excitation',
)
self.INTin = 'ue * (LVG_y - VFE)'
ExcACSat.__init__(self)
self.vref.v_str = 'v + VFE / KA'
self.vref0 = PostInitService(info='Initial reference voltage input',
tex_name='V_{ref0}',
v_str='vref',
)
self.WF = Washout(u=self.VFE,
T=self.TF,
K=self.KF,
info='Stablizing circuit feedback',
)
self.vout.e_str = 'ue * FEX_y * INT_y - vout'
def __init__(self, system, config):
ExcBase.__init__(self, system, config)
self.flags.nr_iter = True
ExcVsum.__init__(self)
self.UEL0.v_str = '-999'
self.OEL0.v_str = '999'
self.ulim = ConstService('9999')
self.llim = ConstService('-9999')
self.SWUEL = Switcher(u=self.UELc,
options=[0, 1, 2, 3],
tex_name='SW_{UEL}',
cache=True)
self.SWVOS = Switcher(u=self.VOSc,
options=[0, 1, 2],
tex_name='SW_{VOS}',
cache=True)
# control block begin
self.LG = Lag(
self.v,
T=self.TR,
K=1,
info='Voltage transducer',
)
self.SG0 = ConstService(v_str='0', info='SG initial value.')
self.SG = Algeb(
tex_name='SG',
info='SG',
v_str='SG0',
e_str='SG0 - SG',
)
self.zero = ConstService('0')
self.LR = GainLimiter(
u='XadIfd - ILR',
K=self.KLR,
R=1,
upper=self.ulim,
lower=self.zero,
no_upper=True,
info='Exciter output current gain limiter',
)
self.VA0 = PostInitService(tex_name='V_{A0}',
v_str='vf0 - SWVOS_s2 * SG + LR_y',
info='VA (LA_y) initial value')
self.vref.v_str = 'ue * (v + (vf0 - SWVOS_s2 * SG + LR_y) / KA - SWVOS_s1 * SG - SWUEL_s1 * UEL)'
self.vref.v_iter = 'ue * (v + (vf0 - SWVOS_s2 * SG + LR_y) / KA - SWVOS_s1 * SG - SWUEL_s1 * UEL)'
self.vref0 = PostInitService(
info='Initial reference voltage input',
tex_name='V_{ref0}',
v_str='vref',
)
self.vi = Algeb(
info='Total input voltages',
tex_name='V_i',
unit='p.u.',
e_str=
'ue * (-LG_y + vref - WF_y + SWUEL_s1 * UEL + SWVOS_s1 * SG + Vs) - vi',
v_iter=
'ue * (-LG_y + vref - WF_y + SWUEL_s1 * UEL + SWVOS_s1 * SG + Vs)',
v_str=
'ue * (-LG_y + vref - WF_y + SWUEL_s1 * UEL + SWVOS_s1 * SG + Vs)',
)
self.vil = GainLimiter(
u=self.vi,
K=1,
R=1,
upper=self.VIMAX,
lower=self.VIMIN,
info='Exciter voltage input limiter',
)
self.UEL2 = Algeb(
tex_name='UEL_2',
info='UEL_2 as HVG1 u1',
v_str='ue * (SWUEL_s2 * UEL + (1 - SWUEL_s2) * llim)',
e_str='ue * (SWUEL_s2 * UEL + (1 - SWUEL_s2) * llim) - UEL2',
)
self.HVG1 = HVGate(
u1=self.UEL2,
u2=self.vil_y,
info='HVGate after V_I',
)
self.LL = LeadLag(
u=self.HVG1_y,
T1=self.TC,
T2=self.TB,
info='Lead-lag compensator',
zero_out=True,
)
self.LL1 = LeadLag(
u=self.LL_y,
T1=self.TC1,
T2=self.TB1,
info='Lead-lag compensator 1',
zero_out=True,
)
self.LA = LagAntiWindup(
u=self.LL1_y,
T=self.TA,
K=self.KA,
upper=self.VAMAX,
lower=self.VAMIN,
info='V_A, Anti-windup lag',
) # LA_y is VA
self.vas = Algeb(
tex_name=r'V_{As}',
info='V_A after subtraction, as HVG u2',
v_str='ue * (SWVOS_s2 * SG + LA_y - LR_y)',
v_iter='ue * (SWVOS_s2 * SG + LA_y - LR_y)',
e_str='ue * (SWVOS_s2 * SG + LA_y - LR_y) - vas',
)
self.UEL3 = Algeb(
tex_name='UEL_3',
info='UEL_3 as HVG u1',
v_str='ue * (SWUEL_s3 * UEL + (1 - SWUEL_s3) * llim)',
e_str='ue * (SWUEL_s3 * UEL + (1 - SWUEL_s3) * llim) - UEL3',
)
self.HVG = HVGate(
u1=self.UEL3,
u2=self.vas,
info='HVGate for under excitation',
)
self.LVG = LVGate(
u1=self.HVG_y,
u2=self.OEL,
info='HVGate for over excitation',
)
# vd, vq, Id, Iq from SynGen
self.vd = ExtAlgeb(
src='vd',
model='SynGen',
indexer=self.syn,
tex_name=r'V_d',
info='d-axis machine voltage',
)
self.vq = ExtAlgeb(
src='vq',
model='SynGen',
indexer=self.syn,
tex_name=r'V_q',
info='q-axis machine voltage',
)
self.efdu = VarService(
info='Output exciter voltage upper bound',
tex_name=r'efd_{u}',
v_str='Abs(vd + 1j*vq) * VRMAX - KC * XadIfd',
)
self.efdl = VarService(info='Output exciter voltage lower bound',
tex_name=r'efd_{l}',
v_str='Abs(vd + 1j*vq) * VRMIN')
self.vol = GainLimiter(
u=self.LVG_y,
K=1,
R=1,
upper=self.efdu,
lower=self.efdl,
info='Exciter output limiter',
)
self.WF = Washout(
u=self.LVG_y,
T=self.TF,
K=self.KF,
info='V_F, Stablizing circuit feedback',
)
self.vout.e_str = 'ue * vol_y - vout'