Merge pull request more-itertools#984 from more-itertools/polynomial-endianness

bbayles · web-flow · commit ee1b2fe5d8ce · 2025-04-30T14:59:49.000-05:00
Add a note about polynomial endianness
diff --git a/more_itertools/recipes.py b/more_itertools/recipes.py
@@ -760,6 +760,8 @@ def convolve(signal, kernel):
         >>> list(convolve([1, -1, -20], [1, -3]))
         [1, -4, -17, 60]
 
+    Note that polynomial coefficients are specified in descending power order.
+
     Examples of popular kinds of kernels:
 
     * The kernel ``[0.25, 0.25, 0.25, 0.25]`` computes a moving average.
@@ -905,6 +907,8 @@ def polynomial_from_roots(roots):
     >>> polynomial_from_roots(roots)  # x³ - 4 x² - 17 x + 60
     [1, -4, -17, 60]
 
+    Note that polynomial coefficients are specified in descending power order.
+
     Supports all numeric types: int, float, complex, Decimal, Fraction.
     """
     # This recipe differs from the one in itertools docs in that it
@@ -1112,6 +1116,8 @@ def polynomial_eval(coefficients, x):
     >>> polynomial_eval(coefficients, x)
     8.125
 
+    Note that polynomial coefficients are specified in descending power order.
+
     Supports all numeric types: int, float, complex, Decimal, Fraction.
     """
     n = len(coefficients)
@@ -1142,6 +1148,8 @@ def polynomial_derivative(coefficients):
     >>> derivative_coefficients
     [3, -8, -17]
 
+    Note that polynomial coefficients are specified in descending power order.
+
     Supports all numeric types: int, float, complex, Decimal, Fraction.
     """
     n = len(coefficients)
