DP_Ph1_ResIndSeries.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_Ph1_ResIndSeries.h>
 
using namespace CPS;
 
DP::Ph1::ResIndSeries::ResIndSeries(String uid, String name,
                                    Logger::Level logLevel)
    : MNASimPowerComp<Complex>(uid, name, true, true, logLevel),
      mInductance(mAttributes->create<Real>("L")),
      mResistance(mAttributes->create<Real>("R")) {
  mEquivCurrent = {0, 0};
  **mIntfVoltage = MatrixComp::Zero(1, 1);
  **mIntfCurrent = MatrixComp::Zero(1, 1);
  setTerminalNumber(2);
}

SimPowerComp<Complex>::Ptr DP::Ph1::ResIndSeries::clone(String name) {
  auto copy = ResIndSeries::make(name, mLogLevel);
  copy->setParameters(**mResistance, **mInductance);
  return copy;
}
 
void DP::Ph1::ResIndSeries::setParameters(Real resistance, Real inductance) {
  **mResistance = resistance;
  **mInductance = inductance;
}
 
void DP::Ph1::ResIndSeries::initialize(Matrix frequencies) {
  SimPowerComp<Complex>::initialize(frequencies);
 
  mEquivCurrent = MatrixComp::Zero(mNumFreqs, 1);
  mEquivCond = MatrixComp::Zero(mNumFreqs, 1);
  mPrevCurrFac = MatrixComp::Zero(mNumFreqs, 1);
}
 
void DP::Ph1::ResIndSeries::initializeFromNodesAndTerminals(Real frequency) {
 
  Real omega = 2. * PI * frequency;
  Complex impedance = {0, omega * **mInductance};
  (**mIntfVoltage)(0, 0) = initialSingleVoltage(1) - initialSingleVoltage(0);
  (**mIntfCurrent)(0, 0) = (**mIntfVoltage)(0, 0) / impedance;
 
  SPDLOG_LOGGER_INFO(mSLog,
                     "\n--- Initialization from powerflow ---"
                     "\nVoltage across: {:s}"
                     "\nCurrent: {:s}"
                     "\nTerminal 0 voltage: {:s}"
                     "\nTerminal 1 voltage: {:s}"
                     "\n--- Initialization from powerflow finished ---",
                     Logger::phasorToString((**mIntfVoltage)(0, 0)),
                     Logger::phasorToString((**mIntfCurrent)(0, 0)),
                     Logger::phasorToString(initialSingleVoltage(0)),
                     Logger::phasorToString(initialSingleVoltage(1)));
}
 
// #### MNA functions ####
 
void DP::Ph1::ResIndSeries::initVars(Real timeStep) {
  for (Int freq = 0; freq < mNumFreqs; freq++) {
    Real a = timeStep / (2. * **mInductance);
    Real b = timeStep * 2. * PI * mFrequencies(freq, 0) / 2.;
 
    Real equivCondReal = a / (1. + b * b);
    Real equivCondImag = -a * b / (1. + b * b);
    mEquivCond(freq, 0) = {equivCondReal, equivCondImag};
    Real preCurrFracReal = (1. - b * b) / (1. + b * b);
    Real preCurrFracImag = (-2. * b) / (1. + b * b);
    mPrevCurrFac(freq, 0) = {preCurrFracReal, preCurrFracImag};
 
    // TODO: check if this is correct or if it should be only computed before the step
    mEquivCurrent(freq, 0) = mEquivCond(freq, 0) * (**mIntfVoltage)(0, freq) +
                             mPrevCurrFac(freq, 0) * (**mIntfCurrent)(0, freq);
    (**mIntfCurrent)(0, freq) =
        mEquivCond(freq, 0) * (**mIntfVoltage)(0, freq) +
        mEquivCurrent(freq, 0);
  }
}
 
void DP::Ph1::ResIndSeries::mnaCompInitialize(
    Real omega, Real timeStep, Attribute<Matrix>::Ptr leftVector) {
  updateMatrixNodeIndices();
  initVars(timeStep);
 
  SPDLOG_LOGGER_INFO(mSLog,
                     "\n--- MNA initialization ---"
                     "\nInitial voltage {:s}"
                     "\nInitial current {:s}"
                     "\nEquiv. current {:s}"
                     "\n--- MNA initialization finished ---",
                     Logger::phasorToString((**mIntfVoltage)(0, 0)),
                     Logger::phasorToString((**mIntfCurrent)(0, 0)),
                     Logger::complexToString(mEquivCurrent(0, 0)));
}
 
