dlspit 2.2.0__tar.gz → 2.4.0__tar.gz

dlspit-2.2.0/README.md → dlspit-2.4.0/PKG-INFO

@@ -1,4 +1,57 @@
-# dlspit v2.2.0 — Multi-Domain Experiment Package
+Metadata-Version: 2.5
+Name: dlspit
+Version: 2.4.0
+Summary: A multi-domain experiment package: Deep Learning (MLP, CNN, ResNet, RNN, LSTM, Transformer, GAN, VAE), ML ESE Lab (regression, SVM, decision tree, random forest, XGBoost, k-means) Generative AI from scratch in NumPy (VAE, GAN, mini GPT, text-to-image, face swap, music, CycleGAN, chatbot, diffusion) and Explainable AI from scratch (SHAP, PDP, ICE, LIME, Grad-CAM, XRAI-style, Gradient x Input, LRP).
+Project-URL: Repository, https://github.com/PrathamShid07/DL_Expts
+Project-URL: Issues, https://github.com/PrathamShid07/DL_Expts/issues
+Author: DLSPIT Team Open Source Contributor
+License: MIT
+Keywords: chatbot,clustering,cnn,cyclegan,decision-tree,deep-learning,diffusion,education,explainable-ai,from-scratch,gan,generative-ai,gpt,grad-cam,interpretability,kmeans,lime,lrp,lstm,machine-learning,mlp,neural-network,numpy,pytorch,random-forest,resnet,rnn,shap,sklearn,standalone-scripts,svm,tensorflow,transformer,vae,xai,xgboost
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: numpy>=1.24
+Provides-Extra: all
+Requires-Dist: matplotlib>=3.6; extra == 'all'
+Requires-Dist: pandas>=1.5; extra == 'all'
+Requires-Dist: scikit-learn>=1.3; extra == 'all'
+Requires-Dist: scipy>=1.9; extra == 'all'
+Requires-Dist: seaborn>=0.12; extra == 'all'
+Requires-Dist: tensorflow>=2.12; extra == 'all'
+Requires-Dist: torch>=2.0; extra == 'all'
+Requires-Dist: xgboost>=1.7; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: hatchling>=1.18; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Provides-Extra: dl
+Requires-Dist: tensorflow>=2.12; extra == 'dl'
+Provides-Extra: genai
+Requires-Dist: matplotlib>=3.6; extra == 'genai'
+Requires-Dist: scikit-learn>=1.3; extra == 'genai'
+Requires-Dist: torch>=2.0; extra == 'genai'
+Provides-Extra: ml-ese
+Requires-Dist: matplotlib>=3.6; extra == 'ml-ese'
+Requires-Dist: pandas>=1.5; extra == 'ml-ese'
+Requires-Dist: scikit-learn>=1.3; extra == 'ml-ese'
+Requires-Dist: seaborn>=0.12; extra == 'ml-ese'
+Requires-Dist: xgboost>=1.7; extra == 'ml-ese'
+Provides-Extra: sklearn
+Requires-Dist: scikit-learn>=1.3; extra == 'sklearn'
+Provides-Extra: xai
+Requires-Dist: matplotlib>=3.6; extra == 'xai'
+Requires-Dist: scikit-learn>=1.3; extra == 'xai'
+Requires-Dist: scipy>=1.9; extra == 'xai'
+Description-Content-Type: text/markdown
+
+# dlspit v2.4.0 — Multi-Domain Experiment Package
 
 A pip-installable multi-domain experiment viewer and runner covering:
 
