Base synchronous generator model. More...

#include <Base_SynchronGenerator.h>

Inheritance diagram for CPS::Base::SynchronGenerator:

Collaboration diagram for CPS::Base::SynchronGenerator:

Public Types
enum class	StateType { perUnit , statorReferred , rotorReferred }
	State type of machine variables. More...

enum class	ParameterType { perUnit , statorReferred , operational }
	Machine parameters type. More...

Public Member Functions
void	addGovernor (Real Ta, Real Tb, Real Tc, Real Fa, Real Fb, Real Fc, Real K, Real Tsr, Real Tsm, Real Tm_init, Real PmRef)

void	addGovernor (std::shared_ptr< Signal::TurbineGovernorType1 > turbineGovernor)
	Add TurbineGovernorType1 (already constructed and initialised)

void	addGovernor (Real T3, Real T4, Real T5, Real Tc, Real Ts, Real R, Real Tmin, Real Tmax, Real OmRef, Real TmRef)

void	addGovernorAndTurbine (std::shared_ptr< Base::Governor > governor, std::shared_ptr< Base::GovernorParameters > govParams, std::shared_ptr< Base::Turbine > turbine, std::shared_ptr< Base::TurbineParameters > turbineParams)
	Add a modular governor + turbine pair (new API for SteamTurbineGovernor / SteamTurbine)

void	addGovernorAndTurbine (std::shared_ptr< Base::Governor > governor, std::shared_ptr< Base::Turbine > turbine)
	Add a pre-constructed governor + turbine pair (parameters already set)

void	addExciter (std::shared_ptr< Base::Exciter > exciter, std::shared_ptr< Base::ExciterParameters > params)
	Add voltage regulator and exciter.

void	addExciter (std::shared_ptr< Base::Exciter > exciter)
	Add already constructed regulator and exciter.

void	addExciter (Real Ta, Real Ka, Real Te, Real Ke, Real Tf, Real Kf, Real Tr)

void	addPSS (std::shared_ptr< Base::PSS > pss, std::shared_ptr< Base::PSSParameters > parameters)
	Attach a PSS (initialised separately) to this generator.

void	addPSS (std::shared_ptr< Base::PSS > pss)
	Attach a pre-constructed PSS (parameters already set)

virtual	~SynchronGenerator ()
	Destructor - does nothing.

void	setBaseAndFundamentalPerUnitParameters (Real nomPower, Real nomVolt, Real nomFreq, Real nomFieldCur, Int poleNumber, Real Rs, Real Ll, Real Lmd, Real Lmq, Real Rfd, Real Llfd, Real Rkd, Real Llkd, Real Rkq1, Real Llkq1, Real Rkq2, Real Llkq2, Real inertia)
	Initializes the base and fundamental machine parameters in per unit.

void	setBaseAndOperationalPerUnitParameters (Real nomPower, Real nomVolt, Real nomFreq, Int poleNumber, Real nomFieldCur, Real Rs, Real Ld, Real Lq, Real Ld_t, Real Lq_t, Real Ld_s, Real Lq_s, Real Ll, Real Td0_t, Real Tq0_t, Real Td0_s, Real Tq0_s, Real inertia)

void	setFundamentalPerUnitParameters (Int poleNumber, Real Rs, Real Ll, Real Lmd, Real Lmq, Real Rfd, Real Llfd, Real Rkd, Real Llkd, Real Rkq1, Real Llkq1, Real Rkq2, Real Llkq2, Real inertia)

void	applyFundamentalPerUnitParameters ()

void	setAndApplyFundamentalPerUnitParameters (Int poleNumber, Real Rs, Real Ll, Real Lmd, Real Lmq, Real Rfd, Real Llfd, Real Rkd, Real Llkd, Real Rkq1, Real Llkq1, Real Rkq2, Real Llkq2, Real inertia)

void	setOperationalPerUnitParameters (Int poleNumber, Real inertia, Real Rs, Real Ld, Real Lq, Real Ll, Real Ld_t, Real Lq_t, Real Ld_s, Real Lq_s, Real Td0_t, Real Tq0_t, Real Td0_s, Real Tq0_s)

void	calculateFundamentalFromOperationalParameters ()

void	setInitialValues (Real initActivePower, Real initReactivePower, Real initTerminalVolt, Real initVoltAngle, Real initMechPower)

void	setNumericalMethod (NumericalMethod method)
	Switch to determine the integration method for the machine model.

Public Attributes
const Attribute< Real >::Ptr	mRs
	stator resistance Rs [Ohm]

const Attribute< Real >::Ptr	mLl
	leakage inductance Ll [H]

const Attribute< Real >::Ptr	mLd
	d-axis inductance Ld [H]

const Attribute< Real >::Ptr	mLq
	q-axis inductance Lq [H]

const Attribute< Real >::Ptr	mLd_t
	Transient d-axis inductance [H].

const Attribute< Real >::Ptr	mLq_t
	Transient q-axis inductance [H].

const Attribute< Real >::Ptr	mLd_s
	Subtransient d-axis inductance [H].

const Attribute< Real >::Ptr	mLq_s
	Subtransient q-axis inductance [H].

const Attribute< Real >::Ptr	mTd0_t
	Transient time constant of d-axis [s].

const Attribute< Real >::Ptr	mTq0_t
	Transient time constant of q-axis [s].

const Attribute< Real >::Ptr	mTd0_s
	Subtransient time constant of d-axis [s].

const Attribute< Real >::Ptr	mTq0_s
	Subtransient time constant of q-axis [s].

