text: /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
   Module:       FGDeadBand.cpp
   Author:       Jon S. Berndt
   Date started: 11/1999
  
   ------------- Copyright (C) 2000 -------------
  
   This program 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 of the License, or (at your option) any
   later version.
  
   This program 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 program; if not, write to the Free Software Foundation, Inc., 59
   Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  
   Further information about the GNU Lesser General Public License can also be
   found on the world wide web at http://www.gnu.org.
  
  FUNCTIONAL DESCRIPTION
  --------------------------------------------------------------------------------
  
  HISTORY
  --------------------------------------------------------------------------------
  
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  COMMENTS, REFERENCES,  and NOTES
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  INCLUDES
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
  
  #include "FGDeadBand.h"
  #include "math/FGParameterValue.h"
  
  using namespace std;
  
  namespace JSBSim {
  
  /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  CLASS IMPLEMENTATION
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
  
  //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
  FGDeadBand::FGDeadBand(FGFCS* fcs, Element* element)
    : FGFCSComponent(fcs, element)
  {
    Width = nullptr;
    gain = 1.0;
  
    Element* width_element = element->FindElement("width");
    if (width_element)
      Width = new FGParameterValue(width_element, PropertyManager);
    else
      Width = new FGRealValue(0.0);
  
    if (element->FindElement("gain"))
      gain = element->FindElementValueAsNumber("gain");
  
    bind(element);
    Debug(0);
  }
  
  //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
  FGDeadBand::~FGDeadBand()
  {
    Debug(1);
  }
  
  //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
  bool FGDeadBand::Run(void)
  {
    Input = InputNodes[0]->getDoubleValue();
  
    double HalfWidth = 0.5*Width;
  
    if (Input < -HalfWidth) {
      Output = (Input + HalfWidth)*gain;
    } else if (Input > HalfWidth) {
      Output = (Input - HalfWidth)*gain;
    } else {
      Output = 0.0;
    }
  
    Clip();
    SetOutput();
  
    return true;
  }
  
  //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  //    The bitmasked value choices are as follows:
  //    unset: In this case (the default) JSBSim would only print
  //       out the normally expected messages, essentially echoing
  //       the config files as they are read. If the environment
  //       variable is not set, debug_lvl is set to 1 internally
  //    0: This requests JSBSim not to output any messages
  //       whatsoever.
  //    1: This value explicity requests the normal JSBSim
  //       startup messages
  //    2: This value asks for a message to be printed out when
  //       a class is instantiated
  //    4: When this value is set, a message is displayed when a
  //       FGModel object executes its Run() method
  //    8: When this value is set, various runtime state variables
  //       are printed out periodically
  //    16: When set various parameters are sanity checked and
  //       a message is printed out when they go out of bounds
  
  void FGDeadBand::Debug(int from)
  {
    if (debug_lvl <= 0) return;
  
    if (debug_lvl & 1) { // Standard console startup message output
      if (from == 0) { // Constructor
        cout << "      INPUT: " << InputNodes[0]->GetName() << endl;
        cout << "      DEADBAND WIDTH: " << Width->GetName() << endl;
        cout << "      GAIN: " << gain << endl;
  
        for (auto node: OutputNodes)
          cout << "      OUTPUT: " << node->getName() << endl;
      }
    }
    if (debug_lvl & 2 ) { // Instantiation/Destruction notification
      if (from == 0) cout << "Instantiated: FGDeadBand" << endl;
      if (from == 1) cout << "Destroyed:    FGDeadBand" << endl;
    }
    if (debug_lvl & 4 ) { // Run() method entry print for FGModel-derived objects
    }
    if (debug_lvl & 8 ) { // Runtime state variables
    }
    if (debug_lvl & 16) { // Sanity checking
    }
    if (debug_lvl & 64) {
      if (from == 0) { // Constructor
      }
    }
  }
  }
  