Synchronous generator power element. More...

#include <SyncGenerator.h>

Inheritance diagram for SyncGenerator:

[legend]

Collaboration diagram for SyncGenerator:

[legend]

Public Member Functions
	SyncGenerator (wxString name)

virtual Element *	GetCopy ()
	Get a the element copy.

virtual void	Init ()

virtual void	DrawDCSymbol (wxGraphicsContext *gc) const

virtual void	DrawDCSymbol (wxDC &dc) const

virtual bool	GetContextMenu (wxMenu &menu)
	Get the element contex menu.

virtual bool	ShowForm (wxWindow parent, Element element, wxWindow *workspace=nullptr)
	Show element data form.

virtual wxString	GetTipText () const
	Get the tip text.

virtual SyncGeneratorElectricalData	GetElectricalData ()

virtual SyncGeneratorElectricalData &	GetElectricalDataRef ()

virtual SyncGeneratorElectricalData	GetPUElectricalData (double systemPowerBase)

virtual void	SetElectricalData (SyncGeneratorElectricalData electricalData)

virtual void	SetNominalVoltage (std::vector< double > nominalVoltage, std::vector< ElectricalUnit > nominalVoltageUnit)
	Set nominal voltage of the element.

virtual void	SavePlotData ()

virtual bool	GetPlotData (ElementPlotData &plotData, PlotStudy study=PlotStudy::STABILITY)
	Fill the plot data.

virtual rapidxml::xml_node *	SaveElement (rapidxml::xml_document<> &doc, rapidxml::xml_node<> *elementListNode)

virtual bool	OpenElement (rapidxml::xml_node<> elementNode, std::vector< Element > parentList)

Public Member Functions inherited from Machines
virtual bool	AddParent (Element *parent, wxPoint2DDouble position)
	Add a parent to the element. This method must be used on power elements that connect to a bus, so the parent must be a bus. The element basic points are calculated in this method, so apply this when the element is being inserted.

virtual bool	Contains (wxPoint2DDouble position) const
	Checks if the element contains a position.

virtual void	DrawDC (wxPoint2DDouble translation, double scale, wxGraphicsContext *gc) const
	Draw the element using GDI+.

virtual void	DrawDC (wxPoint2DDouble translation, double scale, wxDC &dc) const
	Draw the element using wxDC.

virtual bool	Intersects (wxRect2DDouble rect) const
	Check if the element's rect intersects other rect.

virtual void	Move (wxPoint2DDouble position)
	Move the element other position.

virtual void	MoveNode (Element *element, wxPoint2DDouble position)
	Move a node. StartMove(wxPoint2DDouble position) before start moving.

virtual void	StartMove (wxPoint2DDouble position)
	Update the element attributes related to the movement.

virtual void	RotateNode (Element *parent, bool clockwise=true)
	Rotate a node.

virtual void	RemoveParent (Element *parent)
	Remove a parent.

virtual bool	NodeContains (wxPoint2DDouble position)
	Check if a node contains a point. If contains, set the attributes related to node movement.

virtual bool	SetNodeParent (Element *parent)
	Set a perent to the node. If all conditions are met, a new parent are added to the element and the points related to the nodes will be calculated.

virtual void	UpdateNodes ()
	Update the nodes according to the parents. If a parent is removed, use this method.

virtual void	Rotate (bool clockwise=true)
	Rotate the element.

virtual void	SetPowerFlowDirection (PowerFlowDirection pfDirection)
	Set the direction of the power flow.

Public Member Functions inherited from PowerElement
	PowerElement ()
	Constructor.

virtual	~PowerElement ()
	Destructor.

virtual wxPoint2DDouble	GetSwitchPoint (Element *parent, wxPoint2DDouble parentPoint, wxPoint2DDouble secondPoint) const
	Get the correct switch position.

virtual bool	SwitchesContains (wxPoint2DDouble position) const
	Check if switch contains position.

virtual void	UpdateSwitches ()
	Update the switch position.

virtual void	DrawDCSwitches (wxGraphicsContext *gc) const
	Draw switch.

virtual void	DrawDCSwitches (wxDC &dc) const

virtual void	CalculatePowerFlowPts (std::vector< wxPoint2DDouble > edges)
	Calculate the points of the power flow arrows.

virtual void	DrawDCPowerFlowPts (wxGraphicsContext *gc) const
	Draw power flow arrows.

virtual void	DrawDCPowerFlowPts (wxDC &dc) const

virtual void	SetSwitchingData (SwitchingData data)
	Set the switching data of the element.

virtual SwitchingData	GetSwitchingData ()
	Returns the switching data of the element.

virtual PowerFlowDirection	GetPowerFlowDirection () const
	Return the direction of the power flow.

virtual bool	HaveDynamicEvent () const
	Check if the power element have dynamic event.

virtual void	SetDynamicEvent (bool dynEvent=true)
	Set if the power element have dynamic event.

virtual double	GetValueFromUnit (double value, ElectricalUnit valueUnit)

virtual void	SaveCADProperties (rapidxml::xml_document<> &doc, rapidxml::xml_node<> *elementNode)

virtual void	SaveSwitchingData (rapidxml::xml_document<> &doc, rapidxml::xml_node<> *electricalNode)

virtual bool	OpenCADProperties (rapidxml::xml_node<> elementNode, std::vector< Element > parentList)

virtual bool	OpenSwitchingData (rapidxml::xml_node<> *electricalNode)

Public Member Functions inherited from Element
	Element ()
	Constructor.

virtual	~Element ()
	Destructor.

void	SetDragging (bool dragging=true)
	Set if the element are being dragged.

void	SetHeight (double height)
	Set element height.

void	SetPosition (const wxPoint2DDouble position)
	Set the element position and update the rectangle.

void	SetSelected (bool selected=true)
	Set element selection.

void	SetWidth (double width)
	Set element width.

void	SetAngle (double angle)
	Set element angle.

