Update the table of Samplers in docs#6287
Merged
y0z merged 2 commits intooptuna:masterfrom Oct 1, 2025
Merged
Conversation
Member
|
Could you review this PR? |
kAIto47802
requested changes
Oct 1, 2025
Comment on lines
+17
to
+44
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | ||
| | | AutoSampler | :class:`~optuna.samplers.RandomSampler` | :class:`~optuna.samplers.TPESampler` | :class:`~optuna.samplers.GPSampler` | :class:`~optuna.samplers.CmaEsSampler` | :class:`~optuna.samplers.NSGAIISampler` | :class:`~optuna.samplers.NSGAIIISampler` | :class:`~optuna.samplers.GridSampler` | :class:`~optuna.samplers.QMCSampler` | :class:`~optuna.samplers.BoTorchSampler` | :class:`~optuna.samplers.BruteForceSampler` | | ||
| +====================================+=================================+=========================================+======================================+=====================================+========================================+===============================================================================+===============================================================================+=======================================+======================================+==========================================+================================================================================+ | ||
| | Float parameters | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` (:math:`\color{red}\times` for infinite domain)| | ||
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | ||
| | Integer parameters | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | | ||
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | ||
| | Categorical parameters | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | | ||
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | ||
| | Pruning | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{red}\times` (:math:`\blacktriangle` for single-objective) | :math:`\color{red}\times` (:math:`\blacktriangle` for single-objective) | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | | ||
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | ||
| | Multivariate optimization | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | | ||
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | ||
| | Conditional search space | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | | ||
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | ||
| | Multi-objective optimization | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | :math:`\color{green}\checkmark` (:math:`\blacktriangle` for single-objective) | :math:`\color{green}\checkmark` (:math:`\blacktriangle` for single-objective) | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | | ||
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | ||
| | Batch optimization | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | | ||
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | ||
| | Distributed optimization | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | | ||
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | ||
| | Constrained optimization | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | :math:`\color{red}\times` | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | | ||
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | ||
| | Time complexity (per trial) (*) | N/A | :math:`O(d)` | :math:`O(dn \log n)` | :math:`O(n^3)` | :math:`O(d^3)` | :math:`O(mp^2)` (\*\*\*) | :math:`O(mp^2)` (\*\*\*) | :math:`O(dn)` | :math:`O(dn)` | :math:`O(n^3)` | :math:`O(d)` | | ||
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | ||
| | Recommended budgets (#trials) (**) | as many as one likes | as many as one likes | 100 – 1000 | – 500 | 1000 – 10000 | 100 – 10000 | 100 – 10000 | number of combinations | as many as one likes | 10 – 100 | number of combinations | | ||
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | ||
|
|
Collaborator
There was a problem hiding this comment.
Suggested change
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | |
| | | AutoSampler | :class:`~optuna.samplers.RandomSampler` | :class:`~optuna.samplers.TPESampler` | :class:`~optuna.samplers.GPSampler` | :class:`~optuna.samplers.CmaEsSampler` | :class:`~optuna.samplers.NSGAIISampler` | :class:`~optuna.samplers.NSGAIIISampler` | :class:`~optuna.samplers.GridSampler` | :class:`~optuna.samplers.QMCSampler` | :class:`~optuna.samplers.BoTorchSampler` | :class:`~optuna.samplers.BruteForceSampler` | | |
| +====================================+=================================+=========================================+======================================+=====================================+========================================+===============================================================================+===============================================================================+=======================================+======================================+==========================================+================================================================================+ | |
| | Float parameters | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` (:math:`\color{red}\times` for infinite domain)| | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | |
| | Integer parameters | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | |
| | Categorical parameters | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | |
| | Pruning | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{red}\times` (:math:`\blacktriangle` for single-objective) | :math:`\color{red}\times` (:math:`\blacktriangle` for single-objective) | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | |
| | Multivariate optimization | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | |
| | Conditional search space | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | |
| | Multi-objective optimization | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | :math:`\color{green}\checkmark` (:math:`\blacktriangle` for single-objective) | :math:`\color{green}\checkmark` (:math:`\blacktriangle` for single-objective) | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | |
| | Batch optimization | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | |
| | Distributed optimization | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | |
| | Constrained optimization | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | :math:`\color{red}\times` | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | |
| | Time complexity (per trial) (*) | N/A | :math:`O(d)` | :math:`O(dn \log n)` | :math:`O(n^3)` | :math:`O(d^3)` | :math:`O(mp^2)` (\*\*\*) | :math:`O(mp^2)` (\*\*\*) | :math:`O(dn)` | :math:`O(dn)` | :math:`O(n^3)` | :math:`O(d)` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | |
| | Recommended budgets (#trials) (**) | as many as one likes | as many as one likes | 100 – 1000 | – 500 | 1000 – 10000 | 100 – 10000 | 100 – 10000 | number of combinations | as many as one likes | 10 – 100 | number of combinations | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+------------------------------------------+--------------------------------------------------------------------------------+ | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+---------------------------------+---------------------------------------------------------------------------------+ | |
| | | |AutoSampler|_ | :class:`~optuna.samplers.RandomSampler` | :class:`~optuna.samplers.TPESampler` | :class:`~optuna.samplers.GPSampler` | :class:`~optuna.samplers.CmaEsSampler` | :class:`~optuna.samplers.NSGAIISampler` | :class:`~optuna.samplers.NSGAIIISampler` | :class:`~optuna.samplers.GridSampler` | :class:`~optuna.samplers.QMCSampler` | |BoTorchSampler|_ | :class:`~optuna.samplers.BruteForceSampler` | | |
| +====================================+=================================+=========================================+======================================+=====================================+========================================+===============================================================================+===============================================================================+=======================================+======================================+=================================+=================================================================================+ | |
| | Float parameters | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` (:math:`\color{red}\times` for infinite domain) | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+---------------------------------+---------------------------------------------------------------------------------+ | |
| | Integer parameters | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+---------------------------------+---------------------------------------------------------------------------------+ | |
| | Categorical parameters | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+---------------------------------+---------------------------------------------------------------------------------+ | |
| | Pruning | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{red}\times` (:math:`\blacktriangle` for single-objective) | :math:`\color{red}\times` (:math:`\blacktriangle` for single-objective) | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+---------------------------------+---------------------------------------------------------------------------------+ | |
| | Multivariate optimization | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+---------------------------------+---------------------------------------------------------------------------------+ | |
| | Conditional search space | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+---------------------------------+---------------------------------------------------------------------------------+ | |
| | Multi-objective optimization | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | :math:`\color{green}\checkmark` (:math:`\blacktriangle` for single-objective) | :math:`\color{green}\checkmark` (:math:`\blacktriangle` for single-objective) | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+---------------------------------+---------------------------------------------------------------------------------+ | |
| | Batch optimization | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+---------------------------------+---------------------------------------------------------------------------------+ | |
| | Distributed optimization | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\blacktriangle` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+---------------------------------+---------------------------------------------------------------------------------+ | |
| | Constrained optimization | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | :math:`\color{green}\checkmark` | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | :math:`\color{red}\times` | :math:`\color{green}\checkmark` | :math:`\color{red}\times` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+---------------------------------+---------------------------------------------------------------------------------+ | |
| | Time complexity (per trial) (*) | N/A | :math:`O(d)` | :math:`O(dn \log n)` | :math:`O(n^3)` | :math:`O(d^3)` | :math:`O(mp^2)` (\*\*\*) | :math:`O(mp^2)` (\*\*\*) | :math:`O(dn)` | :math:`O(dn)` | :math:`O(n^3)` | :math:`O(d)` | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+---------------------------------+---------------------------------------------------------------------------------+ | |
| | Recommended budgets (#trials) (**) | as many as one likes | as many as one likes | 100–1000 | –500 | 1000–10000 | 100–10000 | 100–10000 | number of combinations | as many as one likes | 10–100 | number of combinations | | |
| +------------------------------------+---------------------------------+-----------------------------------------+--------------------------------------+-------------------------------------+----------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------+---------------------------------------+--------------------------------------+---------------------------------+---------------------------------------------------------------------------------+ | |
| .. |AutoSampler| replace:: ``AutoSampler`` | |
| .. _AutoSampler: https://hub.optuna.org/samplers/auto_sampler/ | |
| .. |BoTorchSampler| replace:: ``BoTorchSampler`` | |
| .. _BoTorchSampler: https://optuna-integration.readthedocs.io/en/latest/reference/generated/optuna_integration.BoTorchSampler.html |
Collaborator
There was a problem hiding this comment.
To keep consistency with the other samplers, AutoSampler should also have a link attached. You can achieve this by using a substitution directive, which allows inline code blocks to also function as links.
Also, ":class:~optuna.samplers.BoTorchSampler" does not work, since BoTorchSampler is located in optuna_integration, not in optuna.
Furthermore, we don't insert spaces before and after the en dash (U+2013). This is defined in several style guides, including Chicago Manual of Style 1, APA Style, IEEE Editorial Style Manual, Oxford Style Manual, New Oxford Style Manual.
I also fixed the spacing around BruteForceSampler, which was slightly misaligned.
Footnotes
Collaborator
|
Thank you for the PR! I was also thinking that this table isn’t very user-friendly. Also, could you fix the order of the samplers in the autosummary section to make it consistent with the table? |
Collaborator
|
I’ve decided to address this in a follow-up PR, so I’ll go ahead and approve this one for now. |
kAIto47802
approved these changes
Oct 1, 2025
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
Changing the layout of the Samplers table would help users.
Description of the changes
Changes I made are:
NSGAIIISamplerImage:
