Electromechanical Class Reference

Calculates the electromechanical transient based on disturbances (e.g. system fault). More...

#include <Electromechanical.h>

Inheritance diagram for Electromechanical:

Collaboration diagram for Electromechanical:

Public Member Functions
	Electromechanical (wxWindow *parent, std::vector< Element * > elementList, SimulationData data)
bool	RunStabilityCalculation ()
wxString	GetErrorMessage () const
std::vector< double >	GetTimeVector () const
std::vector< double >	GetIterationVector () const
wxString	GetDebugMessage () const
Public Member Functions inherited from ElectricCalculation
	ElectricCalculation ()
	Constructor.
	~ElectricCalculation ()
	Destructor.
virtual void	GetElementsFromList (std::vector< Element * > elementList)
	Separate the power elements from a generic list.
virtual bool	GetYBus (std::vector< std::vector< std::complex< double > > > &yBus, double systemPowerBase, YBusSequence sequence=POSITIVE_SEQ, bool includeSyncMachines=false, bool allLoadsAsImpedances=false, bool usePowerFlowVoltagesOnImpedances=false)
	Get the admittance matrix from the list of elements (use GetElementsFromList first).
virtual bool	InvertMatrix (std::vector< std::vector< std::complex< double > > > matrix, std::vector< std::vector< std::complex< double > > > &inverse)
	Invert a matrix.
virtual void	UpdateElementsPowerFlow (std::vector< std::complex< double > > voltage, std::vector< std::complex< double > > power, std::vector< BusType > busType, std::vector< ReactiveLimits > reactiveLimit, double systemPowerBase)
	Update the elements after the power flow calculation.
void	ABCtoDQ0 (std::complex< double > complexValue, double angle, double &dValue, double &qValue)
	Convert a complex phasor in ABC representation to DQ components.
void	DQ0toABC (double dValue, double qValue, double angle, std::complex< double > &complexValue)
	Convert DQ components to a complex phasor in ABC representation.
std::vector< std::complex< double > >	GaussianElimination (std::vector< std::vector< std::complex< double > > > matrix, std::vector< std::complex< double > > array)
	Solve a linear system using Gaussian elimination (complex version).
std::vector< double >	GaussianElimination (std::vector< std::vector< double > > matrix, std::vector< double > array)
	Solve a linear system using Gaussian elimination (real version).
Machines::SyncMachineModel	GetMachineModel (SyncGenerator *generator)
	Get the synchronous machine model used by the generator based on user-defined parameters.
std::vector< std::complex< double > >	ComplexMatrixTimesVector (std::vector< std::vector< std::complex< double > > > matrix, std::vector< std::complex< double > > vector)
	Multiply a complex matrix by a complex vector.
void	GetLUDecomposition (std::vector< std::vector< std::complex< double > > > matrix, std::vector< std::vector< std::complex< double > > > &matrixL, std::vector< std::vector< std::complex< double > > > &matrixU)
	Compute the LU decomposition of a matrix.
std::vector< std::complex< double > >	LUEvaluate (std::vector< std::vector< std::complex< double > > > u, std::vector< std::vector< std::complex< double > > > l, std::vector< std::complex< double > > b)
	Solve a linear system using LU decomposition.
bool	GetParentBus (Element *childElement, Bus *&parentBus)
	Get the parent bus of a given shunt element.
bool	GetParentBus (Element *childElement, Bus *&parentBus1, Bus *&parentBus2)
	Get the parent buses of a two-terminal element (branch).
bool	CalculateEMTElementsAdmittance (const double &basePower, wxString &errorMsg)
	Calculate the admittance of EMT elements.
bool	CalculateEMTElementsPower (const double &basePower, wxString &errorMsg, bool updateCurrent=true)
	Calculate the power of EMT elements.
double	CalculateEMTPowerError (const std::vector< std::complex< double > > &voltage, std::vector< std::complex< double > > &power, const double &basePower, wxString &errorMsg)
	Calculate the power mismatch error for EMT simulation.
const std::vector< PowerElement * >	GetPowerElementList () const
	Get the power elements of the system (use GetElementsFromList first).
const std::vector< Bus * >	GetBusList () const
	Get the buses of the system (use GetElementsFromList first).
const std::vector< Capacitor * >	GetCapacitorList () const
	Get the capacitors of the system (use GetElementsFromList first).
const std::vector< IndMotor * >	GetIndMotorList () const
	Get the induction motors of the system (use GetElementsFromList first).
const std::vector< Inductor * >	GetInductorList () const
	Get the inductors of the system (use GetElementsFromList first).
const std::vector< Line * >	GetLineList () const
	Get the lines of the system (use GetElementsFromList first).
const std::vector< Load * >	GetLoadList () const
	Get the loads of the system (use GetElementsFromList first).
const std::vector< SyncGenerator * >	GetSyncGeneratorList () const
	Get the synchronous generators of the system (use GetElementsFromList first).
const std::vector< SyncMotor * >	GetSyncMotorList () const
	Get the synchronous motors of the system (use GetElementsFromList first).
const std::vector< Transformer * >	GetTransformerList () const
	Get the transformers of the system (use GetElementsFromList first).
const std::vector< HarmCurrent * >	GetHarmCurrentList () const
	Get the harmonic current source of the system (use GetElementsFromList first).
const std::vector< EMTElement * >	GetEMTElementList () const
	Get the electromagnetic element list of the system (use GetElementsFromList first).

Protected Member Functions
void	SetEventTimeList ()
bool	HasEvent (double currentTime)
void	SetEvent (double currentTime)
bool	EventTrigger (double eventTime, double currentTime)
void	InsertSyncMachinesOnYBus ()
bool	InsertIndMachinesOnYBus ()
bool	CalculateIndMachinesTransientValues (IndMotor *motor)
std::complex< double >	GetSyncMachineAdmittance (SyncGenerator *generator)
std::complex< double >	GetIndMachineAdmittance (IndMotor *motor)
bool	InitializeDynamicElements ()
bool	CalculateInjectedCurrents ()
void	CalculateIntegrationConstants (SyncGenerator *syncGenerator, double id, double iq, double k=1.0)
void	CalculateIntegrationConstants (IndMotor *indMotor, double ir, double im, double k=1.0)
bool	SolveMachines ()
void	SetSyncMachinesModel ()
SyncMachineModelData	GetSyncMachineModelData (SyncGenerator *syncMachine)
double	CalculateIntVariables (SyncGenerator *syncGenerator, double id, double iq, double sd, double sq, double pe, double k=1.0)
double	CalculateIntVariables (IndMotor *indMotor, double ir, double im, double te, double k=1.0)
bool	CalculateNonIntVariables (SyncGenerator *syncGenerator, double &id, double &iq, double &sd, double &sq, double &pe, double k=1.0)
bool	CalculateNonIntVariables (IndMotor *indMotor, double &ir, double &im, double &te, double k=1.0)
void	CalculateReferenceSpeed ()
bool	CalculateSyncMachineSaturation (SyncGenerator *syncMachine, double &id, double &iq, double &sd, double &sq, bool updateCurrents=true, double k=1.0)
void	CalculateBusesFrequency (bool hasEvent)
void	SaveData ()
void	PreallocateVectors ()
Protected Member Functions inherited from ElectricCalculation
void	GetNextConnection (const unsigned int &checkBusNumber, const std::vector< std::vector< std::complex< double > > > &yBus, std::vector< bool > &connToSlack)
	Recursively check if a bus is electrically connected to the slack bus.
void	DistributeReactivePower (std::vector< ReactiveMachine > &machines, double qTotal)
	Distribute reactive power among synchronous machines connected to the same bus.

Protected Attributes
wxWindow *	m_parent = nullptr
wxString	m_errorMsg = _("Unknown error")
SimulationData	m_simData
double	m_systemFreq = 60.0
double	m_refSpeed = 2.0 * M_PI * 60.0
bool	m_useCOI = false
std::vector< std::vector< std::complex< double > > >	m_yBus
std::vector< std::vector< std::complex< double > > >	m_yBusU
std::vector< std::vector< std::complex< double > > >	m_yBusL
std::vector< std::complex< double > >	m_vBus
std::vector< std::complex< double > >	m_iBus
double	m_powerSystemBase = 100e6
double	m_simTime = 10.0
double	m_currentTime = 0.0
double	m_plotTime = 1e-2
double	m_timeStep = 1e-2
double	m_ctrlTimeStepMultiplier = 0.1
double	m_tolerance = 1e-8
int	m_maxIterations = 100
double	m_saturationTolerance = 1e-8
int	m_currentPoint = 0
std::vector< double >	m_eventTimeList
std::vector< bool >	m_eventOccurrenceList
std::vector< double >	m_timeVector
int	m_iterationsNum = 0.0
std::vector< double >	m_iterationsNumVector
wxString	m_debugMessage = ""
Protected Attributes inherited from ElectricCalculation
std::vector< PowerElement * >	m_powerElementList
	List of power elements in the system.
std::vector< Bus * >	m_busList
	List of buses in the system.
std::vector< Capacitor * >	m_capacitorList
	List of capacitor elements in the system.
std::vector< IndMotor * >	m_indMotorList
	List of induction motors in the system.
std::vector< Inductor * >	m_inductorList
	List of inductors in the system.
std::vector< Line * >	m_lineList
	List of transmission lines in the system.
std::vector< Load * >	m_loadList
	List of load elements in the system.
std::vector< SyncGenerator * >	m_syncGeneratorList
	List of synchronous generators in the system.
std::vector< SyncMotor * >	m_syncMotorList
	List of synchronous motors in the system.
std::vector< Transformer * >	m_transformerList
	List of transformers in the system.
std::vector< HarmCurrent * >	m_harmCurrentList
	List of harmonic current sources in the system.
std::vector< EMTElement * >	m_emtElementList
	List of electromagnetic transient (EMT) elements in the system.

Detailed Description

Calculates the electromechanical transient based on disturbances (e.g. system fault).

Author

Thales Lima Oliveira thale.nosp@m.s@uf.nosp@m.u.br

Date

23/09/2017

Definition at line 51 of file Electromechanical.h.

Constructor & Destructor Documentation

Electromechanical()

Electromechanical::Electromechanical	(	wxWindow *	parent,
		std::vector< Element * >	elementList,
		SimulationData	data
	)

Definition at line 21 of file Electromechanical.cpp.

{
    m_parent = parent;
    GetElementsFromList(elementList);
    SetEventTimeList();
 
    Bus dummyBus;
    m_simData = data;
    m_powerSystemBase = dummyBus.GetValueFromUnit(data.basePower, data.basePowerUnit);
    m_systemFreq = data.stabilityFrequency;
    m_simTime = data.stabilitySimulationTime;
    m_timeStep = data.timeStep;
    m_tolerance = data.stabilityTolerance;
    m_maxIterations = data.stabilityMaxIterations;
 
    m_ctrlTimeStepMultiplier = 1.0 / static_cast<double>(data.controlTimeStepRatio);
 
    m_plotTime = data.plotTime;
    m_useCOI = data.useCOI;
    // If the user use all load as ZIP, updates the portions of each model, otherwise use constant impedance only.
    for (auto it = m_loadList.begin(), itEnd = m_loadList.end(); it != itEnd; ++it) {
        Load* load = *it;
        auto loadData = load->GetElectricalData();
        if (!loadData.useCompLoad) {  // If no individual load composition defined.
            if (data.useCompLoads) {  // Use general composition, if defined.
                loadData.constImpedanceActive = data.constImpedanceActive;
                loadData.constCurrentActive = data.constCurrentActive;
                loadData.constPowerActive = data.constPowerActive;
                loadData.constImpedanceReactive = data.constImpedanceReactive;
                loadData.constCurrentReactive = data.constCurrentReactive;
                loadData.constPowerReactive = data.constPowerReactive;
            }
            else {  // Otherwise, use constant impedance.
                loadData.constImpedanceActive = 100.0;
                loadData.constCurrentActive = 0.0;
                loadData.constPowerActive = 0.0;
                loadData.constImpedanceReactive = 100.0;
                loadData.constCurrentReactive = 0.0;
                loadData.constPowerReactive = 0.0;
            }
        }
 
        loadData.constCurrentUV = data.underVoltageConstCurrent / 100.0;
        loadData.constPowerUV = data.underVoltageConstPower / 100.0;
        load->SetElectricalData(loadData);
    }
}

~Electromechanical()

Electromechanical::~Electromechanical

(

)

Definition at line 69 of file Electromechanical.cpp.

{ }

Member Function Documentation

CalculateBusesFrequency()

void Electromechanical::CalculateBusesFrequency ( bool  hasEvent )

protected

Definition at line 1771 of file Electromechanical.cpp.

