DPsim
Loading...
Searching...
No Matches
DP_Ph1_PiLine.h
1/* Author: Christoph Wirtz <christoph.wirtz@fgh-ma.de>
2 * SPDX-FileCopyrightText: 2025 FGH e.V.
3 * SPDX-License-Identifier: MPL-2.0
4 */
5
6#pragma once
7
8#include <dpsim-models/Base/Base_Ph1_PiLine.h>
9#include <dpsim-models/CompositePowerComp.h>
10#include <dpsim-models/DP/DP_Ph1_Capacitor.h>
11#include <dpsim-models/DP/DP_Ph1_Inductor.h>
12#include <dpsim-models/DP/DP_Ph1_Resistor.h>
13#include <dpsim-models/Solver/MNATearInterface.h>
14
15namespace CPS {
16namespace DP {
17namespace Ph1 {
22class PiLine : public CompositePowerComp<Complex>,
23 public MNATearInterface,
24 public Base::Ph1::PiLine,
25 public SharedFactory<PiLine> {
26protected:
28 std::shared_ptr<Inductor> mSubSeriesInductor;
30 std::shared_ptr<Resistor> mSubSeriesResistor;
32 std::shared_ptr<Resistor> mSubParallelResistor0;
33 // Parallel Capacitor submodel at Terminal 0
34 std::shared_ptr<Capacitor> mSubParallelCapacitor0;
36 std::shared_ptr<Resistor> mSubParallelResistor1;
38 std::shared_ptr<Capacitor> mSubParallelCapacitor1;
40 std::vector<const Matrix *> mRightVectorStamps;
41
42public:
44 PiLine(String uid, String name, Logger::Level logLevel = Logger::Level::off);
46 PiLine(String name, Logger::Level logLevel = Logger::Level::off)
47 : PiLine(name, name, logLevel) {}
48
49 SimPowerComp<Complex>::Ptr clone(String copySuffix) override;
50
51 // #### General ####
53 void initializeFromNodesAndTerminals(Real frequency) override;
54
55 // #### MNA section ####
57 void mnaCompUpdateCurrent(const Matrix &leftVector) override;
59 void mnaCompUpdateVoltage(const Matrix &leftVector) override;
61 void mnaParentPreStep(Real time, Int timeStepCount) override;
62 void mnaParentPostStep(Real time, Int timeStepCount,
63 Attribute<Matrix>::Ptr &leftVector) override;
66 AttributeBase::List &prevStepDependencies,
67 AttributeBase::List &attributeDependencies,
68 AttributeBase::List &modifiedAttributes) override;
69 void
70 mnaParentAddPostStepDependencies(AttributeBase::List &prevStepDependencies,
71 AttributeBase::List &attributeDependencies,
72 AttributeBase::List &modifiedAttributes,
73 Attribute<Matrix>::Ptr &leftVector) override;
74
75 MNAInterface::List mnaTearGroundComponents() override;
76 void mnaTearInitialize(Real omega, Real timeStep) override;
77 void mnaTearApplyMatrixStamp(SparseMatrixRow &tearMatrix) override;
78 void mnaTearApplyVoltageStamp(Matrix &voltageVector) override;
79 void mnaTearPostStep(Complex voltage, Complex current) override;
80};
81} // namespace Ph1
82} // namespace DP
83} // namespace CPS
CompositePowerComp(String uid, String name, Bool hasPreStep, Bool hasPostStep, Logger::Level logLevel)
void mnaParentPreStep(Real time, Int timeStepCount) override
MNA pre and post step operations.
std::shared_ptr< Capacitor > mSubParallelCapacitor1
Parallel capacitor submodel at Terminal 1.
SimPowerComp< Complex >::Ptr clone(String copySuffix) override
DEPRECATED: Remove method.
void mnaCompUpdateCurrent(const Matrix &leftVector) override
Updates internal current variable of the component.
std::shared_ptr< Resistor > mSubParallelResistor1
Parallel resistor submodel at Terminal 1.
std::shared_ptr< Resistor > mSubSeriesResistor
Series Resistor submodel.
void initializeFromNodesAndTerminals(Real frequency) override
Initializes component from power flow data.
std::shared_ptr< Inductor > mSubSeriesInductor
Series Inductance submodel.
PiLine(String name, Logger::Level logLevel=Logger::Level::off)
Defines name and logging level.
PiLine(String uid, String name, Logger::Level logLevel=Logger::Level::off)
Defines UID, name and logging level.
std::shared_ptr< Resistor > mSubParallelResistor0
Parallel Resistor submodel at Terminal 0.
std::vector< const Matrix * > mRightVectorStamps
Right side vectors of subcomponents.
void mnaParentAddPreStepDependencies(AttributeBase::List &prevStepDependencies, AttributeBase::List &attributeDependencies, AttributeBase::List &modifiedAttributes) override
add MNA pre and post step dependencies
void mnaCompUpdateVoltage(const Matrix &leftVector) override
Updates internal voltage variable of the component.
String uid()
Returns unique id.