linear_system_analyzer.h

/* Copyright (C) 2004-2021 MBSim Development Team
 *
 * This library is free software; you can redistribute it and/or 
 * modify it under the terms of the GNU Lesser General Public 
 * License as published by the Free Software Foundation; either 
 * version 2.1 of the License, or (at your option) any later version. 
 *  
 * This library is distributed in the hope that it will be useful, 
 * but WITHOUT ANY WARRANTY; without even the implied warranty of 
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU 
 * Lesser General Public License for more details. 
 *  
 * You should have received a copy of the GNU Lesser General Public 
 * License along with this library; if not, write to the Free Software 
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301 USA
 *
 * Contact: martin.o.foerg@gmail.com
 */
 
#ifndef _LINEAR_SYSTEM_ANALYZER_H_
#define _LINEAR_SYSTEM_ANALYZER_H_
 
#include "mbsim/solver.h"
#include "mbsim/functions/function.h"
#include "mbsim/utils/index.h"
#include <mbsim/utils/boost_parameters.h>
 
namespace MBSim {
 
  BOOST_PARAMETER_NAME(modeNumbers)
  BOOST_PARAMETER_NAME(frequencyRange)
 
}
 
namespace MBSimControl {
 
  class LinearSystemAnalyzer : public MBSim::Solver {
    public:
      LinearSystemAnalyzer() : fRange("[0;1e4]") { }
      ~LinearSystemAnalyzer() override;
      void execute() override;
      void setInitialTime(double t0_) { t0 = t0_; }
      void setInitialInput(const fmatvec::Vec &u0_) { u0 <<= u0_; }
      void setMinimumNaturalFrequency(double fmin_) { fmin = fmin_; }
      void setMaximumNaturalFrequency(double fmax_) { fmax = fmax_; }
      void setNormalModeScaleFactor(double modeScaleFactor_) { modeScaleFactor = modeScaleFactor_; }
      void setNormalModeScale(const fmatvec::VecV &modeScale_) { modeScale <<= modeScale_; }
      void setExcitationFrequencies(const fmatvec::VecV &fex_) { fex <<= fex_; }
      void setExcitationAmplitudeFunction(MBSim::Function<fmatvec::VecV(double)> *Amp_) { Amp = Amp_; }
      void setExcitationPhaseFunction(MBSim::Function<fmatvec::VecV(double)> *Phi_) { Phi = Phi_; }
      void setPlotStepSize(double dtPlot_) { dtPlot = dtPlot_; }
      void setLoops(double loops_) { loops = loops_; }
      void initializeUsingXML(xercesc::DOMElement *element) override;
 
      BOOST_PARAMETER_MEMBER_FUNCTION( (void), visualizeNormalModes, MBSim::tag, (optional (modeNumbers,(fmatvec::VecVI),fmatvec::VecVI()))) {
    msv = true;
    modes = modeNumbers;
      }
 
      BOOST_PARAMETER_MEMBER_FUNCTION( (void), visualizeFrequencyResponse, MBSim::tag, (optional (frequencyRange,(fmatvec::Vec2),"[0;1e4]"))) {
    frv = true;
    fRange = frequencyRange;
      }
 
    protected:
      double t0{0};
      double fmin{1e-2};
      double fmax{1e5};
      double modeScaleFactor{1};
      fmatvec::VecV modeScale;
      MBSim::Function<fmatvec::VecV(double)> *Amp{nullptr};
      MBSim::Function<fmatvec::VecV(double)> *Phi{nullptr};
      fmatvec::VecV amp, phi;
      fmatvec::Vec zEq, u0, fex;
      bool msv{false};
      bool frv{false};
      bool srv{false};
      bool its{true};
      double tSpan{1};
      fmatvec::VecVI modes;
      fmatvec::Vec2 fRange;
      std::vector<fmatvec::MatVx3> fap;
      int loops{5};
      double dtPlot{1e-2};
  };
 
}
 
#endif