SP_Ph1_Load.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/CompositePowerComp.h>
#include <dpsim-models/PowerProfile.h>
#include <dpsim-models/SP/SP_Ph1_Capacitor.h>
#include <dpsim-models/SP/SP_Ph1_Inductor.h>
#include <dpsim-models/SP/SP_Ph1_PQNode.h>
#include <dpsim-models/SP/SP_Ph1_PVNode.h>
#include <dpsim-models/SP/SP_Ph1_Resistor.h>
#include <dpsim-models/SP/SP_Ph1_VDNode.h>
#include <dpsim-models/Solver/PFSolverInterfaceBus.h>
 
namespace CPS {
namespace SP {
namespace Ph1 {
class Load : public CompositePowerComp<Complex>,
             public SharedFactory<Load>,
             public PFSolverInterfaceBus {
public:
  const Attribute<Real>::Ptr mActivePower;
  const Attribute<Real>::Ptr mReactivePower;
  const Attribute<Real>::Ptr mActivePowerPerUnit;
  const Attribute<Real>::Ptr mReactivePowerPerUnit;
 
private:
  Real mNomVoltage;
  Real mBaseApparentPower;
  Real mBaseOmega;
  Real mResistance;
  Real mConductance;
  Real mReactance;
  Real mInductance;
  Real mCapacitance;

  std::shared_ptr<SP::Ph1::Inductor> mSubInductor;
  std::shared_ptr<SP::Ph1::Capacitor> mSubCapacitor;
  std::shared_ptr<SP::Ph1::Resistor> mSubResistor;
 
public:
  Load(String uid, String name, Logger::Level logLevel = Logger::Level::off);
  Load(String name, Logger::Level logLevel = Logger::Level::off)
      : Load(name, name, logLevel) {}

  void setParameters(Real activePower, Real reactivePower, Real nominalVoltage);
 
  // #### General ####
  void createSubComponents() override;
  void initializeParentFromNodesAndTerminals(Real frequency) override;
  PowerProfile mLoadProfile;
  bool use_profile = false;
  void updatePQ(Real time);
 
  // #### Powerflow section ####
  Real getNomVoltage() const;
  void calculatePerUnitParameters(Real baseApparentPower, Real baseOmega);
  void modifyPowerFlowBusType(PowerflowBusType powerflowBusType) override;
 
  // #### MNA section ####
  void mnaCompUpdateCurrent(const Matrix &leftVector) override;
  void mnaCompUpdateVoltage(const Matrix &leftVector) override;

  void mnaParentPostStep(Real time, Int timeStepCount,
                         Attribute<Matrix>::Ptr &leftVector) override;
 
  void
  mnaParentAddPostStepDependencies(AttributeBase::List &prevStepDependencies,
                                   AttributeBase::List &attributeDependencies,
                                   AttributeBase::List &modifiedAttributes,
                                   Attribute<Matrix>::Ptr &leftVector) override;
};
} // namespace Ph1
} // namespace SP
 
} // namespace CPS