const Attribute< Real >::Ptr	mDelta
	rotor angle delta

const Attribute< Real >::Ptr	mMechTorque
	mechanical torque

const Attribute< Real >::Ptr	mInertia
	inertia constant H [s] for per unit or moment of inertia J [kg*m^2]

const Attribute< Real >::Ptr	mOmMech
	rotor speed omega_r

const Attribute< Real >::Ptr	mElecActivePower
	Active part of the electrical power.

const Attribute< Real >::Ptr	mElecReactivePower
	Reactive part of the electrical power.

const Attribute< Real >::Ptr	mMechPower
	mechanical Power Pm [W]

const Attribute< Real >::Ptr	mElecTorque
	electrical torque

std::shared_ptr< Signal::TurbineGovernor >	mTurbineGovernor
	Signal component modelling governor control and steam turbine (legacy)

std::shared_ptr< Signal::TurbineGovernorType1 >	mTurbineGovernorType1
	Signal component modelling governor control and steam turbine (TurbineGovernorType1)

std::shared_ptr< Base::Governor >	mGovernor
	Modular governor (SteamTurbineGovernor / HydroTurbineGovernor)

std::shared_ptr< Base::Turbine >	mTurbine
	Modular turbine (SteamTurbine / HydroTurbine)

std::shared_ptr< Base::Exciter >	mExciter
	Signal component modelling voltage regulator and exciter.

std::shared_ptr< Base::PSS >	mPSS
	Power system stabilizer.

Protected Member Functions
void	initPerUnitStates ()

	SynchronGenerator (CPS::AttributeList::Ptr attributeList)
	Constructor.

void	setBaseParameters (Real nomPower, Real nomVolt, Real nomFreq)

void	setBaseParameters (Real nomPower, Real nomVolt, Real nomFreq, Real nomFieldCur)

void	calcStateSpaceMatrixDQ ()

Real	calcHfromJ (Real J, Real omegaNominal, Int polePairNumber)

Protected Attributes
NumericalMethod	mNumericalMethod

Real	mSystemOmega
	Simulation angular system speed.

Real	mTimeStep
	Simulation time step.

StateType	mStateType = StateType::perUnit
	specifies if the machine parameters are transformed to per unit

ParameterType	mParameterType

Bool	mInitialValuesSet = false
	Flag to remember when initial values are set.

Real	mNomPower = 0
	nominal power Pn [VA]

Real	mNomVolt = 0
	nominal voltage Vn [V] (phase-to-phase RMS)

Real	mNomFreq = 0
	nominal frequency fn [Hz]

Real	mNomOmega = 0
	nominal angular frequency wn [Hz]

Real	mNomFieldCur = 0
	nominal field current Ifn [A]

Int	mNumDampingWindings = 0
	Number of damping windings in q.

Int	mPoleNumber = 0
	mNumber of poles

Real	mLmd = 0
	d-axis mutual inductance Lmd [H]

Real	mLmq = 0
	q-axis mutual inductance Lmq [H]

Real	mRfd = 0
	field resistance Rfd [Ohm]

Real	mLlfd = 0
	field leakage inductance Llfd [H]

Real	mLfd = 0
	field inductance Lfd [H]

Real	mLf = 0
	field winding inductance Lf [H]

Real	mRkd = 0
	d-axis damper resistance Rkd [Ohm]

Real	mLlkd = 0
	d-axis damper leakage inductance Llkd [H]

Real	mLkd = 0
	d-axis damper inductance Lkd [H]

Real	mRkq1 = 0
	q-axis damper resistance 1 Rkq1 [Ohm]

Real	mLlkq1 = 0
	q-axis damper leakage inductance 1 Llkq1 [H]

Real	mLkq1 = 0
	q-axis damper inductance 1 Lkq1 [H]

Real	mRkq2 = 0
	q-axis damper resistance 2 Rkq2 [Ohm]

Real	mLlkq2 = 0
	q-axis damper leakage inductance 2 Llkq2 [H]

Real	mLkq2 = 0
	q-axis damper inductance 2 Lkq2 [H]

Complex	mInitElecPower = 0

Complex	mInitTermVoltage = 0

Real	mInitMechPower = 0

Real	mBase_V = 0
	base stator voltage (phase-to-ground peak)

Real	mBase_V_RMS = 0
	base stator voltage (phase-to-ground RMS)

Real	mBase_I = 0
	base stator current peak

Real	mBase_I_RMS = 0
	base stator current RMS

Real	mBase_Z = 0
	base stator impedance

Real	mBase_OmElec = 0
	base electrical angular frequency

Real	mBase_OmMech = 0
	base mechanical angular frequency

Real	mBase_L = 0
	base stator inductance

Real	mBase_T = 0
	base torque

Real	mBase_Psi = 0
	base flux linkage

Real	mBase_ifd = 0
	base field current

Real	mBase_vfd = 0
	base field voltage

Real	mBase_Zfd = 0
	base field impedance

Real	mBase_Lfd = 0
	base field inductance

Matrix	mInductanceMat
	Inductance matrix which is numerically equal to the reactance matrix in per unit.

Matrix	mResistanceMat
	resistance matrix

Matrix	mInvInductanceMat
	Inverse of the inductance matrix.

Real	mThetaMech = 0
	theta

Matrix	mVsr
	Vector of stator and rotor voltages.

Matrix	mIsr
	Vector of stator and rotor currents.

Matrix	mPsisr
	Vector of stator and rotor fluxes.

Matrix	mVdq0
	dq0 voltage calculated from terminal voltage