void	ShowPickbox (bool showPickbox=true)
	Set if the pickbox is shown.

void	SetBorderSize (double borderSize)
	Set the size of the border (shown in selected elements).

bool	SetOnline (bool online=true)
	Set if the element is online or offline.

virtual void	SetPointList (std::vector< wxPoint2DDouble > pointList)
	Set the list of points that connect the element to the bus.

ElementType	GetElementType ()

wxRect2DDouble	GetRect () const
	Get the element rectangle.

wxPoint2DDouble	GetPosition () const
	Get the element position.

bool	IsDragging () const
	Checks if the element is being dragged.

double	GetHeight () const
	Get the element height.

bool	IsSelected () const
	Checks if the element is selected.

double	GetWidth () const
	Get the element width.

double	GetAngle () const
	Get the element angle.

double	GetRotationAngle () const
	Get the angle of rotation.

bool	IsPickboxShown () const
	Checks if the pickbox is shown.

bool	IsOnline () const
	Checks if the element is online or offline.

virtual std::vector< wxPoint2DDouble >	GetPointList () const
	Get the list of points that connect the element to bus.

virtual void	AddParent (Element *parent)
	Add a parent to the element.

virtual void	SetID (int id)
	Set the element ID.

virtual int	GetID () const
	Get the element ID.

virtual void	AddChild (Element *child)
	Add a child to the child list.

virtual void	RemoveChild (Element *child)
	Remove a child from the list.

virtual void	ReplaceChild (Element oldChild, Element newChild)
	Replace a child from the list.

virtual void	AddPoint (wxPoint2DDouble point)
	Add point to the list of points that connect the element to the bus.

void	SetParent (Element *parent, int num)

void	SetChild (Element *child, int num)

virtual void	ReplaceParent (Element oldParent, Element newParent)
	Replace a parent.

virtual bool	PickboxContains (wxPoint2DDouble position)
	Check if a pickbox contains a point. If contains the attributes related to pickbox movement will be calculated.

virtual void	MovePickbox (wxPoint2DDouble position)
	Move the pickbox.

virtual wxCursor	GetBestPickboxCursor () const
	Get the best cursor to shown to the user when the mouse is above a pickbox.

virtual void	ResetPickboxes ()
	Remove the pickboxes.

virtual void	ResetNodes ()
	Remove the active nodes.

virtual wxPoint2DDouble	WorldToScreen (wxPoint2DDouble translation, double scale, double offsetX=0.0, double offsetY=0.0) const
	Convert the element position to screen position.

virtual wxPoint2DDouble	WorldToScreen (wxPoint2DDouble position, wxPoint2DDouble translation, double scale, double offsetX=0.0, double offsetY=0.0) const
	Convert a generic position to screen position.

virtual bool	RotatedRectanglesIntersects (wxRect2DDouble rect1, wxRect2DDouble rect2, double angle1, double angle2) const
	Check if two roteted rectangles intersect.

virtual void	DrawDCRectangle (wxPoint2DDouble position, double width, double height, double angle, wxDC &dc) const
	Draw a circle.

virtual void	DrawDCRoundedRectRotated (wxDC &dc, const wxPoint2DDouble &center, double width, double height, double radius, double angleDeg, int arcSegments=8) const

virtual void	DrawDCCircle (wxPoint2DDouble position, double radius, int numSegments, wxGraphicsContext *gc) const
	Draw a circle using device context.

virtual void	DrawDCCircle (wxPoint2DDouble position, double radius, wxDC &dc) const

virtual void	DrawDCArc (wxPoint2DDouble position, double radius, double initAngle, double finalAngle, int numSegments, wxGraphicsContext *gc) const

virtual void	DrawDCArc (wxPoint2DDouble position, double radius, double initAngle, double finalAngle, wxDC &dc) const

virtual void	DrawDCTriangle (std::vector< wxPoint2DDouble > points, wxGraphicsContext *gc) const
	Draw rectangle.

virtual void	DrawDCTriangle (std::vector< wxPoint > points, wxDC &dc) const

virtual void	DrawDCPickbox (wxPoint2DDouble position, wxGraphicsContext *gc) const
	Draw a point.

virtual wxPoint2DDouble	RotateAtPosition (wxPoint2DDouble pointToRotate, double angle, bool degrees=true) const
	Rotate a point as element position being the origin.

virtual wxPoint2DDouble	RotateLocal (wxPoint2DDouble local, double angleDeg) const

virtual wxPoint	RotateAround (const wxPoint2DDouble &p, const wxPoint2DDouble &center, double angleDeg) const

virtual std::vector< Element * >	GetParentList () const
	Get the parent list.

virtual std::vector< Element * >	GetChildList () const
	Get the Child list.

virtual void	CalculateBoundaries (wxPoint2DDouble &leftUp, wxPoint2DDouble &rightBottom) const
	Calculate the element boundaries.

virtual void	GeneralMenuItens (wxMenu &menu)
	Insert general itens to context menu.

virtual double	PointToLineDistance (wxPoint2DDouble point, int *segmentNumber=nullptr) const
	Calculate the distance between a line (formed by point list) and a point.

bool	IsInserted () const
	Check if the element is properly inserted in the workspace.

void	SetInserted (bool inserted=true)
	Set if the element is properly inserted in the workspace.

virtual bool	OpenElement (rapidxml::xml_node<> *elementNode)

void	SaveCADProperties (rapidxml::xml_document<> &doc, rapidxml::xml_node<> *elementNode)

bool	OpenCADProperties (rapidxml::xml_node<> *elementNode)

Protected Attributes
std::vector< wxPoint2DDouble >	m_sinePts

SyncGeneratorElectricalData	m_electricalData

Protected Attributes inherited from PowerElement
SwitchingData	m_swData

std::vector< std::vector< wxPoint2DDouble > >	m_powerFlowArrow

PowerFlowDirection	m_pfDirection = PowerFlowDirection::PF_NONE

wxColour	m_busColour