{
    bool ignoreEventStep = true;
    for (auto& bus : m_busList) {
        auto data = bus->GetElectricalData();
        if (!data.plotBus) continue;
 
        if (m_simData.busFreqEstimation == BusFreqEstimation::WASHOUT_FILTER) {
            //tex: 
            // Low-pass filter:
            // $$\frac{d}{dt}x_{\theta} = x_{\theta}' = \frac{\omega^{-1}(\theta_k - \theta_0) - x_{\theta}}{T_f}$$
            // Washout filter:
            // $$\frac{d}{dt}\Delta\omega_{k} = \Delta\omega_{k}' = \frac{x_{\theta}' - \Delta\omega_{k}}{T_w}$$
            // Trapezoidal rule:
            // $$ y_{k} = y_{k-1} + 0.5 h \cdot (y_{k-1}'+y_{k}') $$
 
            double tf = m_simData.tf;
            double tw = m_simData.tw;
            double error = 1.0;
            double theta0 = std::arg(data.number >= 0 ? data.voltage : 0.0);
 
            // Low-pass filter
            auto fdxt = [this, tf, theta0](double theta, double xt) {
                return (1.0 / tf) * ((1.0 / (2.0 * M_PI * m_systemFreq)) * (theta - theta0) - xt);
                };
 
            // Washout filter
            auto fddw = [this, tw](double dxt, double dw) {
                return (1.0 / tw) * (dxt - dw);
                };
 
            double theta = std::arg(data.number >= 0 ? m_vBus[data.number] : theta0);
 
            double xt = 0, dw = 0, dxt = 0, ddw = 0;
            int iterations = 0;
            while (error > 1e-6 && iterations <= 100) {
                double oldXT = xt, oldDW = dw;
 
                dxt = fdxt(theta, xt);
                xt = data.filteredAngle + 0.5 * m_timeStep * (data.dxt + dxt); // Trapezoidal rule
                error = std::abs(xt - oldXT);
 
                ddw = fddw(dxt, dw);
                dw = data.filteredVelocity + 0.5 * m_timeStep * (data.ddw + ddw); // Trapezoidal rule
                error = std::max(error, std::abs(dw - oldDW));
                iterations++;
            }
 
            //if (ignoreEventStep && hasEvent) {
            //  xt = data.filteredAngle;
            //  dw = 0.0;
            //  dxt = 0.0;
            //  ddw = 0.0;
            //}
 
            data.filteredAngle = xt;
            data.filteredVelocity = dw;
            data.dxt = dxt;
            data.ddw = ddw;
 
            double busVelocity = m_refSpeed + dw * (2.0 * M_PI * m_systemFreq);
            data.stabFreq = busVelocity / (2.0 * M_PI);
 
            bus->SetElectricalData(data);
        }
        else if (m_simData.busFreqEstimation == BusFreqEstimation::ANGLE_DERIVATION) {
            double newAngle = std::arg(data.number >= 0 ? m_vBus[data.number] : 0.0);
 
 
            //tex: $$\Delta \omega^k=\frac{\theta^k - \theta^{k-1}}{h}$$
            double dw = (newAngle - data.oldAngle) / m_timeStep;
            //double dw = (1.0 / (2.0 * M_PI * m_systemFreq)) * ((newAngle - data.oldAngle) / m_timeStep); // p.u.
 
            if (m_simData.ignoreBusFreqEventStep && hasEvent) dw = 0.0;
 
            //tex: $$f^k= \frac{\omega_{CoI}+\Delta \omega^k}{2\pi}$$
            data.stabFreq = (m_refSpeed + dw) / (2.0 * M_PI);
            //data.stabFreq = ((2.0 * M_PI * m_systemFreq) + dw) / (2.0 * M_PI);
 
            data.oldAngle = newAngle;
        }
        bus->SetElectricalData(data);
    }
}

CalculateIndMachinesTransientValues()

bool Electromechanical::CalculateIndMachinesTransientValues ( IndMotor *  motor )

protected

Definition at line 1975 of file Electromechanical.cpp.

{
    auto data = motor->GetElectricalData();
    auto dataPU = motor->GetPUElectricalData(m_powerSystemBase);
    double k = 1.0;  // Power base change factor.
    if (data.useMachinePowerAsBase) {
        double oldBase = motor->GetValueFromUnit(data.ratedPower, data.ratedPowerUnit);
        k = m_powerSystemBase / oldBase;
    }
 
    data.terminalVoltage = static_cast<Bus*>(motor->GetParentList()[0])->GetElectricalData().voltage;
 
    // Calculate the induction machine transient constants at the machine base
    double r1t = data.r1 * k;
    double r2t = data.r2 * k;
    double x1t = data.x1 * k;
    double x2t = data.x2 * k;
    double xmt = data.xm * k;
    data.r1t = r1t;
    data.r2t = r2t;
    data.x1t = x1t;
    data.x2t = x2t;
    data.xmt = xmt;
 
    double xt = x1t + (x2t * xmt) / (x2t + xmt);
    double x0 = x1t + xmt;
    data.xt = xt;
    data.x0 = x0;
 
    double p = dataPU.activePower;
    double v = std::abs(data.terminalVoltage);
 
    //[Ref.] Induction Motor Static Models for Power Flow and Voltage stability Studies
    // If the motor is offline, calculate the nominal slip to user-defined power input and 1.0 p.u. voltage
    if (!motor->IsOnline()) v = 1.0;
    double r1 = data.r1t;
    double r2 = data.r2t;
    if (data.useKf) r2 *= (1.0 + data.kf * r2t);
    double x1 = data.x1t;
    double x2 = data.x2t;
    double xm = data.xmt;
    double k1 = x2 + xm;
    double k2 = -x1 * k1 - x2 * xm;
    double k3 = xm + x1;
    double k4 = r1 * k1;
    double a = p * (r1 * r1 + k3 * k3) - v * v * r1;
    double b = 2.0 * p * (r1 * k2 + k3 * k4) - v * v * (k2 + k1 * k3);
    double c = p * (k2 * k2 + k4 * k4) - v * v * k1 * k4;
    double d = (b * b - 4.0 * a * c);
    if (d < 0.0) {
        m_errorMsg = _("Error on initializate the slip of \"") + data.name + _("\".");
        return false;
    }
    double r2_s = (-b + std::sqrt(d)) / (2.0 * a);
    data.s0 = r2 / r2_s;
 
    double qa = k1 * (r2_s * r1 - x1 * k1 - x2 * xm);
    double qb = r2_s * (r2_s * (xm + x1) + r1 * k1);
    double qc = r2_s * r1 - x1 * k1 - x2 * xm;
    double qd = r2_s * (xm + x1) + r1 * k1;
    data.q0 = (-v * v * (qa - qb)) / (qc * qc + qd * qd);
 
    data.t0 = (x2t + xmt) / (2.0 * M_PI * m_systemFreq * r2);
 
    motor->SetElectricalData(data);
    return true;
}

CalculateInjectedCurrents()

bool Electromechanical::CalculateInjectedCurrents ( )

protected

Definition at line 910 of file Electromechanical.cpp.

{
    // Reset injected currents vector
    for (unsigned int i = 0; i < m_iBus.size(); ++i) m_iBus[i] = std::complex<double>(0.0, 0.0);
 
    // Synchronous machines
    for (auto it = m_syncGeneratorList.begin(), itEnd = m_syncGeneratorList.end(); it != itEnd; ++it) {
        SyncGenerator* syncGenerator = *it;
        auto data = syncGenerator->GetElectricalData();
        if (syncGenerator->IsOnline()) {
            double k = 1.0;  // Power base change factor.
            if (data.useMachineBase) {
                double oldBase = syncGenerator->GetValueFromUnit(data.nominalPower, data.nominalPowerUnit);
                k = m_powerSystemBase / oldBase;
            }
 
            double ra = data.armResistance * k;
            double xp = data.potierReactance * k;
            if (xp == 0.0) xp = 0.8 * data.transXd * k;
 
            int n = static_cast<Bus*>(syncGenerator->GetParentList()[0])->GetElectricalData().number;
            std::complex<double> e = std::complex<double>(0.0, 0.0);
            std::complex<double> v = m_vBus[n];
            std::complex<double> iInj = m_iBus[n];
 
            auto smModelData = GetSyncMachineModelData(syncGenerator);
            DQ0toABC(smModelData.ed, smModelData.eq, data.delta, e);
            double xd = smModelData.xd;
            double xq = smModelData.xq;
 
            double sd = data.sd;
            double sq = data.sq;
            double id, iq;
 
            // Calculate the saturation effect
            if (data.satFactor != 0.0) {
                if (!CalculateSyncMachineSaturation(syncGenerator, id, iq, sd, sq, false, k)) return false;
            }
 
            double xdq, xds, xqs, xdqs;
            xdq = 0.5 * (xd + xq);
            xds = (xd - xp) / sd + xp;
            xqs = (xq - xp) / sq + xp;
            xdqs = 0.5 * (xds + xqs);
 
            std::complex<double> y0 = std::complex<double>(ra, -xdq) / std::complex<double>(ra * ra + xd * xq, 0.0);
            std::complex<double> iUnadjusted = y0 * v;
 
            // [Ref] Arrillaga, J.; Arnold, C. P.. "Computer Modelling of Electrical Power Systems". Pg. 225-226
            // [Ref] Dommell, H. W.; Sato, N.. "Fast transient stability solutions". IEEE Transactions on Power
            // Apparatus and Systems, PAS-91 (4), 1643-1650
            std::complex<double> iSaliency = std::complex<double>(0.0, -((0.5 * (xqs - xds)) / (ra * ra + xds * xqs))) *
                (std::conj(e) - std::conj(v));
            iSaliency = iSaliency * std::cos(2.0 * data.delta) +
                iSaliency * std::complex<double>(0.0, std::sin(2.0 * data.delta));
 
            // [Ref] Arrillaga, J.; Arnold, C. P.; Computer Modelling of Electrical Power Systems. Pg. 258-259
            std::complex<double> y0s = std::complex<double>(ra, -xdqs) / std::complex<double>(ra * ra + xds * xqs, 0.0);
            std::complex<double> iSaturation = y0s * (e - v);
 
            iInj = iUnadjusted + iSaliency + iSaturation;
 
            m_iBus[n] += iInj;
 
            // Remove the current flowing through y0 (i.e. iUnadjusted in this case, y0 is inserted in admittance
            // matrix) to calculate the electrical power.
            std::complex<double> iMachine = iInj - iUnadjusted;
            data.electricalPower = v * std::conj(iMachine);
 
            ABCtoDQ0(iMachine, data.delta, id, iq);
 
            data.id = id;
            data.iq = iq;
            data.sd = sd;
            data.sq = sq;
        }
        else {
            data.electricalPower = std::complex<double>(0.0, 0.0);
        }
 
        syncGenerator->SetElectricalData(data);
    }
    // Induction motors
    for (auto it = m_indMotorList.begin(), itEnd = m_indMotorList.end(); it != itEnd; ++it) {
        IndMotor* motor = *it;
        auto data = motor->GetElectricalData();
        if (motor->IsOnline()) {
            int n = static_cast<Bus*>(motor->GetParentList()[0])->GetElectricalData().number;
            std::complex<double> y0 = std::complex<double>(1.0, 0.0) / std::complex<double>(data.r1t, data.xt);
            std::complex<double> v = m_vBus[n];
            std::complex<double> e = std::complex<double>(data.tranEr, data.tranEm);
            std::complex<double> iInj = y0 * e;
            m_iBus[n] += iInj;
 
            std::complex<double> iMachine = y0 * (v - e);
 
            data.ir = std::real(iMachine);
            data.im = std::imag(iMachine);
        }
        else {
            data.ir = 0.0;
            data.im = 0.0;
        }
        motor->SetElectricalData(data);
    }
 
    // Loads
    for (auto it = m_loadList.begin(), itEnd = m_loadList.end(); it != itEnd; ++it) {
        Load* load = *it;
        auto data = load->GetElectricalData();
        Bus* bus = nullptr;
        if (!GetParentBus(load, bus)) {
            load->SetOnline(false);
        }
        else if (load->IsOnline()) {
 
            data.voltage = m_vBus[bus->GetElectricalData().number];
            double vAbs = std::abs(data.voltage);
 
            double pz, pi, pp, qz, qi, qp;
            pz = data.pz0 * std::pow(vAbs / data.v0, 2);
            pi = data.pi0 * (vAbs / data.v0);
            pp = data.pp0;
            qz = data.qz0 * std::pow(vAbs / data.v0, 2);
            qi = data.qi0 * (vAbs / data.v0);
            qp = data.qp0;
 
            // If voltage value is low, set the ZIP load to constant impedance.
            if (vAbs < data.constCurrentUV) {
                pi = data.pi0 * (data.constCurrentUV / data.v0) * std::pow(vAbs / data.constCurrentUV, 2);
                qi = data.qi0 * (data.constCurrentUV / data.v0) * std::pow(vAbs / data.constCurrentUV, 2);
            }
            if (vAbs < data.constPowerUV) {
                pp *= std::pow(vAbs / data.constPowerUV, 2);
                qp *= std::pow(vAbs / data.constPowerUV, 2);
            }
 
            double activePower = pz + pi + pp;
            double reactivePower = qz + qi + qp;
 
            std::complex<double> newY = std::complex<double>(activePower, -reactivePower) / (vAbs * vAbs);
            m_iBus[bus->GetElectricalData().number] += (data.y0 - newY) * data.voltage;
 
            data.electricalPower = std::complex<double>(activePower, reactivePower);
        }
        else {
            data.voltage = std::complex<double>(0.0, 0.0);
            data.electricalPower = std::complex<double>(0.0, 0.0);
        }
 
        load->SetElectricalData(data);
    }
    return true;
}

CalculateIntegrationConstants() [1/2]

void Electromechanical::CalculateIntegrationConstants ( IndMotor *  indMotor, double  ir, double  im, double  k = 1.0  )

protected

Definition at line 1137 of file Electromechanical.cpp.

