From 8114da3da3249ca6f372bf9257e40b239ad92d12 Mon Sep 17 00:00:00 2001
From: Bas Nijholt <basnijholt@gmail.com>
Date: Wed, 6 Sep 2017 11:35:33 +0200
Subject: [PATCH] improve docstrings of Learner2D

---
 adaptive/learner.py | 27 ++++++++++-----------------
 1 file changed, 10 insertions(+), 17 deletions(-)

diff --git a/adaptive/learner.py b/adaptive/learner.py
index f72158d0..191a8f1c 100644
--- a/adaptive/learner.py
+++ b/adaptive/learner.py
@@ -489,8 +489,7 @@ class BalancingLearner(BaseLearner):
 
 
 def _max_disagreement_location_in_simplex(points, values, grad, transform):
-    """
-    Find the point of maximum disagreement between linear and quadratic model
+    """Find the point of maximum disagreement between linear and quadratic model
 
     Parameters
     ----------
@@ -589,35 +588,29 @@ def _max_disagreement_location_in_simplex(points, values, grad, transform):
 
 class Learner2D(BaseLearner):
 
-    """
-    Sample a 2-D function adaptively.
+    """Sample a 2-D function adaptively.
 
     Parameters
     ----------
+    function : callable
+        The function to learn. Must take a tuple of two real
+        parameters and return a real number.
     bounds : list of 2-tuples
         A list ``[(a1, b1), (a2, b2)]`` containing bounds,
         one per dimension.
     dtype : dtype, optional
         Type of data from function. Default: float (real-valued)
 
-    Methods
-    -------
-    sample
-        Add new samples obtained from a function.
-    add
-        Add a new sample point. Use in combination with `next()`.
-    next
-        Return next sampling point.
-
     Attributes
     ----------
     points
-        Sample points so far.
+        Sample points so far including the unknown interpolated ones.
     values
+        Sampled values so far including the unknown interpolated ones.
+    points_real
+        Sample points so far.
+    values_real
         Sampled values so far.
-    integral
-        Estimate for the N-dim integral over the bounded area,
-        based on an interpolant constructed from the samples.
 
     Notes
     -----
-- 
GitLab