DPsim
Loading...
Searching...
No Matches
DP_Ph3_CurrentSource.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/MNASimPowerComp.h>
7#include <dpsim-models/Signal/SineWaveGenerator.h>
8#include <dpsim-models/Solver/MNAInterface.h>
9
10namespace CPS {
11namespace DP {
12namespace Ph3 {
17class CurrentSource : public MNASimPowerComp<Complex>,
18 public SharedFactory<CurrentSource> {
19private:
20 void updateCurrent(Real time);
22 CPS::Signal::SignalGenerator::Ptr mSrcSig;
23
24public:
26 const Attribute<MatrixComp>::Ptr mCurrentRef;
28 const Attribute<Real>::Ptr mSrcFreq;
30 CurrentSource(String uid, String name,
31 Logger::Level logLevel = Logger::Level::off);
33 CurrentSource(String name, Logger::Level logLevel = Logger::Level::off)
34 : CurrentSource(name, name, logLevel) {}
35
36 SimPowerComp<Complex>::Ptr clone(String name) override;
37 // #### General ####
39 void initializeFromNodesAndTerminals(Real frequency) override;
41 void setParameters(MatrixComp currentRef, Real srcFreq = 0.0);
42
43 // #### MNA section ####
45 void mnaCompInitialize(Real omega, Real timeStep,
46 Attribute<Matrix>::Ptr leftVector) override;
48 void mnaCompApplyRightSideVectorStamp(Matrix &rightVector) override;
50 void mnaCompUpdateVoltage(const Matrix &leftVector) override;
52 void mnaCompPreStep(Real time, Int timeStepCount) override;
54 void mnaCompPostStep(Real time, Int timeStepCount,
55 Attribute<Matrix>::Ptr &leftVector) override;
58 AttributeBase::List &prevStepDependencies,
59 AttributeBase::List &attributeDependencies,
60 AttributeBase::List &modifiedAttributes) override;
62 void
63 mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies,
64 AttributeBase::List &attributeDependencies,
65 AttributeBase::List &modifiedAttributes,
66 Attribute<Matrix>::Ptr &leftVector) override;
67};
68} // namespace Ph3
69} // namespace DP
70} // namespace CPS
void mnaCompApplyRightSideVectorStamp(Matrix &rightVector) override
Stamps right side (source) vector.
CurrentSource(String name, Logger::Level logLevel=Logger::Level::off)
Defines name 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
MNA post step operations.
CurrentSource(String uid, String name, Logger::Level logLevel=Logger::Level::off)
Defines UID, name and logging level.
void initializeFromNodesAndTerminals(Real frequency) override
Initializes component from power flow data.
void mnaCompAddPreStepDependencies(AttributeBase::List &prevStepDependencies, AttributeBase::List &attributeDependencies, AttributeBase::List &modifiedAttributes) override
Add MNA pre step dependencies.
void mnaCompPreStep(Real time, Int timeStepCount) override
MNA pre step operations.
void mnaCompUpdateVoltage(const Matrix &leftVector) override
Returns voltage through the component.
const Attribute< MatrixComp >::Ptr mCurrentRef
Reference current phasor, independent per phase (A, B, C)
void mnaCompInitialize(Real omega, Real timeStep, Attribute< Matrix >::Ptr leftVector) override
Initializes internal variables of the component.
const Attribute< Real >::Ptr mSrcFreq
Signal frequency, as an offset from the domain carrier (0 = steady)
void mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies, AttributeBase::List &attributeDependencies, AttributeBase::List &modifiedAttributes, Attribute< Matrix >::Ptr &leftVector) override
Add MNA post step dependencies.
void setParameters(MatrixComp currentRef, Real srcFreq=0.0)
Setter for reference current per phase and offset from the carrier.
String uid()
Returns unique id.
MNASimPowerComp(String uid, String name, Bool hasPreStep, Bool hasPostStep, Logger::Level logLevel)