Matrix	mIdq0
	dq0 current calculated from terminal current

Matrix	mFluxStateSpaceMat
	Flux state space matrix excluding omega term.

Matrix	mOmegaFluxMat
	Omega-flux matrix for state space system.

Matrix	mFluxToCurrentMat
	Calculates currents from fluxes.

Real	mLad
	Inductance to calculate magnetizing flux linkage from winding flux linkages.

Real	mLaq
	Inductance to calculate magnetizing flux linkage from winding flux linkages.

Real	mDetLd
	Determinant of d-axis inductance matrix.

Real	mDetLq
	Determinant of q-axis inductance matrix.

Bool	mCompensationOn
	Determines if compensation elements are used.

Real	mRcomp
	Compensation Resistance.

Bool	mHasTurbineGovernor = false
	Determines if legacy TurbineGovernor is activated.

Bool	mHasTurbineGovernorType1 = false
	Determines if TurbineGovernorType1 is activated.

Bool	mHasGovernorAndTurbine = false
	Determines if modular Governor + Turbine pair is activated.

Bool	mHasExciter = false
	Determines if Exciter is activated.

Bool	mHasPSS = false
	Determines if PSS is activated.

Real	mInitTerminalVoltage = 0

Real	mInitVoltAngle = 0

Detailed Description

Base synchronous generator model.

If parInPerUnit is not set, the parameters have to be given with their respective stator or rotor referred values. The calculation to per unit is performed in the initialization. The case where parInPerUnit is not set will be implemented later. parameter names include underscores and typical variables names found in literature instead of descriptive names in order to shorten formulas and increase the readability

Definition at line 29 of file Base_SynchronGenerator.h.

Member Enumeration Documentation

◆ ParameterType

enum class CPS::Base::SynchronGenerator::ParameterType

strong

Machine parameters type.

Definition at line 37 of file Base_SynchronGenerator.h.

◆ StateType

enum class CPS::Base::SynchronGenerator::StateType

strong

State type of machine variables.

Determines if the machine states are considered in per unit, referred to the stator parameters or the rotor parameters.

Definition at line 35 of file Base_SynchronGenerator.h.

Constructor & Destructor Documentation

◆ SynchronGenerator()

CPS::Base::SynchronGenerator::SynchronGenerator ( CPS::AttributeList::Ptr attributeList )

inlineexplicitprotected

Constructor.

Definition at line 311 of file Base_SynchronGenerator.h.

◆ ~SynchronGenerator()

virtual CPS::Base::SynchronGenerator::~SynchronGenerator ( )

inlinevirtual

Destructor - does nothing.

Definition at line 346 of file Base_SynchronGenerator.h.

Member Function Documentation

◆ addExciter()

void CPS::Base::SynchronGenerator::addExciter	(	Real	Ta,
		Real	Ka,
		Real	Te,
		Real	Ke,
		Real	Tf,
		Real	Kf,
		Real	Tr )

Definition at line 393 of file Base_SynchronGenerator.cpp.

◆ addGovernor() [1/3]

void Base::SynchronGenerator::addGovernor	(	Real	T3,
		Real	T4,
		Real	T5,
		Real	Tc,
		Real	Ts,
		Real	R,
		Real	Tmin,
		Real	Tmax,
		Real	OmRef,
		Real	TmRef )

Definition at line 464 of file Base_SynchronGenerator.cpp.

◆ addGovernor() [2/3]

void Base::SynchronGenerator::addGovernor	(	Real	Ta,
		Real	Tb,
		Real	Tc,
		Real	Fa,
		Real	Fb,
		Real	Fc,
		Real	K,
		Real	Tsr,
		Real	Tsm,
		Real	Tm_init,
		Real	PmRef )

Definition at line 436 of file Base_SynchronGenerator.cpp.

◆ addGovernor() [3/3]

void Base::SynchronGenerator::addGovernor ( std::shared_ptr< Signal::TurbineGovernorType1 > turbineGovernor )

Add TurbineGovernorType1 (already constructed and initialised)

Definition at line 451 of file Base_SynchronGenerator.cpp.

◆ addGovernorAndTurbine() [1/2]

void Base::SynchronGenerator::addGovernorAndTurbine	(	std::shared_ptr< Base::Governor >	governor,
		std::shared_ptr< Base::GovernorParameters >	govParams,
		std::shared_ptr< Base::Turbine >	turbine,
		std::shared_ptr< Base::TurbineParameters >	turbineParams )

Add a modular governor + turbine pair (new API for SteamTurbineGovernor / SteamTurbine)

Definition at line 480 of file Base_SynchronGenerator.cpp.

◆ addGovernorAndTurbine() [2/2]

void Base::SynchronGenerator::addGovernorAndTurbine	(	std::shared_ptr< Base::Governor >	governor,
		std::shared_ptr< Base::Turbine >	turbine )

Add a pre-constructed governor + turbine pair (parameters already set)

Definition at line 502 of file Base_SynchronGenerator.cpp.

◆ addPSS() [1/2]

void Base::SynchronGenerator::addPSS ( std::shared_ptr< Base::PSS > pss )

Attach a pre-constructed PSS (parameters already set)

Definition at line 540 of file Base_SynchronGenerator.cpp.

◆ addPSS() [2/2]

void Base::SynchronGenerator::addPSS	(	std::shared_ptr< Base::PSS >	pss,
		std::shared_ptr< Base::PSSParameters >	parameters )

Attach a PSS (initialised separately) to this generator.

Definition at line 520 of file Base_SynchronGenerator.cpp.

