DP_Ph3_SynchronGeneratorDQ.cpp

Go to the documentation of this file.

/* 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/.
 *********************************************************************************/
 
#include <dpsim-models/DP/DP_Ph3_SynchronGeneratorDQ.h>
 
//Added for testing/printing purposes:
#include <fstream>
#include <iostream>
 
using namespace CPS;
using namespace std;
 
DP::Ph3::SynchronGeneratorDQ::SynchronGeneratorDQ(String uid, String name,
                                                  Logger::Level logLevel)
    : MNASimPowerComp<Complex>(uid, name, true, true, logLevel),
      Base::SynchronGenerator(mAttributes) {
  mPhaseType = PhaseType::ABC;
  setTerminalNumber(1);
  **mIntfVoltage = MatrixComp::Zero(3, 1);
  **mIntfCurrent = MatrixComp::Zero(3, 1);
}
 
DP::Ph3::SynchronGeneratorDQ::SynchronGeneratorDQ(String name,
                                                  Logger::Level logLevel)
    : SynchronGeneratorDQ(name, name, logLevel) {}
 
DP::Ph3::SynchronGeneratorDQ::~SynchronGeneratorDQ() {}
 
void DP::Ph3::SynchronGeneratorDQ::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) {
 
  Base::SynchronGenerator::setBaseAndFundamentalPerUnitParameters(
      nomPower, nomVolt, nomFreq, nomFieldCur, poleNumber, Rs, Ll, Lmd, Lmq,
      Rfd, Llfd, Rkd, Llkd, Rkq1, Llkq1, Rkq2, Llkq2, inertia);
  Base::SynchronGenerator::setInitialValues(initActivePower, initReactivePower,
                                            initTerminalVolt, initVoltAngle,
                                            initMechPower);
}
 
void DP::Ph3::SynchronGeneratorDQ::initialize(Matrix frequencies) {
  SimPowerComp<Complex>::initialize(frequencies);
  mSystemOmega = frequencies(0, 0);
 
  // #### Compensation ####
  mCompensationOn = false;
  mCompensationCurrent = MatrixComp::Zero(3, 1);
  // Calculate real compensation resistance from per unit
  mRcomp = mRcomp * mBase_Z;
 
  // #### General setup ####
  // Create matrices for state space representation
  calcStateSpaceMatrixDQ();
 
  // steady state per unit initial value
  initPerUnitStates();
 
  mVdq0 = Matrix::Zero(3, 1);
  mIdq0 = Matrix::Zero(3, 1);
  if (mNumDampingWindings == 2) {
    mVdq0 << mVsr(0, 0), mVsr(3, 0), mVsr(6, 0);
    mIdq0 << mIsr(0, 0), mIsr(3, 0), mIsr(6, 0);
  } else {
    mVdq0 << mVsr(0, 0), mVsr(3, 0), mVsr(5, 0);
    mIdq0 << mIsr(0, 0), mIsr(3, 0), mIsr(5, 0);
  }
 
  **mIntfVoltage = mBase_V * dq0ToAbcTransform(mThetaMech, mVdq0);
  **mIntfCurrent = mBase_I * dq0ToAbcTransform(mThetaMech, mIdq0);
}
 
void DP::Ph3::SynchronGeneratorDQ::mnaCompApplySystemMatrixStamp(
    SparseMatrixRow &systemMatrix) {
  if (!mCompensationOn)
    return;
 
  Real conductance = 1. / mRcomp;
 
  if (terminalNotGrounded(0)) {
    Math::addToMatrixElement(systemMatrix, matrixNodeIndices(0)[0],
                             matrixNodeIndices(0)[0], Complex(conductance, 0));
    Math::addToMatrixElement(systemMatrix, matrixNodeIndices(0)[1],
                             matrixNodeIndices(0)[1], Complex(conductance, 0));
    Math::addToMatrixElement(systemMatrix, matrixNodeIndices(0)[2],
                             matrixNodeIndices(0)[2], Complex(conductance, 0));
    SPDLOG_LOGGER_INFO(mSLog, "Add {} to {}, {}", conductance,
                       matrixNodeIndices(0)[0], matrixNodeIndices(0)[0]);
    SPDLOG_LOGGER_INFO(mSLog, "Add {} to {}, {}", conductance,
                       matrixNodeIndices(0)[1], matrixNodeIndices(0)[1]);
    SPDLOG_LOGGER_INFO(mSLog, "Add {} to {}, {}", conductance,
                       matrixNodeIndices(0)[2], matrixNodeIndices(0)[2]);
  }
}
 