wxColour	m_onlineElementColour

wxColour	m_offlineElementColour

wxColour	m_closedSwitchColour

wxColour	m_openedSwitchColour

wxColour	m_powerFlowArrowColour

wxColour	m_dynamicEventColour

bool	m_dynEvent = false

Protected Attributes inherited from Element
ElementType	m_elementType = ElementType::TYPE_NONE

int	m_elementID = 0

std::vector< Element * >	m_parentList

std::vector< Element * >	m_childList

wxRect2DDouble	m_rect

wxPoint2DDouble	m_position

double	m_width = 0.0

double	m_height = 0.0

double	m_angle = 0.0

double	m_borderSize = 2.0

double	m_rotationAngle = 45.0

double	m_switchSize = 10.0

std::vector< wxRect2DDouble >	m_switchRect

bool	m_selected = false

bool	m_dragging = false

bool	m_showPickbox = false

bool	m_inserted = false

int	m_activePickboxID = ID_PB_NONE

int	m_activeNodeID = 0

std::vector< wxPoint2DDouble >	m_pointList

std::vector< wxPoint2DDouble >	m_movePts

wxPoint2DDouble	m_moveStartPt

wxPoint2DDouble	m_movePos

bool	m_online = true

wxColour	m_selectionColour

Additional Inherited Members
Public Types inherited from Machines
enum	SyncMachineModel { SM_MODEL_1 = 0 , SM_MODEL_2 , SM_MODEL_3 , SM_MODEL_4 , SM_MODEL_5 }

Static Public Member Functions inherited from Element
static bool	DoubleFromString (wxWindow *parent, wxString strValue, double &value, wxString errorMsg)
	Get a double value from a string. Show a error message if the conversion fail.

static bool	IntFromString (wxWindow *parent, wxString strValue, int &value, wxString errorMsg)
	Convert a string to int. Show a error message if the conversion fail.

static wxString	StringFromDouble (double value, int minDecimal=1, int maxDecimals=13)
	Convert a double value to string.

Protected Member Functions inherited from Machines
void	UpdateSwitchesPosition ()

void	UpdatePowerFlowArrowsPosition ()

Detailed Description

Synchronous generator power element.

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

Date: 06/10/2017

Definition at line 145 of file SyncGenerator.h.

Constructor & Destructor Documentation

◆ SyncGenerator() [1/2]

SyncGenerator::SyncGenerator ( )

Definition at line 32 of file SyncGenerator.cpp.

                             : Machines() {
    m_elementType = TYPE_SYNC_GENERATOR;
    Init();
}

◆ SyncGenerator() [2/2]

SyncGenerator::SyncGenerator ( wxString name )

Definition at line 36 of file SyncGenerator.cpp.

                                          : Machines()
{
    m_elementType = TYPE_SYNC_GENERATOR;
    Init();
    m_electricalData.name = name;
}

◆ ~SyncGenerator()

SyncGenerator::~SyncGenerator ( )

virtual

Definition at line 43 of file SyncGenerator.cpp.

{
    if (m_electricalData.avr) delete m_electricalData.avr;
    if (m_electricalData.speedGov) delete m_electricalData.speedGov;
    //if (m_electricalData.avrSolver) delete m_electricalData.avrSolver;
    //if (m_electricalData.speedGovSolver) delete m_electricalData.speedGovSolver;
}

Member Function Documentation

◆ DrawDCSymbol() [1/2]

void SyncGenerator::DrawDCSymbol ( wxDC & dc ) const

virtual

Reimplemented from Machines.

Definition at line 84 of file SyncGenerator.cpp.

{
    std::vector<wxPoint> sinePts;
    wxPoint pos = wxPoint(wxRound(m_position.m_x), wxRound(m_position.m_y));
    for (unsigned int i = 0; i < m_sinePts.size(); i++) { sinePts.push_back(wxPoint(wxRound(m_sinePts[i].m_x), wxRound(m_sinePts[i].m_y)) + pos); }
    dc.DrawLines(sinePts.size(), &sinePts[0]);
}

◆ DrawDCSymbol() [2/2]

void SyncGenerator::DrawDCSymbol ( wxGraphicsContext * gc ) const

virtual

Reimplemented from Machines.

Definition at line 76 of file SyncGenerator.cpp.

{
    // Draw sine.
    std::vector<wxPoint2DDouble> sinePts;
    for (unsigned int i = 0; i < m_sinePts.size(); i++) { sinePts.push_back(m_sinePts[i] + m_position); }
    gc->StrokeLines(sinePts.size(), &sinePts[0]);
}

◆ GetContextMenu()

bool SyncGenerator::GetContextMenu ( wxMenu & menu )

virtual

Get the element contex menu.

Parameters

menu	menu that will be inserted the element itens.

Returns: True if was possible to build the menu, false otherwise.

Reimplemented from Element.

Definition at line 92 of file SyncGenerator.cpp.

{
    menu.Append(ID_EDIT_ELEMENT, _("Edit Generator"));
 
    wxMenu* textMenu = new wxMenu();
 
    textMenu->Append(ID_TXT_NAME, _("Name"));
    textMenu->Append(ID_TXT_ACTIVE_POWER, _("Active power"));
    textMenu->Append(ID_TXT_REACTIVE_POWER, _("Reactive power"));
    textMenu->Append(ID_TXT_FAULTCURRENT, _("Fault current"));
    textMenu->SetClientData(menu.GetClientData());
    menu.AppendSubMenu(textMenu, _("Add text"));
 
    GeneralMenuItens(menu);
    return true;
}

Here is the call graph for this function:

◆ GetCopy()

Element * SyncGenerator::GetCopy ( )

virtual

Get a the element copy.

Returns: Copy of the element.

Reimplemented from Element.

Definition at line 249 of file SyncGenerator.cpp.

