src/FDM/YASim/Surface.hpp

   1 #ifndef _SURFACE_HPP
   2 #define _SURFACE_HPP
   3
   4 namespace yasim {
   5
   6 // FIXME: need a "chord" member for calculating moments.  Generic
   7 // forces act at the center, but "pre-stall" lift acts towards the
   8 // front, and flaps act (in both lift and drag) toward the back.
   9 class Surface
  10 {
  11 public:
  12     Surface();
  13
  14     // Position of this surface in local coords
  15     void setPosition(float* p);
  16     void getPosition(float* out);
  17
  18     // Distance scale along the X axis
  19     void setChord(float chord);
  20
  21     // Slats act to move the stall peak by the specified angle, and
  22     // increase drag by the multiplier specified.
  23     void setSlatParams(float stallDelta, float dragPenalty);
  24
  25     // Flaps add to lift coefficient, and multiply drag.
  26     void setFlapParams(float liftAdd, float dragPenalty);
  27
  28     // Spoilers reduce the pre-stall lift, and multiply drag.
  29     void setSpoilerParams(float liftPenalty, float dragPenalty);
  30
  31     // Positions for the controls, in the range [0:1].  [-1:1] for
  32     // flaps, with positive meaning "force goes towards positive Z"
  33     void setFlap(float pos);
  34     void setSlat(float pos);
  35     void setSpoiler(float pos);
  36
  37     // local -> Surface coords
  38     void setOrientation(float* o);
  39
  40     // For variable-incidence control surfaces.  The angle is a
  41     // negative rotation about the surface's Y axis, in radians, so
  42     // positive is "up" (i.e. "positive AoA")
  43     void setIncidence(float angle);
  44
  45     void setTotalDrag(float c0);
  46     float getTotalDrag();
  47
  48     void setXDrag(float cx);
  49     void setYDrag(float cy);
  50     void setZDrag(float cz);
  51
  52     // zero-alpha Z drag ("camber") specified as a fraction of cz
  53     void setBaseZDrag(float cz0);
  54
  55     // i: 0 == forward, 1 == backwards
  56     void setStallPeak(int i, float peak);
  57
  58     // i: 0 == fwd/+z, 1 == fwd/-z, 2 == rev/+z, 3 == rev/-z
  59     void setStall(int i, float alpha);
  60     void setStallWidth(int i, float width);
  61
  62     void calcForce(float* v, float rho, float* forceOut, float* torqueOut);
  63
  64 private:
  65     float stallFunc(float* v);
  66     float controlDrag();
  67
  68     float _chord;     // X-axis size
  69     float _c0;        // total force coefficient
  70     float _cx;        // X-axis force coefficient
  71     float _cy;        // Y-axis force coefficient
  72     float _cz;        // Z-axis force coefficient
  73     float _cz0;       // Z-axis force offset
  74     float _peaks[2];  // Stall peak coefficients (fwd, back)
  75     float _stalls[4]; // Stall angles (fwd/back, pos/neg)
  76     float _widths[4]; // Stall widths  " "
  77     float _pos[3];    // position in local coords
  78     float _orient[9]; // local->surface orthonormal matrix
  79
  80     float _slatAlpha;
  81     float _slatDrag;
  82     float _flapLift;
  83     float _flapDrag;
  84     float _spoilerLift;
  85     float _spoilerDrag;
  86
  87     float _slatPos;
  88     float _flapPos;
  89     float _spoilerPos;
  90     float _incidence;
  91 };
  92
  93 }; // namespace yasim
  94 #endif // _SURFACE_HPP