{
    double w0 = 2.0 * M_PI * m_systemFreq;
 
    auto data = indMotor->GetElectricalData();
 
    // If the velocity is too low set mechanical torque to zero (a, b and c coeficients)
    if (data.slip > 0.99999) {
        data.as = 0.0;
        data.bs = 0.0;
        data.cs = 0.0;
    }
    else {
        data.as = data.aCalc;
        data.bs = data.bCalc;
        data.cs = data.cCalc;
    }
 
    // Mechanical equations
    // s
    data.icSlip.m = m_timeStep / ((4.0f * data.inertia / w0) / k + data.bs * m_timeStep);
    data.icSlip.c = data.slip * (1.0 - 2.0 * data.bs * data.icSlip.m) +
        data.icSlip.m * (2.0 * data.as + data.cs * data.slip * data.slip - data.te);
 
    // Electrical equations
    // Er
    data.icTranEr.m = m_timeStep / (2.0 * data.t0 + m_timeStep);
    data.icTranEr.c = data.tranEr * (1.0 - 2.0 * data.icTranEr.m) +
        data.icTranEr.m * (w0 * data.t0 * data.slip * data.tranEm - (data.x0 - data.xt) * im);
    // Em
    data.icTranEm.m = m_timeStep / (2.0 * data.t0 + m_timeStep);
    data.icTranEm.c = data.tranEm * (1.0 - 2.0 * data.icTranEm.m) -
        data.icTranEm.m * (w0 * data.t0 * data.slip * data.tranEr - (data.x0 - data.xt) * ir);
 
    indMotor->SetElectricalData(data);
}

CalculateIntegrationConstants() [2/2]

void Electromechanical::CalculateIntegrationConstants ( SyncGenerator *  syncGenerator, double  id, double  iq, double  k = 1.0  )

protected

Definition at line 1065 of file Electromechanical.cpp.

{
    CalculateReferenceSpeed();
    auto data = syncGenerator->GetElectricalData();
 
    double syncXd, syncXq, transXd, transXq, subXd, subXq;
    syncXd = data.syncXd * k;
    syncXq = data.syncXq * k;
    transXd = data.transXd * k;
    transXq = data.transXq * k;
    subXd = data.subXd * k;
    subXq = data.subXq * k;
 
    if (syncXq == 0.0) syncXq = syncXd;
    if (transXq == 0.0) transXq = transXd;
    if (subXd == 0.0) subXd = subXq;
    if (subXq == 0.0) subXq = subXd;
 
    double transTd0, transTq0, subTd0, subTq0;
    transTd0 = data.transTd0;
    transTq0 = data.transTq0;
    subTd0 = data.subTd0;
    subTq0 = data.subTq0;
 
    if (subTd0 == 0.0) subTd0 = subTq0;
    if (subTq0 == 0.0) subTq0 = subTd0;
 
    // Speed
    data.icSpeed.m = m_timeStep / ((4.0f * data.inertia / m_refSpeed) / k + m_timeStep * data.damping * k);
    data.icSpeed.c = (1.0f - 2.0f * data.icSpeed.m * data.damping * k) * data.speed +
        data.icSpeed.m * (data.pm - data.pe + 2.0f * m_refSpeed * data.damping * k);
 
    // Delta
    data.icDelta.m = 0.5f * m_timeStep;
    data.icDelta.c = data.delta + data.icDelta.m * (data.speed - 2.0f * m_refSpeed);
 
    // Eq'
    if (data.model == Machines::SM_MODEL_2 || data.model == Machines::SM_MODEL_3 || data.model == Machines::SM_MODEL_4 ||
        data.model == Machines::SM_MODEL_5) {
        data.icTranEq.m = m_timeStep / (2.0f * transTd0 + m_timeStep);
        data.icTranEq.c = (1.0 - data.icTranEq.m * (1.0 + data.sd)) * data.tranEq +
            data.icTranEq.m * (data.fieldVoltage + (syncXd - transXd) * id);
    }
 
    // Ed'
    if (data.model == Machines::SM_MODEL_3 || data.model == Machines::SM_MODEL_4 || data.model == Machines::SM_MODEL_5) {
        data.icTranEd.m = m_timeStep / (2.0f * transTq0 + m_timeStep);
        data.icTranEd.c =
            (1.0 - data.icTranEd.m * (1.0 + data.sq)) * data.tranEd - data.icTranEd.m * (syncXq - transXq) * iq;
    }
 
    // Eq''
    if (data.model == Machines::SM_MODEL_4 || data.model == Machines::SM_MODEL_5) {
        data.icSubEq.m = m_timeStep / (2.0f * subTd0 + m_timeStep);
        data.icSubEq.c = (1.0 - data.icSubEq.m * (1.0 + data.sd)) * data.subEq +
            data.icSubEq.m * (data.sd * data.tranEq + (transXd - subXd) * id);
    }
    // Ed''
    if (data.model == Machines::SM_MODEL_4) {
        data.icSubEd.m = m_timeStep / (2.0f * subTq0 + m_timeStep);
        data.icSubEd.c =
            (1.0f - data.icSubEd.m * (1.0 + data.sq)) * data.subEd - data.icSubEd.m * (syncXq - subXq) * iq;
    }
    if (data.model == Machines::SM_MODEL_5) {
        data.icSubEd.m = m_timeStep / (2.0f * subTq0 + m_timeStep);
        data.icSubEd.c = (1.0f - data.icSubEd.m * (1.0 + data.sq)) * data.subEd +
            data.icSubEd.m * (data.sq * data.tranEd - (transXq - subXq) * iq);
    }
 
    syncGenerator->SetElectricalData(data);
}

CalculateIntVariables() [1/2]

double Electromechanical::CalculateIntVariables ( IndMotor *  indMotor, double  ir, double  im, double  te, double  k = 1.0  )

protected

Definition at line 1606 of file Electromechanical.cpp.

{
    double error = 0.0;
    auto data = indMotor->GetElectricalData();
    double w0 = 2.0 * M_PI * m_systemFreq;
 
    // Mechanical differential equations
    // Using Newton method to solve the non-linear slip equation: s = Cs + Ms * (C * s^2 - Te):
    double slip = data.slip;  // Initial value. CAN BE THE PROBLEM ON MOTOR START!
    double ds = (data.icSlip.c + data.icSlip.m * (data.cs * slip * slip - te) - slip) /
        (1.0 - 2.0 * data.icSlip.m * data.cs * slip * slip);
    int iteration = 0;
    while (std::abs(ds) > 1e-8) {
        slip += ds;
        ds = (data.icSlip.c + data.icSlip.m * (data.cs * slip * slip - te) - slip) /
            (1.0 - 2.0 * data.icSlip.m * data.cs * slip * slip);
        iteration++;
        if (iteration > m_maxIterations) break;
    }
 
    //if(!indMotor->IsOnline()) slip = 1.0 - 1e-7;
    error = std::max(error, std::abs(data.slip - slip));
    data.slip = slip;
 
    // Change T'0 with the cage factor
    if (data.useKf)
        data.t0 = (data.x2t + data.xmt) / (2.0 * M_PI * m_systemFreq * data.r2t * (1.0 + data.kf * data.r2t));
 
    // Electrical differential equations
    double tranEr = data.icTranEr.c + data.icTranEr.m * (w0 * data.t0 * slip * data.tranEm - (data.x0 - data.xt) * im);
    error = std::max(error, std::abs(data.tranEr - tranEr));
 
    double tranEm = data.icTranEm.c - data.icTranEm.m * (w0 * data.t0 * slip * data.tranEr - (data.x0 - data.xt) * ir);
    error = std::max(error, std::abs(data.tranEm - tranEm));
 
    data.tranEr = tranEr;
    data.tranEm = tranEm;
 
    indMotor->SetElectricalData(data);
    return error;
}

CalculateIntVariables() [2/2]

double Electromechanical::CalculateIntVariables ( SyncGenerator *  syncGenerator, double  id, double  iq, double  sd, double  sq, double  pe, double  k = 1.0  )

protected

Definition at line 1476 of file Electromechanical.cpp.

{
    double error = 0.0;
    auto data = syncGenerator->GetElectricalData();
 
    // Mechanical differential equations.
    double w = data.icSpeed.c + data.icSpeed.m * (data.pm - pe);
    error = std::max(error, std::abs(data.speed - w) / m_refSpeed);
 
    double delta = data.icDelta.c + data.icDelta.m * w;
    error = std::max(error, std::abs(data.delta - delta));
 
    data.speed = w;
    data.delta = delta;
 
    // Electrical differential equations
    switch (data.model) {
    case Machines::SM_MODEL_1: {
        // There is no differential equations.
    } break;
    case Machines::SM_MODEL_2: {
        double syncXd, transXd;
        syncXd = data.syncXd * k;
        transXd = data.transXd * k;
 
        double tranEq = (data.icTranEq.c + data.icTranEq.m * (data.fieldVoltage + (syncXd - transXd) * id)) /
            (1.0 + data.icTranEq.m * (sd - 1.0));
        error = std::max(error, std::abs(data.tranEq - tranEq));
 
        data.tranEq = tranEq;
    } break;
    case Machines::SM_MODEL_3: {
        double syncXd, syncXq, transXd, transXq;
        syncXd = data.syncXd * k;
        syncXq = data.syncXq * k;
        transXd = data.transXd * k;
        transXq = data.transXq * k;
        if (syncXq == 0.0) syncXq = syncXd;
        if (transXq == 0.0) transXq = transXd;
 
        double tranEq = (data.icTranEq.c + data.icTranEq.m * (data.fieldVoltage + (syncXd - transXd) * id)) /
            (1.0 + data.icTranEq.m * (sd - 1.0));
        error = std::max(error, std::abs(data.tranEq - tranEq));
 
        double tranEd =
            (data.icTranEd.c - data.icTranEd.m * (syncXq - transXq) * iq) / (1.0 + data.icTranEd.m * (sq - 1.0));
        error = std::max(error, std::abs(data.tranEd - tranEd));
 
        data.tranEq = tranEq;
        data.tranEd = tranEd;
 
        if (!syncGenerator->IsOnline()) {
            std::complex<double> e;
            DQ0toABC(data.tranEd, data.tranEq, data.delta, e);
            data.terminalVoltage = e;
        }
    } break;
    case Machines::SM_MODEL_4: {
        double syncXd, syncXq, transXd, subXd, subXq;
        syncXd = data.syncXd * k;
        syncXq = data.syncXq * k;
        transXd = data.transXd * k;
        subXd = data.subXd * k;
        subXq = data.subXq * k;
        if (syncXq == 0.0) syncXq = syncXd;
        if (subXd == 0.0) subXd = subXq;
        if (subXq == 0.0) subXq = subXd;
 
        double tranEq = (data.icTranEq.c + data.icTranEq.m * (data.fieldVoltage + (syncXd - transXd) * id)) /
            (1.0 + data.icTranEq.m * (sd - 1.0));
        error = std::max(error, std::abs(data.tranEq - tranEq));
 
        double subEq = (data.icSubEq.c + data.icSubEq.m * (sd * tranEq + (transXd - subXd) * id)) /
            (1.0 + data.icSubEq.m * (sd - 1.0));
        error = std::max(error, std::abs(data.subEq - subEq));
 
        double subEd =
            (data.icSubEd.c - data.icSubEd.m * ((syncXq - subXq) * iq)) / (1.0 + data.icSubEd.m * (sq - 1.0));
        error = std::max(error, std::abs(data.subEd - subEd));
 
        data.tranEq = tranEq;
        data.subEq = subEq;
        data.subEd = subEd;
    } break;
    case Machines::SM_MODEL_5: {
        double syncXd, syncXq, transXd, transXq, subXd, subXq;
        syncXd = data.syncXd * k;
        syncXq = data.syncXq * k;
        transXd = data.transXd * k;
        transXq = data.transXq * k;
        subXd = data.subXd * k;
        subXq = data.subXq * k;
        if (syncXq == 0.0) syncXq = syncXd;
        if (transXq == 0.0) transXq = transXd;
        if (subXd == 0.0) subXd = subXq;
        if (subXq == 0.0) subXq = subXd;
 
        double tranEq = (data.icTranEq.c + data.icTranEq.m * (data.fieldVoltage + (syncXd - transXd) * id)) /
            (1.0 + data.icTranEq.m * (sd - 1.0));
        error = std::max(error, std::abs(data.tranEq - tranEq));
 
        double tranEd =
            (data.icTranEd.c - data.icTranEd.m * (syncXq - transXq) * iq) / (1.0 + data.icTranEd.m * (sq - 1.0));
        error = std::max(error, std::abs(data.tranEd - tranEd));
 
        double subEq = (data.icSubEq.c + data.icSubEq.m * (sd * tranEq + (transXd - subXd) * id)) /
            (1.0 + data.icSubEq.m * (sd - 1.0));
        error = std::max(error, std::abs(data.subEq - subEq));
 
        double subEd = (data.icSubEd.c + data.icSubEd.m * (sq * tranEd - (transXq - subXq) * iq)) /
            (1.0 + data.icSubEd.m * (sq - 1.0));
        error = std::max(error, std::abs(data.subEd - subEd));
 
        data.tranEq = tranEq;
        data.tranEd = tranEd;
        data.subEq = subEq;
        data.subEd = subEd;
    } break;
    }
 
    syncGenerator->SetElectricalData(data);
    return error;
}

CalculateNonIntVariables() [1/2]

