Exciter.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/Logger.h>
#include <dpsim-models/SimSignalComp.h>
 
namespace CPS {
namespace Signal {
class Exciter : public SimSignalComp, public SharedFactory<Exciter> {
 
private:
  // ### Exciter Parameters ####
  Real mTa;
  Real mKa;
  Real mKe;
  Real mTe;
  Real mKf;
  Real mTf;
  Real mTr;

  Real mVref = 0;
  Real mVm_prev = 0;
  Real mVis_prev = 0;
  Real mVse_prev = 0;
  Real mVr_prev = 0;
  Real mEf_prev = 0;
  Real mMaxVr;
  Real mMinVr;
 
protected:
  const Attribute<Real>::Ptr mVm;
  const Attribute<Real>::Ptr mVh;
  const Attribute<Real>::Ptr mVis;
  const Attribute<Real>::Ptr mVr;
  const Attribute<Real>::Ptr mVse;
  const Attribute<Real>::Ptr mEf;
 
public:
  explicit Exciter(const String &name) : SimSignalComp(name, name) {}
  Exciter(const String &name, CPS::Logger::Level logLevel);

  void setParameters(Real Ta, Real Ka, Real Te, Real Ke, Real Tf, Real Kf,
                     Real Tr, Real maxVr = 1.0, Real minVr = -0.9);
  void initialize(Real Vh_init, Real Vf_init);
  Real step(Real mVd, Real mVq, Real dt);
};
} // namespace Signal
} // namespace CPS