{
    auto copy = new SyncGenerator(*this);
 
    auto data = copy->GetElectricalData();
    data.avrSolver.reset();
    data.speedGovSolver.reset();
 
    // AVR
    if (m_electricalData.avr)
    {
        std::vector<std::shared_ptr<ConnectionLine>> cLineList;
        std::vector<std::shared_ptr<ControlElement>> elementList;
 
        m_electricalData.avr->GetContainerCopy(elementList, cLineList);
 
        auto avrCopy = new ControlElementContainer();
        avrCopy->FillContainer(elementList, cLineList);
 
        data.avr = avrCopy;
    }
    else
        data.avr = nullptr;
 
 
    // Speed governor
    if (m_electricalData.speedGov)
    {
        std::vector<std::shared_ptr<ConnectionLine>> cLineList;
        std::vector<std::shared_ptr<ControlElement>> elementList;
 
        m_electricalData.speedGov->GetContainerCopy(elementList, cLineList);
 
        auto speedGovCopy = new ControlElementContainer();
        speedGovCopy->FillContainer(elementList, cLineList);
 
        data.speedGov = speedGovCopy;
    }
    else
        data.speedGov = nullptr;
 
    copy->SetElectricalData(data);
 
    return copy;
}

◆ GetElectricalData()

virtual SyncGeneratorElectricalData SyncGenerator::GetElectricalData ( )

inlinevirtual

Definition at line 160 of file SyncGenerator.h.

160{ return m_electricalData; }

◆ GetElectricalDataRef()

virtual SyncGeneratorElectricalData & SyncGenerator::GetElectricalDataRef ( )

inlinevirtual

Definition at line 161 of file SyncGenerator.h.

161{ return m_electricalData; }

◆ GetPlotData()

bool SyncGenerator::GetPlotData	(	ElementPlotData &	plotData,
		PlotStudy	study = `PlotStudy::STABILITY`
	)

virtual

Fill the plot data.

Parameters

plotData Plot data to be filled.

Returns: true if the plot data was successfully filled, false otherwise.

Reimplemented from PowerElement.

Definition at line 341 of file SyncGenerator.cpp.

{
    if (study == PlotStudy::STABILITY) {
        if (!m_electricalData.plotSyncMachine) return false;
        plotData.SetName(m_electricalData.name);
        plotData.SetCurveType(ElementPlotData::CurveType::CT_SYNC_GENERATOR);
 
        std::vector<double> absTerminalVoltage, activePower, reactivePower;
        for (unsigned int i = 0; i < m_electricalData.terminalVoltageVector.size(); ++i) {
            activePower.push_back(std::real(m_electricalData.electricalPowerVector[i]));
            reactivePower.push_back(std::imag(m_electricalData.electricalPowerVector[i]));
        }
        plotData.AddData(m_electricalData.terminalVoltageVector, _("Terminal voltage"));
        plotData.AddData(activePower, _("Active power"));
        plotData.AddData(reactivePower, _("Reactive power"));
        plotData.AddData(m_electricalData.mechanicalPowerVector, _("Mechanical power"));
        plotData.AddData(m_electricalData.freqVector, _("Frequency"));
        plotData.AddData(m_electricalData.fieldVoltageVector, _("Field voltage"));
        plotData.AddData(m_electricalData.deltaVector, _("Delta"));
        return true;
    }
    return false;
}

◆ GetPUElectricalData()

SyncGeneratorElectricalData SyncGenerator::GetPUElectricalData ( double systemPowerBase )

virtual

Definition at line 123 of file SyncGenerator.cpp.