◆ applyFundamentalPerUnitParameters()

void Base::SynchronGenerator::applyFundamentalPerUnitParameters ( )

Definition at line 125 of file Base_SynchronGenerator.cpp.

◆ calcHfromJ()

Real Base::SynchronGenerator::calcHfromJ	(	Real	J,
		Real	omegaNominal,
		Int	polePairNumber )

protected

Definition at line 388 of file Base_SynchronGenerator.cpp.

◆ calcStateSpaceMatrixDQ()

void Base::SynchronGenerator::calcStateSpaceMatrixDQ ( )

protected

Definition at line 313 of file Base_SynchronGenerator.cpp.

◆ calculateFundamentalFromOperationalParameters()

void Base::SynchronGenerator::calculateFundamentalFromOperationalParameters ( )

Definition at line 195 of file Base_SynchronGenerator.cpp.

◆ initPerUnitStates()

void Base::SynchronGenerator::initPerUnitStates ( )

protected

Initializes states in per unit. All machine parameters are assumed to be in per unit. Function parameters have to be given in real units.

Definition at line 228 of file Base_SynchronGenerator.cpp.

◆ setAndApplyFundamentalPerUnitParameters()

void Base::SynchronGenerator::setAndApplyFundamentalPerUnitParameters	(	Int	poleNumber,
		Real	Rs,
		Real	Ll,
		Real	Lmd,
		Real	Lmq,
		Real	Rfd,
		Real	Llfd,
		Real	Rkd,
		Real	Llkd,
		Real	Rkq1,
		Real	Llkq1,
		Real	Rkq2,
		Real	Llkq2,
		Real	inertia )

Definition at line 91 of file Base_SynchronGenerator.cpp.

◆ setBaseAndFundamentalPerUnitParameters()

void Base::SynchronGenerator::setBaseAndFundamentalPerUnitParameters	(	Real	nomPower,
		Real	nomVolt,
		Real	nomFreq,
		Real	nomFieldCur,
		Int	poleNumber,
		Real	Rs,
		Real	Ll,
		Real	Lmd,
		Real	Lmq,
		Real	Rfd,
		Real	Llfd,
		Real	Rkd,
		Real	Llkd,
		Real	Rkq1,
		Real	Llkq1,
		Real	Rkq2,
		Real	Llkq2,
		Real	inertia )

Initializes the base and fundamental machine parameters in per unit.

Definition at line 43 of file Base_SynchronGenerator.cpp.

◆ setBaseAndOperationalPerUnitParameters()

void Base::SynchronGenerator::setBaseAndOperationalPerUnitParameters	(	Real	nomPower,
		Real	nomVolt,
		Real	nomFreq,
		Int	poleNumber,
		Real	nomFieldCur,
		Real	Rs,
		Real	Ld,
		Real	Lq,
		Real	Ld_t,
		Real	Lq_t,
		Real	Ld_s,
		Real	Lq_s,
		Real	Ll,
		Real	Td0_t,
		Real	Tq0_t,
		Real	Td0_s,
		Real	Tq0_s,
		Real	inertia )

Initializes the base and operational machine parameters in per unit. The fundamental machine parameters in per unit are calculated and set accordingly.

Definition at line 56 of file Base_SynchronGenerator.cpp.

◆ setBaseParameters() [1/2]

void Base::SynchronGenerator::setBaseParameters	(	Real	nomPower,
		Real	nomVolt,
		Real	nomFreq )

protected

Definition at line 14 of file Base_SynchronGenerator.cpp.

◆ setBaseParameters() [2/2]

void Base::SynchronGenerator::setBaseParameters	(	Real	nomPower,
		Real	nomVolt,
		Real	nomFreq,
		Real	nomFieldCur )

protected

Definition at line 36 of file Base_SynchronGenerator.cpp.

◆ setFundamentalPerUnitParameters()

void Base::SynchronGenerator::setFundamentalPerUnitParameters	(	Int	poleNumber,
		Real	Rs,
		Real	Ll,
		Real	Lmd,
		Real	Lmq,
		Real	Rfd,
		Real	Llfd,
		Real	Rkd,
		Real	Llkd,
		Real	Rkq1,
		Real	Llkq1,
		Real	Rkq2,
		Real	Llkq2,
		Real	inertia )

Definition at line 102 of file Base_SynchronGenerator.cpp.

◆ setInitialValues()

void Base::SynchronGenerator::setInitialValues	(	Real	initActivePower,
		Real	initReactivePower,
		Real	initTerminalVolt,
		Real	initVoltAngle,
		Real	initMechPower )

Definition at line 216 of file Base_SynchronGenerator.cpp.

◆ setNumericalMethod()

void CPS::Base::SynchronGenerator::setNumericalMethod ( NumericalMethod method )

inline

Switch to determine the integration method for the machine model.

Definition at line 398 of file Base_SynchronGenerator.h.

◆ setOperationalPerUnitParameters()

void Base::SynchronGenerator::setOperationalPerUnitParameters	(	Int	poleNumber,
		Real	inertia,
		Real	Rs,
		Real	Ld,
		Real	Lq,
		Real	Ll,
		Real	Ld_t,
		Real	Lq_t,
		Real	Ld_s,
		Real	Lq_s,
		Real	Td0_t,
		Real	Tq0_t,
		Real	Td0_s,
		Real	Tq0_s )

Definition at line 69 of file Base_SynchronGenerator.cpp.

Member Data Documentation

◆ mBase_I

Real CPS::Base::SynchronGenerator::mBase_I = 0

