DP_Ph1_varResSwitch.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/Base/Base_Ph1_Switch.h>
#include <dpsim-models/MNASimPowerComp.h>
#include <dpsim-models/Solver/MNAInterface.h>
#include <dpsim-models/Solver/MNASwitchInterface.h>
#include <dpsim-models/Solver/MNAVariableCompInterface.h>
 
namespace CPS {
namespace DP {
namespace Ph1 {

class varResSwitch : public MNASimPowerComp<Complex>,
                     public Base::Ph1::Switch,
                     public MNAVariableCompInterface,
                     public MNASwitchInterface,
                     public SharedFactory<varResSwitch> {
 
protected:
  Real mDeltaResClosed = 0;
  Real mDeltaResOpen = 1.5;
  Real mPrevRes; // previous resistance value to multiply with rate of change
  // because we change the base value mClosedResistance & mOpenResistance to recompute the system Matrix
  // we need to save the initialisation values to use them as target values in the transition
  Real mInitClosedRes;
  Real mInitOpenRes;
 
public:
  void setInitParameters(Real timestep);

  varResSwitch(String uid, String name,
               Logger::Level logLevel = Logger::Level::off);
  varResSwitch(String name, Logger::Level logLevel = Logger::Level::off)
      : varResSwitch(name, name, logLevel) {}
 
  SimPowerComp<Complex>::Ptr clone(String name) override;
 
  // #### General ####
  void initializeFromNodesAndTerminals(Real frequency) override;
 
  // #### MNA section ####
  void mnaCompInitialize(Real omega, Real timeStep,
                         Attribute<Matrix>::Ptr leftVector) override;

  void mnaCompApplySystemMatrixStamp(SparseMatrixRow &systemMatrix) override;

  void mnaCompApplyRightSideVectorStamp(Matrix &rightVector) override;

  void mnaCompUpdateVoltage(const Matrix &leftVector) override;

  void mnaCompUpdateCurrent(const Matrix &leftVector) override;

  void mnaCompPostStep(Real time, Int timeStepCount,
                       Attribute<Matrix>::Ptr &leftVector) override;

  void
  mnaCompAddPostStepDependencies(AttributeBase::List &prevStepDependencies,
                                 AttributeBase::List &attributeDependencies,
                                 AttributeBase::List &modifiedAttributes,
                                 Attribute<Matrix>::Ptr &leftVector) override;
  Bool supportsPrecomputedSystemMatrices() const override { return false; }
 
  // #### MNA section for switch ####
  Bool mnaIsClosed() override;

  void mnaCompApplySwitchSystemMatrixStamp(Bool closed,
                                           SparseMatrixRow &systemMatrix,
                                           Int freqIdx) override;
 
  // #### MNA section for variable component ####
  Bool hasParameterChanged() override;
};
} // namespace Ph1
} // namespace DP
} // namespace CPS