DPsim
SP_Ph1_Switch.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/Definitions.h>
13 #include <dpsim-models/Logger.h>
14 #include <dpsim-models/MNASimPowerComp.h>
15 #include <dpsim-models/Solver/MNAInterface.h>
16 #include <dpsim-models/Solver/MNASwitchInterface.h>
17 
18 namespace CPS {
19 namespace SP {
20 namespace Ph1 {
25 class Switch : public MNASimPowerComp<Complex>,
26  public Base::Ph1::Switch,
27  public SharedFactory<Switch>,
28  public MNASwitchInterface {
29 
30 public:
32  Switch(String uid, String name, Logger::Level loglevel = Logger::Level::off);
34  Switch(String name, Logger::Level logLevel = Logger::Level::off)
35  : Switch(name, name, logLevel) {}
36 
37  SimPowerComp<Complex>::Ptr clone(String name) override;
38 
39  // #### General ####
41  void initializeFromNodesAndTerminals(Real frequency) override;
42 
43  // #### General MNA section ####
44  void mnaCompInitialize(Real omega, Real timeStep,
45  Attribute<Matrix>::Ptr leftVector) override;
47  void mnaCompApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override;
49  void mnaCompApplyRightSideVectorStamp(Matrix &rightVector) override;
51  void mnaCompUpdateVoltage(const Matrix &leftVector) override;
53  void mnaCompUpdateCurrent(const Matrix &leftVector) override;
55  void mnaCompPostStep(Real time, Int timeStepCount,
56  Attribute<Matrix>::Ptr &leftVector) override;
58  void
59  mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies,
60  AttributeBase::List &attributeDependencies,
61  AttributeBase::List &modifiedAttributes,
62  Attribute<Matrix>::Ptr &leftVector) override;
63 
64  // #### MNA section for switch ####
66  Bool mnaIsClosed() override;
68  void mnaCompApplySwitchSystemMatrixStamp(Bool closed,
69  SparseMatrixRow &systemMatrix,
70  Int freqIdx) override;
71 };
72 } // namespace Ph1
73 } // namespace SP
74 } // namespace CPS
Dynamic Phasor Three-Phase Switch.
String uid()
Returns unique id.
Base class for all MNA components that are transmitting power.
MNA interface to be used by switching devices.
Dynamic phasor switch.
Definition: SP_Ph1_Switch.h:28
Bool mnaIsClosed() override
Check if switch is closed.
void mnaCompApplySwitchSystemMatrixStamp(Bool closed, SparseMatrixRow &systemMatrix, Int freqIdx) override
Stamps system matrix considering the defined switch position.
void mnaCompApplyRightSideVectorStamp(Matrix &rightVector) override
Stamps right side (source) vector.
SimPowerComp< Complex >::Ptr clone(String name) override
Returns a modified copy of the component with the given suffix added to the name and without.
void mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies, AttributeBase::List &attributeDependencies, AttributeBase::List &modifiedAttributes, Attribute< Matrix >::Ptr &leftVector) override
Add MNA post step dependencies.
Switch(String uid, String name, Logger::Level loglevel=Logger::Level::off)
Defines UID, name, component parameters and logging level.
void mnaCompUpdateVoltage(const Matrix &leftVector) override
Update interface voltage from MNA system result.
Switch(String name, Logger::Level logLevel=Logger::Level::off)
Defines name, component parameters and logging level.
Definition: SP_Ph1_Switch.h:34
void mnaCompUpdateCurrent(const Matrix &leftVector) override
Update interface current from MNA system result.
void mnaCompApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override
Stamps system matrix.
void mnaCompPostStep(Real time, Int timeStepCount, Attribute< Matrix >::Ptr &leftVector) override
MNA post step operations.
void initializeFromNodesAndTerminals(Real frequency) override
Initializes component from power flow data.
Base class for all components that are transmitting power.
Definition: SimPowerComp.h:17