protected

base stator current peak

Definition at line 176 of file Base_SynchronGenerator.h.

◆ mBase_I_RMS

Real CPS::Base::SynchronGenerator::mBase_I_RMS = 0

protected

base stator current RMS

Definition at line 178 of file Base_SynchronGenerator.h.

◆ mBase_ifd

Real CPS::Base::SynchronGenerator::mBase_ifd = 0

protected

base field current

Definition at line 193 of file Base_SynchronGenerator.h.

◆ mBase_L

Real CPS::Base::SynchronGenerator::mBase_L = 0

protected

base stator inductance

Definition at line 186 of file Base_SynchronGenerator.h.

◆ mBase_Lfd

Real CPS::Base::SynchronGenerator::mBase_Lfd = 0

protected

base field inductance

Definition at line 199 of file Base_SynchronGenerator.h.

◆ mBase_OmElec

Real CPS::Base::SynchronGenerator::mBase_OmElec = 0

protected

base electrical angular frequency

Definition at line 182 of file Base_SynchronGenerator.h.

◆ mBase_OmMech

Real CPS::Base::SynchronGenerator::mBase_OmMech = 0

protected

base mechanical angular frequency

Definition at line 184 of file Base_SynchronGenerator.h.

◆ mBase_Psi

Real CPS::Base::SynchronGenerator::mBase_Psi = 0

protected

base flux linkage

Definition at line 190 of file Base_SynchronGenerator.h.

◆ mBase_T

Real CPS::Base::SynchronGenerator::mBase_T = 0

protected

base torque

Definition at line 188 of file Base_SynchronGenerator.h.

◆ mBase_V

Real CPS::Base::SynchronGenerator::mBase_V = 0

protected

base stator voltage (phase-to-ground peak)

Definition at line 172 of file Base_SynchronGenerator.h.

◆ mBase_V_RMS

Real CPS::Base::SynchronGenerator::mBase_V_RMS = 0

protected

base stator voltage (phase-to-ground RMS)

Definition at line 174 of file Base_SynchronGenerator.h.

◆ mBase_vfd

Real CPS::Base::SynchronGenerator::mBase_vfd = 0

protected

base field voltage

Definition at line 195 of file Base_SynchronGenerator.h.

◆ mBase_Z

Real CPS::Base::SynchronGenerator::mBase_Z = 0

protected

base stator impedance

Definition at line 180 of file Base_SynchronGenerator.h.

◆ mBase_Zfd

Real CPS::Base::SynchronGenerator::mBase_Zfd = 0

protected

base field impedance

Definition at line 197 of file Base_SynchronGenerator.h.

◆ mCompensationOn

Bool CPS::Base::SynchronGenerator::mCompensationOn

protected

Determines if compensation elements are used.

Definition at line 286 of file Base_SynchronGenerator.h.

◆ mDelta

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mDelta

rotor angle delta

Definition at line 215 of file Base_SynchronGenerator.h.

◆ mDetLd

Real CPS::Base::SynchronGenerator::mDetLd

protected

Determinant of d-axis inductance matrix.

Definition at line 281 of file Base_SynchronGenerator.h.

◆ mDetLq

Real CPS::Base::SynchronGenerator::mDetLq

protected

Determinant of q-axis inductance matrix.

Definition at line 283 of file Base_SynchronGenerator.h.

◆ mElecActivePower

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mElecActivePower

Active part of the electrical power.

Definition at line 223 of file Base_SynchronGenerator.h.

◆ mElecReactivePower

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mElecReactivePower

Reactive part of the electrical power.

Definition at line 225 of file Base_SynchronGenerator.h.

◆ mElecTorque

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mElecTorque

electrical torque

Definition at line 229 of file Base_SynchronGenerator.h.

◆ mExciter

std::shared_ptr<Base::Exciter> CPS::Base::SynchronGenerator::mExciter

Signal component modelling voltage regulator and exciter.

Definition at line 409 of file Base_SynchronGenerator.h.

◆ mFluxStateSpaceMat

Matrix CPS::Base::SynchronGenerator::mFluxStateSpaceMat

protected

Flux state space matrix excluding omega term.

Definition at line 271 of file Base_SynchronGenerator.h.

◆ mFluxToCurrentMat

Matrix CPS::Base::SynchronGenerator::mFluxToCurrentMat

protected

Calculates currents from fluxes.

Definition at line 275 of file Base_SynchronGenerator.h.

◆ mGovernor

std::shared_ptr<Base::Governor> CPS::Base::SynchronGenerator::mGovernor

Modular governor (SteamTurbineGovernor / HydroTurbineGovernor)

Definition at line 405 of file Base_SynchronGenerator.h.

◆ mHasExciter

Bool CPS::Base::SynchronGenerator::mHasExciter = false

protected

Determines if Exciter is activated.

Definition at line 302 of file Base_SynchronGenerator.h.

◆ mHasGovernorAndTurbine

Bool CPS::Base::SynchronGenerator::mHasGovernorAndTurbine = false

protected

Determines if modular Governor + Turbine pair is activated.

Definition at line 300 of file Base_SynchronGenerator.h.

◆ mHasPSS

Bool CPS::Base::SynchronGenerator::mHasPSS = false

protected

Determines if PSS is activated.

Definition at line 304 of file Base_SynchronGenerator.h.

◆ mHasTurbineGovernor

Bool CPS::Base::SynchronGenerator::mHasTurbineGovernor = false

protected

Determines if legacy TurbineGovernor is activated.

