DP_Ph3_NetworkInjection.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Institute for Automation of Complex Power Systems, EONERC, RWTH Aachen University
// SPDX-License-Identifier: MPL-2.0
 
#pragma once
 
#include <dpsim-models/CompositePowerComp.h>
#include <dpsim-models/DP/DP_Ph3_VoltageSource.h>
#include <dpsim-models/Solver/MNAInterface.h>
 
namespace CPS {
namespace DP {
namespace Ph3 {
class NetworkInjection : public CompositePowerComp<Complex>,
                         public SharedFactory<NetworkInjection> {
private:
  // ### Electrical Subcomponents ###
  std::shared_ptr<DP::Ph3::VoltageSource> mSubVoltageSource;
 
  // #### solver ####
  std::vector<const Matrix *> mRightVectorStamps;
 
public:
  const CPS::Attribute<MatrixComp>::Ptr mVoltageRef;
  const CPS::Attribute<Real>::Ptr mSrcFreq;

  NetworkInjection(String uid, String name,
                   Logger::Level loglevel = Logger::Level::off);
  NetworkInjection(String name, Logger::Level logLevel = Logger::Level::off)
      : NetworkInjection(name, name, logLevel) {}

  SimPowerComp<Complex>::Ptr clone(String name) override;
 
  // #### General ####
  void initializeParentFromNodesAndTerminals(Real frequency) override;
  void setParameters(MatrixComp voltageRef, Real srcFreq = 0.0);
 
  // #### MNA Section ####
  void mnaParentApplyRightSideVectorStamp(Matrix &rightVector) override;
  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;
};
} // namespace Ph3
} // namespace DP
} // namespace CPS