Add test for sphere and torus

Fix numerical approximations inconsistencies with dim fraction exponent when generating points as grid on torus
Add notes in doc regarding the torus versions use cases

1 files changed, 5 insertions, 0 deletions

diff --git a/src/python/doc/datasets_generators.rst b/src/python/doc/datasets_generators.rst
index 2802eccd..e63dde82 100644
--- a/src/python/doc/datasets_generators.rst
+++ b/src/python/doc/datasets_generators.rst
@@ -60,6 +60,9 @@ Otherwise, if set to **'grid'**, the points are generated on a grid and would be
 
    ( [n\_samples^{1 \over {dim}}]^{dim}, 2*dim )
 
+
+**Note:** This version is recommended when the user wishes to use **'grid'** as sample type, or **'random'** with a relatively small number of samples (~ less than 150).
+
 Example
 """""""
 .. code-block:: python
@@ -81,6 +84,8 @@ The user should provide the number of points to be generated on the torus :code:
 The :code:`sample` argument is optional and is set to **'random'** by default.
 The other allowed value of sample type is **'grid'**.
 
+**Note:** This version is recommended when the user wishes to use **'random'** as sample type with a great number of samples and a low dimension.
+
 Example
 """""""
 .. code-block:: python