@@ -13,9 +66,9 @@ A pip-installable multi-domain experiment viewer and runner covering:
   regression, tree/KNN, SHAP, PDP, ICE, XRAI-style, Grad-CAM, LIME, Gradient × Input, LRP
   → see [Explainable AI experiments](#explainable-ai-experiments-dlspit-xai--new-in-v220)
 
-For the `DL` and `ML-ESE` domains, `dlspit` **prints the source code** of the selected experiment by default.
-Use `--run` to actually execute it. (The `GENAI` and `XAI` domains are the exception: `dlspit genai vae` and `dlspit xai shap` run
-immediately; add `--source` to print the code instead.)
+For **all four domains** (`DL`, `ML-ESE`, `GENAI`, `XAI`) `dlspit` **prints the experiment** — aim, theory, formulas and the complete
+code — by default, and `--run` executes it. For GenAI and XAI the printed code is a **standalone script**: copy it into Google Colab,
+Jupyter or a `.py` file and it runs without this package (see [GenAI and XAI: show → copy → run](#genai-and-xai-show--copy--run)).
 
 ---
 
@@ -34,9 +87,10 @@ pip install "dlspit[ml-ese]"
 # Everything
 pip install "dlspit[all]"
 
-# Generative AI (dlspit genai ...) and Explainable AI (dlspit xai ...) experiments need nothing beyond the core install
-# Optional figures for the XAI experiments (--plot):
-pip install "dlspit[xai]"
+# Showing any experiment (dlspit genai gan, dlspit xai shap, ...) needs nothing beyond the core install.
+# To RUN the standalone GenAI / XAI scripts, install what each script lists under REQUIREMENTS:
+pip install "dlspit[genai]"   # torch, matplotlib, scikit-learn
+pip install "dlspit[xai]"     # scikit-learn, scipy, matplotlib   (Grad-CAM and XRAI also need: pip install torch)
 ```
 
 ---
@@ -90,6 +144,120 @@ python -m dl_experiments ML-ESE --run random_forest
 
 ---
 
+## GenAI and XAI: show → copy → run
+
+Every GenAI and XAI experiment is a **standalone script** that starts with its title, aim, theory and formulas and then
+contains the complete code. `dlspit` prints it, exactly like it prints the ML-ESE experiments:
+
+```bash
+dlspit genai gan            # SHOW: title, aim, theory, formulas + the complete standalone code
+dlspit genai gan --run      # EXECUTE the very same script
+dlspit xai shap             # same for the XAI experiments
+dlspit xai shap --run
+dlspit genai --list         # the names (also: dlspit xai --list)
+```
+
+**Google Colab** (copy the code from the output into a cell and run it):
+
+```python
+!pip install dlspit
+!dlspit genai gan                    # shows the theory and the code
+# ... copy the code into a new cell and run it - nothing else from dlspit is needed.
+# Colab already has torch, scikit-learn, scipy and matplotlib.  Or run it directly:
+!dlspit genai gan --run
+```
+
+In a notebook you can also display it nicely, with highlighting: `from dl_experiments import show_experiment; show_experiment("genai", "gan")`
+(see the next section). In **VS Code** (or any editor) save the script with `dlspit genai gan --raw > gan.py` — `--raw` prints only the file, no banner —
+and run `python gan.py`.
+
+**Why the code can be copied:** the scripts import only NumPy, scikit-learn, scipy, matplotlib and (for the neural networks) PyTorch —
+never `dl_experiments`. Figures appear with `plt.show()` when you paste the code into a notebook cell or run it as a script
+(`!dlspit ... --run` in Colab runs in a separate process, so paste the code into a cell to *see the figures*; the printed results always appear).
+Settings you may want to change are constants at the top of each script (`SEED`, `EPOCHS`, `INSTANCE`, ...).
+
+| GenAI command | What the script shows | `pip install` | |
+|---|---|---|---|
+| `dlspit genai vae` | encoder → (μ, log σ²) → reparameterisation → decoder; reconstruction + KL loss; sampling and interpolation | `torch matplotlib numpy` | |
+| `dlspit genai gan` | generator, discriminator, BCE losses, two optimisers, training loop, generated samples | `torch matplotlib numpy` | |
+| `dlspit genai gpt` | tokenisation, embeddings, causal self-attention, next-word loss, training, text generation | `torch numpy` | |
+| `dlspit genai text-to-image` | prompt → numbers → conditional VAE that draws 8×8 pictures | `torch matplotlib numpy` | |
+| `dlspit genai face-swap` | one shared encoder + two decoders; swap = A's code through B's decoder | `torch matplotlib numpy` | |
+| `dlspit genai music` | next-note model with a genre input, sine-wave synthesis, WAV files, spectrum analysis | `numpy scikit-learn matplotlib` | |
+| `dlspit genai cyclegan` | two generators + two discriminators, adversarial + cycle loss | `torch matplotlib numpy` | |
+| `dlspit genai chatbot` | bag-of-words intent classifier with an "I did not understand" fallback | `numpy scikit-learn` | |
+| `dlspit genai diffusion` | forward noising, noise-prediction training, reverse sampling | `torch matplotlib numpy` | |
+
+| XAI command | What the script shows | `pip install` |
+|---|---|---|
+| `dlspit xai regression` | R², adjusted R², t-statistics, 95 % CI, odds ratios | `numpy scipy scikit-learn` |
+| `dlspit xai tree-knn` | decision-tree rules, impurity vs permutation importance, KNN neighbours and vote | `numpy scikit-learn matplotlib` |
+| `dlspit xai shap` | exact Shapley values and permutation-sampling approximation | `numpy scikit-learn matplotlib` |
+| `dlspit xai pdp` | partial dependence and PDP importance (numerical and categorical) | `numpy scikit-learn matplotlib` |
+| `dlspit xai ice` | ICE curves, PDP = mean of ICE, centred ICE | `numpy scikit-learn matplotlib` |
+| `dlspit xai xrai` | Integrated Gradients → fixed-grid regions → ranking (**XRAI-style**, not full XRAI) | `torch matplotlib numpy` |
+| `dlspit xai grad-cam` | gradients × feature maps → class heat map | `torch matplotlib numpy` |
+| `dlspit xai lime` | perturb, weight, weighted least squares | `numpy scikit-learn matplotlib` |
+| `dlspit xai gradient-input` | CBOW embeddings and Gradient × Input | `numpy scikit-learn` |
+| `dlspit xai lrp` | LRP-ε, relevance conservation | `numpy scikit-learn` |
+
+If a package is missing, `--run` says which one and prints the `pip install` line. All scripts use small synthetic data (nothing is downloaded,
+no pretrained model is used), fixed random seeds, and finish in roughly 1–15 seconds on a laptop CPU (no GPU needed; the first run is slower while PyTorch loads).
+
+**Also available:** the original parameterised implementations that need only NumPy (hand-written back-propagation, `--epochs`, `--samples`, ... ,
+and the Python API `dl_experiments.genai.vae.run_experiment(...)`) are still there: add `--library`, e.g.
+`dlspit genai vae --library --epochs 50` or `dlspit xai pdp --library --feature 1 --plot`; `dlspit genai vae --library --source` prints that code.
+The sections "Generative AI experiments" and "Explainable AI experiments" further below describe this library version (and contain
+viva questions and exam modifications that apply to both).
+
+---
+
+## Read an experiment in Google Colab / Jupyter
+
+Install the package in a notebook and call one function. The cell output shows the experiment's **theory** followed by its
+**complete Python source code** (syntax-highlighted), exactly as stored in the package. Nothing is executed and nothing is
+rewritten: the theory is the header docstring of the experiment's `.py` file (GenAI, XAI: title, aim, theory, formulas) or its leading
+`# THEORY` comment block (DL, ML-ESE), and the code is the file itself. For GenAI and XAI that file is the standalone script, so the
+code you see runs when you paste it into a cell.
+
+```python
+!pip install dlspit
+
+from dl_experiments import show_experiment
+
+show_experiment("genai", "chatbot")          # theory + full source of the chatbot experiment
+show_experiment("xai", "shap")               # domains: "genai", "xai", "dl", "ml-ese"
+show_experiment("dl", "4CNN")
+show_experiment("ml-ese", "decision_tree")
+```
+
+Useful options:
+
+```python
+show_experiment("xai", "grad-cam", code=False)     # theory only
+show_experiment("xai", "grad-cam", theory=False)   # code only
+show_experiment("xai", "lrp", output="text")       # force plain text (default: HTML in a notebook, text in a terminal)
+```
+
+The valid names are listed by `dl_experiments.genai.list_experiments()`, `dl_experiments.xai.list_experiments()`,
+`dl_experiments.dl.list_experiments()` and `dl_experiments.ml_ese.list_experiments()`; the same aliases as the command line work
+(`"gradcam"`, `"text_to_image"`, ...). An invalid name raises an error that lists the valid ones.
+
+To get the text itself (for example to copy it into a journal, or to print it):
+
+```python
+from dl_experiments import get_theory, get_source
+
+print(get_theory("genai", "chatbot"))        # the explanation only
+print(get_source("genai", "chatbot"))        # the complete file
+```
+
+Syntax highlighting uses Pygments, which Colab and Jupyter already include (without it the code is shown as plain monospaced
+text); no extra package is required. To *run* an experiment instead of reading it, use `dlspit genai chatbot` or
+`from dl_experiments.genai.chatbot import run_experiment`.
+
+---
+
 ## DL Experiment Index
 
 | Key                  | Description                                         |
@@ -156,20 +324,26 @@ run_experiment("decision_tree")    # executes (requires scikit-learn)
 | core     | `numpy>=1.24`                                     | Always                     |
 | `dl`     | `tensorflow>=2.12`                                | Running DL experiments     |
 | `ml-ese` | `scikit-learn`, `pandas`, `matplotlib`, `seaborn`, `xgboost` | Running ML-ESE experiments |
-| *(none)* | NumPy only (core)                                 | Running the GenAI and XAI experiments |
-| `xai`    | `matplotlib>=3.6`                                 | Optional XAI figures (`--plot`) |
+| *(none)* | NumPy only (core)                                 | Showing any experiment; running the `--library` GenAI / XAI versions |
+| `genai`  | `torch`, `matplotlib`, `scikit-learn`             | Running the standalone GenAI scripts (`--run`, or paste them) |
+| `xai`    | `scikit-learn`, `scipy`, `matplotlib`             | Running the standalone XAI scripts (Grad-CAM, XRAI also need `torch`) |
 
 ---
 
 # Generative AI experiments (`dlspit genai`) — new in v2.1.0
 
-Nine Generative AI experiments, implemented **from scratch in Python + NumPy** and designed for
+> **Which version is this section about?** `dlspit genai <name>` now shows the **standalone script** (PyTorch / scikit-learn; see
+> [show → copy → run](#genai-and-xai-show--copy--run)). This section describes the original **NumPy-only library version**
+> (`--library`, Python API `dl_experiments.genai.<module>`), including the educational substitutions, viva questions and exam
+> modifications, which apply to both. Function names in the "code walk-through" lines refer to the library modules.
+
+Nine Generative AI experiments, implemented **from scratch in Python + NumPy** (library version) and designed for
 college practical examinations:
 
 * **No pretrained models** — nothing is loaded from TensorFlow Hub, Hugging Face, PyTorch Hub, an API, …
 * **No dataset downloads** — every experiment builds a small synthetic dataset in code.
 * **No internet, no API keys, no GPU** — each experiment runs in seconds on a laptop.
-* **No TensorFlow / PyTorch needed** — the networks use a tiny NumPy toolkit with hand-written back-propagation
+* **No TensorFlow / PyTorch needed (library version)** — the networks use a tiny NumPy toolkit with hand-written back-propagation
   (`dl_experiments/genai/_nn.py`, about 350 lines, gradient-checked in the tests).
 * **Short, commented code** — one file per experiment, split into *data → model → training → demo*.
 
@@ -180,7 +354,8 @@ college practical examinations:
 ## A. Installation
 
 ```bash
-pip install dlspit            # this is all you need for the GenAI experiments (NumPy only)
+pip install dlspit            # enough for the --library versions and for showing any experiment (NumPy only)
+pip install "dlspit[genai]"   # to RUN the standalone scripts: torch, matplotlib, scikit-learn
 
 # optional extras of the other domains are unchanged:
 pip install "dlspit[dl]"      # TensorFlow, for the original DL experiments
@@ -207,7 +382,7 @@ The numbering follows the PDFs in `Genai/Expt Done Docs/`.
 | 8 | Chatbot | bag-of-words intent classifier with an "unknown" fallback | `dl_experiments.genai.chatbot` | `dlspit genai chatbot` |
 | 9 | Diffusion (DDPM) | forward noising, noise prediction, reverse sampling, schedules, guidance | `dl_experiments.genai.diffusion` | `dlspit genai diffusion` |
 
-**Required optional dependencies: none** (NumPy only) for all nine.
+**Dependencies of the library versions: none** (NumPy only). The standalone scripts need the packages listed in the table above.
 
 ### Educational substitutions (what the lab document uses → what is implemented here)
 
@@ -228,23 +403,24 @@ The numbering follows the PDFs in `Genai/Expt Done Docs/`.
 ### Command line
 
 ```bash
-dlspit genai --list                    # the nine experiments
-dlspit genai vae                       # RUN an experiment (GenAI keys run by default)
-dlspit genai gan --epochs 100          # change a parameter
-dlspit genai diffusion --samples 1000 --seed 3
-dlspit genai music --save-dir out      # also write WAV / PNG files into ./out
-dlspit genai gpt --source              # print the source code instead of running
-dlspit genai vae gan                   # several experiments in a row
-dlspit genai chatbot                   # interactive chat; type 'exit' to stop
-dlspit genai chatbot --demo            # scripted conversation instead
-python -m dl_experiments genai vae     # same thing without the console script
+dlspit genai --list                              # the nine experiments
+dlspit genai vae                                 # SHOW the standalone script (theory + code)
+dlspit genai vae --run                           # run that script
+dlspit genai vae --library                       # RUN the NumPy-only library version
+dlspit genai gan --library --epochs 100          # ... and change a parameter (options need --library)
+dlspit genai diffusion --library --samples 1000 --seed 3
+dlspit genai music --library --save-dir out      # also write WAV / PNG files into ./out
+dlspit genai gpt --library --source              # print the LIBRARY source code
+dlspit genai chatbot --library                   # interactive chat (library); type 'exit' to stop
+dlspit genai chatbot --library --demo            # scripted conversation instead
+python -m dl_experiments genai vae               # same thing without the console script
 ```
 
 Names are case-insensitive and accept `_`/`-` and a few aliases (`mini_gpt`, `text_to_image`, `faceswap`, `ddpm`, or the
 experiment number `1`–`9`). Options: `--epochs`, `--samples` (size of the synthetic training set), `--seed`,
-`--save-dir`, `--demo` (chatbot only), `--source`. An option an experiment does not have (for example `--samples` for
-`gpt`) produces a clear error. **Unlike `DL` and `ML-ESE`, which print source code unless `--run` is given, GenAI keys run
-immediately**; use `--source` to read the code.
+`--save-dir`, `--demo` (chatbot only), `--source`. These options apply to the library version, so they require `--library`
+(without it the command explains this and exits). An option an experiment does not have (for example `--samples` for `gpt`)
+produces a clear error. The standalone scripts have their settings as constants at the top of the file.
 
 ### Python
 
@@ -679,14 +855,20 @@ of Part 3 is *not* included because it needs pretrained weights. Sample quality
 
 # Explainable AI experiments (`dlspit xai`) — new in v2.2.0
 
-Ten Explainable AI (XAI) experiments, implemented **from scratch in Python + NumPy** for college practical examinations.
+> **Which version is this section about?** `dlspit xai <name>` now shows the **standalone script** (scikit-learn, and PyTorch for Grad-CAM
+> and XRAI; see [show → copy → run](#genai-and-xai-show--copy--run)). This section describes the original **NumPy-only library version**
+> (`--library`, Python API `dl_experiments.xai.<module>`) with its viva questions and exam modifications, which apply to both.
+> The standalone scripts use scikit-learn models and `torch` where this section says "NumPy only", and they have no `plot=` argument
+> (their figures are always drawn).
+
+Ten Explainable AI (XAI) experiments, implemented **from scratch in Python + NumPy** (library version) for college practical examinations.
 Every explanation method (Shapley values, PDP, ICE, LIME, Grad-CAM, Integrated Gradients / XRAI-style regions,
 Gradient × Input, LRP, …) is written out in the module itself, and each one is applied to a small model that is
 **trained here on synthetic data**.
 
 * **No pretrained models** and **no dataset downloads** — nothing is fetched from Kaggle, scikit-learn, TensorFlow Hub, etc.; no internet is needed.
-* **No XAI libraries** — the `shap`, `lime`, `captum`, … packages are *not* used (a test checks the imports), and neither are scikit-learn or scipy.
-* **NumPy only** — plots are optional (`pip install "dlspit[xai]"` adds Matplotlib). The neural networks reuse the small NumPy toolkit of the GenAI package (`dl_experiments/genai/_nn.py`).
+* **No XAI libraries** — the `shap`, `lime`, `captum`, … packages are *not* used (a test checks the imports). The library version does not use scikit-learn or scipy either; the standalone scripts do use scikit-learn / scipy for ordinary model training and the t-distribution.
+* **NumPy only (library version)** — plots are optional (`pip install "dlspit[xai]"` adds Matplotlib). The neural networks reuse the small NumPy toolkit of the GenAI package (`dl_experiments/genai/_nn.py`).
 * **Short, commented, modifiable code** — one file per experiment: data → model → explanation → demonstration.
 
 > **Honest scope.** These are *educational* implementations on toy models. They show how each algorithm works and are
@@ -696,8 +878,8 @@ Gradient × Input, LRP, …) is written out in the module itself, and each one i
 ## A. Installation
 
 ```bash
-pip install dlspit            # enough to run all ten XAI experiments (text output)
-pip install "dlspit[xai]"     # adds matplotlib, only needed for the optional figures (--plot / plot=True)
+pip install dlspit            # enough for the --library versions and for showing any experiment
+pip install "dlspit[xai]"     # to RUN the standalone scripts: scikit-learn, scipy, matplotlib (+ pip install torch for grad-cam / xrai)
 pip install "dlspit[all]"     # everything (TensorFlow, scikit-learn, pandas, matplotlib, ...)
 ```
 
@@ -744,25 +926,26 @@ The numbering follows the PDFs in `XAI/expt_details/`. The completed notebooks/P
 ### Command line
 
 ```bash
-dlspit xai --list                      # the ten experiments
-dlspit xai shap                        # RUN an experiment (XAI keys run by default)
-dlspit xai shap --instance 5           # explain a different test row
-dlspit xai pdp --feature 1 --epochs 200 --plot      # choose the feature; also draw a figure
-dlspit xai tree-knn --k 7 --instance 3
-dlspit xai grad-cam --target 0         # explain class 0 only
-dlspit xai lrp --target 0 --instance 4
-dlspit xai grad-cam --save-dir out     # also write PNG files into ./out
-dlspit xai lrp --source                # print the source code instead of running it
-dlspit xai ice xrai                    # several experiments in a row
-python -m dl_experiments xai lime      # same thing without the console script
+dlspit xai --list                               # the ten experiments
+dlspit xai shap                                 # SHOW the standalone script (theory + code)
+dlspit xai shap --run                           # run that script
+dlspit xai shap --library --instance 5          # NumPy-only library version; options need --library
+dlspit xai pdp --library --feature 1 --epochs 200 --plot      # choose the feature; also draw a figure
+dlspit xai tree-knn --library --k 7 --instance 3
+dlspit xai grad-cam --library --target 0        # explain class 0 only
+dlspit xai lrp --library --target 0 --instance 4
+dlspit xai grad-cam --library --save-dir out    # also write PNG files into ./out
+dlspit xai lrp --library --source               # print the LIBRARY source code
+dlspit xai ice xrai                             # several experiments in a row (shown)
+python -m dl_experiments xai lime               # same thing without the console script
 ```
 
 Names are case-insensitive and accept aliases (`knn`, `gradcam`, `gxi`, `linear`, `shapley`, …) or the experiment number `1`–`10`.
 Command-line options: `--epochs`, `--samples` (size of the synthetic data set), `--seed`, `--save-dir`, `--feature` (pdp, ice),
 `--target` (grad-cam, xrai, gradient-input, lrp), `--instance` (shap, lime, gradient-input, lrp, tree-knn), `--k` (tree-knn), `--plot`, `--source`.
-An option that an experiment does not have (for example `--epochs` for `regression`) produces a clear error. Parameters such as
-`epsilon`, `rule`, `kernel_width`, `grid`, `steps`, `n_grid`, `n_permutations` are Python arguments (see below). **Unlike `DL` and `ML-ESE`, XAI keys run
-immediately**; use `--source` to read the code.
+These options apply to the library version and therefore require `--library`. An option that an experiment does not have (for example
+`--epochs` for `regression`) produces a clear error. Parameters such as `epsilon`, `rule`, `kernel_width`, `grid`, `steps`, `n_grid`,
+`n_permutations` are Python arguments of the library (see below); in the standalone scripts they are constants at the top of the file.
 
 ### Python