SimNode.h

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/.
 *********************************************************************************/
 
#pragma once
 
#include <dpsim-models/Task.h>
#include <dpsim-models/TopologicalNode.h>
 
namespace CPS {
 
template <typename VarType>
class SimNode : public TopologicalNode,
                public std::enable_shared_from_this<SimNode<VarType>>,
                public SharedFactory<SimNode<VarType>> {
protected:
  std::vector<UInt> mMatrixNodeIndex = {0};
  Matrix mFrequencies;
  UInt mNumFreqs = 0;
  Task::List mMnaTasks;
 
public:
  typedef VarType Type;
  typedef std::shared_ptr<SimNode<VarType>> Ptr;
  typedef std::vector<Ptr> List;
  static Ptr GND;

  const typename Attribute<MatrixVar<VarType>>::Ptr mVoltage;
  const typename Attribute<MatrixVar<VarType>>::Ptr mApparentPower;

  SimNode(String uid, String name, std::vector<UInt> matrixNodeIndex,
          PhaseType phaseType, const std::vector<Complex> &initialVoltage);
  SimNode(PhaseType phaseType = PhaseType::Single);
  SimNode(String name, PhaseType phaseType = PhaseType::Single,
          const std::vector<Complex> &initialVoltage = {0, 0, 0})
      : SimNode(name, name, {0, 0, 0}, phaseType, initialVoltage) {}

  SimNode(String uid, String name, UInt matrixNodeIndex,
          PhaseType phaseType = PhaseType::Single,
          const std::vector<Complex> &initialVoltage = {0, 0, 0})
      : SimNode(uid, name,
                {matrixNodeIndex, matrixNodeIndex + 1, matrixNodeIndex + 2},
                phaseType, initialVoltage) {}

  SimNode(UInt matrixNodeIndex, PhaseType phaseType = PhaseType::Single)
      : SimNode("N" + std::to_string(matrixNodeIndex),
                "N" + std::to_string(matrixNodeIndex), matrixNodeIndex,
                phaseType) {}
 
  std::shared_ptr<TopologicalNode> clone(String name);

  void initialize();
  void initialize(Matrix frequencies);
  UInt matrixNodeIndex(PhaseType phaseType = PhaseType::Single) override;
  std::vector<UInt> matrixNodeIndices() override;
  VarType singleVoltage(PhaseType phaseType = PhaseType::Single);
  MatrixVar<VarType> voltage();
  void setMatrixNodeIndex(UInt phase, UInt matrixNodeIndex) override;
  void setVoltage(VarType newVoltage) {}
  void setPower(VarType newPower) {}
 
  // #### MNA Section ####
  void mnaUpdateVoltage(const Matrix &leftVector);
  void mnaInitializeHarm(std::vector<Attribute<Matrix>::Ptr> leftVector);
  void mnaUpdateVoltageHarm(const Matrix &leftVector, Int freqIdx);
  const Task::List &mnaTasks();
  class MnaPostStepHarm : public Task {
  public:
    MnaPostStepHarm(SimNode &node,
                    const std::vector<Attribute<Matrix>::Ptr> &leftVectors)
        : Task(**node.mName + ".MnaPostStepHarm"), mNode(node),
          mLeftVectors(leftVectors) {
      for (UInt i = 0; i < mLeftVectors.size(); i++)
        mAttributeDependencies.push_back(mLeftVectors[i]);
      mModifiedAttributes.push_back(mNode.attribute("v"));
    }
    void execute(Real time, Int timeStepCount);
 
  private:
    SimNode &mNode;
    std::vector<Attribute<Matrix>::Ptr> mLeftVectors;
  };
};
 
namespace SP {
typedef CPS::SimNode<Complex> SimNode;
}
namespace DP {
typedef CPS::SimNode<Complex> SimNode;
}
namespace EMT {
typedef CPS::SimNode<Real> SimNode;
}
 
template <typename VarType>
typename SimNode<VarType>::Ptr SimNode<VarType>::GND = SimNode<VarType>::make();
 
template <> void SimNode<Real>::mnaUpdateVoltage(const Matrix &leftVector);
 
template <> void SimNode<Complex>::mnaUpdateVoltage(const Matrix &leftVector);
 
template <>
void SimNode<Complex>::mnaInitializeHarm(
    std::vector<Attribute<Matrix>::Ptr> leftVector);
 
template <> void SimNode<Complex>::setVoltage(Complex newVoltage);
 
template <> void SimNode<Complex>::setPower(Complex newPower);
} // namespace CPS