bool Electromechanical::CalculateNonIntVariables ( IndMotor *  indMotor, double &  ir, double &  im, double &  te, double  k = 1.0  )

protected

Definition at line 1455 of file Electromechanical.cpp.

{
    auto data = indMotor->GetElectricalData();
    if (indMotor->IsOnline()) {
        double w0 = 2.0 * M_PI * m_systemFreq;
        te = (data.tranEr * ir + data.tranEm * im) / w0;
    }
    else {
        te = ir = im = 0.0;
    }
    data.te = te;
    data.ir = ir;
    data.im = im;
    data.oldTe = te;
    data.oldIr = ir;
    data.oldIm = im;
    indMotor->SetElectricalData(data);
 
    return true;
}

CalculateNonIntVariables() [2/2]

bool Electromechanical::CalculateNonIntVariables ( SyncGenerator *  syncGenerator, double &  id, double &  iq, double &  sd, double &  sq, double &  pe, double  k = 1.0  )

protected

Definition at line 1415 of file Electromechanical.cpp.

{
    auto data = syncGenerator->GetElectricalData();
    Bus* bus = nullptr;
    if (GetParentBus(syncGenerator, bus)) { data.terminalVoltage = m_vBus[bus->GetElectricalData().number]; }
 
    double vd, vq;
    ABCtoDQ0(data.terminalVoltage, data.delta, vd, vq);
 
    if (data.satFactor != 0.0) {
        if (!CalculateSyncMachineSaturation(syncGenerator, id, iq, sd, sq, true, k)) return false;
        data.sd = sd;
        data.sq = sq;
        data.oldSd = sd;
        data.oldSq = sq;
    }
 
    if (syncGenerator->IsOnline()) {
        pe = id * vd + iq * vq + (id * id + iq * iq) * data.armResistance * k;
    }
    else {
        pe = id = iq = 0.0f;
    }
    data.pe = pe;
    data.id = id;
    data.iq = iq;
    data.oldPe = pe;
    data.oldId = id;
    data.oldIq = iq;
    syncGenerator->SetElectricalData(data);
 
    return true;
}

CalculateReferenceSpeed()

void Electromechanical::CalculateReferenceSpeed ( )

protected

Definition at line 1648 of file Electromechanical.cpp.

{
    if (m_useCOI) {
        double sumHW = 0.0;
        double sumH = 0.0;
        for (auto it = m_syncGeneratorList.begin(), itEnd = m_syncGeneratorList.end(); it != itEnd; ++it) {
            SyncGenerator* syncGenerator = *it;
            if (syncGenerator->IsOnline()) {
                auto data = syncGenerator->GetElectricalData();
                double k = 1.0;  // Power base change factor.
                if (data.useMachineBase) {
                    double oldBase = syncGenerator->GetValueFromUnit(data.nominalPower, data.nominalPowerUnit);
                    k = m_powerSystemBase / oldBase;
                }
                sumH += data.inertia / k;
                sumHW += data.inertia * data.speed / k;
            }
        }
        m_refSpeed = sumHW / sumH;
    }
    else {
        m_refSpeed = 2.0 * M_PI * m_systemFreq;
    }
}

CalculateSyncMachineSaturation()

bool Electromechanical::CalculateSyncMachineSaturation ( SyncGenerator *  syncMachine, double &  id, double &  iq, double &  sd, double &  sq, bool  updateCurrents = true, double  k = 1.0  )

protected

Definition at line 1673 of file Electromechanical.cpp.

{
    // [Ref] Arrillaga, J.; Arnold, C. P.. "Computer Modelling of Electrical Power Systems". Pg. 254-260
    auto data = syncMachine->GetElectricalData();
    auto smDataModel = GetSyncMachineModelData(syncMachine);
 
    Bus* bus = nullptr;
    if (GetParentBus(syncMachine, bus)) { data.terminalVoltage = m_vBus[bus->GetElectricalData().number]; }
    //else {
        //data.terminalVoltage = 0.0;
        //return true;
    //}
    double idCalc = id;
    double iqCalc = iq;
    double sdCalc = sd;
    double sqCalc = sq;
 
    double vd, vq;
    ABCtoDQ0(data.terminalVoltage, data.delta, vd, vq);
    double deltaVd = smDataModel.ed - vd;
    double deltaVq = smDataModel.eq - vq;
 
    double ra = data.armResistance * k;
    double xd = smDataModel.xd;
    double xq = smDataModel.xq;
 
    double syncXd = data.syncXd * k;
    double syncXq = data.syncXq * k;
    if (data.model == Machines::SM_MODEL_1) {
        syncXq = data.transXd * k;
        syncXd = syncXq;
    }
    else if (data.syncXq == 0.0)
        syncXq = data.syncXd * k;
 
    double xp = data.potierReactance * k;
    if (xp == 0.0) xp = 0.8 * data.transXd * k;
    double satFacd = (data.satFactor - 1.2) / std::pow(1.2, 7);
    double satFacq = satFacd * (syncXq / syncXd);
 
    bool exit = false;
    int iterations = 0;
    while (!exit) {
        double oldSd = sdCalc;
        double oldSq = sqCalc;
 
        // Saturated reactances.
        double xds = (xd - xp) / sdCalc + xp;
        double xqs = (xq - xp) / sqCalc + xp;
        // dq currents.
        double den = 1.0 / (ra * ra + xds * xqs);
        iqCalc = den * (ra * deltaVq + xds * deltaVd);
        idCalc = den * (-xqs * deltaVq + ra * deltaVd);
        // Potier voltages
        double epq = vq + ra * iqCalc - xp * idCalc;
        double epd = vd + ra * idCalc + xp * iqCalc;
        // Saturation factors.
        // Gauss
        /*sdCalc = 1.0 + satFacd * std::pow(epq, 6);
        sqCalc = 1.0 + satFacq * std::pow(epd, 6);*/
 
        // Newton-raphson
        double f1 = 1.0 - sdCalc + satFacd * std::pow(epq, 6);
        double f2 = 1.0 - sqCalc + satFacq * std::pow(epd, 6);
        double dF1dSd =
            (6.0 * satFacd * std::pow(epq, 5) * xp * (xd - xp) * deltaVq) / ((sdCalc - 1.0) * xp + xd) - 1.0;
        double dF2dSq =
            (6.0 * satFacq * std::pow(epd, 5) * xp * (xq - xp) * deltaVd) / ((sqCalc - 1.0) * xp + xq) - 1.0;
 
        sdCalc = sdCalc - f1 / dF1dSd;
        sqCalc = sqCalc - f2 / dF2dSq;
 
        double error = std::abs(sdCalc - oldSd) + std::abs(sqCalc - oldSq);
        if (error < m_saturationTolerance) exit = true;
 
        iterations++;
        if ((iterations >= m_maxIterations) && !exit) {
            m_errorMsg =
                _("It was not possible to solve the saturation of the synchronous machine \"") + data.name + wxT("\".");
            return false;
        }
    }
 
    sd = sdCalc;
    sq = sqCalc;
    if (updateCurrents) {
        id = idCalc;
        iq = iqCalc;
    }
    return true;
}

EventTrigger()

bool Electromechanical::EventTrigger ( double  eventTime, double  currentTime  )

inlineprotected

Definition at line 521 of file Electromechanical.cpp.

{
    return (((eventTime - m_timeStep) < currentTime) && (eventTime >= currentTime));
}

GetDebugMessage()

wxString Electromechanical::GetDebugMessage ( ) const

inline

Definition at line 63 of file Electromechanical.h.

{ return m_debugMessage; }

GetErrorMessage()

wxString Electromechanical::GetErrorMessage ( ) const

inline

Definition at line 58 of file Electromechanical.h.

{ return m_errorMsg; }

GetIndMachineAdmittance()

std::complex< double > Electromechanical::GetIndMachineAdmittance ( IndMotor *  motor )

protected

Definition at line 1951 of file Electromechanical.cpp.

{
    auto data = motor->GetElectricalData();
    auto dataPU = motor->GetPUElectricalData(m_powerSystemBase);
    std::complex<double> v = static_cast<Bus*>(motor->GetParentList()[0])->GetElectricalData().voltage;
    std::complex<double> y0 = (std::complex<double>(1, 0) / std::complex<double>(data.r1t, data.xt));
    // The difference between calculated and defined reactive power
    std::complex<double> yq = std::complex<double>(0.0, data.q0 - dataPU.reactivePower) / (std::abs(v) * std::abs(v));
    return y0 + yq;
}

GetIterationVector()

std::vector< double > Electromechanical::GetIterationVector ( ) const

inline

Definition at line 62 of file Electromechanical.h.

{ return m_iterationsNumVector; }

GetSyncMachineAdmittance()

std::complex< double > Electromechanical::GetSyncMachineAdmittance ( SyncGenerator *  generator )

protected

Definition at line 526 of file Electromechanical.cpp.

{
    auto data = generator->GetElectricalData();
    double k = 1.0;  // Power base change factor.
    if (data.useMachineBase) {
        double oldBase = generator->GetValueFromUnit(data.nominalPower, data.nominalPowerUnit);
        k = m_powerSystemBase / oldBase;
    }
 
    double ra = data.armResistance * k;
    auto smModelData = GetSyncMachineModelData(generator);
    double xd = smModelData.xd;
    double xq = smModelData.xq;
    double xdq = 0.5 * (xd + xq);
    return (std::complex<double>(ra, -xdq) / std::complex<double>(ra * ra + xd * xq, 0.0));
}

GetSyncMachineModelData()

SyncMachineModelData Electromechanical::GetSyncMachineModelData ( SyncGenerator *  syncMachine )

protected

Definition at line 1856 of file Electromechanical.cpp.

{
    SyncMachineModelData smModelData;
 
    auto data = syncMachine->GetElectricalData();
    double k = 1.0;  // Power base change factor.
    if (data.useMachineBase) {
        double oldBase = syncMachine->GetValueFromUnit(data.nominalPower, data.nominalPowerUnit);
        k = m_powerSystemBase / oldBase;
    }
 
    switch (data.model) {
    case Machines::SM_MODEL_1: {
        smModelData.ed = data.tranEd;
        smModelData.eq = data.tranEq;
        smModelData.xq = data.transXd * k;
        smModelData.xd = smModelData.xq;
    } break;
    case Machines::SM_MODEL_2: {
        smModelData.ed = data.tranEd;
        smModelData.eq = data.tranEq;
        smModelData.xd = data.transXd * k;
        smModelData.xq = data.transXq * k;
        if (smModelData.xq == 0.0) {
            smModelData.xq = data.syncXq * k;
            if (smModelData.xq == 0.0) { smModelData.xq = data.syncXd * k; }
        }
    } break;
    case Machines::SM_MODEL_3: {
        smModelData.ed = data.tranEd;
        smModelData.eq = data.tranEq;
        smModelData.xd = data.transXd * k;
        smModelData.xq = data.transXq * k;
        if (smModelData.xq == 0.0) smModelData.xq = smModelData.xd;
    } break;
    case Machines::SM_MODEL_4:
    case Machines::SM_MODEL_5: {
        smModelData.ed = data.subEd;
        smModelData.eq = data.subEq;
        smModelData.xd = data.subXd * k;
        smModelData.xq = data.subXq * k;
        if (smModelData.xd == 0.0) smModelData.xd = smModelData.xq;
        if (smModelData.xq == 0.0) smModelData.xq = smModelData.xd;
    } break;
    }
    return smModelData;
}

GetTimeVector()

std::vector< double > Electromechanical::GetTimeVector ( ) const

inline

Definition at line 59 of file Electromechanical.h.

{ return m_timeVector; }

HasEvent()

bool Electromechanical::HasEvent ( double  currentTime )

protected

Definition at line 196 of file Electromechanical.cpp.

{
    for (unsigned int i = 0; i < m_eventTimeList.size(); ++i) {
        if (!m_eventOccurrenceList[i]) {
            if (EventTrigger(m_eventTimeList[i], currentTime)) {
                m_eventOccurrenceList[i] = true;
                return true;
            }
        }
    }
    return false;
}

InitializeDynamicElements()

bool Electromechanical::InitializeDynamicElements ( )

protected

Definition at line 543 of file Electromechanical.cpp.

