improved explanation of linear interpolation in quantile

pandas-dev · Aug 18, 2023 · e91ea5e · e91ea5e
1 parent c92b370
commit e91ea5e
Showing 1 changed file with 4 additions and 2 deletions.
diff --git a/pandas/core/series.py b/pandas/core/series.py
@@ -2683,8 +2683,10 @@ def quantile(
             This optional parameter specifies the interpolation method to use,
             when the desired quantile lies between two data points `i` and `j`:
 
-                * linear: `i + (j - i) * fraction`, where `fraction` is the
-                  fractional part of the index surrounded by `i` and `j`.
+                * linear: `i + (j - i) * fraction`, where `fraction` is the proportion
+                of the distance between `i` and `j`. it refers to the relative position
+                of the desired quantile value between i and j
+                hence fraction = (desired_quantile - i) / (j - i)
                 * lower: `i`.
                 * higher: `j`.
                 * nearest: `i` or `j` whichever is nearest.