From 177277fd6dc640eafb0f454db2c799d41b690fbe Mon Sep 17 00:00:00 2001 From: Aamir Yaqoob Date: Mon, 24 Jun 2024 17:18:33 +0500 Subject: [PATCH] In reStructuredText files, one-off hyperlinks replaced with two trailing underscores rather than a single trailing underscore. --- docs/source/faq.rst | 28 +++++++++---------- docs/source/index.rst | 6 ++-- docs/source/reference/importance.rst | 2 +- docs/source/reference/integration.rst | 4 +-- docs/source/reference/samplers/index.rst | 2 +- docs/source/reference/terminator.rst | 2 +- docs/source/reference/visualization/index.rst | 2 +- docs/source/tutorial/index.rst | 6 ++-- tutorial/10_key_features/README.rst | 2 +- 9 files changed, 27 insertions(+), 27 deletions(-) diff --git a/docs/source/faq.rst b/docs/source/faq.rst index c1c712c1f0..dab202e19c 100644 --- a/docs/source/faq.rst +++ b/docs/source/faq.rst @@ -8,7 +8,7 @@ Can I use Optuna with X? (where X is your favorite ML library) -------------------------------------------------------------- Optuna is compatible with most ML libraries, and it's easy to use Optuna with those. -Please refer to `examples `_. +Please refer to `examples `__. .. _objective-func-additional-args: @@ -63,7 +63,7 @@ Below is an example that uses ``lambda``: study = optuna.create_study() study.optimize(lambda trial: objective(trial, min_x, max_x), n_trials=100) -Please also refer to `sklearn_additional_args.py `_ example, +Please also refer to `sklearn_additional_args.py `__ example, which reuses the dataset instead of loading it in each trial execution. @@ -116,7 +116,7 @@ And to resume the study: Note that Optuna does not support saving/reloading across different Optuna versions with ``pickle``. To save/reload a study across different Optuna versions, -please use RDBs and `upgrade storage schema `_ +please use RDBs and `upgrade storage schema `__ if necessary. If you are using RDBs, see :ref:`rdb` for more details. How to suppress log messages of Optuna? @@ -274,7 +274,7 @@ If your optimization target supports GPU (CUDA) acceleration and you want to spe $ export CUDA_VISIBLE_DEVICES=1 $ python main.py -Please refer to `CUDA C Programming Guide `_ for further details. +Please refer to `CUDA C Programming Guide `__ for further details. How can I test my objective functions? @@ -382,7 +382,7 @@ How do I suggest variables which represent the proportion, that is, are in accor When you want to suggest :math:`n` variables which represent the proportion, that is, :math:`p[0], p[1], ..., p[n-1]` which satisfy :math:`0 \le p[k] \le 1` for any :math:`k` and :math:`p[0] + p[1] + ... + p[n-1] = 1`, try the below. For example, these variables can be used as weights when interpolating the loss functions. -These variables are in accordance with the flat `Dirichlet distribution `_. +These variables are in accordance with the flat `Dirichlet distribution `__. .. code-block:: python @@ -433,7 +433,7 @@ You can verify the transformation by calculating the elements of the Jacobian. How can I optimize a model with some constraints? ------------------------------------------------- -When you want to optimize a model with constraints, you can use the following classes: :class:`~optuna.samplers.TPESampler`, :class:`~optuna.samplers.NSGAIISampler` or `BoTorchSampler `_. +When you want to optimize a model with constraints, you can use the following classes: :class:`~optuna.samplers.TPESampler`, :class:`~optuna.samplers.NSGAIISampler` or `BoTorchSampler `__. The following example is a benchmark of Binh and Korn function, a multi-objective optimization, with constraints using :class:`~optuna.samplers.NSGAIISampler`. This one has two constraints :math:`c_0 = (x-5)^2 + y^2 - 25 \le 0` and :math:`c_1 = -(x - 8)^2 - (y + 3)^2 + 7.7 \le 0` and finds the optimal solution satisfying these constraints. @@ -488,7 +488,7 @@ The following example is a benchmark of Binh and Korn function, a multi-objectiv ) print(" Params: {}".format(trial.params)) -If you are interested in an example for `BoTorchSampler `_, please refer to `this sample code `_. +If you are interested in an example for `BoTorchSampler `__, please refer to `this sample code `__. There are two kinds of constrained optimizations, one with soft constraints and the other with hard constraints. @@ -541,12 +541,12 @@ How can I solve the error that occurs when performing parallel optimization with We would never recommend SQLite3 for parallel optimization in the following reasons. -- To concurrently evaluate trials enqueued by :func:`~optuna.study.Study.enqueue_trial`, :class:`~optuna.storages.RDBStorage` uses `SELECT ... FOR UPDATE` syntax, which is unsupported in `SQLite3 `_. -- As described in `the SQLAlchemy's documentation `_, +- To concurrently evaluate trials enqueued by :func:`~optuna.study.Study.enqueue_trial`, :class:`~optuna.storages.RDBStorage` uses `SELECT ... FOR UPDATE` syntax, which is unsupported in `SQLite3 `__. +- As described in `the SQLAlchemy's documentation `__, SQLite3 (and pysqlite driver) does not support a high level of concurrency. You may get a "database is locked" error, which occurs when one thread or process has an exclusive lock on a database connection (in reality a file handle) and another thread times out waiting for the lock to be released. - You can increase the default `timeout `_ value like `optuna.storages.RDBStorage("sqlite:///example.db", engine_kwargs={"connect_args": {"timeout": 20.0}})` though. -- For distributed optimization via NFS, SQLite3 does not work as described at `FAQ section of sqlite.org `_. + You can increase the default `timeout `__ value like `optuna.storages.RDBStorage("sqlite:///example.db", engine_kwargs={"connect_args": {"timeout": 20.0}})` though. +- For distributed optimization via NFS, SQLite3 does not work as described at `FAQ section of sqlite.org `__. If you want to use a file-based Optuna storage for these scenarios, please consider using :class:`~optuna.storages.JournalFileStorage` instead. @@ -559,7 +559,7 @@ If you want to use a file-based Optuna storage for these scenarios, please consi study = optuna.create_study(storage=storage) ... -See `the Medium blog post `_ for details. +See `the Medium blog post `__ for details. .. _heartbeat_monitoring: @@ -572,7 +572,7 @@ Can I monitor trials and make them failed automatically when they are killed une A process running a trial could be killed unexpectedly, typically by a job scheduler in a cluster environment. If trials are killed unexpectedly, they will be left on the storage with their states `RUNNING` until we remove them or update their state manually. -For such a case, Optuna supports monitoring trials using `heartbeat `_ mechanism. +For such a case, Optuna supports monitoring trials using `heartbeat `__ mechanism. Using heartbeat, if a process running a trial is killed unexpectedly, Optuna will automatically change the state of the trial that was running on that process to :obj:`~optuna.trial.TrialState.FAIL` from :obj:`~optuna.trial.TrialState.RUNNING`. @@ -622,7 +622,7 @@ How can I deal with permutation as a parameter? Although it is not straightforward to deal with combinatorial search spaces like permutations with existing API, there exists a convenient technique for handling them. It involves re-parametrization of permutation search space of :math:`n` items as an independent :math:`n`-dimensional integer search space. -This technique is based on the concept of `Lehmer code `_. +This technique is based on the concept of `Lehmer code `__. A Lehmer code of a sequence is the sequence of integers in the same size, whose :math:`i`-th entry denotes how many inversions the :math:`i`-th entry of the permutation has after itself. In other words, the :math:`i`-th entry of the Lehmer code represents the number of entries that are located after and are smaller than the :math:`i`-th entry of the original sequence. diff --git a/docs/source/index.rst b/docs/source/index.rst index 86cf4a09a4..699401137d 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -82,9 +82,9 @@ optimization *studies*. Web Dashboard ------------- -`Optuna Dashboard `_ is a real-time web dashboard for Optuna. +`Optuna Dashboard `__ is a real-time web dashboard for Optuna. You can check the optimization history, hyperparameter importance, etc. in graphs and tables. -You don't need to create a Python script to call `Optuna's visualization `_ functions. +You don't need to create a Python script to call `Optuna's visualization `__ functions. Feature requests and bug reports are welcome! .. image:: https://user-images.githubusercontent.com/5564044/204975098-95c2cb8c-0fb5-4388-abc4-da32f56cb4e5.gif @@ -97,7 +97,7 @@ Feature requests and bug reports are welcome! .. TIP:: - Please check out the `getting started `_ section of Optuna Dashboard's official documentation. + Please check out the `getting started `__ section of Optuna Dashboard's official documentation. Communication ------------- diff --git a/docs/source/reference/importance.rst b/docs/source/reference/importance.rst index b73d73164f..51fe18bac2 100644 --- a/docs/source/reference/importance.rst +++ b/docs/source/reference/importance.rst @@ -8,7 +8,7 @@ The :mod:`~optuna.importance` module provides functionality for evaluating hyper .. note:: :class:`~optuna.importance.FanovaImportanceEvaluator` takes over 1 minute when given a study that contains 1000+ trials. - We published `optuna-fast-fanova `_ library, + We published `optuna-fast-fanova `__ library, that is a Cython accelerated fANOVA implementation. By using it, you can get hyperparameter importances within a few seconds. If ``n_trials`` is more than 10000, the Cython implementation takes more than a minute, so you can use :class:`~optuna.importance.PedAnovaImportanceEvaluator` instead, enabling the evaluation to finish in a second. diff --git a/docs/source/reference/integration.rst b/docs/source/reference/integration.rst index 1be9013325..18cbfd10e7 100644 --- a/docs/source/reference/integration.rst +++ b/docs/source/reference/integration.rst @@ -7,8 +7,8 @@ The :mod:`~optuna.integration` module contains classes used to integrate Optuna .. note:: Optuna's integration modules for third-party libraries have started migrating from Optuna itself to a package called - `optuna-integration`. Please check the `repository `_ and - the `documentation `_. + `optuna-integration`. Please check the `repository `__ and + the `documentation `__. For most of the ML frameworks supported by Optuna, the corresponding Optuna integration class serves only to implement a callback object and functions, compliant with the framework's specific callback API, to be called with each intermediate step in the model training. The functionality implemented in these callbacks across the different ML frameworks includes: diff --git a/docs/source/reference/samplers/index.rst b/docs/source/reference/samplers/index.rst index 6e6b0d9126..7560671e11 100644 --- a/docs/source/reference/samplers/index.rst +++ b/docs/source/reference/samplers/index.rst @@ -76,7 +76,7 @@ The :mod:`~optuna.samplers` module defines a base class for parameter sampling a For distributed optimization, see :ref:`distributed` tutorial. Note that the ``constant_liar`` option of :class:`~optuna.samplers.TPESampler` allows :class:`~optuna.samplers.TPESampler` to handle the distributed optimization. - For constrained optimization, see an `example `_. + For constrained optimization, see an `example `__. .. autosummary:: :toctree: generated/ diff --git a/docs/source/reference/terminator.rst b/docs/source/reference/terminator.rst index be6812cbc3..f970e246f7 100644 --- a/docs/source/reference/terminator.rst +++ b/docs/source/reference/terminator.rst @@ -20,4 +20,4 @@ The :mod:`~optuna.terminator` module implements a mechanism for automatically te optuna.terminator.TerminatorCallback optuna.terminator.report_cross_validation_scores -For an example of using this module, please refer to `this example `_. \ No newline at end of file +For an example of using this module, please refer to `this example `__. \ No newline at end of file diff --git a/docs/source/reference/visualization/index.rst b/docs/source/reference/visualization/index.rst index 2e30c9fb9a..79f59132ff 100644 --- a/docs/source/reference/visualization/index.rst +++ b/docs/source/reference/visualization/index.rst @@ -10,7 +10,7 @@ The :mod:`~optuna.visualization` module provides utility functions for plotting render them by default. Please follow this `installation guide`_ to show figures in `JupyterLab`_. .. note:: - The :func:`~optuna.visualization.plot_param_importances` requires the Python package of `scikit-learn `_. + The :func:`~optuna.visualization.plot_param_importances` requires the Python package of `scikit-learn `__. .. _JupyterLab: https://github.com/jupyterlab/jupyterlab .. _installation guide: https://github.com/plotly/plotly.py#jupyterlab-support diff --git a/docs/source/tutorial/index.rst b/docs/source/tutorial/index.rst index e38473c873..2c1a57b5fb 100644 --- a/docs/source/tutorial/index.rst +++ b/docs/source/tutorial/index.rst @@ -16,7 +16,7 @@ If you are new to Optuna or want a general introduction, we highly recommend the Key Features ------------ -Showcases Optuna's `Key Features `_. +Showcases Optuna's `Key Features `__. 1. :doc:`10_key_features/001_first` 2. :doc:`10_key_features/002_configurations` @@ -41,7 +41,7 @@ Showcases the recipes that might help you using Optuna with comfort. - :doc:`20_recipes/009_ask_and_tell` - :doc:`20_recipes/010_reuse_best_trial` - :doc:`20_recipes/011_journal_storage` -- `Human-in-the-loop Optimization with Optuna Dashboard `_ +- `Human-in-the-loop Optimization with Optuna Dashboard `__ - :doc:`20_recipes/012_artifact_tutorial` - :doc:`20_recipes/013_wilcoxon_pruner` @@ -49,4 +49,4 @@ Showcases the recipes that might help you using Optuna with comfort. .. rst-class:: sphx-glr-signature - `Gallery generated by Sphinx-Gallery `_ + `Gallery generated by Sphinx-Gallery `__ diff --git a/tutorial/10_key_features/README.rst b/tutorial/10_key_features/README.rst index edad13f9c7..0ca29b9187 100644 --- a/tutorial/10_key_features/README.rst +++ b/tutorial/10_key_features/README.rst @@ -3,4 +3,4 @@ Key Features ------------ -Showcases Optuna's `Key Features `_. +Showcases Optuna's `Key Features `__.