{
    // Buses
    for (auto it = m_busList.begin(), itEnd = m_busList.end(); it != itEnd; ++it) {
        Bus* bus = *it;
        auto data = bus->GetElectricalData();
        data.stabVoltageVector.clear();
        data.stabVoltageVector.shrink_to_fit();
        data.stabFreqVector.clear();
        data.stabFreqVector.shrink_to_fit();
        data.stabFreq = m_systemFreq;
        data.oldAngle = std::arg(data.voltage);
        data.filteredAngle = 0.0;
        data.dxt = 0.0;
        data.filteredVelocity = 0.0;
        data.ddw = 0.0;
        bus->SetElectricalData(data);
    }
    // Loads
    for (auto* load : m_loadList) {
        auto dataPU = load->GetPUElectricalData(m_powerSystemBase);
        auto data = load->GetElectricalData();
 
        double activePower = dataPU.activePower;
        double reactivePower = dataPU.reactivePower;
 
        Bus* bus = nullptr;
        if (GetParentBus(load, bus))
        {
            data.voltage = bus->GetElectricalData().voltage;
        }
        else {
            load->SetOnline(false);
        }
 
        data.v0 = std::abs(data.voltage);
        data.y0 = std::complex<double>(activePower, -reactivePower) / (data.v0 * data.v0);
 
        if (data.loadType == CONST_IMPEDANCE) {
            std::complex<double> s0 = std::complex<double>(activePower, -reactivePower) * (data.v0 * data.v0);
            activePower = s0.real();
            reactivePower = -s0.imag();
        }
 
        data.pz0 = (data.constImpedanceActive / 100.0) * activePower;
        data.pi0 = (data.constCurrentActive / 100.0) * activePower;
        data.pp0 = (data.constPowerActive / 100.0) * activePower;
 
        data.qz0 = (data.constImpedanceReactive / 100.0) * reactivePower;
        data.qi0 = (data.constCurrentReactive / 100.0) * reactivePower;
        data.qp0 = (data.constPowerReactive / 100.0) * reactivePower;
 
        data.voltageVector.clear();
        data.voltageVector.shrink_to_fit();
        data.electricalPowerVector.clear();
        data.electricalPowerVector.shrink_to_fit();
 
        if (load->IsOnline())
            data.electricalPower = std::complex<double>(activePower, reactivePower);
        else {
            data.electricalPower = std::complex<double>(0.0, 0.0);
            data.voltage = std::complex<double>(0.0, 0.0);
        }
 
        load->SetElectricalData(data);
    }
    // Synchronous generators
    for (auto it = m_syncGeneratorList.begin(), itEnd = m_syncGeneratorList.end(); it != itEnd; ++it) {
        SyncGenerator* syncGenerator = *it;
        auto dataPU = syncGenerator->GetPUElectricalData(m_powerSystemBase);
        auto data = syncGenerator->GetElectricalData();
        double k = 1.0;  // Power base change factor.
        if (data.useMachineBase) {
            double oldBase = syncGenerator->GetValueFromUnit(data.nominalPower, data.nominalPowerUnit);
            k = m_powerSystemBase / oldBase;
        }
        Bus* bus = nullptr;
        if (GetParentBus(syncGenerator, bus))
            data.terminalVoltage = bus->GetElectricalData().voltage;
        else
            data.terminalVoltage = std::complex<double>(1.0, 0.0);
 
        std::complex<double> conjS(dataPU.activePower, -dataPU.reactivePower);
        std::complex<double> vt = data.terminalVoltage;
        std::complex<double> ia = conjS / std::conj(vt);
 
        double xd = data.syncXd * k;
        double xq = data.syncXq * k;
        double ra = data.armResistance * k;
 
        if (data.model == Machines::SM_MODEL_1) {
            xq = data.transXd * k;
            xd = xq;
        }
        else if (data.syncXq == 0.0)
            xq = data.syncXd * k;
 
        double sd = 1.0;
        double sq = 1.0;
        double satF = 1.0;
        double xp = data.potierReactance * k;
        bool hasSaturation = false;
        if (data.satFactor != 0.0) {  // Have saturation.
            satF = (data.satFactor - 1.2) / std::pow(1.2, 7);
            if (xp == 0.0) xp = 0.8 * (data.transXd * k);
            hasSaturation = true;
        }
 
        // Initialize state variables
        std::complex<double> eq0 = vt + std::complex<double>(ra, xq) * ia;
        double delta = std::arg(eq0);
 
        double id0, iq0, vd0, vq0;
        ABCtoDQ0(ia, delta, id0, iq0);
        ABCtoDQ0(vt, delta, vd0, vq0);
 
        // Initialize saturation
        double xqs = xq;
        double xds = xd;
        if (hasSaturation) {
            double oldDelta = 0;
            bool exit = false;
            int numIt = 0;
            while (!exit) {
                oldDelta = delta;
                ABCtoDQ0(ia, delta, id0, iq0);
                ABCtoDQ0(vt, delta, vd0, vq0);
 
                // Direct-axis Potier voltage.
                double epd = vd0 + ra * id0 + xp * iq0;
 
                sq = 1.0 + satF * (xq / xd) * std::pow(epd, 6);
                xqs = (xq - xp) / sq + xp;
                eq0 = data.terminalVoltage + std::complex<double>(ra, xqs) * ia;
                delta = std::arg(eq0);
                if (std::abs(delta - oldDelta) < m_saturationTolerance) {
                    exit = true;
                }
                else if (numIt >= m_maxIterations) {
                    m_errorMsg = _("Error on initializate the saturation values of \"") + data.name + _("\".");
                    return false;
                }
                numIt++;
            }
            // Quadrature-axis Potier voltage.
            double epq = vq0 + ra * iq0 - xp * id0;
            sd = 1.0 + satF * std::pow(epq, 6);
            xds = (xd - xp) / sd + xp;
        }
 
        double ef0 = vq0 + ra * iq0 - xds * id0;
 
        data.initialFieldVoltage = ef0 * sd;
        data.fieldVoltage = data.initialFieldVoltage;
        data.pm = std::real((data.terminalVoltage * std::conj(ia)) + (std::abs(ia) * std::abs(ia) * ra));
        syncGenerator->IsOnline() ? data.speed = 2.0 * M_PI * m_systemFreq : data.speed = 2.0 * M_PI * data.ocFrequency;
        data.delta = delta;
        data.pe = data.pm;
        data.electricalPower = std::complex<double>(dataPU.activePower, dataPU.reactivePower);
        if (!syncGenerator->IsOnline()) data.electricalPower = std::complex<double>(0.0, 0.0);
        data.sd = sd;
        data.sq = sq;
        data.id = id0;
        data.iq = iq0;
 
        // Variables to extrapolate.
        data.oldIq = iq0;
        data.oldId = id0;
        data.oldPe = data.pe;
        data.oldSd = sd;
        data.oldSq = sq;
 
        switch (data.model) {
        case Machines::SM_MODEL_1: {
            data.tranEq = std::abs(eq0);
 
            data.tranEd = 0.0;
            data.subEq = 0.0;
            data.subEd = 0.0;
        } break;
        case Machines::SM_MODEL_2: {
            double tranXd = data.transXd * k;
 
            data.tranEq = ef0 + (xd - tranXd) * (id0 / sd);
            data.tranEd = 0.0;
            data.subEd = 0.0;
            data.subEq = 0.0;
        } break;
        case Machines::SM_MODEL_3: {
            double tranXd = data.transXd * k;
            double tranXq = data.transXq * k;
            if (tranXq == 0.0) tranXq = tranXd;
 
            data.tranEq = ef0 + (xd - tranXd) * (id0 / sd);
            data.tranEd = -(xq - tranXq) * (iq0 / sq);
 
            data.subEd = 0.0;
            data.subEq = 0.0;
        } break;
        case Machines::SM_MODEL_4: {
            double tranXd = data.transXd * k;
            double subXd = data.subXd * k;
            double subXq = data.subXq * k;
            if (subXd == 0.0) subXd = subXq;
            if (subXq == 0.0) subXq = subXd;
 
            data.tranEq = ef0 + (xd - tranXd) * (id0 / sd);
            data.tranEd = 0.0;
            data.subEq = data.tranEq + (tranXd - subXd) * (id0 / sd);
            data.subEd = -(xq - subXq) * (iq0 / sq);
        } break;
        case Machines::SM_MODEL_5: {
            double tranXd = data.transXd * k;
            double tranXq = data.transXq * k;
            double subXd = data.subXd * k;
            double subXq = data.subXq * k;
            if (subXd == 0.0) subXd = subXq;
            if (subXq == 0.0) subXq = subXd;
 
            data.tranEq = ef0 + (xd - tranXd) * (id0 / sd);
            data.tranEd = -(xq - tranXq) * (iq0 / sq);
            data.subEq = data.tranEq + (tranXd - subXd) * (id0 / sd);
            data.subEd = data.tranEd - (tranXq - subXq) * (iq0 / sq);
        } break;
        default:
            break;
        }
 
        // Initialize controllers
        if (data.useAVR) {
            //if (data.avrSolver) delete data.avrSolver;
            //data.avrSolver =
            //  new ControlElementSolver(data.avr, m_timeStep * m_ctrlTimeStepMultiplier, m_tolerance, m_parent);
            data.avrSolver = std::make_shared<ControlElementSolver>(data.avr, m_timeStep * m_ctrlTimeStepMultiplier, m_tolerance, m_parent);
 
            data.avrSolver->SetSwitchStatus(syncGenerator->IsOnline());
            data.avrSolver->SetCurrentTime(m_currentTime);
            data.avrSolver->SetTerminalVoltage(std::abs(data.terminalVoltage));
            data.avrSolver->SetInitialTerminalVoltage(std::abs(data.terminalVoltage));
            data.avrSolver->SetActivePower(dataPU.activePower);
            data.avrSolver->SetReactivePower(dataPU.reactivePower);
            data.avrSolver->SetVelocity(data.speed);
            data.avrSolver->SetInitialVelocity(data.speed);
            data.avrSolver->InitializeValues(false);
            if (!data.avrSolver->IsOK()) {
                m_errorMsg = _("Error on initializate the AVR of \"") + data.name + wxT("\".\n") +
                    data.avrSolver->GetErrorMessage();
                syncGenerator->SetElectricalData(data);
                return false;
            }
        }
        if (data.useSpeedGovernor) {
            //if (data.speedGovSolver) delete data.speedGovSolver;
            //data.speedGovSolver =
            //  new ControlElementSolver(data.speedGov, m_timeStep * m_ctrlTimeStepMultiplier, m_tolerance, m_parent);
 
            data.speedGovSolver = std::make_shared<ControlElementSolver>(data.speedGov, m_timeStep * m_ctrlTimeStepMultiplier, m_tolerance, m_parent);
            data.speedGovSolver->SetSwitchStatus(syncGenerator->IsOnline());
            data.speedGovSolver->SetCurrentTime(m_currentTime);
            data.speedGovSolver->SetActivePower(dataPU.activePower);
            data.speedGovSolver->SetReactivePower(dataPU.reactivePower);
            data.speedGovSolver->SetVelocity(data.speed);
            data.speedGovSolver->SetInitialVelocity(data.speed);
            data.speedGovSolver->SetInitialMecPower(data.pm);
            data.speedGovSolver->InitializeValues(false);
            if (!data.speedGovSolver->IsOK()) {
                m_errorMsg = _("Error on initializate the speed governor of \"") + data.name + wxT("\".\n") +
                    data.speedGovSolver->GetErrorMessage();
                syncGenerator->SetElectricalData(data);
                return false;
            }
        }
        //}
        //} else {
        // Initialize open circuit machine.
        //}
        // Reset plot data
        data.terminalVoltageVector.clear();
        data.terminalVoltageVector.shrink_to_fit();
        data.electricalPowerVector.clear();
        data.electricalPowerVector.shrink_to_fit();
        data.mechanicalPowerVector.clear();
        data.mechanicalPowerVector.shrink_to_fit();
        data.freqVector.clear();
        data.freqVector.shrink_to_fit();
        data.fieldVoltageVector.clear();
        data.fieldVoltageVector.shrink_to_fit();
        data.deltaVector.clear();
        data.deltaVector.shrink_to_fit();
 
        syncGenerator->SetElectricalData(data);
    }
    // Induction motors
    for (auto it = m_indMotorList.begin(), itEnd = m_indMotorList.end(); it != itEnd; ++it) {
        IndMotor* indMotor = *it;
        auto dataPU = indMotor->GetPUElectricalData(m_powerSystemBase);
        auto data = indMotor->GetElectricalData();
 
        Bus* connBus = static_cast<Bus*>(indMotor->GetParentList()[0]);
        if (connBus->GetElectricalData().number < 0) indMotor->SetOnline(false);
 
        double w0 = 2.0 * M_PI * m_systemFreq;
        std::complex<double> i1 = std::complex<double>(dataPU.activePower, -data.q0) / std::conj(data.terminalVoltage);
        double ir = std::real(i1);
        double im = std::imag(i1);
        std::complex<double> e = data.terminalVoltage - std::complex<double>(data.r1t, data.x1t) * i1;
        double te = std::real(e * std::conj(i1)) / w0;
 
        double wi = w0 * (1 - data.s0);  // Initial velocity
        data.as = te * (data.aw + (data.bw * w0) / wi + (data.cw * w0 * w0) / (wi * wi));
        data.bs = te * ((data.bw * w0) / wi + (2.0 * data.cw * w0 * w0) / (wi * wi));
        data.cs = (te * data.cw * w0 * w0) / (wi * wi);
 
        data.aCalc = data.as;
        data.bCalc = data.bs;
        data.cCalc = data.cs;
 
        if (indMotor->IsOnline()) {
            std::complex<double> tranE =
                (std::complex<double>(0, data.x0 - data.xt) * i1) / std::complex<double>(1.0, w0 * data.s0 * data.t0);
 
            data.tranEr = std::real(tranE);
            data.tranEm = std::imag(tranE);
 
            data.slip = data.s0;
            data.ir = ir;
            data.im = im;
            data.te = te;
        }
        else {  // Offline
            data.tranEr = 0.0;
            data.tranEm = 0.0;
            data.slip = 1.0 - 1e-7;
            data.ir = 0.0;
            data.im = 0.0;
            data.te = 0.0;
        }
 
        // Variables to extrapolate.
        data.oldTe = data.te;
        data.oldIr = data.ir;
        data.oldIm = data.im;
 
        // Reset plot data
        data.slipVector.clear();
        data.slipVector.shrink_to_fit();
        data.electricalTorqueVector.clear();
        data.electricalTorqueVector.shrink_to_fit();
        data.mechanicalTorqueVector.clear();
        data.mechanicalTorqueVector.shrink_to_fit();
        data.velocityVector.clear();
        data.velocityVector.shrink_to_fit();
        data.currentVector.clear();
        data.currentVector.shrink_to_fit();
        data.terminalVoltageVector.clear();
        data.terminalVoltageVector.shrink_to_fit();
        data.activePowerVector.clear();
        data.activePowerVector.shrink_to_fit();
        data.reactivePowerVector.clear();
        data.reactivePowerVector.shrink_to_fit();
 
        indMotor->SetElectricalData(data);
    }
    CalculateReferenceSpeed();
    return true;
}

