HydroTurbineGovernor.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 HydroGovernorParameters : public Base::GovernorParameters,
                                public SharedFactory<HydroGovernorParameters> {
public:
  Real R = 0;
  Real T1 = 0;
  Real T2 = 0;
  Real T3 = 0;
  Real Pmax = 0;
  Real Pmin = 0;
  Real OmRef = 0;
};

class HydroTurbineGovernor : public SimSignalComp,
                             public Base::Governor,
                             public SharedFactory<HydroTurbineGovernor> {
private:
  std::shared_ptr<HydroGovernorParameters> mParameters;
 
  // ### Setpoints ###
  Real mPref = 0;
 
  // ### State variables (previous step) ###
  Real mDelOm_prev = 0;
  Real mX1_prev = 0;
  Real mX2_prev = 0;
 
  // ### State variables (current step) — loggable via .attr() ###
  const Attribute<Real>::Ptr mDelOm;
  const Attribute<Real>::Ptr mX1;
  const Attribute<Real>::Ptr mX2;
  const Attribute<Real>::Ptr mPgv;
 
  // ### Auxiliary variables computed in initializeStates ###
  Real mCa = 0;
  Real mCb = 0;
 
public:
  HydroTurbineGovernor(const String &name,
                       CPS::Logger::Level logLevel = CPS::Logger::Level::off);
 
  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