DPsim
Loading...
Searching...
No Matches
SP_Ph1_ControlledCurrentSource.h
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
6#include <dpsim-models/Base/Base_Ph1_CurrentSource.h>
7#include <dpsim-models/MNASimPowerComp.h>
8#include <dpsim-models/Signal/SineWaveGenerator.h>
9#include <dpsim-models/Solver/MNAInterface.h>
10#include <dpsim-models/Task.h>
11
12namespace CPS {
13namespace SP {
14namespace Ph1 {
19 public SharedFactory<ControlledCurrentSource> {
20
21protected:
22 // Updates current according to reference phasor and frequency
23 void updateCurrent(Real time);
24
25public:
26 const Attribute<Complex>::Ptr mCurrentRef;
28 ControlledCurrentSource(String uid, String name,
29 Logger::Level loglevel = Logger::Level::off);
32 Logger::Level logLevel = Logger::Level::off)
33 : ControlledCurrentSource(name, name, logLevel) {}
34
35 ControlledCurrentSource(String name, Complex current,
36 Logger::Level logLevel = Logger::Level::off);
37
38 SimPowerComp<Complex>::Ptr clone(String copySuffix) override;
39
40 // #### General ####
42 void initializeFromNodesAndTerminals(Real frequency) override;
44 // void setSourceValue(Complex current);
45
46 void setParameters(Complex currentRef);
47
48 // #### MNA section ####
50 void mnaCompInitialize(Real omega, Real timeStep,
51 Attribute<Matrix>::Ptr leftVector) override;
53 void mnaCompApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override {}
55 void mnaCompApplyRightSideVectorStamp(Matrix &rightVector) override;
57 void mnaCompUpdateVoltage(const Matrix &leftVector) override;
58
61 AttributeBase::List &prevStepDependencies,
62 AttributeBase::List &attributeDependencies,
63 AttributeBase::List &modifiedAttributes) override;
65 void
66 mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies,
67 AttributeBase::List &attributeDependencies,
68 AttributeBase::List &modifiedAttributes,
69 Attribute<Matrix>::Ptr &leftVector) override;
70 void mnaCompPreStep(Real time, Int timeStepCount) override;
71 void mnaCompPostStep(Real time, Int timeStepCount,
72 Attribute<Matrix>::Ptr &leftVector) override;
73};
74} // namespace Ph1
75} // namespace SP
76} // namespace CPS
String uid()
Returns unique id.
MNASimPowerComp(String uid, String name, Bool hasPreStep, Bool hasPostStep, Logger::Level logLevel)
void mnaCompApplyRightSideVectorStamp(Matrix &rightVector) override
Stamps right side (source) vector.
void mnaCompAddPreStepDependencies(AttributeBase::List &prevStepDependencies, AttributeBase::List &attributeDependencies, AttributeBase::List &modifiedAttributes) override
Add MNA pre step dependencies.
SimPowerComp< Complex >::Ptr clone(String copySuffix) override
Returns a modified copy of the component with the given suffix added to the name and without.
void mnaCompApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override
Stamps system matrix.
ControlledCurrentSource(String uid, String name, Logger::Level loglevel=Logger::Level::off)
Defines UID, name and logging level.
ControlledCurrentSource(String name, Logger::Level logLevel=Logger::Level::off)
Defines name and logging level.
void initializeFromNodesAndTerminals(Real frequency) override
Initializes component from power flow data.
void mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies, AttributeBase::List &attributeDependencies, AttributeBase::List &modifiedAttributes, Attribute< Matrix >::Ptr &leftVector) override
Add MNA post step dependencies.