InsertIndMachinesOnYBus()

bool Electromechanical::InsertIndMachinesOnYBus ( )

protected

Definition at line 1962 of file Electromechanical.cpp.

{
    for (auto it = m_indMotorList.begin(), itEnd = m_indMotorList.end(); it != itEnd; ++it) {
        IndMotor* motor = *it;
        if (!CalculateIndMachinesTransientValues(motor)) return false;
        if (motor->IsOnline()) {
            int n = static_cast<Bus*>(motor->GetParentList()[0])->GetElectricalData().number;
            m_yBus[n][n] += GetIndMachineAdmittance(motor);
        }
    }
    return true;
}

InsertSyncMachinesOnYBus()

void Electromechanical::InsertSyncMachinesOnYBus ( )

protected

Definition at line 498 of file Electromechanical.cpp.

{
    for (auto it = m_syncGeneratorList.begin(), itEnd = m_syncGeneratorList.end(); it != itEnd; ++it) {
        SyncGenerator* syncGenerator = *it;
        if (syncGenerator->IsOnline()) {
            Bus* connBus = static_cast<Bus*>(syncGenerator->GetParentList()[0]);
            if (connBus->GetElectricalData().number < 0) {
                syncGenerator->SetOnline(false);
                //auto data = syncGenerator->GetElectricalData();
                //data.activePower = 0.0;
                //data.reactivePower = 0.0;
                //syncGenerator->SetElectricalData(data);
            }
 
            if (syncGenerator->IsOnline()) {
                auto data = syncGenerator->GetElectricalData();
                int n = connBus->GetElectricalData().number;
                m_yBus[n][n] += GetSyncMachineAdmittance(syncGenerator);
            }
        }
    }
}

PreallocateVectors()

void Electromechanical::PreallocateVectors ( )

protected

Definition at line 1904 of file Electromechanical.cpp.

{
    int numPoints = static_cast<unsigned int>(m_simTime / m_plotTime);
 
    m_timeVector.reserve(numPoints);
    for (auto it = m_syncGeneratorList.begin(), itEnd = m_syncGeneratorList.end(); it != itEnd; ++it) {
        SyncGenerator* syncGenerator = *it;
        auto data = syncGenerator->GetElectricalData();
        if (data.plotSyncMachine) {
            data.terminalVoltageVector.reserve(numPoints);
            data.electricalPowerVector.reserve(numPoints);
            data.mechanicalPowerVector.reserve(numPoints);
            data.freqVector.reserve(numPoints);
            data.fieldVoltageVector.reserve(numPoints);
            data.deltaVector.reserve(numPoints);
            syncGenerator->SetElectricalData(data);
        }
    }
    for (auto it = m_busList.begin(), itEnd = m_busList.end(); it != itEnd; ++it) {
        Bus* bus = *it;
        auto data = bus->GetElectricalData();
        if (data.plotBus) {
            data.stabVoltageVector.reserve(numPoints);
            data.stabFreqVector.reserve(numPoints);
            bus->SetElectricalData(data);
        }
    }
    for (auto it = m_loadList.begin(), itEnd = m_loadList.end(); it != itEnd; ++it) {
        Load* load = *it;
        auto data = load->GetElectricalData();
        if (data.plotLoad) {
            data.voltageVector.reserve(numPoints);
            data.electricalPowerVector.reserve(numPoints);
            load->SetElectricalData(data);
        }
    }
    for (auto it = m_indMotorList.begin(), itEnd = m_indMotorList.end(); it != itEnd; ++it) {
        IndMotor* motor = *it;
        auto data = motor->GetElectricalData();
        if (data.plotIndMachine) {
            data.slipVector.reserve(numPoints);
            data.electricalTorqueVector.reserve(numPoints);
            motor->SetElectricalData(data);
        }
    }
}

RunStabilityCalculation()

bool Electromechanical::RunStabilityCalculation

(

)

Definition at line 71 of file Electromechanical.cpp.

{
    wxProgressDialog pbd(_("Running simulation"), _("Initializing..."), 100, m_parent,
        wxPD_APP_MODAL | wxPD_AUTO_HIDE | wxPD_CAN_ABORT | wxPD_SMOOTH);
 
    SetSyncMachinesModel();
 
    // Calculate the admittance matrix with the synchronous machines.
    if (!GetYBus(m_yBus, m_powerSystemBase, POSITIVE_SEQ, false, true, true)) {
        m_errorMsg = _("It was not possible to build the admittance matrix.");
        return false;
    }
    InsertSyncMachinesOnYBus();
    if (!InsertIndMachinesOnYBus()) return false;
    GetLUDecomposition(m_yBus, m_yBusL, m_yBusU);
 
    // Get buses voltages.
    m_vBus.clear();
    m_vBus.resize(m_yBus.size());
    for (auto it = m_busList.begin(), itEnd = m_busList.end(); it != itEnd; ++it) {
        Bus* bus = *it;
        auto data = bus->GetElectricalData();
        if (data.number >= 0) m_vBus[data.number] = data.voltage;
    }
    m_vBus.shrink_to_fit();
 
    // Calculate injected currents
    m_iBus = ComplexMatrixTimesVector(m_yBus, m_vBus);
    for (unsigned int i = 0; i < m_iBus.size(); ++i) {
        if (std::abs(m_iBus[i]) < 1e-5) m_iBus[i] = std::complex<double>(0.0, 0.0);
    }
 
    if (!InitializeDynamicElements()) return false;
    PreallocateVectors();  // Reserve the vectors' memory with a estimated size, this can optimize the simulation.
 
#ifdef _DEBUG
    for (auto* syncGenerator : m_syncGeneratorList) {
        auto data = syncGenerator->GetPUElectricalData(m_powerSystemBase);
        m_debugMessage += "------\n";
        m_debugMessage += data.name + ":\n";
        m_debugMessage += "P = " + wxString::FromDouble(data.electricalPower.real(), 5) + " p.u.\n";
        m_debugMessage += "Q = " + wxString::FromDouble(data.electricalPower.imag(), 5) + " p.u.\n";
        m_debugMessage += "If0 = " + wxString::FromDouble(data.initialFieldVoltage, 5) + " p.u.\n";
        m_debugMessage += "If = " + wxString::FromDouble(data.fieldVoltage, 5) + " p.u.\n";
        m_debugMessage += "delta = " + wxString::FromDouble(data.delta, 5) + " rad?\n";
        m_debugMessage += "Vf = " + wxString::FromDouble(data.fieldVoltage, 5) + " p.u.\n";
        m_debugMessage += "Vf0 = " + wxString::FromDouble(data.initialFieldVoltage, 5) + " p.u.\n";
        m_debugMessage += "Vt = " + wxString::FromDouble(std::abs(data.terminalVoltage), 5) + " p.u.\n";
        m_debugMessage += "theta = " + wxString::FromDouble(std::arg(data.terminalVoltage), 5) + " rad\n";
        m_debugMessage += "Pe = " + wxString::FromDouble(data.pe, 5) + " p.u.\n";
        m_debugMessage += "Pm = " + wxString::FromDouble(data.pm, 5) + " p.u.\n";
        m_debugMessage += "w = " + wxString::FromDouble(data.speed, 5) + " p.u.\n";
        m_debugMessage += "Id = " + wxString::FromDouble(data.id, 5) + " p.u.\n";
        m_debugMessage += "Iq = " + wxString::FromDouble(data.iq, 5) + " p.u.\n";
        m_debugMessage += "Ed' = " + wxString::FromDouble(data.tranEd, 5) + " p.u.\n";
        m_debugMessage += "Eq' = " + wxString::FromDouble(data.tranEq, 5) + " p.u.\n";
        m_debugMessage += "Ed'' = " + wxString::FromDouble(data.subEd, 5) + " p.u.\n";
        m_debugMessage += "Eq'' = " + wxString::FromDouble(data.subEq, 5) + " p.u.\n";
        m_debugMessage += "------\n\n";
    }
#endif
 
    double pbdTime = m_plotTime;
    m_currentTime = 0.0;
    double currentPlotTime = 0.0;
    double currentPbdTime = 0.0;
    while (m_currentTime <= m_simTime) {
        bool hasEvent = false;
        if (HasEvent(m_currentTime)) {
            hasEvent = true;
            SetEvent(m_currentTime);
            GetLUDecomposition(m_yBus, m_yBusL, m_yBusU);
        }
 
        if (currentPlotTime >= m_plotTime || m_currentTime == 0.0) {
            m_timeVector.emplace_back(m_currentTime);
            SaveData();
            currentPlotTime = 0.0;
        }
 
        if (currentPbdTime > pbdTime) {
            if (!pbd.Update((m_currentTime / m_simTime) * 100, wxString::Format("Time = %.2fs", m_currentTime))) {
                m_errorMsg = wxString::Format(_("Simulation cancelled at %.2fs."), m_currentTime);
                pbd.Update(100);
                return false;
            }
            currentPbdTime = 0.0;
        }
 
        if (!SolveMachines()) return false;
 
        CalculateBusesFrequency(hasEvent);
 
        m_currentTime += m_timeStep;
        currentPlotTime += m_timeStep;
        currentPbdTime += m_timeStep;
    }
 
    return true;
}

SaveData()

void Electromechanical::SaveData ( )

protected

Definition at line 1356 of file Electromechanical.cpp.

{
    for (auto it = m_syncGeneratorList.begin(), itEnd = m_syncGeneratorList.end(); it != itEnd; ++it) {
        SyncGenerator* syncGenerator = *it;
        auto data = syncGenerator->GetElectricalData();
        if (data.plotSyncMachine) { syncGenerator->SavePlotData(); }
    }
    for (auto it = m_busList.begin(), itEnd = m_busList.end(); it != itEnd; ++it) {
        Bus* bus = *it;
        auto data = bus->GetElectricalData();
        if (data.plotBus) {
            data.stabVoltageVector.emplace_back(data.number >= 0 ? m_vBus[data.number] : 0.0);
            data.stabFreqVector.emplace_back(data.number >= 0 ? data.stabFreq : 0.0);
            bus->SetElectricalData(data);
        }
    }
    for (auto it = m_loadList.begin(), itEnd = m_loadList.end(); it != itEnd; ++it) {
        Load* load = *it;
        auto data = load->GetElectricalData();
        if (data.plotLoad) {
            data.voltageVector.emplace_back(data.voltage);
            data.electricalPowerVector.emplace_back(data.electricalPower);
            load->SetElectricalData(data);
        }
    }
    for (auto it = m_indMotorList.begin(), itEnd = m_indMotorList.end(); it != itEnd; ++it) {
        IndMotor* motor = *it;
        auto data = motor->GetElectricalData();
        if (data.plotIndMachine) {
            data.slipVector.emplace_back(data.slip * 100.0);
            data.electricalTorqueVector.emplace_back(data.te * 2.0 * M_PI * m_systemFreq);
            double tm = (data.as - data.bs * data.slip + data.cs * data.slip * data.slip) * 2.0 * M_PI * m_systemFreq;
            data.mechanicalTorqueVector.emplace_back(tm);
            double w = (1.0 - data.slip) * 2.0 * M_PI * m_systemFreq;
            data.velocityVector.emplace_back(w);
            std::complex<double> i1 = std::complex<double>(data.ir, data.im);
            data.currentVector.emplace_back(std::abs(i1));
            int n = static_cast<Bus*>(motor->GetParentList()[0])->GetElectricalData().number;
            std::complex<double> v = n >= 0 ? m_vBus[n] : 0.0;
            data.terminalVoltageVector.emplace_back(std::abs(v));
            std::complex<double> s = v * std::conj(i1);
            data.activePowerVector.emplace_back(std::real(s));
            data.reactivePowerVector.emplace_back(std::imag(s));
            motor->SetElectricalData(data);
        }
    }
    m_iterationsNumVector.emplace_back(m_iterationsNum);
}

SetEvent()

void Electromechanical::SetEvent ( double  currentTime )

protected

Definition at line 209 of file Electromechanical.cpp.