{
    SyncGeneratorElectricalData data;
 
    data.name = m_electricalData.name;
 
    data.nominalPower = m_electricalData.nominalPower;
    data.nominalPowerUnit = m_electricalData.nominalPowerUnit;
 
    data.nominalVoltage = m_electricalData.nominalVoltage;
    data.nominalVoltageUnit = m_electricalData.nominalVoltageUnit;
 
    data.activePower = m_electricalData.activePower;
    data.activePowerUnit = m_electricalData.activePowerUnit;
 
    data.reactivePower = m_electricalData.reactivePower;
    data.reactivePowerUnit = m_electricalData.reactivePowerUnit;
 
    data.haveMaxReactive = m_electricalData.haveMaxReactive;
    data.maxReactive = m_electricalData.maxReactive;
    data.maxReactiveUnit = m_electricalData.maxReactiveUnit;
 
    data.haveMinReactive = m_electricalData.haveMinReactive;
    data.minReactive = m_electricalData.minReactive;
    data.minReactiveUnit = m_electricalData.minReactiveUnit;
 
    data.useMachineBase = m_electricalData.useMachineBase;
 
    data.positiveResistance = m_electricalData.positiveResistance;
    data.positiveReactance = m_electricalData.positiveReactance;
 
    data.negativeResistance = m_electricalData.negativeResistance;
    data.negativeReactance = m_electricalData.negativeReactance;
 
    data.zeroResistance = m_electricalData.zeroResistance;
    data.zeroReactance = m_electricalData.zeroReactance;
 
    data.groundResistance = m_electricalData.groundResistance;
    data.groundReactance = m_electricalData.groundReactance;
 
    data.groundNeutral = m_electricalData.groundNeutral;
 
    data.faultCurrent[0] = m_electricalData.faultCurrent[0];
    data.faultCurrent[1] = m_electricalData.faultCurrent[1];
    data.faultCurrent[2] = m_electricalData.faultCurrent[2];
 
 
    double machineBasePower = 1.0;
    if (data.useMachineBase) { machineBasePower = GetValueFromUnit(data.nominalPower, data.nominalPowerUnit); }
 
    // Active power
    double activePower = GetValueFromUnit(data.activePower, data.activePowerUnit);
    if (!m_online) activePower = 0.0;
    if (data.activePowerUnit == ElectricalUnit::UNIT_PU) {
        if (data.useMachineBase) data.activePower = (activePower * machineBasePower) / systemPowerBase;
    }
    else {
        data.activePower = activePower / systemPowerBase;
    }
    data.activePowerUnit = ElectricalUnit::UNIT_PU;
 
    // Reactive power
    double reactivePower = GetValueFromUnit(data.reactivePower, data.reactivePowerUnit);
    if (!m_online) reactivePower = 0.0;
    if (data.reactivePowerUnit == ElectricalUnit::UNIT_PU) {
        if (data.useMachineBase) data.reactivePower = (reactivePower * machineBasePower) / systemPowerBase;
    }
    else {
        data.reactivePower = reactivePower / systemPowerBase;
    }
    data.reactivePowerUnit = ElectricalUnit::UNIT_PU;
 
    // Max reactive power
    double maxReactive = GetValueFromUnit(data.maxReactive, data.maxReactiveUnit);
    if (data.maxReactiveUnit == ElectricalUnit::UNIT_PU) {
        if (data.useMachineBase) data.maxReactive = (maxReactive * machineBasePower) / systemPowerBase;
    }
    else {
        data.maxReactive = maxReactive / systemPowerBase;
    }
    data.maxReactiveUnit = ElectricalUnit::UNIT_PU;
 
    // Min reactive power
    double minReactive = GetValueFromUnit(data.minReactive, data.minReactiveUnit);
    if (data.minReactiveUnit == ElectricalUnit::UNIT_PU) {
        if (data.useMachineBase) data.minReactive = (minReactive * machineBasePower) / systemPowerBase;
    }
    else {
        data.minReactive = minReactive / systemPowerBase;
    }
    data.minReactiveUnit = ElectricalUnit::UNIT_PU;
 
    double baseVoltage = GetValueFromUnit(data.nominalVoltage, data.nominalVoltageUnit);
    double systemBaseImpedance = (baseVoltage * baseVoltage) / systemPowerBase;
    double machineBaseImpedance = (baseVoltage * baseVoltage) / machineBasePower;
 
    // Fault data
    if (data.useMachineBase) {
        data.positiveResistance = (data.positiveResistance * machineBaseImpedance) / systemBaseImpedance;
        data.positiveReactance = (data.positiveReactance * machineBaseImpedance) / systemBaseImpedance;
        data.negativeResistance = (data.negativeResistance * machineBaseImpedance) / systemBaseImpedance;
        data.negativeReactance = (data.negativeReactance * machineBaseImpedance) / systemBaseImpedance;
        data.zeroResistance = (data.zeroResistance * machineBaseImpedance) / systemBaseImpedance;
        data.zeroReactance = (data.zeroReactance * machineBaseImpedance) / systemBaseImpedance;
        data.groundResistance = (data.groundResistance * machineBaseImpedance) / systemBaseImpedance;
        data.groundReactance = (data.groundReactance * machineBaseImpedance) / systemBaseImpedance;
    }
 
    if (!m_online) {
        data.faultCurrent[0] = std::complex<double>(0, 0);
        data.faultCurrent[1] = std::complex<double>(0, 0);
        data.faultCurrent[2] = std::complex<double>(0, 0);
    }
 
    return data;
}

◆ GetTipText()

wxString SyncGenerator::GetTipText ( ) const

virtual

Get the tip text.

Returns: Tip text.

Reimplemented from Element.

Definition at line 295 of file SyncGenerator.cpp.

{
    wxString tipText = m_electricalData.name;
    tipText += "\n";
    double activePower = m_electricalData.activePower;
    if (!m_online) activePower = 0.0;
    tipText += _("\nP = ") + wxString::FromDouble(activePower, 5);
    switch (m_electricalData.activePowerUnit) {
    case ElectricalUnit::UNIT_PU: {
        tipText += _(" p.u.");
    } break;
    case ElectricalUnit::UNIT_W: {
        tipText += _(" W");
    } break;
    case ElectricalUnit::UNIT_kW: {
        tipText += _(" kW");
    } break;
    case ElectricalUnit::UNIT_MW: {
        tipText += _(" MW");
    } break;
    default:
        break;
    }
    double reactivePower = m_electricalData.reactivePower;
    if (!m_online) reactivePower = 0.0;
    tipText += _("\nQ = ") + wxString::FromDouble(reactivePower, 5);
    switch (m_electricalData.reactivePowerUnit) {
    case ElectricalUnit::UNIT_PU: {
        tipText += _(" p.u.");
    } break;
    case ElectricalUnit::UNIT_var: {
        tipText += _(" var");
    } break;
    case ElectricalUnit::UNIT_kvar: {
        tipText += _(" kvar");
    } break;
    case ElectricalUnit::UNIT_Mvar: {
        tipText += _(" Mvar");
    } break;
    default:
        break;
    }
 
    return tipText;
}

◆ Init()

void SyncGenerator::Init ( )

virtual

Definition at line 51 of file SyncGenerator.cpp.

{
    int numPtsSine = 10;
    double mx = 15.0;
    double my = 10.0;
    double pi = 3.14159265359;
 
    for (int i = 0; i <= numPtsSine; i++) {
        double x = (2.0 * pi / double(numPtsSine)) * double(i) - pi;
        double y = std::sin(x);
        m_sinePts.push_back(wxPoint2DDouble((x / pi) * mx, y * my));
    }
 
    m_electricalData.avr = new ControlElementContainer();
    m_electricalData.speedGov = new ControlElementContainer();
}

◆ OpenElement()

bool SyncGenerator::OpenElement	(	rapidxml::xml_node<> *	elementNode,
		std::vector< Element * >	parentList
	)

virtual

Reimplemented from PowerElement.

Definition at line 463 of file SyncGenerator.cpp.

