EMT_Ph3_CurrentSource.h

/* Copyright 2017-2020 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/MNASimPowerComp.h>
#include <dpsim-models/Signal/CosineFMGenerator.h>
#include <dpsim-models/Signal/FrequencyRampGenerator.h>
#include <dpsim-models/Signal/SignalGenerator.h>
#include <dpsim-models/Signal/SineWaveGenerator.h>
#include <dpsim-models/Solver/MNAInterface.h>
 
namespace CPS {
namespace EMT {
namespace Ph3 {
class CurrentSource : public MNASimPowerComp<Real>,
                      public SharedFactory<CurrentSource> {
private:
  CPS::Signal::SignalGenerator::Ptr mSrcSig;
 
protected:
  // Updates current according to reference phasor and frequency
  void updateCurrent(Real time);
 
public:
  const Attribute<MatrixComp>::Ptr mCurrentRef;
  const Attribute<Real>::Ptr mSrcFreq;
  const Attribute<Complex>::Ptr mSigOut;

  CurrentSource(String uid, String name,
                Logger::Level logLevel = Logger::Level::off);
  CurrentSource(String name, Logger::Level logLevel = Logger::Level::off)
      : CurrentSource(name, name, logLevel) {}
 
  SimPowerComp<Real>::Ptr clone(String name) override;
  // #### General ####
  void initializeFromNodesAndTerminals(Real frequency) override;
  void setParameters(MatrixComp currentRef, Real srcFreq = 50.0);
  void setParameters(MatrixComp currentRef, Real freqStart, Real rocof,
                     Real timeStart, Real duration, bool smoothRamp = true);
  void setParameters(MatrixComp currentRef, Real modulationFrequency,
                     Real modulationAmplitude, Real baseFrequency = 50.0,
                     bool zigzag = false);
 
  // #### MNA section ####
  void mnaCompInitialize(Real omega, Real timeStep,
                         Attribute<Matrix>::Ptr leftVector) override;
  void mnaCompApplyRightSideVectorStamp(Matrix &rightVector) override;
  void mnaCompUpdateVoltage(const Matrix &leftVector) override;
  void mnaCompPreStep(Real time, Int timeStepCount) override;
  void mnaCompPostStep(Real time, Int timeStepCount,
                       Attribute<Matrix>::Ptr &leftVector) override;
  void mnaCompAddPreStepDependencies(
      AttributeBase::List &prevStepDependencies,
      AttributeBase::List &attributeDependencies,
      AttributeBase::List &modifiedAttributes) override;
  void
  mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies,
                                 AttributeBase::List &attributeDependencies,
                                 AttributeBase::List &modifiedAttributes,
                                 Attribute<Matrix>::Ptr &leftVector) override;
};
} // namespace Ph3
} // namespace EMT
} // namespace CPS