{
    // Fault
    for (auto it = m_busList.begin(), itEnd = m_busList.end(); it != itEnd; ++it) {
        Bus* bus = *it;
        auto data = bus->GetElectricalData();
        int n = data.number;
        if (data.stabHasFault && n >= 0) {
 
            // Insert fault
            if (EventTrigger(data.stabFaultTime, currentTime)) {
                double r, x;
                r = data.stabFaultResistance;
                x = data.stabFaultReactance;
                if (x < 1e-5) x = 1e-5;
                m_yBus[n][n] += std::complex<double>(1.0, 0.0) / std::complex<double>(r, x);
            }
 
            // Remove fault
            else if (EventTrigger(data.stabFaultTime + data.stabFaultLength, currentTime)) {
                double r, x;
                r = data.stabFaultResistance;
                x = data.stabFaultReactance;
                if (x < 1e-5) x = 1e-5;
                m_yBus[n][n] -= std::complex<double>(1.0, 0.0) / std::complex<double>(r, x);
            }
        }
    }
 
    // SyncGenerator switching
    for (auto it = m_syncGeneratorList.begin(), itEnd = m_syncGeneratorList.end(); it != itEnd; ++it) {
        SyncGenerator* generator = *it;
        auto swData = generator->GetSwitchingData();
        for (unsigned int i = 0; i < swData.swType.size(); ++i) {
            if (EventTrigger(swData.swTime[i], currentTime)) {
                // Remove machine (only connected machines)
                if (swData.swType[i] == SwitchingType::SW_REMOVE && generator->IsOnline()) {
                    generator->SetOnline(false);
                    int n = static_cast<Bus*>(generator->GetParentList()[0])->GetElectricalData().number;
                    if (n >= 0) m_yBus[n][n] -= GetSyncMachineAdmittance(generator);
                }
 
                // Insert machine (only disconnected machines)
                if (swData.swType[i] == SwitchingType::SW_INSERT && !generator->IsOnline() && generator->GetParentList().size() == 1) {
                    if (generator->SetOnline(true)) {
                        int n = static_cast<Bus*>(generator->GetParentList()[0])->GetElectricalData().number;
                        if (n >= 0) m_yBus[n][n] += GetSyncMachineAdmittance(generator);
                    }
                }
            }
        }
    }
 
    // Induction motor switching
    for (auto it = m_indMotorList.begin(), itEnd = m_indMotorList.end(); it != itEnd; ++it) {
        IndMotor* motor = *it;
        auto swData = motor->GetSwitchingData();
        for (unsigned int i = 0; i < swData.swType.size(); ++i) {
            if (EventTrigger(swData.swTime[i], currentTime)) {
                // Remove machine (only connected machines)
                if (swData.swType[i] == SwitchingType::SW_REMOVE && motor->IsOnline() && motor->GetParentList().size() == 1) {
                    auto data = motor->GetElectricalData();
                    motor->SetOnline(false);
                    int n = static_cast<Bus*>(motor->GetParentList()[0])->GetElectricalData().number;
                    if (n >= 0) m_yBus[n][n] -= (std::complex<double>(1, 0) / std::complex<double>(data.r1t, data.xt));
                }
 
                // Insert machine (only disconnected machines)
                if (swData.swType[i] == SwitchingType::SW_INSERT && !motor->IsOnline() && motor->GetParentList().size() == 1) {
                    auto data = motor->GetElectricalData();
                    if (motor->SetOnline(true)) {
                        int n = static_cast<Bus*>(motor->GetParentList()[0])->GetElectricalData().number;
                        if (n >= 0) m_yBus[n][n] += (std::complex<double>(1, 0) / std::complex<double>(data.r1t, data.xt));
                    }
                }
            }
        }
    }
 
    // Load switching
    for (auto it = m_loadList.begin(), itEnd = m_loadList.end(); it != itEnd; ++it) {
        Load* load = *it;
        auto swData = load->GetSwitchingData();
        for (unsigned int i = 0; i < swData.swType.size(); ++i) {
            if (EventTrigger(swData.swTime[i], currentTime)) {
                // Remove load (only connected loads)
                if (swData.swType[i] == SwitchingType::SW_REMOVE && load->IsOnline() && load->GetParentList().size() == 1) {
                    load->SetOnline(false);
                    auto data = load->GetPUElectricalData(m_powerSystemBase);
                    Bus* parentBus = static_cast<Bus*>(load->GetParentList()[0]);
                    int n = parentBus->GetElectricalData().number;
                    std::complex<double> v = parentBus->GetElectricalData().voltage;
                    if (n >= 0) {
                        m_yBus[n][n] -=
                            std::complex<double>(data.activePower, -data.reactivePower) / (std::abs(v) * std::abs(v));
                    }
                }
 
                // Insert load (only disconnected load)
                if (swData.swType[i] == SwitchingType::SW_INSERT && !load->IsOnline() && load->GetParentList().size() == 1) {
                    if (load->SetOnline(true)) {
                        auto data = load->GetPUElectricalData(m_powerSystemBase);
                        Bus* parentBus = static_cast<Bus*>(load->GetParentList()[0]);
                        int n = parentBus->GetElectricalData().number;
                        std::complex<double> v = parentBus->GetElectricalData().voltage;
                        if (n >= 0) {
                            m_yBus[n][n] +=
                                std::complex<double>(data.activePower, -data.reactivePower) / (std::abs(v) * std::abs(v));
                        }
                    }
                }
            }
        }
    }
 
    // Line switching
    for (auto it = m_lineList.begin(), itEnd = m_lineList.end(); it != itEnd; ++it) {
        Line* line = *it;
        auto swData = line->GetSwitchingData();
        for (unsigned int i = 0; i < swData.swType.size(); ++i) {
            if (EventTrigger(swData.swTime[i], currentTime)) {
                // Remove line (only connected lines)
                if (swData.swType[i] == SwitchingType::SW_REMOVE && line->IsOnline()) {
                    line->SetOnline(false);
                    auto data = line->GetElectricalData();
 
                    int n1 = static_cast<Bus*>(line->GetParentList()[0])->GetElectricalData().number;
                    int n2 = static_cast<Bus*>(line->GetParentList()[1])->GetElectricalData().number;
                    if (n1 >= 0 && n2 >= 0) {
                        m_yBus[n1][n2] += 1.0 / std::complex<double>(data.resistance, data.indReactance);
                        m_yBus[n2][n1] += 1.0 / std::complex<double>(data.resistance, data.indReactance);
 
                        m_yBus[n1][n1] -= 1.0 / std::complex<double>(data.resistance, data.indReactance);
                        m_yBus[n2][n2] -= 1.0 / std::complex<double>(data.resistance, data.indReactance);
 
                        m_yBus[n1][n1] -= std::complex<double>(0.0, data.capSusceptance / 2.0);
                        m_yBus[n2][n2] -= std::complex<double>(0.0, data.capSusceptance / 2.0);
                    }
                }
 
                // Insert line (only disconnected lines)
                if (swData.swType[i] == SwitchingType::SW_INSERT && !line->IsOnline() && line->GetParentList().size() == 2) {
                    if (line->SetOnline(true)) {
                        auto data = line->GetElectricalData();
 
                        int n1 = static_cast<Bus*>(line->GetParentList()[0])->GetElectricalData().number;
                        int n2 = static_cast<Bus*>(line->GetParentList()[1])->GetElectricalData().number;
                        if (n1 >= 0 && n2 >= 0) {
                            m_yBus[n1][n2] -= 1.0 / std::complex<double>(data.resistance, data.indReactance);
                            m_yBus[n2][n1] -= 1.0 / std::complex<double>(data.resistance, data.indReactance);
 
                            m_yBus[n1][n1] += 1.0 / std::complex<double>(data.resistance, data.indReactance);
                            m_yBus[n2][n2] += 1.0 / std::complex<double>(data.resistance, data.indReactance);
 
                            m_yBus[n1][n1] += std::complex<double>(0.0, data.capSusceptance / 2.0);
                            m_yBus[n2][n2] += std::complex<double>(0.0, data.capSusceptance / 2.0);
                        }
                    }
                }
            }
        }
    }
 
    // Transformer switching
    for (auto it = m_transformerList.begin(), itEnd = m_transformerList.end(); it != itEnd; ++it) {
        Transformer* transformer = *it;
        auto swData = transformer->GetSwitchingData();
        for (unsigned int i = 0; i < swData.swType.size(); ++i) {
            if (EventTrigger(swData.swTime[i], currentTime)) {
                // Remove transformer (only connected transformers)
                if (swData.swType[i] == SwitchingType::SW_REMOVE && transformer->IsOnline()) {
                    transformer->SetOnline(false);
                    auto data = transformer->GetElectricalData();
 
                    int n1 = static_cast<Bus*>(transformer->GetParentList()[0])->GetElectricalData().number;
                    int n2 = static_cast<Bus*>(transformer->GetParentList()[1])->GetElectricalData().number;
                    if (n1 >= 0 && n2 >= 0) {
                        if (data.turnsRatio == 1.0 && data.phaseShift == 0.0) {
                            m_yBus[n1][n2] -= -1.0 / std::complex<double>(data.resistance, data.indReactance);
                            m_yBus[n2][n1] -= -1.0 / std::complex<double>(data.resistance, data.indReactance);
 
                            m_yBus[n1][n1] -= 1.0 / std::complex<double>(data.resistance, data.indReactance);
                            m_yBus[n2][n2] -= 1.0 / std::complex<double>(data.resistance, data.indReactance);
                        }
                        else {
                            // Complex turns ratio
                            double radPhaseShift = wxDegToRad(data.phaseShift);
                            std::complex<double> a = std::complex<double>(data.turnsRatio * std::cos(radPhaseShift),
                                -data.turnsRatio * std::sin(radPhaseShift));
 
                            // Transformer admitance
                            std::complex<double> y = 1.0 / std::complex<double>(data.resistance, data.indReactance);
                            m_yBus[n1][n1] -= y / std::pow(std::abs(a), 2.0);
                            m_yBus[n1][n2] -= -(y / std::conj(a));
                            m_yBus[n2][n1] -= -(y / a);
                            m_yBus[n2][n2] -= y;
                        }
                    }
                }
 
                // Insert transformer (only disconnected transformers)
                if (swData.swType[i] == SwitchingType::SW_INSERT && !transformer->IsOnline() &&
                    transformer->GetParentList().size() == 2) {
                    if (transformer->SetOnline(true)) {
                        auto data = transformer->GetElectricalData();
 
                        int n1 = static_cast<Bus*>(transformer->GetParentList()[0])->GetElectricalData().number;
                        int n2 = static_cast<Bus*>(transformer->GetParentList()[1])->GetElectricalData().number;
                        if (n1 >= 0 && n2 >= 0) {
                            if (data.turnsRatio == 1.0 && data.phaseShift == 0.0) {
                                m_yBus[n1][n2] += -1.0 / std::complex<double>(data.resistance, data.indReactance);
                                m_yBus[n2][n1] += -1.0 / std::complex<double>(data.resistance, data.indReactance);
 
                                m_yBus[n1][n1] += 1.0 / std::complex<double>(data.resistance, data.indReactance);
                                m_yBus[n2][n2] += 1.0 / std::complex<double>(data.resistance, data.indReactance);
                            }
                            else {
                                // Complex turns ratio
                                double radPhaseShift = wxDegToRad(data.phaseShift);
                                std::complex<double> a = std::complex<double>(data.turnsRatio * std::cos(radPhaseShift),
                                    -data.turnsRatio * std::sin(radPhaseShift));
 
                                // Transformer admitance
                                std::complex<double> y = 1.0 / std::complex<double>(data.resistance, data.indReactance);
                                m_yBus[n1][n1] += y / std::pow(std::abs(a), 2.0);
                                m_yBus[n1][n2] += -(y / std::conj(a));
                                m_yBus[n2][n1] += -(y / a);
                                m_yBus[n2][n2] += y;
                            }
                        }
                    }
                }
            }
        }
    }
 
    // Capacitor switching
    for (auto it = m_capacitorList.begin(), itEnd = m_capacitorList.end(); it != itEnd; ++it) {
        Capacitor* capacitor = *it;
        auto swData = capacitor->GetSwitchingData();
        for (unsigned int i = 0; i < swData.swType.size(); ++i) {
            if (EventTrigger(swData.swTime[i], currentTime)) {
                // Remove capacitor (only connected capacitors)
                if (swData.swType[i] == SwitchingType::SW_REMOVE && capacitor->IsOnline()) {
                    capacitor->SetOnline(false);
                    auto data = capacitor->GetPUElectricalData(m_powerSystemBase);
                    int n = static_cast<Bus*>(capacitor->GetParentList()[0])->GetElectricalData().number;
                    if (n >= 0)  m_yBus[n][n] -= std::complex<double>(0.0, data.reactivePower);
                }
 
                // Insert capacitor (only disconnected capacitors)
                if (swData.swType[i] == SwitchingType::SW_INSERT && !capacitor->IsOnline() && capacitor->GetParentList().size() == 1) {
                    if (capacitor->SetOnline(true)) {
                        auto data = capacitor->GetPUElectricalData(m_powerSystemBase);
                        int n = static_cast<Bus*>(capacitor->GetParentList()[0])->GetElectricalData().number;
                        if (n >= 0)  m_yBus[n][n] += std::complex<double>(0.0, data.reactivePower);
                    }
                }
            }
        }
    }
 
    // Inductor switching
    for (auto it = m_inductorList.begin(), itEnd = m_inductorList.end(); it != itEnd; ++it) {
        Inductor* inductor = *it;
        auto swData = inductor->GetSwitchingData();
        for (unsigned int i = 0; i < swData.swType.size(); ++i) {
            if (EventTrigger(swData.swTime[i], currentTime)) {
                // Remove inductor (only connected inductors)
                if (swData.swType[i] == SwitchingType::SW_REMOVE && inductor->IsOnline()) {
                    inductor->SetOnline(false);
                    auto data = inductor->GetPUElectricalData(m_powerSystemBase);
                    int n = static_cast<Bus*>(inductor->GetParentList()[0])->GetElectricalData().number;
                    if (n >= 0) m_yBus[n][n] -= std::complex<double>(0.0, -data.reactivePower);
                }
 
                // Insert inductor (only disconnected inductors)
                if (swData.swType[i] == SwitchingType::SW_INSERT && !inductor->IsOnline() && inductor->GetParentList().size() == 1) {
                    if (inductor->SetOnline(true)) {
                        auto data = inductor->GetPUElectricalData(m_powerSystemBase);
                        int n = static_cast<Bus*>(inductor->GetParentList()[0])->GetElectricalData().number;
                        if (n >= 0) m_yBus[n][n] += std::complex<double>(0.0, -data.reactivePower);
                    }
                }
            }
        }
    }
}

