PowerControllerVSI.h

/* Copyright 2017-2021 Institute for Automation of Complex Power Systems,
 *                     EONERC, RWTH Aachen University
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
 *********************************************************************************/
 
#pragma once
 
#include <vector>
 
#include <dpsim-models/SimPowerComp.h>
#include <dpsim-models/SimSignalComp.h>
#include <dpsim-models/Task.h>
 
namespace CPS {
namespace Signal {
class PowerControllerVSI : public SimSignalComp,
                           public SharedFactory<PowerControllerVSI> {
 
protected:
  Real mTimeStep;
 
  // Power parameters
  Real mPref = 0;
  Real mQref = 0;
 
  // Power controller
  Real mOmegaCutoff;
  Real mKiPowerCtrld;
  Real mKiPowerCtrlq;
  Real mKpPowerCtrld;
  Real mKpPowerCtrlq;
 
  // Current controller
  Real mKiCurrCtrld;
  Real mKiCurrCtrlq;
  Real mKpCurrCtrld;
  Real mKpCurrCtrlq;

  Real mPInit = 0;
  Real mQInit = 0;
  Real mPhi_dInit = 0;
  Real mPhi_qInit = 0;
  Real mGamma_dInit = 0;
  Real mGamma_qInit = 0;
 
  // state space matrices
  Matrix mA = Matrix::Zero(6, 6);
  Matrix mB = Matrix::Zero(6, 6);
  Matrix mC = Matrix::Zero(2, 6);
  Matrix mD = Matrix::Zero(2, 6);
 
public:
  // attributes of input references
  const Attribute<Real>::Ptr mVc_d;
  const Attribute<Real>::Ptr mVc_q;
  const Attribute<Real>::Ptr mIrc_d;
  const Attribute<Real>::Ptr mIrc_q;
 
  // input, state and output vectors
  const Attribute<Matrix>::Ptr mInputPrev;
  const Attribute<Matrix>::Ptr mInputCurr;
  const Attribute<Matrix>::Ptr mStatePrev;
  const Attribute<Matrix>::Ptr mStateCurr;
  const Attribute<Matrix>::Ptr mOutputPrev;
  const Attribute<Matrix>::Ptr mOutputCurr;
 
  PowerControllerVSI(String name, Logger::Level logLevel = Logger::Level::off);

  void setParameters(Real Pref, Real Qref);
  void setControllerParameters(Real Kp_powerCtrl, Real Ki_powerCtrl,
                               Real Kp_currCtrl, Real Ki_currCtrl,
                               Real Omega_cutoff);
  void setInitialStateValues(Real pInit, Real qInit, Real phi_dInit,
                             Real phi_qInit, Real gamma_dInit,
                             Real gamma_qInit);

  void initializeStateSpaceModel(Real omega, Real timeStep,
                                 Attribute<Matrix>::Ptr leftVector);
  void updateBMatrixStateSpaceModel();

  void signalPreStep(Real time, Int timeStepCount);
  void signalAddPreStepDependencies(AttributeBase::List &prevStepDependencies,
                                    AttributeBase::List &attributeDependencies,
                                    AttributeBase::List &modifiedAttributes);
  void signalStep(Real time, Int timeStepCount);
  void signalAddStepDependencies(AttributeBase::List &prevStepDependencies,
                                 AttributeBase::List &attributeDependencies,
                                 AttributeBase::List &modifiedAttributes);
 
  Task::List getTasks();
 
  class PreStep : public Task {
  public:
    PreStep(PowerControllerVSI &powerControllerVSI)
        : Task(**powerControllerVSI.mName + ".PreStep"),
          mPowerControllerVSI(powerControllerVSI) {
      mPowerControllerVSI.signalAddPreStepDependencies(
          mPrevStepDependencies, mAttributeDependencies, mModifiedAttributes);
    }
    void execute(Real time, Int timeStepCount) {
      mPowerControllerVSI.signalPreStep(time, timeStepCount);
    };
 
  private:
    PowerControllerVSI &mPowerControllerVSI;
  };
  class Step : public Task {
  public:
    Step(PowerControllerVSI &powerControllerVSI)
        : Task(**powerControllerVSI.mName + ".Step"),
          mPowerControllerVSI(powerControllerVSI) {
      mPowerControllerVSI.signalAddStepDependencies(
          mPrevStepDependencies, mAttributeDependencies, mModifiedAttributes);
    }
    void execute(Real time, Int timeStepCount) {
      mPowerControllerVSI.signalStep(time, timeStepCount);
    };
 
  private:
    PowerControllerVSI &mPowerControllerVSI;
  };
};
} // namespace Signal
} // namespace CPS