DPsim
SP_Ph3_Inductor.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/MNASimPowerComp.h>
12 
13 #include <dpsim-models/Base/Base_Ph3_Inductor.h>
14 #include <dpsim-models/Solver/MNATearInterface.h>
15 
16 namespace CPS {
17 namespace SP {
18 namespace Ph3 {
26 class Inductor : public MNASimPowerComp<Complex>,
27  public Base::Ph3::Inductor,
28  public MNATearInterface,
29  public SharedFactory<Inductor> {
30 protected:
32  MatrixComp mSusceptance;
33 
34 public:
36  Inductor(String uid, String name,
37  Logger::Level logLevel = Logger::Level::off);
39  Inductor(String name, Logger::Level logLevel = Logger::Level::off)
40  : Inductor(name, name, logLevel) {}
42  Inductor(String name, Real inductance,
43  Logger::Level logLevel = Logger::Level::off);
44 
45  SimPowerComp<Complex>::Ptr clone(String name) override;
46 
47  // #### General ####
49  void initializeFromNodesAndTerminals(Real frequency) override;
50  // #### MNA section ####
52  void mnaCompInitialize(Real omega, Real timeStep,
53  Attribute<Matrix>::Ptr leftVector) override;
55  void mnaCompApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override;
57  void mnaStep(Matrix &systemMatrix, Matrix &rightVector, Matrix &leftVector,
58  Real time);
60  void mnaMnaPostStep(Matrix &rightVector, Matrix &leftVector, Real time);
62  void mnaCompUpdateVoltage(const Matrix &leftVector) override;
64  void mnaCompUpdateCurrent(const Matrix &leftVector) override;
65 
66  void mnaCompPostStep(Real time, Int timeStepCount,
67  Attribute<Matrix>::Ptr &leftVector) override;
68 
70  void
71  mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies,
72  AttributeBase::List &attributeDependencies,
73  AttributeBase::List &modifiedAttributes,
74  Attribute<Matrix>::Ptr &leftVector) override;
75 
76  void mnaTearApplyMatrixStamp(SparseMatrixRow &tearMatrix) override;
77 };
78 } // namespace Ph3
79 } // namespace SP
80 } // namespace CPS
String uid()
Returns unique id.
Base class for all MNA components that are transmitting power.
Inductor(String name, Logger::Level logLevel=Logger::Level::off)
Defines name, component parameters and logging level.
Inductor(String name, Real inductance, Logger::Level logLevel=Logger::Level::off)
Defines name, component parameters and logging level.
void initializeFromNodesAndTerminals(Real frequency) override
Initializes component from power flow data.
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 mnaCompInitialize(Real omega, Real timeStep, Attribute< Matrix >::Ptr leftVector) override
Initializes internal variables of the component.
void mnaCompUpdateCurrent(const Matrix &leftVector) override
Update interface current from MNA system result.
void mnaStep(Matrix &systemMatrix, Matrix &rightVector, Matrix &leftVector, Real time)
Upgrade values in the source vector and maybe system matrix before MNA solution.
void mnaMnaPostStep(Matrix &rightVector, Matrix &leftVector, Real time)
Upgrade internal variables after MNA solution.
MatrixComp mSusceptance
susceptance [S]
void mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies, AttributeBase::List &attributeDependencies, AttributeBase::List &modifiedAttributes, Attribute< Matrix >::Ptr &leftVector) override
Add MNA post step dependencies.
Inductor(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.
void mnaCompApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override
Stamps system matrix.
Base class for all components that are transmitting power.
Definition: SimPowerComp.h:17