python/ New function generate_ndset().

 * bibkeys.txt: Add LacKlaFon2017box, Muller1959sphere, RubMel1998simulation.
 * python/doc/source/conf.py: Fix to render plotly.
 * python/examples/plot_generate.py: New.
 * python/src/moocore/_moocore.py (generate_ndset): New.
 * python/pyproject.toml: Depend on plotly.
 * python/requirements_dev.txt: Add plotly.

Author: MLopez-Ibanez

bibkeys.txt

@@ -21,10 +21,13 @@ Jen03
 JohAraMcGSch1991
 KnoCor2002cec
 KunLucPre1975jacm
+LacKlaFon2017box
 LopPaqStu09emaa
 LopVerDreDoe2025
 LopezIbanezPhD
 Molchanov2005theory
+Muller1959sphere
+RubMel1998simulation
 SchEsqLarCoe2012tec
 VelLam1998gp
 ZhoZhaJin2009igdx

python/doc/source/REFERENCES.bib

@@ -268,6 +268,17 @@ @article{KunLucPre1975jacm
   doi = {10.1145/321906.321910}
 }
 
+@article{LacKlaFon2017box,
+  author = {Renaud Lacour and  Kathrin Klamroth  and  Carlos M. Fonseca },
+  title = {A box decomposition algorithm to compute the hypervolume
+                  indicator},
+  journal = {Computers \& Operations Research},
+  year = 2017,
+  volume = 79,
+  pages = {347--360},
+  doi = {10.1016/J.COR.2016.06.021}
+}
+
 @article{LopVerDreDoe2025,
   author = { Manuel L{\'o}pez-Ib{\'a}{\~n}ez  and  Diederick Vermetten  and  Johann Dreo  and  Carola Doerr },
   title = {Using the Empirical Attainment Function for Analyzing
@@ -298,6 +309,19 @@ @article{LopVerDreDoe2025
   keywords = {EAF-based ECDF}
 }
 
+@article{Muller1959sphere,
+  author = {Mervin E. Muller},
+  title = {A Note on a Method for Generating Points Uniformly on
+                  N-Dimensional Spheres},
+  journal = {Communications of the ACM},
+  year = 1959,
+  volume = 2,
+  number = 4,
+  pages = {19--20},
+  doi = {10.1145/377939.377946},
+  keywords = {hypersphere, sampling}
+}
+
 @article{SchEsqLarCoe2012tec,
   author = { Oliver Sch{\"u}tze  and X. Esquivel and A. Lara and  Carlos A. {Coello Coello} },
   journal = {IEEE Transactions on Evolutionary Computation},
@@ -613,6 +637,15 @@ @book{Molchanov2005theory
   keywords = {Vorob'ev expectation}
 }
 
+@book{RubMel1998simulation,
+  author = {R. Y. Rubinstein and B. Melamed},
+  title = {Modern simulation and modeling},
+  year = 1998,
+  publisher = {Wiley},
+  address = { New York, NY},
+  notes = {Uniform sampling from the simplex.}
+}
+
 @inproceedings{VelLam1998gp,
   year = 1998,
   publisher = {Stanford University Bookstore},

python/doc/source/conf.py

@@ -11,21 +11,17 @@
 from datetime import date
 import sphinx
 
-# Set plotly renderer to capture _repr_html_ for sphinx-gallery
-try:
-    import plotly.io
-except ImportError:
-    pass
-else:
-    plotly.io.renderers.default = "sphinx_gallery"
-
 import os
 import sys
 
 # Building the docs requires installing the package.
 import moocore
 
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
 sys.path.insert(0, os.path.abspath("."))
+
 # Prevent ruff from deleting seemingly unused imports
 import my_unsrt_style  # noqa: F401
 
@@ -42,9 +38,10 @@
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
-html_js_files = [
-    "https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"
-]
+# FIXME: This breaks plotly rendering.
+# html_js_files = [
+#     "https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"
+# ]
 
 extensions = [
     "sphinx_design",  # grid directive
@@ -238,6 +235,16 @@ def setup(app):
     "scipy": ("https://docs.scipy.org/doc/scipy/", None),
 }
 
+# Set plotly renderer to capture _repr_html_ for sphinx-gallery
+try:
+    import plotly
+    import plotly.io as pio
+
+    pio.renderers.default = "sphinx_gallery"
+except ImportError:
+    plotly = None
+
+
 # From https://github.com/scikit-learn/scikit-learn/blob/main/doc/conf.py
 sphinx_gallery_conf = {
     "examples_dirs": "../../examples",
@@ -262,15 +269,12 @@ def setup(app):
     #     "dependencies": "./binder/requirements.txt",
     #     "use_jupyter_lab": True,
     # },
+    "image_srcset": ["2x"],
+    "nested_sections": True,
     # avoid generating too many cross links
     "inspect_global_variables": False,
     "remove_config_comments": True,
     "matplotlib_animations": True,
     # "plot_gallery": "True",
     # "recommender": {"enable": True, "n_examples": 5, "min_df": 12},
-    # "reset_modules": ("matplotlib", "seaborn"),
 }
-# if with_jupyterlite:
-#     sphinx_gallery_conf["jupyterlite"] = {
-#         "notebook_modification_function": notebook_modification_function
-#     }

python/doc/source/reference/functions.io.rst

@@ -22,3 +22,9 @@ Transform data
    apply_within_sets
 
 
+Generate data
+-------------
+.. autosummary::
+   :toctree: generated/
+
+   generate_ndset

python/doc/source/whatsnew/index.rst

@@ -7,8 +7,10 @@ What's new
 Version 0.1.9 (dev)
 -------------------
 
-- New function: :func:`~moocore.any_dominated` to quickly detect if a set is
-  nondominated.
+- New functions: :func:`~moocore.any_dominated` to quickly detect if a set is
+  nondominated and :func:`~moocore.generate_ndset` to generate random
+  nondominated sets with different shapes.
+- New example :ref:`sphx_glr_auto_examples_plot_generate.py`.
 
 
 Version 0.1.8 (15/07/2025)