DP_Ph3_SynchronGeneratorDQ.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 <dpsim-models/Base/Base_SynchronGenerator.h>
#include <dpsim-models/MNASimPowerComp.h>
#include <dpsim-models/Solver/MNAInterface.h>
 
namespace CPS {
namespace DP {
namespace Ph3 {
class SynchronGeneratorDQ : public MNASimPowerComp<Complex>,
                            public Base::SynchronGenerator {
protected:
  MatrixComp mCompensationCurrent;

  SynchronGeneratorDQ(String name, String uid,
                      Logger::Level logLevel = Logger::Level::off);
  SynchronGeneratorDQ(String name, Logger::Level logLevel = Logger::Level::off);

  Matrix abcToDq0Transform(Real theta, MatrixComp &abc);

  MatrixComp dq0ToAbcTransform(Real theta, Matrix &dq0);
 
  // #### Deprecated ###
  void trapezoidalFluxStates();
  // calculate current states using trapezoidal rule - depcrecated
  void trapezoidalCurrentStates();
 
public:
  virtual ~SynchronGeneratorDQ();

  void setParametersFundamentalPerUnit(
      Real nomPower, Real nomVolt, Real nomFreq, Int poleNumber,
      Real nomFieldCur, Real Rs, Real Ll, Real Lmd, Real Lmq, Real Rfd,
      Real Llfd, Real Rkd, Real Llkd, Real Rkq1, Real Llkq1, Real Rkq2,
      Real Llkq2, Real inertia, Real initActivePower, Real initReactivePower,
      Real initTerminalVolt, Real initVoltAngle, Real initMechPower);

  void initialize(Real omega, Real timeStep);
  void initialize(Matrix frequencies) override;
  Real electricalTorque() const;
  Real rotationalSpeed() const;
  Real rotorPosition() const;
  void step(MatrixComp &voltage, Real time);
 
  // #### MNA Functions ####
  virtual void
  mnaCompInitialize(Real omega, Real timeStep,
                    Attribute<Matrix>::Ptr leftVector) override = 0;
  void mnaStep(Matrix &systemMatrix, Matrix &rightVector, Matrix &leftVector,
               Real time);
  void mnaCompApplyRightSideVectorStamp(Matrix &rightVector) override;
  void mnaCompApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override;

  virtual void mnaCompUpdateVoltage(const Matrix &leftVector) override;

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