DPsim
Loading...
Searching...
No Matches
EMT_Ph3_NetworkInjection.h
Go to the documentation of this file.
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
15
16namespace CPS {
17namespace EMT {
18namespace Ph3 {
23 public SharedFactory<NetworkInjection> {
24private:
25 // ### Electrical Subcomponents ###
27 std::shared_ptr<EMT::Ph3::VoltageSource> mSubVoltageSource;
28 Bool mUseSubcomponents = true;
30
31 // #### solver ####
33 std::vector<const Matrix *> mRightVectorStamps;
34
35public:
38
41 Logger::Level loglevel = Logger::Level::off);
43 NetworkInjection(String uid, String name, Bool useSubcomponents,
44 Logger::Level loglevel = Logger::Level::off);
45 NetworkInjection(String name, Bool useSubcomponents,
46 Logger::Level logLevel = Logger::Level::off)
47 : NetworkInjection(name, name, useSubcomponents, logLevel) {}
48
49 NetworkInjection(String name, Logger::Level logLevel = Logger::Level::off)
50 : NetworkInjection(name, name, logLevel) {}
51
53 Logger::Level logLevel = Logger::Level::off);
56
57 // #### General ####
59 void initializeParentFromNodesAndTerminals(Real frequency) override;
61 void setParameters(MatrixComp voltageRef, Real srcFreq = 50.0);
63 void setParameters(MatrixComp voltageRef, Real freqStart, Real rocof,
64 Real timeStart, Real duration, bool smoothRamp = true);
66 void setParameters(MatrixComp voltageRef, Real modulationFrequency,
67 Real modulationAmplitude, Real baseFrequency = 50.0,
68 bool zigzag = false);
69
70 // #### MNA Section ####
72 void mnaParentApplyRightSideVectorStamp(Matrix &rightVector) override;
73 void mnaParentApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override;
75 void mnaAddCompactRightSideVectorStamp(Matrix &rightVector) override;
77 void mnaCompUpdateCurrent(const Matrix &leftVector) override;
79 void mnaCompUpdateVoltage(const Matrix &leftVector) override;
81 void mnaParentPreStep(Real time, Int timeStepCount) override;
83 void mnaParentPostStep(Real time, Int timeStepCount,
84 Attribute<Matrix>::Ptr &leftVector) override;
87 AttributeBase::List &prevStepDependencies,
88 AttributeBase::List &attributeDependencies,
89 AttributeBase::List &modifiedAttributes) override;
91 void
93 AttributeBase::List &attributeDependencies,
94 AttributeBase::List &modifiedAttributes,
95 Attribute<Matrix>::Ptr &leftVector) override;
96};
97} // namespace Ph3
98} // namespace EMT
99} // namespace CPS
std::vector< Ptr > List
Definition Attribute.h:123
AttributePointer< Attribute< T > > Ptr
Definition Attribute.h:249
CompositePowerComp(String uid, String name, Bool hasPreStep, Bool hasPostStep, Logger::Level logLevel)
void mnaParentApplyRightSideVectorStamp(Matrix &rightVector) override
Stamps right side (source) vector.
void setParameters(MatrixComp voltageRef, Real srcFreq=50.0)
Setter for reference voltage parameters.
NetworkInjection(String name, Bool useSubcomponents, Logger::Level logLevel=Logger::Level::off)
void initializeParentFromNodesAndTerminals(Real frequency) override
Initializes component from power flow data.
void mnaCompUpdateVoltage(const Matrix &leftVector) override
Updates voltage across component.
NetworkInjection(String name, Logger::Level logLevel=Logger::Level::off)
Defines UID, name, component parameters and logging level.
void mnaParentAddPostStepDependencies(AttributeBase::List &prevStepDependencies, AttributeBase::List &attributeDependencies, AttributeBase::List &modifiedAttributes, Attribute< Matrix >::Ptr &leftVector) override
Add MNA post step dependencies.
void mnaCompUpdateCurrent(const Matrix &leftVector) override
Returns current through the component.
NetworkInjection(String name, Complex voltage, Logger::Level logLevel=Logger::Level::off)
Defines name, component parameters and logging level.
void mnaParentPostStep(Real time, Int timeStepCount, Attribute< Matrix >::Ptr &leftVector) override
MNA post step operations.
Bool mnaHasCompactRightSideVectorStamp() const override
Composite stamps touch only their cached terminal and virtual-node rows.
void mnaAddCompactRightSideVectorStamp(Matrix &rightVector) override
SimPowerComp< Real >::Ptr clone(String name) override
Returns a modified copy of the component with the given suffix added to the name and without.
void mnaParentPreStep(Real time, Int timeStepCount) override
MNA pre step operations.
const CPS::Attribute< MatrixComp >::Ptr mVoltageRef
const CPS::Attribute< Real >::Ptr mSrcFreq
void mnaParentAddPreStepDependencies(AttributeBase::List &prevStepDependencies, AttributeBase::List &attributeDependencies, AttributeBase::List &modifiedAttributes) override
Add MNA pre step dependencies.
NetworkInjection(String uid, String name, Logger::Level loglevel=Logger::Level::off)
Defines UID, name, component parameters and logging level.
void mnaParentApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override
String uid()
Returns unique id.
spdlog::level::level_enum Level
Definition Logger.h:33
std::shared_ptr< SignalGenerator > Ptr
std::shared_ptr< SimPowerComp< VarType > > Ptr
Eigen::Matrix< Real, Eigen::Dynamic, Eigen::Dynamic, Eigen::ColMajor > Matrix
Dense matrix for real numbers.
Definition Definitions.h:79
std::string String
Definition Definitions.h:63
double Real
Definition Definitions.h:60
int Int
Definition Definitions.h:59
std::complex< Real > Complex
Definition Definitions.h:61
Eigen::Matrix< Complex, Eigen::Dynamic, Eigen::Dynamic, Eigen::ColMajor > MatrixComp
Dense matrix for complex numbers.
Definition Definitions.h:82
bool Bool
Definition Definitions.h:62
Eigen::SparseMatrix< Real, Eigen::RowMajor > SparseMatrixRow
Sparse matrix for real numbers (row major).
Definition Definitions.h:72