SteamTurbineGovernor.h

// SPDX-FileCopyrightText: 2026 Institute for Automation of Complex Power Systems, EONERC, RWTH Aachen University
// SPDX-License-Identifier: MPL-2.0
 
#pragma once
 
#include <dpsim-models/Base/Base_Governor.h>
#include <dpsim-models/Logger.h>
#include <dpsim-models/SimSignalComp.h>
 
namespace CPS {
namespace Signal {
 
class SteamGovernorParameters : public Base::GovernorParameters,
                                public SharedFactory<SteamGovernorParameters> {
public:
  Real R = 0;
  Real T1 = 0;
  Real T2 = 0;
  Real T3 = 0;

  Real dPmax = 0;
  Real dPmin = 0;
  Real Pmax = 0;
  Real Pmin = 0;

  Real OmRef = 0;

  Real Kbc = 0;
};

class SteamTurbineGovernor : public SimSignalComp,
                             public Base::Governor,
                             public SharedFactory<SteamTurbineGovernor> {
private:
  std::shared_ptr<SteamGovernorParameters> mParameters;
 
  // ### Setpoints ###
  Real mPref = 0;
 
  // ### State variables (previous step) ###
  Real mDelOm_prev = 0;
  Real mDelOm_2prev = 0;
  Real mP1_prev = 0;
 
  // ### State variables (current step) — loggable via .attr() ###
  const Attribute<Real>::Ptr mDelOm;
  const Attribute<Real>::Ptr mP1;
  const Attribute<Real>::Ptr mP;
  const Attribute<Real>::Ptr mPgvLim;
  const Attribute<Real>::Ptr mPgv;
 
  // ### Auxiliar variables computed in initializeStates ###
  Real mCa = 0;
  Real mCb = 0;
 
  // ### Internal transient ###
  Real mDerPgv = 0;
 
public:
  explicit SteamTurbineGovernor(const String &name)
      : SimSignalComp(name, name), mDelOm(mAttributes->create<Real>("DelOm")),
        mP1(mAttributes->create<Real>("P1")),
        mP(mAttributes->create<Real>("P")),
        mPgvLim(mAttributes->create<Real>("PgvLim")),
        mPgv(mAttributes->create<Real>("Pgv")) {}
 
  SteamTurbineGovernor(const String &name, CPS::Logger::Level logLevel);
 
  void
  setParameters(std::shared_ptr<Base::GovernorParameters> parameters) final;
  void initializeStates(Real Pref) final;
  Real step(Real Omega, Real dt) final;
};
 
} // namespace Signal
} // namespace CPS