void DP::Ph1::ResIndSeries::mnaCompInitializeHarm(
    Real omega, Real timeStep,
    std::vector<Attribute<Matrix>::Ptr> leftVectors) {
  updateMatrixNodeIndices();
 
  initVars(timeStep);
 
  mMnaTasks.push_back(std::make_shared<MnaPreStepHarm>(*this));
  mMnaTasks.push_back(std::make_shared<MnaPostStepHarm>(*this, leftVectors));
  **mRightVector = Matrix::Zero(leftVectors[0]->get().rows(), mNumFreqs);
}
 
void DP::Ph1::ResIndSeries::mnaCompApplySystemMatrixStamp(
    SparseMatrixRow &systemMatrix) {
  for (Int freq = 0; freq < mNumFreqs; freq++) {
    if (terminalNotGrounded(0))
      Math::addToMatrixElement(systemMatrix, matrixNodeIndex(0),
                               matrixNodeIndex(0), mEquivCond(freq, 0),
                               mNumFreqs, freq);
    if (terminalNotGrounded(1))
      Math::addToMatrixElement(systemMatrix, matrixNodeIndex(1),
                               matrixNodeIndex(1), mEquivCond(freq, 0),
                               mNumFreqs, freq);
    if (terminalNotGrounded(0) && terminalNotGrounded(1)) {
      Math::addToMatrixElement(systemMatrix, matrixNodeIndex(0),
                               matrixNodeIndex(1), -mEquivCond(freq, 0),
                               mNumFreqs, freq);
      Math::addToMatrixElement(systemMatrix, matrixNodeIndex(1),
                               matrixNodeIndex(0), -mEquivCond(freq, 0),
                               mNumFreqs, freq);
    }
 
    SPDLOG_LOGGER_INFO(mSLog, "-- Stamp frequency {:d} ---", freq);
    if (terminalNotGrounded(0))
      SPDLOG_LOGGER_INFO(mSLog, "Add {:s} to system at ({:d},{:d})",
                         Logger::complexToString(mEquivCond(freq, 0)),
                         matrixNodeIndex(0), matrixNodeIndex(0));
    if (terminalNotGrounded(1))
      SPDLOG_LOGGER_INFO(mSLog, "Add {:s} to system at ({:d},{:d})",
                         Logger::complexToString(mEquivCond(freq, 0)),
                         matrixNodeIndex(1), matrixNodeIndex(1));
    if (terminalNotGrounded(0) && terminalNotGrounded(1)) {
      SPDLOG_LOGGER_INFO(mSLog, "Add {:s} to system at ({:d},{:d})",
                         Logger::complexToString(-mEquivCond(freq, 0)),
                         matrixNodeIndex(0), matrixNodeIndex(1));
      SPDLOG_LOGGER_INFO(mSLog, "Add {:s} to system at ({:d},{:d})",
                         Logger::complexToString(-mEquivCond(freq, 0)),
                         matrixNodeIndex(1), matrixNodeIndex(0));
    }
  }
}
 
void DP::Ph1::ResIndSeries::mnaCompApplySystemMatrixStampHarm(
    SparseMatrixRow &systemMatrix, Int freqIdx) {
  if (terminalNotGrounded(0))
    Math::addToMatrixElement(systemMatrix, matrixNodeIndex(0),
                             matrixNodeIndex(0), mEquivCond(freqIdx, 0));
  if (terminalNotGrounded(1))
    Math::addToMatrixElement(systemMatrix, matrixNodeIndex(1),
                             matrixNodeIndex(1), mEquivCond(freqIdx, 0));
  if (terminalNotGrounded(0) && terminalNotGrounded(1)) {
    Math::addToMatrixElement(systemMatrix, matrixNodeIndex(0),
                             matrixNodeIndex(1), -mEquivCond(freqIdx, 0));
    Math::addToMatrixElement(systemMatrix, matrixNodeIndex(1),
                             matrixNodeIndex(0), -mEquivCond(freqIdx, 0));
  }
 
  SPDLOG_LOGGER_INFO(mSLog, "-- Stamp frequency {:d} ---", freqIdx);
  if (terminalNotGrounded(0))
    SPDLOG_LOGGER_INFO(mSLog, "Add {:f}+j{:f} to system at ({:d},{:d})",
                       mEquivCond(freqIdx, 0).real(),
                       mEquivCond(freqIdx, 0).imag(), matrixNodeIndex(0),
                       matrixNodeIndex(0));
  if (terminalNotGrounded(1))
    SPDLOG_LOGGER_INFO(mSLog, "Add {:f}+j{:f} to system at ({:d},{:d})",
                       mEquivCond(freqIdx, 0).real(),
                       mEquivCond(freqIdx, 0).imag(), matrixNodeIndex(1),
                       matrixNodeIndex(1));
  if (terminalNotGrounded(0) && terminalNotGrounded(1)) {
    SPDLOG_LOGGER_INFO(mSLog, "Add {:f}+j{:f} to system at ({:d},{:d})",
                       -mEquivCond(freqIdx, 0).real(),
                       -mEquivCond(freqIdx, 0).imag(), matrixNodeIndex(0),
                       matrixNodeIndex(1));
    SPDLOG_LOGGER_INFO(mSLog, "Add {:f}+j{:f} to system at ({:d},{:d})",
                       -mEquivCond(freqIdx, 0).real(),
                       -mEquivCond(freqIdx, 0).imag(), matrixNodeIndex(1),
                       matrixNodeIndex(0));
  }
}
 
