EMT_Ph3_AvVoltSourceInverterStateSpace.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 <array>
#include <vector>
 
#include <dpsim-models/EMT/EMT_Ph3_TwoTerminalVTypeVariableSSNComp.h>
 
namespace CPS {
namespace EMT {
namespace Ph3 {
 
class AvVoltSourceInverterStateSpace final
    : public TwoTerminalVTypeVariableSSNComp,
      public SharedFactory<AvVoltSourceInverterStateSpace> {
private:
  static constexpr Int mStateSize = 14;
 
  enum StateIndex : Int {
    ThetaPLL = 0,
    PhiPLL = 1,
    PFiltered = 2,
    QFiltered = 3,
    PhiD = 4,
    PhiQ = 5,
    GammaD = 6,
    GammaQ = 7,
    VcA = 8,
    VcB = 9,
    VcC = 10,
    IfA = 11,
    IfB = 12,
    IfC = 13
  };
 
  Real mLf;
  Real mCf;
  Real mRf;
  Real mRc;
 
  Real mOmegaN;
  Real mKpPLL;
  Real mKiPLL;
 
  Real mOmegaCutoff;
  Real mPRef;
  Real mQRef;
  Real mKpPowerCtrl;
  Real mKiPowerCtrl;
  Real mKpCurrCtrl;
  Real mKiCurrCtrl;
 
  const Attribute<Real>::Ptr mVcD;
  const Attribute<Real>::Ptr mVcQ;
  const Attribute<Real>::Ptr mIrcD;
  const Attribute<Real>::Ptr mIrcQ;
  const Attribute<Real>::Ptr mPInst;
  const Attribute<Real>::Ptr mQInst;
  const Attribute<Real>::Ptr mOmegaPLL;
 
  Matrix getParkTransformMatrix(Real theta) const;
  Matrix getInverseParkTransformMatrix(Real theta) const;
  void buildStateSpaceModel(const Matrix &x, const Matrix &u, Matrix &A,
                            Matrix &B, Matrix &C, Matrix &D, Matrix &E,
                            Matrix &F) const;
 
protected:
  Bool updateComponentParameters() override final;
  void updateLogAttributes(const Matrix &u) const override final;
 
public:
  using SharedFactory<AvVoltSourceInverterStateSpace>::make;
 
  AvVoltSourceInverterStateSpace(String uid, String name,
                                 Logger::Level logLevel = Logger::Level::off);
  AvVoltSourceInverterStateSpace(String name,
                                 Logger::Level logLevel = Logger::Level::off)
      : AvVoltSourceInverterStateSpace(name, name, logLevel) {}
 
  std::vector<String> getLocalStateNames() const override final;
 
  std::vector<SSNComp::LocalAbcStateBlock>
  getLocalAbcStateBlocks() const override final;
 
  void setParameters(Real lf, Real cf, Real rf, Real rc, Real omegaN,
                     Real kpPLL, Real kiPLL, Real omegaCutoff, Real pRef,
                     Real qRef, Real kpPowerCtrl, Real kiPowerCtrl,
                     Real kpCurrCtrl, Real kiCurrCtrl);
 
  void initializeFromNodesAndTerminals(Real frequency) override final;
};
 
} // namespace Ph3
} // namespace EMT
} // namespace CPS