DPsim
Loading...
Searching...
No Matches
EMT_Ph3_SeriesSwitch.h
1/* Copyright 2017-2021 Institute for Automation of Complex Power Systems,
2 * EONERC, RWTH Aachen University
3 *
4 * This Source Code Form is subject to the terms of the Mozilla Public
5 * License, v. 2.0. If a copy of the MPL was not distributed with this
6 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
7 *********************************************************************************/
8
9#pragma once
10
11#include <dpsim-models/Base/Base_Ph1_Switch.h>
12#include <dpsim-models/MNASimPowerComp.h>
13#include <dpsim-models/Solver/MNASwitchInterface.h>
14#include <dpsim-models/Solver/MNAVariableCompInterface.h>
15
16namespace CPS {
17namespace EMT {
18namespace Ph3 {
25class SeriesSwitch : public MNASimPowerComp<Real>,
26 public Base::Ph1::Switch,
27 public SharedFactory<SeriesSwitch>,
29 public MNASwitchInterface {
30protected:
31 Bool mPrevState = false;
32
33public:
35 SeriesSwitch(String uid, String name,
36 Logger::Level loglevel = Logger::Level::off);
38 SeriesSwitch(String name, Logger::Level logLevel = Logger::Level::off)
39 : SeriesSwitch(name, name, logLevel) {}
40
41 // #### General ####
43 SimPowerComp<Real>::Ptr clone(String name) override;
45 void initializeFromNodesAndTerminals(Real frequency) override;
46
47 // #### General MNA section ####
49 void mnaCompInitialize(Real omega, Real timeStep,
50 Attribute<Matrix>::Ptr leftVector) override;
52 void mnaCompApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override;
54 void mnaCompUpdateVoltage(const Matrix &leftVector) override;
56 void mnaCompUpdateCurrent(const Matrix &leftVector) override;
57
58 // #### Switch specific MNA section ####
60 Bool mnaIsClosed() override;
63 SparseMatrixRow &systemMatrix,
64 Int freqIdx) override;
65 void mnaCompPostStep(Real time, Int timeStepCount,
66 Attribute<Matrix>::Ptr &leftVector) override;
67
69 void
70 mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies,
71 AttributeBase::List &attributeDependencies,
72 AttributeBase::List &modifiedAttributes,
73 Attribute<Matrix>::Ptr &leftVector) override;
74
75 // #### MNA section for variable component ####
76 Bool hasParameterChanged() override;
77};
78} // namespace Ph3
79} // namespace EMT
80} // namespace CPS
Dynamic Phasor Three-Phase Switch.
Bool mnaIsClosed() override
Check if switch is closed.
void mnaCompUpdateCurrent(const Matrix &leftVector) override
Update interface voltage from MNA system results.
void mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies, AttributeBase::List &attributeDependencies, AttributeBase::List &modifiedAttributes, Attribute< Matrix >::Ptr &leftVector) override
Add MNA post step dependencies.
Bool hasParameterChanged() override
Returns true if one of the element paramters has changed.
SeriesSwitch(String uid, String name, Logger::Level loglevel=Logger::Level::off)
Defines UID, name and log level.
void initializeFromNodesAndTerminals(Real frequency) override
Initializes states from power flow data.
void mnaCompUpdateVoltage(const Matrix &leftVector) override
Update interface voltage from MNA system results.
SeriesSwitch(String name, Logger::Level logLevel=Logger::Level::off)
Defines name and log level.
void mnaCompApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override
Stamps system matrix.
SimPowerComp< Real >::Ptr clone(String name) override
Return new instance with the same parameters.
void mnaCompInitialize(Real omega, Real timeStep, Attribute< Matrix >::Ptr leftVector) override
Initializes MNA specific variables.
void mnaCompApplySwitchSystemMatrixStamp(Bool closed, SparseMatrixRow &systemMatrix, Int freqIdx) override
Stamps system matrix considering the defined switch position.
String uid()
Returns unique id.
MNASimPowerComp(String uid, String name, Bool hasPreStep, Bool hasPostStep, Logger::Level logLevel)
MNA interface to be used by switching devices.
MNA interface to be used by elements that require recomputing of the system matrix.