{
    if (!OpenCADProperties(elementNode, parentList)) return false;
 
    auto electricalProp = elementNode->first_node("ElectricalProperties");
    if (!electricalProp) return false;
 
    SetOnline(XMLParser::GetNodeValueInt(electricalProp, "IsOnline"));
    m_electricalData.name = electricalProp->first_node("Name")->value();
    m_electricalData.nominalPower = XMLParser::GetNodeValueDouble(electricalProp, "NominalPower");
    m_electricalData.nominalPowerUnit =
        static_cast<ElectricalUnit>(XMLParser::GetAttributeValueInt(electricalProp, "NominalPower", "UnitID"));
    m_electricalData.nominalVoltage = XMLParser::GetNodeValueDouble(electricalProp, "NominalVoltage");
    m_electricalData.nominalVoltageUnit =
        static_cast<ElectricalUnit>(XMLParser::GetAttributeValueInt(electricalProp, "NominalVoltage", "UnitID"));
    m_electricalData.activePower = XMLParser::GetNodeValueDouble(electricalProp, "ActivePower");
    m_electricalData.activePowerUnit =
        static_cast<ElectricalUnit>(XMLParser::GetAttributeValueInt(electricalProp, "ActivePower", "UnitID"));
    m_electricalData.reactivePower = XMLParser::GetNodeValueDouble(electricalProp, "ReactivePower");
    m_electricalData.reactivePowerUnit =
        static_cast<ElectricalUnit>(XMLParser::GetAttributeValueInt(electricalProp, "ReactivePower", "UnitID"));
    m_electricalData.haveMaxReactive = XMLParser::GetNodeValueInt(electricalProp, "HaveMaxReactive");
    m_electricalData.maxReactive = XMLParser::GetNodeValueDouble(electricalProp, "MaxReactive");
    m_electricalData.maxReactiveUnit =
        static_cast<ElectricalUnit>(XMLParser::GetAttributeValueInt(electricalProp, "MaxReactive", "UnitID"));
    m_electricalData.haveMinReactive = XMLParser::GetNodeValueInt(electricalProp, "HaveMinReactive");
    m_electricalData.minReactive = XMLParser::GetNodeValueDouble(electricalProp, "MinReactive");
    m_electricalData.minReactiveUnit =
        static_cast<ElectricalUnit>(XMLParser::GetAttributeValueInt(electricalProp, "MinReactive", "UnitID"));
    m_electricalData.useMachineBase = XMLParser::GetNodeValueInt(electricalProp, "UseMachineBase");
 
    auto fault = electricalProp->first_node("Fault");
    if (!fault) return false;
    m_electricalData.positiveResistance = XMLParser::GetNodeValueDouble(fault, "PositiveResistance");
    m_electricalData.positiveReactance = XMLParser::GetNodeValueDouble(fault, "PositiveReactance");
    m_electricalData.negativeResistance = XMLParser::GetNodeValueDouble(fault, "NegativeResistance");
    m_electricalData.negativeReactance = XMLParser::GetNodeValueDouble(fault, "NegativeReactance");
    m_electricalData.zeroResistance = XMLParser::GetNodeValueDouble(fault, "ZeroResistance");
    m_electricalData.zeroReactance = XMLParser::GetNodeValueDouble(fault, "ZeroReactance");
    m_electricalData.groundResistance = XMLParser::GetNodeValueDouble(fault, "GroundResistance");
    m_electricalData.groundReactance = XMLParser::GetNodeValueDouble(fault, "GroundReactance");
    m_electricalData.groundNeutral = XMLParser::GetNodeValueInt(fault, "GroundNeutral");
 
    auto stability = electricalProp->first_node("Stability");
    if (!stability) return false;
    m_electricalData.plotSyncMachine = XMLParser::GetNodeValueInt(stability, "PlotSyncMachine");
    m_electricalData.inertia = XMLParser::GetNodeValueDouble(stability, "Inertia");
    m_electricalData.damping = XMLParser::GetNodeValueDouble(stability, "Damping");
    m_electricalData.useAVR = XMLParser::GetNodeValueInt(stability, "UseAVR");
    m_electricalData.useSpeedGovernor = XMLParser::GetNodeValueInt(stability, "UseSpeedGovernor");
    m_electricalData.armResistance = XMLParser::GetNodeValueDouble(stability, "ArmResistance");
    m_electricalData.potierReactance = XMLParser::GetNodeValueDouble(stability, "PotierReactance");
    m_electricalData.satFactor = XMLParser::GetNodeValueDouble(stability, "SatFactor");
    m_electricalData.syncXd = XMLParser::GetNodeValueDouble(stability, "SyncXd");
    m_electricalData.syncXq = XMLParser::GetNodeValueDouble(stability, "SyncXq");
    m_electricalData.transXd = XMLParser::GetNodeValueDouble(stability, "TransXd");
    m_electricalData.transXq = XMLParser::GetNodeValueDouble(stability, "TransXq");
    m_electricalData.transTd0 = XMLParser::GetNodeValueDouble(stability, "TransTd0");
    m_electricalData.transTq0 = XMLParser::GetNodeValueDouble(stability, "TransTq0");
    m_electricalData.subXd = XMLParser::GetNodeValueDouble(stability, "SubXd");
    m_electricalData.subXq = XMLParser::GetNodeValueDouble(stability, "SubXq");
    m_electricalData.subTd0 = XMLParser::GetNodeValueDouble(stability, "SubTd0");
    m_electricalData.subTq0 = XMLParser::GetNodeValueDouble(stability, "SubTq0");
 
    if (!OpenSwitchingData(electricalProp)) return false;
    if (m_swData.swTime.size() != 0) SetDynamicEvent(true);
 
    m_inserted = true;
    return true;
}

◆ SaveElement()

rapidxml::xml_node * SyncGenerator::SaveElement	(	rapidxml::xml_document<> &	doc,
		rapidxml::xml_node<> *	elementListNode
	)

virtual

Reimplemented from Element.

Definition at line 365 of file SyncGenerator.cpp.

