DP_Ph3_PiLine.h

/* Author: Christoph Wirtz <christoph.wirtz@fgh-ma.de>
 * SPDX-FileCopyrightText: 2025 FGH e.V.
 * SPDX-License-Identifier: MPL-2.0
 */
 
#pragma once
 
#include <dpsim-models/Base/Base_Ph3_PiLine.h>
#include <dpsim-models/CompositePowerComp.h>
#include <dpsim-models/DP/DP_Ph3_Capacitor.h>
#include <dpsim-models/DP/DP_Ph3_Inductor.h>
#include <dpsim-models/DP/DP_Ph3_Resistor.h>
#include <dpsim-models/Solver/MNATearInterface.h>
 
namespace CPS {
namespace DP {
namespace Ph3 {
class PiLine : public CompositePowerComp<Complex>,
               public MNATearInterface,
               public Base::Ph3::PiLine,
               public SharedFactory<PiLine> {
protected:
  std::shared_ptr<Inductor> mSubSeriesInductor;
  std::shared_ptr<Resistor> mSubSeriesResistor;
  std::shared_ptr<Resistor> mSubParallelResistor0;
  // Parallel Capacitor submodel at Terminal 0
  std::shared_ptr<Capacitor> mSubParallelCapacitor0;
  std::shared_ptr<Resistor> mSubParallelResistor1;
  std::shared_ptr<Capacitor> mSubParallelCapacitor1;
  std::vector<const Matrix *> mRightVectorStamps;
 
public:
  PiLine(String uid, String name, Logger::Level logLevel = Logger::Level::off);
  PiLine(String name, Logger::Level logLevel = Logger::Level::off)
      : PiLine(name, name, logLevel) {}
 
  SimPowerComp<Complex>::Ptr clone(String copySuffix) override;
 
  // #### General ####
  void createSubComponents() override;
  void initializeParentFromNodesAndTerminals(Real frequency) override;
 
  // #### MNA section ####
  void mnaCompUpdateCurrent(const Matrix &leftVector) override;
  void mnaCompUpdateVoltage(const Matrix &leftVector) override;
  void mnaParentPreStep(Real time, Int timeStepCount) override;
  void mnaParentPostStep(Real time, Int timeStepCount,
                         Attribute<Matrix>::Ptr &leftVector) override;
  void mnaParentAddPreStepDependencies(
      AttributeBase::List &prevStepDependencies,
      AttributeBase::List &attributeDependencies,
      AttributeBase::List &modifiedAttributes) override;
  void
  mnaParentAddPostStepDependencies(AttributeBase::List &prevStepDependencies,
                                   AttributeBase::List &attributeDependencies,
                                   AttributeBase::List &modifiedAttributes,
                                   Attribute<Matrix>::Ptr &leftVector) override;
 
  MNAInterface::List mnaTearGroundComponents() override;
  void mnaTearInitialize(Real omega, Real timeStep) override;
  void mnaTearApplyMatrixStamp(SparseMatrixRow &tearMatrix) override;
  void mnaTearApplyVoltageStamp(Matrix &voltageVector) override;
  void mnaTearPostStep(MatrixComp voltage, MatrixComp current) override;
};
} // namespace Ph3
} // namespace DP
} // namespace CPS