Definition at line 296 of file Base_SynchronGenerator.h.

◆ mHasTurbineGovernorType1

Bool CPS::Base::SynchronGenerator::mHasTurbineGovernorType1 = false

protected

Determines if TurbineGovernorType1 is activated.

Definition at line 298 of file Base_SynchronGenerator.h.

◆ mIdq0

Matrix CPS::Base::SynchronGenerator::mIdq0

protected

dq0 current calculated from terminal current

Definition at line 269 of file Base_SynchronGenerator.h.

◆ mInductanceMat

Matrix CPS::Base::SynchronGenerator::mInductanceMat

protected

Inductance matrix which is numerically equal to the reactance matrix in per unit.

Definition at line 203 of file Base_SynchronGenerator.h.

◆ mInertia

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mInertia

inertia constant H [s] for per unit or moment of inertia J [kg*m^2]

Definition at line 219 of file Base_SynchronGenerator.h.

◆ mInitElecPower

Complex CPS::Base::SynchronGenerator::mInitElecPower = 0

protected

Definition at line 166 of file Base_SynchronGenerator.h.

◆ mInitialValuesSet

Bool CPS::Base::SynchronGenerator::mInitialValuesSet = false

protected

Flag to remember when initial values are set.

Definition at line 87 of file Base_SynchronGenerator.h.

◆ mInitMechPower

Real CPS::Base::SynchronGenerator::mInitMechPower = 0

protected

Definition at line 168 of file Base_SynchronGenerator.h.

◆ mInitTerminalVoltage

Real CPS::Base::SynchronGenerator::mInitTerminalVoltage = 0

protected

Definition at line 307 of file Base_SynchronGenerator.h.

◆ mInitTermVoltage

Complex CPS::Base::SynchronGenerator::mInitTermVoltage = 0

protected

Definition at line 167 of file Base_SynchronGenerator.h.

◆ mInitVoltAngle

Real CPS::Base::SynchronGenerator::mInitVoltAngle = 0

protected

Definition at line 308 of file Base_SynchronGenerator.h.

◆ mInvInductanceMat

Matrix CPS::Base::SynchronGenerator::mInvInductanceMat

protected

Inverse of the inductance matrix.

Definition at line 207 of file Base_SynchronGenerator.h.

◆ mIsr

Matrix CPS::Base::SynchronGenerator::mIsr

protected

Vector of stator and rotor currents.

i_d - stator current in d axis i_fd - Rotor current field winding i_kd - Rotor current damping winding in d axis i_q - stator current in q axis i_kq1 - Rotor current damping winding 1 in q axis i_kq2 - Rotor current damping winding 2 in q axis i_0 - stator current 0 component

Definition at line 251 of file Base_SynchronGenerator.h.

◆ mLad

Real CPS::Base::SynchronGenerator::mLad

protected

Inductance to calculate magnetizing flux linkage from winding flux linkages.

Definition at line 277 of file Base_SynchronGenerator.h.

◆ mLaq

Real CPS::Base::SynchronGenerator::mLaq

protected

Inductance to calculate magnetizing flux linkage from winding flux linkages.

Definition at line 279 of file Base_SynchronGenerator.h.

◆ mLd

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mLd

d-axis inductance Ld [H]

Definition at line 142 of file Base_SynchronGenerator.h.

◆ mLd_s

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mLd_s

Subtransient d-axis inductance [H].

Definition at line 152 of file Base_SynchronGenerator.h.

◆ mLd_t

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mLd_t

Transient d-axis inductance [H].

Definition at line 148 of file Base_SynchronGenerator.h.

◆ mLf

Real CPS::Base::SynchronGenerator::mLf = 0

protected

field winding inductance Lf [H]

Definition at line 116 of file Base_SynchronGenerator.h.

◆ mLfd

Real CPS::Base::SynchronGenerator::mLfd = 0

protected

field inductance Lfd [H]

Definition at line 114 of file Base_SynchronGenerator.h.

◆ mLkd

Real CPS::Base::SynchronGenerator::mLkd = 0

protected

d-axis damper inductance Lkd [H]

Definition at line 122 of file Base_SynchronGenerator.h.

◆ mLkq1

Real CPS::Base::SynchronGenerator::mLkq1 = 0

protected

q-axis damper inductance 1 Lkq1 [H]

Definition at line 128 of file Base_SynchronGenerator.h.

◆ mLkq2

Real CPS::Base::SynchronGenerator::mLkq2 = 0

protected

q-axis damper inductance 2 Lkq2 [H]

Definition at line 134 of file Base_SynchronGenerator.h.

◆ mLl

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mLl

leakage inductance Ll [H]

Definition at line 140 of file Base_SynchronGenerator.h.

◆ mLlfd

Real CPS::Base::SynchronGenerator::mLlfd = 0

protected

field leakage inductance Llfd [H]

Definition at line 112 of file Base_SynchronGenerator.h.

◆ mLlkd

Real CPS::Base::SynchronGenerator::mLlkd = 0

protected

d-axis damper leakage inductance Llkd [H]

Definition at line 120 of file Base_SynchronGenerator.h.

◆ mLlkq1

Real CPS::Base::SynchronGenerator::mLlkq1 = 0

protected

q-axis damper leakage inductance 1 Llkq1 [H]

Definition at line 126 of file Base_SynchronGenerator.h.

◆ mLlkq2

Real CPS::Base::SynchronGenerator::mLlkq2 = 0

protected

q-axis damper leakage inductance 2 Llkq2 [H]

Definition at line 132 of file Base_SynchronGenerator.h.