void DP::Ph1::ResIndSeries::mnaCompApplyRightSideVectorStamp(
    Matrix &rightVector) {
  for (Int freq = 0; freq < mNumFreqs; freq++) {
    // Calculate equivalent current source for next time step
    mEquivCurrent(freq, 0) = mEquivCond(freq, 0) * (**mIntfVoltage)(0, freq) +
                             mPrevCurrFac(freq, 0) * (**mIntfCurrent)(0, freq);
 
    if (terminalNotGrounded(0))
      Math::setVectorElement(rightVector, matrixNodeIndex(0),
                             mEquivCurrent(freq, 0), mNumFreqs, freq);
    if (terminalNotGrounded(1))
      Math::setVectorElement(rightVector, matrixNodeIndex(1),
                             -mEquivCurrent(freq, 0), mNumFreqs, freq);
 
    SPDLOG_LOGGER_DEBUG(mSLog, "MNA EquivCurrent {:s}",
                        Logger::complexToString(mEquivCurrent(freq, 0)));
    if (terminalNotGrounded(0))
      SPDLOG_LOGGER_DEBUG(mSLog, "Add {:s} to source vector at {:d}",
                          Logger::complexToString(mEquivCurrent(freq, 0)),
                          matrixNodeIndex(0));
    if (terminalNotGrounded(1))
      SPDLOG_LOGGER_DEBUG(mSLog, "Add {:s} to source vector at {:d}",
                          Logger::complexToString(-mEquivCurrent(freq, 0)),
                          matrixNodeIndex(1));
  }
}
 
void DP::Ph1::ResIndSeries::mnaCompApplyRightSideVectorStampHarm(
    Matrix &rightVector) {
  for (Int freq = 0; freq < mNumFreqs; freq++) {
    // Calculate equivalent current source for next time step
    mEquivCurrent(freq, 0) = mEquivCond(freq, 0) * (**mIntfVoltage)(0, freq) +
                             mPrevCurrFac(freq, 0) * (**mIntfCurrent)(0, freq);
 
    if (terminalNotGrounded(0))
      Math::setVectorElement(rightVector, matrixNodeIndex(0),
                             mEquivCurrent(freq, 0), 1, 0, freq);
    if (terminalNotGrounded(1))
      Math::setVectorElement(rightVector, matrixNodeIndex(1),
                             -mEquivCurrent(freq, 0), 1, 0, freq);
  }
}
 
void mnaCompAddPreStepDependencies(AttributeBase::List &prevStepDependencies,
                                   AttributeBase::List &attributeDependencies,
                                   AttributeBase::List &modifiedAttributes) {
  // actually depends on L, but then we'd have to modify the system matrix anyway
  modifiedAttributes.push_back(mRightVector);
  prevStepDependencies.push_back(mIntfVoltage);
  prevStepDependencies.push_back(mIntfCurrent);
}
 
void DP::Ph1::ResIndSeries::mnaCompPreStep(Real time, Int timeStepCount) {
  mResIndSeries.mnaCompApplyRightSideVectorStamp(**mRightVector);
}
 
void DP::Ph1::ResIndSeries::MnaPreStepHarm::execute(Real time,
                                                    Int timeStepCount) {
  mResIndSeries.mnaCompApplyRightSideVectorStampHarm(
      **mResIndSeries.mRightVector);
}
 
void mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies,
                                    AttributeBase::List &attributeDependencies,
                                    AttributeBase::List &modifiedAttributes,
                                    Attribute<Matrix>::Ptr &leftVector) {
  attributeDependencies.push_back(leftVector);
  modifiedAttributes.push_back(mIntfVoltage);
  modifiedAttributes.push_back(mIntfCurrent);
}
 
