Skip to content

Update documentation to use the new VOCS interface#302

Open
RemiLehe wants to merge 2 commits into
optimas-org:mainfrom
RemiLehe:fix_examples
Open

Update documentation to use the new VOCS interface#302
RemiLehe wants to merge 2 commits into
optimas-org:mainfrom
RemiLehe:fix_examples

Conversation

@RemiLehe
Copy link
Copy Markdown
Collaborator

Summary

Replaces all references to the old VaryingParameter/Objective/Parameter API with the new VOCS-based interface, keeping the documentation consistent with how the examples and generators actually work.

Changes

  • basic_setup.rst: Rewrites the setup section around a single VOCS object (variables, objectives, observables); updates the generator example to AxSingleFidelityGenerator(vocs=vocs, n_init=4).
  • analyze_output.rst: Replaces VaryingParameter/Objective/Parameter class cross-references with plain "variables, objectives, observables" terminology.
  • running_with_simulations.rst: Updates all variable/objective/observable language; replaces "analyzed parameters" with "observables" throughout.
  • ps_grid_sampling.rst, ps_line_sampling.rst: Replaces VaryingParameter references with VOCS-based wording.
  • bo_with_astra.rst: "analyzed parameters" → "observables".

The Python scripts in examples/ were already using the new interface and were verified to run correctly against the current main branch.

🤖 Generated with Claude Code

RemiLehe and others added 2 commits May 27, 2026 10:18
Replace references to the old VaryingParameter/Objective/Parameter
classes with the new VOCS-based interface throughout the user guide
and example descriptions:

- basic_setup.rst: rewrite the setup section around a single VOCS
  object; update generator instantiation to AxSingleFidelityGenerator(vocs=vocs)
- analyze_output.rst: replace class cross-refs with plain terminology
- running_with_simulations.rst: update variable/objective/observable
  language throughout
- ps_grid_sampling.rst, ps_line_sampling.rst: replace VaryingParameter
  refs with VOCS-based wording
- bo_with_astra.rst: 'analyzed parameters' → 'observables'

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
pycln v2.5.0 uses ast.Str which was removed in Python 3.12+,
causing pre-commit.ci to fail on all Python files.
v2.6.0 switches to ast.Constant for string node handling.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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