◆ mLmd

Real CPS::Base::SynchronGenerator::mLmd = 0

protected

d-axis mutual inductance Lmd [H]

Definition at line 106 of file Base_SynchronGenerator.h.

◆ mLmq

Real CPS::Base::SynchronGenerator::mLmq = 0

protected

q-axis mutual inductance Lmq [H]

Definition at line 108 of file Base_SynchronGenerator.h.

◆ mLq

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mLq

q-axis inductance Lq [H]

Definition at line 144 of file Base_SynchronGenerator.h.

◆ mLq_s

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mLq_s

Subtransient q-axis inductance [H].

Definition at line 154 of file Base_SynchronGenerator.h.

◆ mLq_t

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mLq_t

Transient q-axis inductance [H].

Definition at line 150 of file Base_SynchronGenerator.h.

◆ mMechPower

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mMechPower

mechanical Power Pm [W]

Definition at line 227 of file Base_SynchronGenerator.h.

◆ mMechTorque

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mMechTorque

mechanical torque

Definition at line 217 of file Base_SynchronGenerator.h.

◆ mNomFieldCur

Real CPS::Base::SynchronGenerator::mNomFieldCur = 0

protected

nominal field current Ifn [A]

Definition at line 99 of file Base_SynchronGenerator.h.

◆ mNomFreq

Real CPS::Base::SynchronGenerator::mNomFreq = 0

protected

nominal frequency fn [Hz]

Definition at line 95 of file Base_SynchronGenerator.h.

◆ mNomOmega

Real CPS::Base::SynchronGenerator::mNomOmega = 0

protected

nominal angular frequency wn [Hz]

Definition at line 97 of file Base_SynchronGenerator.h.

◆ mNomPower

Real CPS::Base::SynchronGenerator::mNomPower = 0

protected

nominal power Pn [VA]

Definition at line 91 of file Base_SynchronGenerator.h.

◆ mNomVolt

Real CPS::Base::SynchronGenerator::mNomVolt = 0

protected

nominal voltage Vn [V] (phase-to-phase RMS)

Definition at line 93 of file Base_SynchronGenerator.h.

◆ mNumDampingWindings

Int CPS::Base::SynchronGenerator::mNumDampingWindings = 0

protected

Number of damping windings in q.

Definition at line 101 of file Base_SynchronGenerator.h.

◆ mNumericalMethod

NumericalMethod CPS::Base::SynchronGenerator::mNumericalMethod

protected

Definition at line 77 of file Base_SynchronGenerator.h.

◆ mOmegaFluxMat

Matrix CPS::Base::SynchronGenerator::mOmegaFluxMat

protected

Omega-flux matrix for state space system.

Definition at line 273 of file Base_SynchronGenerator.h.

◆ mOmMech

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mOmMech

rotor speed omega_r

Definition at line 221 of file Base_SynchronGenerator.h.

◆ mParameterType

ParameterType CPS::Base::SynchronGenerator::mParameterType

protected

Definition at line 85 of file Base_SynchronGenerator.h.

◆ mPoleNumber

Int CPS::Base::SynchronGenerator::mPoleNumber = 0

protected

mNumber of poles

Definition at line 103 of file Base_SynchronGenerator.h.

◆ mPsisr

Matrix CPS::Base::SynchronGenerator::mPsisr

protected

Vector of stator and rotor fluxes.

psi_d - stator flux linkage in d axis psi_fd - rotor flux linkage in field winding psi_kd - rotor flux linkage in damping winding from d axis psi_q - stator flux linkage in q axis psi_kq1 - rotor flux linkage in damping winding 1 from q axis psi_kq2 - rotor flux linkage in damping winding 2 from q axis psi_0 - stator flux linkage 0 component

Definition at line 261 of file Base_SynchronGenerator.h.

◆ mPSS

std::shared_ptr<Base::PSS> CPS::Base::SynchronGenerator::mPSS

Power system stabilizer.

Definition at line 411 of file Base_SynchronGenerator.h.

◆ mRcomp

Real CPS::Base::SynchronGenerator::mRcomp

protected

Compensation Resistance.

Definition at line 288 of file Base_SynchronGenerator.h.

◆ mResistanceMat

Matrix CPS::Base::SynchronGenerator::mResistanceMat

protected

resistance matrix

Definition at line 205 of file Base_SynchronGenerator.h.

◆ mRfd

Real CPS::Base::SynchronGenerator::mRfd = 0

protected

field resistance Rfd [Ohm]

Definition at line 110 of file Base_SynchronGenerator.h.

◆ mRkd

Real CPS::Base::SynchronGenerator::mRkd = 0

protected

d-axis damper resistance Rkd [Ohm]

Definition at line 118 of file Base_SynchronGenerator.h.

◆ mRkq1

Real CPS::Base::SynchronGenerator::mRkq1 = 0

protected

q-axis damper resistance 1 Rkq1 [Ohm]

Definition at line 124 of file Base_SynchronGenerator.h.

◆ mRkq2

Real CPS::Base::SynchronGenerator::mRkq2 = 0

protected

q-axis damper resistance 2 Rkq2 [Ohm]

Definition at line 130 of file Base_SynchronGenerator.h.

◆ mRs

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mRs

stator resistance Rs [Ohm]

Definition at line 138 of file Base_SynchronGenerator.h.

◆ mStateType

StateType CPS::Base::SynchronGenerator::mStateType = StateType::perUnit

protected

specifies if the machine parameters are transformed to per unit

Definition at line 83 of file Base_SynchronGenerator.h.