SetEventTimeList()

void Electromechanical::SetEventTimeList ( )

protected

Definition at line 172 of file Electromechanical.cpp.

{
    // Fault
    for (auto it = m_busList.begin(), itEnd = m_busList.end(); it != itEnd; ++it) {
        Bus* bus = *it;
        auto data = bus->GetElectricalData();
        if (data.stabHasFault) {
            m_eventTimeList.emplace_back(data.stabFaultTime);
            m_eventOccurrenceList.push_back(false);
            m_eventTimeList.emplace_back(data.stabFaultTime + data.stabFaultLength);
            m_eventOccurrenceList.push_back(false);
        }
    }
    // Switching
    for (auto it = m_powerElementList.begin(), itEnd = m_powerElementList.end(); it != itEnd; ++it) {
        PowerElement* element = *it;
        SwitchingData swData = element->GetSwitchingData();
        for (unsigned int i = 0; i < swData.swTime.size(); ++i) {
            m_eventTimeList.emplace_back(swData.swTime[i]);
            m_eventOccurrenceList.push_back(false);
        }
    }
}

SetSyncMachinesModel()

void Electromechanical::SetSyncMachinesModel ( )

protected

Definition at line 1405 of file Electromechanical.cpp.

{
    for (auto it = m_syncGeneratorList.begin(), itEnd = m_syncGeneratorList.end(); it != itEnd; ++it) {
        SyncGenerator* syncGenerator = *it;
        auto data = syncGenerator->GetElectricalData();
        data.model = GetMachineModel(syncGenerator);
        syncGenerator->SetElectricalData(data);
    }
}

SolveMachines()

bool Electromechanical::SolveMachines ( )

protected

Definition at line 1174 of file Electromechanical.cpp.

{
    // First interation values and extrapolations
    // Synchronous machines
    for (auto it = m_syncGeneratorList.begin(), itEnd = m_syncGeneratorList.end(); it != itEnd; ++it) {
        SyncGenerator* syncGenerator = *it;
        auto data = syncGenerator->GetElectricalData();
 
        if (syncGenerator->IsOnline()) {
            double id, iq, pe, sd, sq;
            pe = data.pe;
            id = data.id;
            iq = data.iq;
            sd = data.sd;
            sq = data.sq;
 
            double k = 1.0;  // Power base change factor.
            if (data.useMachineBase) {
                double oldBase = syncGenerator->GetValueFromUnit(data.nominalPower, data.nominalPowerUnit);
                k = m_powerSystemBase / oldBase;
            }
 
            // Calculate integration constants.
            CalculateIntegrationConstants(syncGenerator, id, iq, k);
 
            if (!CalculateNonIntVariables(syncGenerator, id, iq, sd, sq, pe, k)) return false;
            // Extrapolate nonintegrable variables.
            id = 2.0 * id - data.oldId;
            iq = 2.0 * iq - data.oldIq;
            pe = 2.0 * pe - data.oldPe;
            sd = 2.0 * sd - data.oldSd;
            sq = 2.0 * sq - data.oldSq;
 
            CalculateIntVariables(syncGenerator, id, iq, sd, sq, pe, k);
        }
        else {
            CalculateIntegrationConstants(syncGenerator, 0.0f, 0.0f);
        }
    }
    // Induction machines
    for (auto it = m_indMotorList.begin(), itEnd = m_indMotorList.end(); it != itEnd; ++it) {
        IndMotor* indMotor = *it;
        auto data = indMotor->GetElectricalData();
 
        //if(indMotor->IsOnline()) {
        double ir, im, te;
        te = data.te;
        ir = data.ir;
        im = data.im;
 
        double k = 1.0;  // Power base change factor.
        if (data.useMachinePowerAsBase) {
            double oldBase = indMotor->GetValueFromUnit(data.ratedPower, data.ratedPowerUnit);
            k = m_powerSystemBase / oldBase;
        }
 
        // Calculate integration constants.
        CalculateIntegrationConstants(indMotor, ir, im, k);
 
        if (!CalculateNonIntVariables(indMotor, ir, im, te, k)) return false;
        // Extrapolate nonintegrable variables.
        ir = 2.0 * ir - data.oldIr;
        im = 2.0 * im - data.oldIm;
        te = 2.0 * te - data.oldTe;
 
        CalculateIntVariables(indMotor, ir, im, te, k);
        //} else {
            //CalculateIntegrationConstants(indMotor, 0.0f, 0.0f);
        //}
    }
 
    double error = 1.0;
    int iterations = 0;
    while (error > m_tolerance) {
        error = 0.0;
 
        // Calculate the injected currents.
        if (!CalculateInjectedCurrents()) return false;
 
        // Calculate the buses voltages.
        m_vBus = LUEvaluate(m_yBusU, m_yBusL, m_iBus);
 
        // Solve synchronous machine equations.
        for (auto it = m_syncGeneratorList.begin(), itEnd = m_syncGeneratorList.end(); it != itEnd; ++it) {
            SyncGenerator* syncGenerator = *it;
 
            auto data = syncGenerator->GetElectricalData();
 
            double id = data.id;
            double iq = data.iq;
            double pe = data.pe;
            double sd = data.sd;
            double sq = data.sq;
 
            // Power base change factor.
            double k = 1.0;
            if (data.useMachineBase) {
                double oldBase = syncGenerator->GetValueFromUnit(data.nominalPower, data.nominalPowerUnit);
                k = m_powerSystemBase / oldBase;
            }
 
            // Calculate id, iq, dq, sd
            if (!CalculateNonIntVariables(syncGenerator, id, iq, sd, sq, pe, k)) return false;
 
            double genError = CalculateIntVariables(syncGenerator, id, iq, sd, sq, pe, k);
 
            if (genError > error) error = genError;
        }
 
        // Solve induction machine equation
        for (auto it = m_indMotorList.begin(), itEnd = m_indMotorList.end(); it != itEnd; ++it) {
            IndMotor* indMotor = *it;
 
            auto data = indMotor->GetElectricalData();
 
            double ir = data.ir;
            double im = data.im;
            double te = data.te;
 
            // Power base change factor.
            double k = 1.0;
            if (data.useMachinePowerAsBase) {
                double oldBase = indMotor->GetValueFromUnit(data.ratedPower, data.ratedPowerUnit);
                k = m_powerSystemBase / oldBase;
            }
 
            // Calculate te
            if (!CalculateNonIntVariables(indMotor, ir, im, te, k)) return false;
 
            double motorError = CalculateIntVariables(indMotor, ir, im, te, k);
 
            if (motorError > error) error = motorError;
        }
 
        ++iterations;
 
        if (iterations > m_maxIterations) {
            m_errorMsg = _("Impossible to solve the system machines.\nCheck the system parameters and/or "
                "decrease the time step.");
            return false;
        }
    }
    m_iterationsNum = iterations;
 
    // Solve controllers.
    int ctrlRatio = static_cast<int>(1 / m_ctrlTimeStepMultiplier);
    for (auto it = m_syncGeneratorList.begin(), itEnd = m_syncGeneratorList.end(); it != itEnd; ++it) {
        SyncGenerator* syncGenerator = *it;
        auto data = syncGenerator->GetElectricalData();
        if (data.useAVR && data.avrSolver) {
            data.avrSolver->SetSwitchStatus(syncGenerator->IsOnline());
            data.avrSolver->SetCurrentTime(m_currentTime);
            data.avrSolver->SetTerminalVoltage(std::abs(data.terminalVoltage));
            data.avrSolver->SetDeltaActivePower((data.electricalPower.real() - data.avrSolver->GetActivePower()) /
                m_timeStep);
            data.avrSolver->SetActivePower(data.electricalPower.real());
            data.avrSolver->SetReactivePower(data.electricalPower.imag());
            data.avrSolver->SetDeltaVelocity((data.speed - data.avrSolver->GetVelocity()) / m_timeStep);
            data.avrSolver->SetVelocity(data.speed);
 
            for (int i = 0; i < ctrlRatio; ++i) data.avrSolver->SolveNextStep();
 
            data.fieldVoltage = data.initialFieldVoltage + data.avrSolver->GetFieldVoltage();
        }
 
        if (data.useSpeedGovernor && data.speedGovSolver) {
            data.speedGovSolver->SetSwitchStatus(syncGenerator->IsOnline());
            data.speedGovSolver->SetCurrentTime(m_currentTime);
            data.speedGovSolver->SetVelocity(data.speed);
            data.speedGovSolver->SetActivePower(data.electricalPower.real());
            data.speedGovSolver->SetReactivePower(data.electricalPower.imag());
 
            for (int i = 0; i < ctrlRatio; ++i) data.speedGovSolver->SolveNextStep();
 
            data.pm = data.speedGovSolver->GetMechanicalPower();
        }
        syncGenerator->SetElectricalData(data);
    }
 
    return true;
}

Member Data Documentation

m_ctrlTimeStepMultiplier

double Electromechanical::m_ctrlTimeStepMultiplier = 0.1

protected

Definition at line 134 of file Electromechanical.h.

m_currentPoint

int Electromechanical::m_currentPoint = 0

protected

Definition at line 139 of file Electromechanical.h.

m_currentTime

double Electromechanical::m_currentTime = 0.0

protected

Definition at line 131 of file Electromechanical.h.

m_debugMessage

wxString Electromechanical::m_debugMessage = ""

protected

Definition at line 149 of file Electromechanical.h.

m_errorMsg

wxString Electromechanical::m_errorMsg = _("Unknown error")

protected

Definition at line 115 of file Electromechanical.h.

m_eventOccurrenceList

std::vector<bool> Electromechanical::m_eventOccurrenceList

protected

Definition at line 142 of file Electromechanical.h.

m_eventTimeList

std::vector<double> Electromechanical::m_eventTimeList

protected

Definition at line 141 of file Electromechanical.h.

m_iBus

std::vector<std::complex<double> > Electromechanical::m_iBus

protected

Definition at line 127 of file Electromechanical.h.

m_iterationsNum

int Electromechanical::m_iterationsNum = 0.0

protected

Definition at line 147 of file Electromechanical.h.

m_iterationsNumVector

std::vector<double> Electromechanical::m_iterationsNumVector

protected

Definition at line 148 of file Electromechanical.h.

m_maxIterations

int Electromechanical::m_maxIterations = 100

protected

Definition at line 136 of file Electromechanical.h.

m_parent

wxWindow* Electromechanical::m_parent = nullptr

protected

Definition at line 114 of file Electromechanical.h.

m_plotTime

double Electromechanical::m_plotTime = 1e-2

protected

Definition at line 132 of file Electromechanical.h.

m_powerSystemBase

double Electromechanical::m_powerSystemBase = 100e6

protected

Definition at line 129 of file Electromechanical.h.

m_refSpeed

double Electromechanical::m_refSpeed = 2.0 * M_PI * 60.0

protected

Definition at line 119 of file Electromechanical.h.

m_saturationTolerance

double Electromechanical::m_saturationTolerance = 1e-8

protected

Definition at line 137 of file Electromechanical.h.

m_simData

SimulationData Electromechanical::m_simData

protected

Definition at line 116 of file Electromechanical.h.

m_simTime

double Electromechanical::m_simTime = 10.0

protected

Definition at line 130 of file Electromechanical.h.

m_systemFreq

double Electromechanical::m_systemFreq = 60.0

protected

Definition at line 118 of file Electromechanical.h.

m_timeStep

double Electromechanical::m_timeStep = 1e-2

protected

Definition at line 133 of file Electromechanical.h.

m_timeVector

std::vector<double> Electromechanical::m_timeVector

protected

Definition at line 144 of file Electromechanical.h.

m_tolerance

double Electromechanical::m_tolerance = 1e-8

protected

Definition at line 135 of file Electromechanical.h.

m_useCOI

bool Electromechanical::m_useCOI = false

protected

Definition at line 120 of file Electromechanical.h.

m_vBus

std::vector<std::complex<double> > Electromechanical::m_vBus

protected

Definition at line 126 of file Electromechanical.h.

m_yBus

std::vector<std::vector<std::complex<double> > > Electromechanical::m_yBus

protected

Definition at line 122 of file Electromechanical.h.

m_yBusL

std::vector<std::vector<std::complex<double> > > Electromechanical::m_yBusL

protected

Definition at line 124 of file Electromechanical.h.

m_yBusU

std::vector<std::vector<std::complex<double> > > Electromechanical::m_yBusU

protected

Definition at line 123 of file Electromechanical.h.

---

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

• Project/simulation/Electromechanical.h
• Project/simulation/Electromechanical.cpp