doc-string improvements

Author: basnijholt

adaptive/learner/average_learner1D.py

@@ -21,8 +21,17 @@
 class AverageLearner1D(Learner1D):
     """Learns and predicts a noisy function 'f:ℝ → ℝ^N'.
 
-    New parameters (wrt Learner1D)
-    ------------------------------
+    Parameters
+    ----------
+    function : callable
+        The function to learn. Must take a tuple of ``(seed, x)`` and
+        return a real number or vector.
+    bounds : pair of reals
+        The bounds of the interval on which to learn 'function'.
+    loss_per_interval: callable, optional
+        A function that returns the loss for a single interval of the domain.
+        If not provided, then a default is used, which uses the scaled distance
+        in the x-y plane as the loss. See the notes for more details.
     delta : float
         This parameter controls the resampling condition. A point is resampled
         if its uncertainty is larger than delta times the smallest neighboring

adaptive/learner/learner1D.py

@@ -171,7 +171,7 @@ class Learner1D(BaseLearner):
     ----------
     function : callable
         The function to learn. Must take a single real parameter and
-        return a real number.
+        return a real number or 1D array.
     bounds : pair of reals
         The bounds of the interval on which to learn 'function'.
     loss_per_interval: callable, optional