◆ mSystemOmega

Real CPS::Base::SynchronGenerator::mSystemOmega

protected

Simulation angular system speed.

Definition at line 79 of file Base_SynchronGenerator.h.

◆ mTd0_s

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mTd0_s

Subtransient time constant of d-axis [s].

Definition at line 160 of file Base_SynchronGenerator.h.

◆ mTd0_t

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mTd0_t

Transient time constant of d-axis [s].

Definition at line 156 of file Base_SynchronGenerator.h.

◆ mThetaMech

Real CPS::Base::SynchronGenerator::mThetaMech = 0

protected

theta

Definition at line 211 of file Base_SynchronGenerator.h.

◆ mTimeStep

Real CPS::Base::SynchronGenerator::mTimeStep

protected

Simulation time step.

Definition at line 81 of file Base_SynchronGenerator.h.

◆ mTq0_s

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mTq0_s

Subtransient time constant of q-axis [s].

Definition at line 162 of file Base_SynchronGenerator.h.

◆ mTq0_t

const Attribute<Real>::Ptr CPS::Base::SynchronGenerator::mTq0_t

Transient time constant of q-axis [s].

Definition at line 158 of file Base_SynchronGenerator.h.

◆ mTurbine

std::shared_ptr<Base::Turbine> CPS::Base::SynchronGenerator::mTurbine

Modular turbine (SteamTurbine / HydroTurbine)

Definition at line 407 of file Base_SynchronGenerator.h.

◆ mTurbineGovernor

std::shared_ptr<Signal::TurbineGovernor> CPS::Base::SynchronGenerator::mTurbineGovernor

Signal component modelling governor control and steam turbine (legacy)

Definition at line 401 of file Base_SynchronGenerator.h.

◆ mTurbineGovernorType1

std::shared_ptr<Signal::TurbineGovernorType1> CPS::Base::SynchronGenerator::mTurbineGovernorType1

Signal component modelling governor control and steam turbine (TurbineGovernorType1)

Definition at line 403 of file Base_SynchronGenerator.h.

◆ mVdq0

Matrix CPS::Base::SynchronGenerator::mVdq0

protected

dq0 voltage calculated from terminal voltage

Initializes the per unit or stator referred machine parameters with the machine parameters given in per unit. The initialization mode depends on the setting of state type.

Definition at line 267 of file Base_SynchronGenerator.h.

◆ mVsr

Matrix CPS::Base::SynchronGenerator::mVsr

protected

Vector of stator and rotor voltages.

v_d - Stator voltage in d axis
v_fd - Rotor voltage field winding
v_kd - Rotor voltage damping winding in d axis
v_q - Stator voltage in q axis
v_kq1 - Rotor voltage damping winding 1 in q axis
v_kq2 - Rotor voltage damping winding 2 in q axis
v_0 - Stator voltage 0 component

Definition at line 241 of file Base_SynchronGenerator.h.

The documentation for this class was generated from the following files:

/__w/dpsim/dpsim/dpsim-models/include/dpsim-models/Base/Base_SynchronGenerator.h
/__w/dpsim/dpsim/dpsim-models/src/Base/Base_SynchronGenerator.cpp

Public Types

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ ParameterType

◆ StateType

Constructor & Destructor Documentation

◆ SynchronGenerator()

◆ ~SynchronGenerator()

Member Function Documentation

◆ addExciter()

◆ addGovernor() [1/3]

◆ addGovernor() [2/3]

◆ addGovernor() [3/3]

◆ addGovernorAndTurbine() [1/2]

◆ addGovernorAndTurbine() [2/2]

◆ addPSS() [1/2]

◆ addPSS() [2/2]

◆ applyFundamentalPerUnitParameters()

◆ calcHfromJ()

◆ calcStateSpaceMatrixDQ()

◆ calculateFundamentalFromOperationalParameters()

◆ initPerUnitStates()

◆ setAndApplyFundamentalPerUnitParameters()

◆ setBaseAndFundamentalPerUnitParameters()

◆ setBaseAndOperationalPerUnitParameters()

◆ setBaseParameters() [1/2]

◆ setBaseParameters() [2/2]

◆ setFundamentalPerUnitParameters()

◆ setInitialValues()

◆ setNumericalMethod()

◆ setOperationalPerUnitParameters()

Member Data Documentation

◆ mBase_I

◆ mBase_I_RMS

◆ mBase_ifd

◆ mBase_L

◆ mBase_Lfd

◆ mBase_OmElec

◆ mBase_OmMech

◆ mBase_Psi

◆ mBase_T

◆ mBase_V

◆ mBase_V_RMS

◆ mBase_vfd

◆ mBase_Z

◆ mBase_Zfd

◆ mCompensationOn

◆ mDelta

◆ mDetLd

◆ mDetLq

◆ mElecActivePower

◆ mElecReactivePower

◆ mElecTorque

◆ mExciter

◆ mFluxStateSpaceMat

◆ mFluxToCurrentMat

◆ mGovernor

◆ mHasExciter

◆ mHasGovernorAndTurbine

◆ mHasPSS

◆ mHasTurbineGovernor

◆ mHasTurbineGovernorType1

◆ mIdq0

◆ mInductanceMat

◆ mInertia

◆ mInitElecPower

◆ mInitialValuesSet

◆ mInitMechPower

◆ mInitTerminalVoltage

◆ mInitTermVoltage

◆ mInitVoltAngle

◆ mInvInductanceMat

◆ mIsr

◆ mLad

◆ mLaq

◆ mLd