{
    auto elementNode = XMLParser::AppendNode(doc, elementListNode, "SyncGenerator");
    XMLParser::SetNodeAttribute(doc, elementNode, "ID", m_elementID);
 
    SaveCADProperties(doc, elementNode);
    auto electricalProp = XMLParser::AppendNode(doc, elementNode, "ElectricalProperties");
    auto isOnline = XMLParser::AppendNode(doc, electricalProp, "IsOnline");
    XMLParser::SetNodeValue(doc, isOnline, m_online);
    auto name = XMLParser::AppendNode(doc, electricalProp, "Name");
    XMLParser::SetNodeValue(doc, name, m_electricalData.name);
    auto nominalPower = XMLParser::AppendNode(doc, electricalProp, "NominalPower");
    XMLParser::SetNodeValue(doc, nominalPower, m_electricalData.nominalPower);
    XMLParser::SetNodeAttribute(doc, nominalPower, "UnitID", static_cast<int>(m_electricalData.nominalPowerUnit));
    auto nominalVoltage = XMLParser::AppendNode(doc, electricalProp, "NominalVoltage");
    XMLParser::SetNodeValue(doc, nominalVoltage, m_electricalData.nominalVoltage);
    XMLParser::SetNodeAttribute(doc, nominalVoltage, "UnitID", static_cast<int>(m_electricalData.nominalVoltageUnit));
    auto activePower = XMLParser::AppendNode(doc, electricalProp, "ActivePower");
    XMLParser::SetNodeValue(doc, activePower, m_electricalData.activePower);
    XMLParser::SetNodeAttribute(doc, activePower, "UnitID", static_cast<int>(m_electricalData.activePowerUnit));
    auto reactivePower = XMLParser::AppendNode(doc, electricalProp, "ReactivePower");
    XMLParser::SetNodeValue(doc, reactivePower, m_electricalData.reactivePower);
    XMLParser::SetNodeAttribute(doc, reactivePower, "UnitID", static_cast<int>(m_electricalData.reactivePowerUnit));
    auto haveMaxReactive = XMLParser::AppendNode(doc, electricalProp, "HaveMaxReactive");
    XMLParser::SetNodeValue(doc, haveMaxReactive, m_electricalData.haveMaxReactive);
    auto maxReactive = XMLParser::AppendNode(doc, electricalProp, "MaxReactive");
    XMLParser::SetNodeValue(doc, maxReactive, m_electricalData.maxReactive);
    XMLParser::SetNodeAttribute(doc, maxReactive, "UnitID", static_cast<int>(m_electricalData.maxReactiveUnit));
    auto haveMinReactive = XMLParser::AppendNode(doc, electricalProp, "HaveMinReactive");
    XMLParser::SetNodeValue(doc, haveMinReactive, m_electricalData.haveMinReactive);
    auto minReactive = XMLParser::AppendNode(doc, electricalProp, "MinReactive");
    XMLParser::SetNodeValue(doc, minReactive, m_electricalData.minReactive);
    XMLParser::SetNodeAttribute(doc, minReactive, "UnitID", static_cast<int>(m_electricalData.minReactiveUnit));
    auto useMachineBase = XMLParser::AppendNode(doc, electricalProp, "UseMachineBase");
    XMLParser::SetNodeValue(doc, useMachineBase, m_electricalData.useMachineBase);
 
    auto fault = XMLParser::AppendNode(doc, electricalProp, "Fault");
    auto positiveResistance = XMLParser::AppendNode(doc, fault, "PositiveResistance");
    XMLParser::SetNodeValue(doc, positiveResistance, m_electricalData.positiveResistance);
    auto positiveReactance = XMLParser::AppendNode(doc, fault, "PositiveReactance");
    XMLParser::SetNodeValue(doc, positiveReactance, m_electricalData.positiveReactance);
    auto negativeResistance = XMLParser::AppendNode(doc, fault, "NegativeResistance");
    XMLParser::SetNodeValue(doc, negativeResistance, m_electricalData.negativeResistance);
    auto negativeReactance = XMLParser::AppendNode(doc, fault, "NegativeReactance");
    XMLParser::SetNodeValue(doc, negativeReactance, m_electricalData.negativeReactance);
    auto zeroResistance = XMLParser::AppendNode(doc, fault, "ZeroResistance");
    XMLParser::SetNodeValue(doc, zeroResistance, m_electricalData.zeroResistance);
    auto zeroReactance = XMLParser::AppendNode(doc, fault, "ZeroReactance");
    XMLParser::SetNodeValue(doc, zeroReactance, m_electricalData.zeroReactance);
    auto groundResistance = XMLParser::AppendNode(doc, fault, "GroundResistance");
    XMLParser::SetNodeValue(doc, groundResistance, m_electricalData.groundResistance);
    auto groundReactance = XMLParser::AppendNode(doc, fault, "GroundReactance");
    XMLParser::SetNodeValue(doc, groundReactance, m_electricalData.groundReactance);
    auto groundNeutral = XMLParser::AppendNode(doc, fault, "GroundNeutral");
    XMLParser::SetNodeValue(doc, groundNeutral, m_electricalData.groundNeutral);
 
    auto stability = XMLParser::AppendNode(doc, electricalProp, "Stability");
    auto plotSyncMachine = XMLParser::AppendNode(doc, stability, "PlotSyncMachine");
    XMLParser::SetNodeValue(doc, plotSyncMachine, m_electricalData.plotSyncMachine);
    auto inertia = XMLParser::AppendNode(doc, stability, "Inertia");
    XMLParser::SetNodeValue(doc, inertia, m_electricalData.inertia);
    auto damping = XMLParser::AppendNode(doc, stability, "Damping");
    XMLParser::SetNodeValue(doc, damping, m_electricalData.damping);
    auto useAVR = XMLParser::AppendNode(doc, stability, "UseAVR");
    XMLParser::SetNodeValue(doc, useAVR, m_electricalData.useAVR);
    auto useSpeedGovernor = XMLParser::AppendNode(doc, stability, "UseSpeedGovernor");
    XMLParser::SetNodeValue(doc, useSpeedGovernor, m_electricalData.useSpeedGovernor);
    auto armResistance = XMLParser::AppendNode(doc, stability, "ArmResistance");
    XMLParser::SetNodeValue(doc, armResistance, m_electricalData.armResistance);
    auto potierReactance = XMLParser::AppendNode(doc, stability, "PotierReactance");
    XMLParser::SetNodeValue(doc, potierReactance, m_electricalData.potierReactance);
    auto satFactor = XMLParser::AppendNode(doc, stability, "SatFactor");
    XMLParser::SetNodeValue(doc, satFactor, m_electricalData.satFactor);
    auto syncXd = XMLParser::AppendNode(doc, stability, "SyncXd");
    XMLParser::SetNodeValue(doc, syncXd, m_electricalData.syncXd);
    auto syncXq = XMLParser::AppendNode(doc, stability, "SyncXq");
    XMLParser::SetNodeValue(doc, syncXq, m_electricalData.syncXq);
    auto transXd = XMLParser::AppendNode(doc, stability, "TransXd");
    XMLParser::SetNodeValue(doc, transXd, m_electricalData.transXd);
    auto transXq = XMLParser::AppendNode(doc, stability, "TransXq");
    XMLParser::SetNodeValue(doc, transXq, m_electricalData.transXq);
    auto transTd0 = XMLParser::AppendNode(doc, stability, "TransTd0");
    XMLParser::SetNodeValue(doc, transTd0, m_electricalData.transTd0);
    auto transTq0 = XMLParser::AppendNode(doc, stability, "TransTq0");
    XMLParser::SetNodeValue(doc, transTq0, m_electricalData.transTq0);
    auto subXd = XMLParser::AppendNode(doc, stability, "SubXd");
    XMLParser::SetNodeValue(doc, subXd, m_electricalData.subXd);
    auto subXq = XMLParser::AppendNode(doc, stability, "SubXq");
    XMLParser::SetNodeValue(doc, subXq, m_electricalData.subXq);
    auto subTd0 = XMLParser::AppendNode(doc, stability, "SubTd0");
    XMLParser::SetNodeValue(doc, subTd0, m_electricalData.subTd0);
    auto subTq0 = XMLParser::AppendNode(doc, stability, "SubTq0");
    XMLParser::SetNodeValue(doc, subTq0, m_electricalData.subTq0);
 
    SaveSwitchingData(doc, electricalProp);
    return elementNode;
}

