EMT_Ph3_RXLoad.h

Go to the documentation of this file.

/* 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/EMT/EMT_Ph3_Capacitor.h>
#include <dpsim-models/EMT/EMT_Ph3_Inductor.h>
#include <dpsim-models/EMT/EMT_Ph3_Resistor.h>
#include <dpsim-models/Solver/MNAInterface.h>
 
namespace CPS {
namespace EMT {
namespace Ph3 {
class RXLoad : public CompositePowerComp<Real>, public SharedFactory<RXLoad> {
protected:
  MatrixComp mPower;
  Matrix mResistance;
  Matrix mReactance;
  Matrix mInductance;
  Matrix mCapacitance;
  Bool initPowerFromTerminal = true;
  Bool mReactanceInSeries;
  std::shared_ptr<EMT::Ph3::Inductor> mSubInductor;
  std::shared_ptr<EMT::Ph3::Capacitor> mSubCapacitor;
  std::shared_ptr<EMT::Ph3::Resistor> mSubResistor;
 
public:
  const Attribute<Matrix>::Ptr mActivePower;
  const Attribute<Matrix>::Ptr mReactivePower;
  const Attribute<Real>::Ptr mNomVoltage;
  RXLoad(String uid, String name, Logger::Level logLevel = Logger::Level::off);
  RXLoad(String name, Logger::Level logLevel = Logger::Level::off);
  RXLoad(String name, Matrix activePower, Matrix reactivePower, Real volt,
         Logger::Level logLevel = Logger::Level::off);
 
  SimPowerComp<Real>::Ptr clone(String name) override;
 
  // #### General ####
  virtual String description() override {
    return fmt::format("Active: {}MW, Reactive: {}MVAr, Voltage: {}kV",
                       (**mActivePower)(0, 0) / 1e6,
                       (**mReactivePower)(0, 0) / 1e6, (**mNomVoltage) / 1e3);
  };

  void setParameters(Matrix activePower, Matrix reactivePower, Real volt,
                     bool reactanceInSeries = false);
  void createSubComponents() override;
  void initializeParentFromNodesAndTerminals(Real frequency) override;
 
  // #### MNA section ####
  void mnaCompUpdateCurrent(const Matrix &leftVector) override;
  void mnaCompUpdateVoltage(const Matrix &leftVector) override;

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