void DP::Ph1::ResIndSeries::mnaCompPostStep(
    Real time, Int timeStepCount, Attribute<Matrix>::Ptr &leftVector) {
  mnaCompUpdateVoltage(**leftVector);
  mnaCompUpdateCurrent(**leftVector);
}
 
void DP::Ph1::ResIndSeries::MnaPostStepHarm::execute(Real time,
                                                     Int timeStepCount) {
  for (Int freq = 0; freq < mResIndSeries.mNumFreqs; freq++)
    mResIndSeries.mnaCompUpdateVoltageHarm(**mLeftVectors[freq], freq);
  mResIndSeries.mnaCompUpdateCurrentHarm();
}
 
void DP::Ph1::ResIndSeries::mnaCompUpdateVoltage(const Matrix &leftVector) {
  // v1 - v0
  for (Int freq = 0; freq < mNumFreqs; freq++) {
    (**mIntfVoltage)(0, freq) = 0;
    if (terminalNotGrounded(1))
      (**mIntfVoltage)(0, freq) = Math::complexFromVectorElement(
          leftVector, matrixNodeIndex(1), mNumFreqs, freq);
    if (terminalNotGrounded(0))
      (**mIntfVoltage)(0, freq) =
          (**mIntfVoltage)(0, freq) -
          Math::complexFromVectorElement(leftVector, matrixNodeIndex(0),
                                         mNumFreqs, freq);
 
    SPDLOG_LOGGER_DEBUG(mSLog, "Voltage {:s}",
                        Logger::phasorToString((**mIntfVoltage)(0, freq)));
  }
}
 
void DP::Ph1::ResIndSeries::mnaCompUpdateVoltageHarm(const Matrix &leftVector,
                                                     Int freqIdx) {
  // v1 - v0
  (**mIntfVoltage)(0, freqIdx) = 0;
  if (terminalNotGrounded(1))
    (**mIntfVoltage)(0, freqIdx) =
        Math::complexFromVectorElement(leftVector, matrixNodeIndex(1));
  if (terminalNotGrounded(0))
    (**mIntfVoltage)(0, freqIdx) =
        (**mIntfVoltage)(0, freqIdx) -
        Math::complexFromVectorElement(leftVector, matrixNodeIndex(0));
 
  SPDLOG_LOGGER_DEBUG(mSLog, "Voltage {:s}",
                      Logger::phasorToString((**mIntfVoltage)(0, freqIdx)));
}
 
void DP::Ph1::ResIndSeries::mnaCompUpdateCurrent(const Matrix &leftVector) {
  for (Int freq = 0; freq < mNumFreqs; freq++) {
    (**mIntfCurrent)(0, freq) =
        mEquivCond(freq, 0) * (**mIntfVoltage)(0, freq) +
        mEquivCurrent(freq, 0);
    SPDLOG_LOGGER_DEBUG(mSLog, "Current {:s}",
                        Logger::phasorToString((**mIntfCurrent)(0, freq)));
  }
}
 
void DP::Ph1::ResIndSeries::mnaCompUpdateCurrentHarm() {
  for (Int freq = 0; freq < mNumFreqs; freq++) {
    (**mIntfCurrent)(0, freq) =
        mEquivCond(freq, 0) * (**mIntfVoltage)(0, freq) +
        mEquivCurrent(freq, 0);
    SPDLOG_LOGGER_DEBUG(mSLog, "Current {:s}",
                        Logger::phasorToString((**mIntfCurrent)(0, freq)));
  }
}
 
// #### Tear Methods ####
void DP::Ph1::ResIndSeries::mnaTearInitialize(Real omega, Real timeStep) {
  initVars(timeStep);
}
 
void DP::Ph1::ResIndSeries::mnaTearApplyMatrixStamp(
    SparseMatrixRow &tearMatrix) {
  Math::addToMatrixElement(tearMatrix, mTearIdx, mTearIdx,
                           1. / mEquivCond(0, 0));
}
 
void DP::Ph1::ResIndSeries::mnaTearApplyVoltageStamp(Matrix &voltageVector) {
  mEquivCurrent(0, 0) = mEquivCond(0, 0) * (**mIntfVoltage)(0, 0) +
                        mPrevCurrFac(0, 0) * (**mIntfCurrent)(0, 0);
  Math::addToVectorElement(voltageVector, mTearIdx,
                           mEquivCurrent(0, 0) / mEquivCond(0, 0));
}
 
void DP::Ph1::ResIndSeries::mnaTearPostStep(Complex voltage, Complex current) {
  (**mIntfVoltage)(0, 0) = voltage;
  (**mIntfCurrent)(0, 0) = mEquivCond(0, 0) * voltage + mEquivCurrent(0, 0);
}