◆ SavePlotData()

void SyncGenerator::SavePlotData ( )

virtual

Definition at line 534 of file SyncGenerator.cpp.

{
    m_electricalData.terminalVoltageVector.emplace_back(std::abs(m_electricalData.terminalVoltage));
    m_electricalData.electricalPowerVector.emplace_back(m_electricalData.electricalPower);
    m_electricalData.mechanicalPowerVector.emplace_back(m_electricalData.pm);
    m_electricalData.freqVector.emplace_back(m_electricalData.speed / (2.0f * M_PI));
    m_electricalData.fieldVoltageVector.emplace_back(m_electricalData.fieldVoltage);
    m_electricalData.deltaVector.emplace_back(wxRadToDeg(m_electricalData.delta));
}

◆ SetElectricalData()

virtual void SyncGenerator::SetElectricalData ( SyncGeneratorElectricalData electricalData )

inlinevirtual

Definition at line 163 of file SyncGenerator.h.

163{ m_electricalData = electricalData; }

◆ SetNominalVoltage()

void SyncGenerator::SetNominalVoltage	(	std::vector< double >	nominalVoltage,
		std::vector< ElectricalUnit >	nominalVoltageUnit
	)

virtual

Set nominal voltage of the element.

Parameters

nominalVoltage	Value of the nominal voltage.
nominalVoltageUnit	Unit of the nominal voltage.

Reimplemented from PowerElement.

Definition at line 240 of file SyncGenerator.cpp.

{
    if (nominalVoltage.size() > 0) {
        m_electricalData.nominalVoltage = nominalVoltage[0];
        m_electricalData.nominalVoltageUnit = nominalVoltageUnit[0];
    }
}

◆ ShowForm()

bool SyncGenerator::ShowForm	(	wxWindow *	parent,
		Element *	element,
		wxWindow *	workspace = `nullptr`
	)

virtual

Show element data form.

Parameters

parent	Form parent
element	Element that will be edited.

Returns: True if the form is shown, false otherwise.

Reimplemented from Element.

Definition at line 109 of file SyncGenerator.cpp.

{
    Workspace* ws = dynamic_cast<Workspace*>(workspace);
    if (!ws) return false;
 
    SyncMachineForm generatorForm(parent, this, static_cast<int>(ws->GetProperties()->GetGeneralPropertiesData().plotLib));
    generatorForm.SetTitle(_("Generator"));
    generatorForm.CenterOnParent();
    if (generatorForm.ShowModal() == wxID_OK) {
        return true;
    }
    return false;
}

Member Data Documentation

◆ m_electricalData

SyncGeneratorElectricalData SyncGenerator::m_electricalData

protected

Definition at line 174 of file SyncGenerator.h.

◆ m_sinePts

std::vector<wxPoint2DDouble> SyncGenerator::m_sinePts

protected

Definition at line 172 of file SyncGenerator.h.

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

Project/elements/powerElement/SyncGenerator.h
Project/elements/powerElement/SyncGenerator.cpp

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SyncGenerator() [1/2]

◆ SyncGenerator() [2/2]

◆ ~SyncGenerator()

Member Function Documentation

◆ DrawDCSymbol() [1/2]

◆ DrawDCSymbol() [2/2]

◆ GetContextMenu()

◆ GetCopy()

◆ GetElectricalData()

◆ GetElectricalDataRef()

◆ GetPlotData()

◆ GetPUElectricalData()

◆ GetTipText()

◆ Init()

◆ OpenElement()

◆ SaveElement()

◆ SavePlotData()

◆ SetElectricalData()

◆ SetNominalVoltage()

◆ ShowForm()

Member Data Documentation

◆ m_electricalData

◆ m_sinePts