PID-Attenuation-and-scaling.md

   1 **TPA** [***Throttle PID Attenuation***] is what allows aircraft that are optimally tuned in a cruise flight range, based on throttle or airspeed, to dynamically adjust PID gains to prevent control oscillations.
   2
   3 ## Multirotors
   4
   5 **TPA** = percentage of PID attenuation that will occur when the throttle is increased above the TPA breakpoint.
   6
   7 **TPA Breakpoint** = the throttle micro-second value in the curve at which **TPA** will begin to be applied. Below that point the PIDs are not attenuated at all.
   8
   9 ### How and Why to use this?
  10
  11 Your PID's should be tuned in a throttle range your copter will comfortably cruise at - _e.g. _1450 - 1650uS_ based on thrust to weight ratio and bank angle_. But as you increase the throttle beyond this, you may start getting oscillations. So increase the **TPA Breakpoint** to a throttle value just below the onset of oscillations. Then slowly increase **TPA** until your oscillations are gone. TPA = 20 is a good starting point. But it may need to be taken higher on more powerful copters.
  12 **Note** - On reverse motor 3D installs, TPA is not recommended.
  13 ### Example of multirotor TPA curve
  14
  15 ![](images/tpa_multirotor.png)
  16
  17 ## Airplanes
  18
  19 For airplanes **TPA** works in a different way - It not only attenuates PID gains at high throttle, but also boosts them at low throttle, allowing better control when flying or gliding at low speeds with minimal or no throttle. **TPA** is expressed as a curve that boosts PIDs below the TPA Breakpoint and attenuates them above the breakpoint.
  20
  21 **TPA** = amount of attenuation apply to the PIDs. 100% TPA allows PIDs to be scaled by a factor of `[2x boost]` `[0.4 reduction]`.
  22
  23 **TPA Breakpoint** = the point in the throttle curve at which PIDs are not boosted or attenuated.
  24
  25 **FW TPA Time Constant** = TPA smoothing and delay time constant to reflect non-instantaneous speed/throttle response of the plane.
  26
  27 ### How to use this?
  28
  29 Tune your PIDs at the throttle level you intend to fly your airplane (cruise throttle). Set that value as **TPA Breakpoint**.
  30 You will notice that when you fly at lower throttle your airplane handles more loosely. And at higher throttle (up to full throttle) it begins to oscillate. Increase **TPA** amount until these oscillations are gone or minimal. This will also translate to better handling at lower throttle values.
  31
  32
  33 The **TPA Time Constant** feature uses an asymmetric filter, that effects both increasing and decreasing throttle/speed. Meaning it delays the addition/removal of attenuation/boost for the selected time period, when the throttle is moved a set value either side of the **TPA Breakpoint**.
  34 Planes with low thrust/weight ratio generally need higher time constant for launch. While planes with a lower drag coefficient, conversely require a higher time constant, during speed wash-off; requiring the constant to be balanced.
  35
  36
  37 ### Example of airplane TPA curve
  38
  39 ![](images/tpa_airplane.png)
  40
  41 > [!NOTE]
  42 > The present airplane implementation has limits.
  43 Until airspeed support is introduced, INAV only uses the throttle for attenuation, which is relatively proportional to airspeed. But it can not attenuate the PIDs at lower throttle values if the airplane is placed into a dive as the airspeed increases.