DP_Ph1_ControlledCurrentSource.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/Base/Base_Ph1_CurrentSource.h>
#include <dpsim-models/MNASimPowerComp.h>
#include <dpsim-models/Solver/MNAInterface.h>
#include <dpsim-models/Task.h>
 
namespace CPS {
namespace DP {
namespace Ph1 {
class ControlledCurrentSource : public MNASimPowerComp<Complex>,
                                public SharedFactory<ControlledCurrentSource> {
protected:
  // Updates current according to reference phasor and frequency
  void updateCurrent(Real time);
 
public:
  const Attribute<Complex>::Ptr mCurrentRef;
  ControlledCurrentSource(String uid, String name,
                          Logger::Level loglevel = Logger::Level::off);
  ControlledCurrentSource(String name,
                          Logger::Level logLevel = Logger::Level::off)
      : ControlledCurrentSource(name, name, logLevel) {}
 
  void setParameters(Complex currentRef);
 
  SimPowerComp<Complex>::Ptr clone(String name) override;
 
  // #### General ####
  void initializeFromNodesAndTerminals(Real frequency) override;
 
  // #### MNA section ####
  void mnaCompInitialize(Real omega, Real timeStep,
                         Attribute<Matrix>::Ptr leftVector) override;
  void mnaCompApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override {}
  void mnaCompApplyRightSideVectorStamp(Matrix &rightVector) override;
  void mnaCompUpdateVoltage(const Matrix &leftVector) override;

  void mnaCompAddPreStepDependencies(
      AttributeBase::List &prevStepDependencies,
      AttributeBase::List &attributeDependencies,
      AttributeBase::List &modifiedAttributes) override;
  void
  mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies,
                                 AttributeBase::List &attributeDependencies,
                                 AttributeBase::List &modifiedAttributes,
                                 Attribute<Matrix>::Ptr &leftVector) override;
  void mnaCompPreStep(Real time, Int timeStepCount) override;
  void mnaCompPostStep(Real time, Int timeStepCount,
                       Attribute<Matrix>::Ptr &leftVector) override;
};
} // namespace Ph1
} // namespace DP
} // namespace CPS