DPsim
Loading...
Searching...
No Matches
DP_Ph3_Switch.h
Go to the documentation of this file.
1// SPDX-FileCopyrightText: 2026 Institute for Automation of Complex Power Systems, EONERC, RWTH Aachen University
2// SPDX-License-Identifier: MPL-2.0
3
4#pragma once
5
12
13namespace CPS {
14namespace DP {
15namespace Ph3 {
21class Switch : public MNASimPowerComp<Complex>,
22 public Base::Ph3::Switch,
23 public SharedFactory<Switch>,
25 public MNASwitchInterface {
26public:
28 Switch(String uid, String name, Logger::Level loglevel = Logger::Level::off);
30 Switch(String name, Logger::Level logLevel = Logger::Level::off)
31 : Switch(name, name, logLevel) {}
32
34
35 // #### General ####
37 void initializeFromNodesAndTerminals(Real frequency) override;
38
39 // #### General MNA section ####
40 void mnaCompInitialize(Real omega, Real timeStep,
41 Attribute<Matrix>::Ptr leftVector) override;
43 void mnaCompApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override;
45 void mnaCompUpdateVoltage(const Matrix &leftVector) override;
47 void mnaCompUpdateCurrent(const Matrix &leftVector) override;
48
49 // #### MNA section for switches ####
51 Bool mnaIsClosed() override;
54 SparseMatrixRow &systemMatrix,
55 Int freqIdx) override;
56
57 void mnaCompPostStep(Real time, Int timeStepCount,
58 Attribute<Matrix>::Ptr &leftVector) override;
59
61 void
63 AttributeBase::List &attributeDependencies,
64 AttributeBase::List &modifiedAttributes,
65 Attribute<Matrix>::Ptr &leftVector) override;
66
67 // #### MNA section for variable component ####
68 Bool hasParameterChanged() override;
69};
70} // namespace Ph3
71} // namespace DP
72} // namespace CPS
std::vector< Ptr > List
Definition Attribute.h:123
AttributePointer< Attribute< T > > Ptr
Definition Attribute.h:250
Dynamic Phasor Three-Phase Switch.
Bool hasParameterChanged() override
Returns true if one of the element paramters has changed.
void mnaCompUpdateCurrent(const Matrix &leftVector) override
Update interface current from MNA system result.
void mnaCompUpdateVoltage(const Matrix &leftVector) override
Update interface voltage from MNA system result.
Switch(String uid, String name, Logger::Level loglevel=Logger::Level::off)
Defines UID, name, component parameters and logging level.
Bool mnaIsClosed() override
Check if switch is closed.
Switch(String name, Logger::Level logLevel=Logger::Level::off)
Defines name, component parameters and logging level.
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 mnaCompPostStep(Real time, Int timeStepCount, Attribute< Matrix >::Ptr &leftVector) override
void initializeFromNodesAndTerminals(Real frequency) override
Initializes component from power flow data.
void mnaCompApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override
Stamps system matrix.
void mnaCompApplySwitchSystemMatrixStamp(Bool closed, SparseMatrixRow &systemMatrix, Int freqIdx) override
Stamps system matrix considering the defined switch position.
void mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies, AttributeBase::List &attributeDependencies, AttributeBase::List &modifiedAttributes, Attribute< Matrix >::Ptr &leftVector) override
Add MNA post step dependencies.
void mnaCompInitialize(Real omega, Real timeStep, Attribute< Matrix >::Ptr leftVector) override
String uid()
Returns unique id.
spdlog::level::level_enum Level
Definition Logger.h:33
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.
std::shared_ptr< SimPowerComp< VarType > > Ptr
Eigen::Matrix< Real, Eigen::Dynamic, Eigen::Dynamic, Eigen::ColMajor > Matrix
Dense matrix for real numbers.
Definition Definitions.h:81
std::string String
Definition Definitions.h:65
double Real
Definition Definitions.h:62
int Int
Definition Definitions.h:61
bool Bool
Definition Definitions.h:64
Eigen::SparseMatrix< Real, Eigen::RowMajor > SparseMatrixRow
Sparse matrix for real numbers (row major).
Definition Definitions.h:74