SP_Ph1_SynchronGenerator.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 <limits>
 
#include <dpsim-models/MNASimPowerComp.h>
#include <dpsim-models/Solver/PFSolverInterfaceBus.h>
 
namespace CPS {
 
namespace SP {
namespace Ph1 {
 
class SynchronGenerator : public SimPowerComp<Complex>,
                          public SharedFactory<SynchronGenerator>,
                          public PFSolverInterfaceBus {
private:
  Real mBaseVoltage;
  Real mBaseApparentPower;
 
public:
  const Attribute<Real>::Ptr mSetPointActivePower;
  const Attribute<Real>::Ptr mSetPointReactivePower;
  const Attribute<Real>::Ptr mSetPointVoltage;
  const Attribute<Real>::Ptr mSetPointActivePowerPerUnit;
  const Attribute<Real>::Ptr mSetPointReactivePowerPerUnit;
  const Attribute<Real>::Ptr mSetPointVoltagePerUnit;
  const Attribute<Real>::Ptr mReactivePowerMax;
  const Attribute<Real>::Ptr mReactivePowerMin;
  const Attribute<Real>::Ptr mReactivePowerMaxPerUnit;
  const Attribute<Real>::Ptr mReactivePowerMinPerUnit;

  SynchronGenerator(String uid, String name,
                    Logger::Level logLevel = Logger::Level::off);
  SynchronGenerator(String name, Logger::Level logLevel = Logger::Level::off)
      : SynchronGenerator(name, name, logLevel) {}

  void setParameters(Real ratedApparentPower, Real ratedVoltage,
                     Real setPointActivePower, Real setPointVoltage,
                     PowerflowBusType powerflowBusType,
                     Real setPointReactivepower = 0,
                     Real qLimMax = std::numeric_limits<Real>::infinity(),
                     Real qLimMin = -std::numeric_limits<Real>::infinity());
  // #### Powerflow section ####
  Real getBaseVoltage() const;
  void setBaseVoltage(Real baseVoltage);
  void calculatePerUnitParameters(Real baseApparentPower, Real baseOmega);
  void modifyPowerFlowBusType(PowerflowBusType powerflowBusType) override;
  void updateReactivePowerInjection(Complex powerInj);
  void updatePowerInjection(Complex powerInj);
  Complex getApparentPower() const;
};
} // namespace Ph1
} // namespace SP
} // namespace CPS