src/FDM/JSBSim/FGAerodynamics.h

   1 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   2
   3  Header:       FGAerodynamics.h
   4  Author:       Jon S. Berndt
   5  Date started: 09/13/00
   6
   7  ------------- Copyright (C) 1999  Jon S. Berndt (jsb@hal-pc.org) -------------
   8
   9  This program is free software; you can redistribute it and/or modify it under
  10  the terms of the GNU General Public License as published by the Free Software
  11  Foundation; either version 2 of the License, or (at your option) any later
  12  version.
  13
  14  This program is distributed in the hope that it will be useful, but WITHOUT
  15  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  16  FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
  17  details.
  18
  19  You should have received a copy of the GNU General Public License along with
  20  this program; if not, write to the Free Software Foundation, Inc., 59 Temple
  21  Place - Suite 330, Boston, MA  02111-1307, USA.
  22
  23  Further information about the GNU General Public License can also be found on
  24  the world wide web at http://www.gnu.org.
  25
  26 HISTORY
  27 --------------------------------------------------------------------------------
  28 09/13/00   JSB   Created
  29
  30 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  31 SENTRY
  32 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
  33
  34 #ifndef FGAERODYNAMICS_H
  35 #define FGAERODYNAMICS_H
  36
  37 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  38 INCLUDES
  39 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
  40
  41 #ifdef FGFS
  42 #  include <simgear/compiler.h>
  43 #  ifdef SG_HAVE_STD_INCLUDES
  44 #    include <vector>
  45 #    include <map>
  46 #  else
  47 #    include <vector.h>
  48 #    include <map.h>
  49 #  endif
  50 #else
  51 #  include <vector>
  52 #  include <map>
  53 #endif
  54
  55 #include "FGModel.h"
  56 #include "FGConfigFile.h"
  57 #include "FGState.h"
  58 #include "FGMassBalance.h"
  59 #include "FGTranslation.h"
  60 #include "FGCoefficient.h"
  61 #include "FGFactorGroup.h"
  62
  63 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  64 DEFINITIONS
  65 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
  66
  67 #define ID_AERODYNAMICS "$Id$"
  68
  69
  70 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  71 FORWARD DECLARATIONS
  72 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
  73
  74 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  75 COMMENTS, REFERENCES, and NOTES [use "class documentation" below for API docs]
  76 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
  77
  78 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  79 CLASS DOCUMENTATION
  80 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
  81
  82 /** Encapsulates the aerodynamic calculations.
  83     This class owns and contains the list of coefficients that define the
  84     aerodynamic properties of this aircraft. Here also, such unique phenomena
  85     as ground effect and maximum lift curve tailoff are handled.
  86     @author Jon S. Berndt
  87     @version $Id$
  88     @see -
  89 */
  90
  91 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  92 CLASS DECLARATION
  93 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
  94
  95 class FGAerodynamics : public FGModel {
  96
  97 public:
  98   /** Constructor
  99       @param Executive a pointer to the parent executive object */
 100   FGAerodynamics(FGFDMExec*);
 101   /// Destructor
 102   ~FGAerodynamics();
 103
 104   /** Runs the Aerodynamics model; called by the Executive
 105       @return false if no error */
 106   bool Run(void);
 107
 108   /** Loads the Aerodynamics model
 109       @return true if successful */
 110   bool Load(FGConfigFile* AC_cfg);
 111
 112   /** Gets the total aerodynamic force vector.
 113       @return a force vector reference. */
 114   FGColumnVector3& GetForces(void) {return vForces;}
 115   inline double GetForces(int n) const {return vForces(n);}
 116
 117   /** Gets the total aerodynamic moment vector.
 118       @return a moment vector reference. */
 119   FGColumnVector3& GetMoments(void) {return vMoments;}
 120   inline double GetMoments(int n) const {return vMoments(n);}
 121
 122   inline FGColumnVector3& GetvLastFs(void) { return vLastFs; }
 123   inline double GetvLastFs(int axis) const { return vLastFs(axis); }
 124   inline FGColumnVector3& GetvFs(void) { return vFs; }
 125   inline double GetvFs(int axis) const { return vFs(axis); }
 126   inline double GetLoD(void) const { return lod; }
 127   inline double GetClSquared(void) const { return clsq; }
 128
 129     /** Gets the strings for the current set of coefficients.
 130       @return a string containing the descriptive names for all coefficients */
 131   string GetCoefficientStrings(void);
 132
 133   /** Gets the coefficient values.
 134       @return a string containing the numeric values for the current set of
 135       coefficients */
 136   string GetCoefficientValues(void);
 137
 138   inline FGCoefficient* GetCoefficient(string name) { return cm[name]; }
 139
 140   void bind(void);
 141   void bindModel(void);
 142   void unbind(void);
 143
 144 private:
 145   typedef map<string,int> AxisIndex;
 146   AxisIndex AxisIdx;
 147   typedef vector<FGCoefficient*> CoeffArray;
 148   CoeffArray* Coeff;
 149   typedef map<string,FGCoefficient*> CoeffMap;
 150   CoeffMap cm;
 151   FGColumnVector3 vFs;
 152   FGColumnVector3 vForces;
 153   FGColumnVector3 vMoments;
 154   FGColumnVector3 vLastFs;
 155   FGColumnVector3 vDXYZcg;
 156   double clsq,lod;
 157
 158   void Debug(int from);
 159 };
 160
 161 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 162 #endif
 163