void DP::Ph3::SynchronGeneratorDQ::mnaCompApplyRightSideVectorStamp(
    Matrix &rightVector) {
  if (mCompensationOn)
    mCompensationCurrent = **mIntfVoltage / mRcomp;
 
  // If the interface current is positive, it is flowing out of the connected node and into ground.
  // Therefore, the generator is interfaced as a consumer but since the currents are reversed the equations
  // are in generator mode.
  if (terminalNotGrounded(0)) {
    Math::setVectorElement(rightVector, matrixNodeIndex(0, 0),
                           -(**mIntfCurrent)(0, 0) +
                               mCompensationCurrent(0, 0));
    Math::setVectorElement(rightVector, matrixNodeIndex(0, 1),
                           -(**mIntfCurrent)(1, 0) +
                               mCompensationCurrent(1, 0));
    Math::setVectorElement(rightVector, matrixNodeIndex(0, 2),
                           -(**mIntfCurrent)(2, 0) +
                               mCompensationCurrent(2, 0));
  }
}
 
void DP::Ph3::SynchronGeneratorDQ::mnaCompUpdateVoltage(
    const Matrix &leftVector) {
  (**mIntfVoltage)(0, 0) =
      Math::complexFromVectorElement(leftVector, matrixNodeIndex(0, 0));
  (**mIntfVoltage)(1, 0) =
      Math::complexFromVectorElement(leftVector, matrixNodeIndex(0, 1));
  (**mIntfVoltage)(2, 0) =
      Math::complexFromVectorElement(leftVector, matrixNodeIndex(0, 2));
}
 
void DP::Ph3::SynchronGeneratorDQ::mnaCompAddPostStepDependencies(
    AttributeBase::List &prevStepDependencies,
    AttributeBase::List &attributeDependencies,
    AttributeBase::List &modifiedAttributes,
    Attribute<Matrix>::Ptr &leftVector) {
  attributeDependencies.push_back(leftVector);
  modifiedAttributes.push_back(mIntfVoltage);
}
 
void DP::Ph3::SynchronGeneratorDQ::mnaCompPostStep(
    Real time, Int timeStepCount, Attribute<Matrix>::Ptr &leftVector) {
  mnaCompUpdateVoltage(**leftVector);
}
 
Real DP::Ph3::SynchronGeneratorDQ::electricalTorque() const {
  return **mElecTorque * mBase_T;
}
 
Real DP::Ph3::SynchronGeneratorDQ::rotationalSpeed() const {
  return **mOmMech * mBase_OmMech;
}
 
Real DP::Ph3::SynchronGeneratorDQ::rotorPosition() const { return mThetaMech; }
 
Matrix DP::Ph3::SynchronGeneratorDQ::abcToDq0Transform(Real theta,
                                                       MatrixComp &abcVector) {
  // Balanced case because we do not return the zero sequence component
  Complex alpha(cos(2. / 3. * PI), sin(2. / 3. * PI));
  Complex thetaCompInv(cos(-theta), sin(-theta));
 
  MatrixComp abcToPnz(3, 3);
  abcToPnz << 1, 1, 1, 1, alpha, pow(alpha, 2), 1, pow(alpha, 2), alpha;
  abcToPnz = (1. / 3.) * abcToPnz;
 
  MatrixComp pnzVector(3, 1);
  pnzVector = abcToPnz * abcVector * thetaCompInv;
 
  Matrix dq0Vector(3, 1);
  dq0Vector << pnzVector(1, 0).real(), pnzVector(1, 0).imag(), 0;
 
  return dq0Vector;
}
 
MatrixComp DP::Ph3::SynchronGeneratorDQ::dq0ToAbcTransform(Real theta,
                                                           Matrix &dq0) {
  // Balanced case because we do not consider the zero sequence component
  Complex alpha(cos(2. / 3. * PI), sin(2. / 3. * PI));
  Complex thetaComp(cos(theta), sin(theta));
  // Matrix to transform from symmetrical components to ABC
  MatrixComp pnzToAbc(3, 3);
  pnzToAbc << 1, 1, 1, 1, pow(alpha, 2), alpha, 1, alpha, pow(alpha, 2);
  // Symmetrical components vector
  MatrixComp pnzVector(3, 1);
  // Picking only d and q for positive sequence component
  pnzVector << 0, Complex(dq0(0, 0), dq0(1, 0)), 0;
  // ABC vector
  MatrixComp abcCompVector(3, 1);
  abcCompVector = pnzToAbc * pnzVector * thetaComp;
 
  return abcCompVector;
}
 
void DP::Ph3::SynchronGeneratorDQ::trapezoidalFluxStates() {}
 
void DP::Ph3::SynchronGeneratorDQ::trapezoidalCurrentStates() {}