Skip to content

docs: document the 8 new algorithms; fix stale PSAF usage - #11

Open
blankjul wants to merge 2 commits into
mainfrom
docs/refresh-algorithms
Open

docs: document the 8 new algorithms; fix stale PSAF usage#11
blankjul wants to merge 2 commits into
mainfrom
docs/refresh-algorithms

Conversation

@blankjul

Copy link
Copy Markdown
Contributor

The documentation covered only GPSAF/PSAF/SSANSGA2 and predated the Bayesian-optimization algorithm suite added on this project. This brings it current.

Added

  • A Bayesian Optimization Algorithms section describing all eight (ParEGO, EHVI, MOEA/D-EGO, TSEMO, K-RVEA, CSEA, TuRBO, SAASBO) with a summary table + references.
  • Worked, executed usage examples with real output for a representative set (ParEGO, EHVI, TuRBO, K-RVEA) spanning single-/multi-/many-objective.
  • Eight rows in the rendered algorithms.csv table.

Fixed

  • PSAF usage cells: rho_min (not the misspelled max_rho, which was silently ignored) and dropped GPSAF-only n_max_infills/n_max_doe kwargs PSAF never read. Stored outputs unchanged (effective config was already the defaults).
  • Two pre-existing table bugs: PSAF-DE/GPSAF-DE mislabeled particle swarm (they're differential evolution); GPSAF-GA/DE/CMAES anchors pointed at the PSAF sections.
  • Pinned nbsphinx_execute='never' so the build renders the committed pre-executed outputs instead of re-running full optimizations.

pyclawd docs build renders cleanly; verified the new sections + example outputs appear in the HTML.

🤖 Generated with Claude Code

blankjul added 2 commits July 17, 2026 06:37
The docs covered only GPSAF/PSAF/SSANSGA2 and predated the Bayesian-optimization
algorithm suite. Bring them up to date:

- Add a "Bayesian Optimization Algorithms" section describing all eight new
  algorithms (ParEGO, EHVI, MOEA/D-EGO, TSEMO, K-RVEA, CSEA, TuRBO, SAASBO)
  with a summary table, and add worked, executed usage examples for a
  representative set (ParEGO, EHVI, TuRBO, K-RVEA) with real output.
- Fix the PSAF usage cells: rho_min (not the misspelled max_rho, which the
  algorithm silently ignored) and drop the GPSAF-only n_max_infills/n_max_doe
  kwargs PSAF never read. The stored outputs are unchanged (the effective
  config was already the defaults).
- Extend algorithms.csv with the eight algorithms and fix two pre-existing
  table bugs (PSAF-DE/GPSAF-DE mislabeled "particle swarm"; GPSAF-GA/DE/CMAES
  anchors pointed at the PSAF sections).
- Pin nbsphinx_execute='never': the notebook is pre-executed with committed
  outputs, so the build renders them instead of re-running full optimizations.
Every algorithm now has its own executed usage example: add MOEA/D-EGO, TSEMO,
CSEA and SAASBO (SAASBO shown on Sphere, where the MAP scaffold converges, with
a note that it is a scaffold). Point the algorithms-table anchors for these four
at their new sections instead of the overview.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant