From a8802194b9e4987e81c19195495b7c3b8dfa5e0f Mon Sep 17 00:00:00 2001 From: pollfly <75068813+pollfly@users.noreply.github.com> Date: Sun, 25 Jul 2021 11:49:58 +0300 Subject: [PATCH] Add hyperparam optimization diagram + minor corrections (#22) * add hpo diagram * edit around hpo diagram * small edits hpo, put tutorial under own heading * fix incorrect wording --- docs/fundamentals/hpo.md | 67 +++++++++++++++++++-------------------- docs/img/hpo_diagram.png | Bin 0 -> 58198 bytes sidebars.js | 2 +- 3 files changed, 33 insertions(+), 36 deletions(-) create mode 100644 docs/img/hpo_diagram.png diff --git a/docs/fundamentals/hpo.md b/docs/fundamentals/hpo.md index 673e0d73..402403fd 100644 --- a/docs/fundamentals/hpo.md +++ b/docs/fundamentals/hpo.md @@ -6,26 +6,39 @@ title: Hyperparameter Optimization Hyperparameters are variables that directly control the behaviors of training algorithms, and have a significant effect on the performance of the resulting machine learning models. Finding the hyperparameter values that yield the best performing models can be complicated. Manually adjusting hyperparameters over the course of many training trials can be -slow and tedious. Luckily, **hyperparameter optimization** can be automated and boosted using **ClearML**'s -`HyperParameterOptimizer` class. +slow and tedious. Luckily, hyperparameter optimization can be automated and boosted using ClearML's +**`HyperParameterOptimizer`** class. ## ClearML's HyperParameter Optimization -ClearML provides the `HyperParameterOptimizer` class which takes care of the entire optimization process for users in -with a simple interface. +ClearML provides the `HyperParameterOptimizer` class, which takes care of the entire optimization process for users in +with a simple interface. -The `HyperParameterOptimizer` class does the following: -* Clones a base experiment that needs to be optimized. -* Changes arguments based on the specified optimizer strategy. -* Tries to minimize / maximize defined objectives. +ClearML's approach to hyperparameter optimization is scalable, easy to set up and to manage, and it makes it easy to +compare results. +### Workflow + + + +The diagram above demonstrates the typical flow of hyperparameter optimization where the parameters of a base task are optimized: + +1. Configure an Optimization Task with a base task whose parameters will be optimized, and a set of parameter values to + test +1. Clone the base task. Each clone's parameter is overridden with a value from the optimization task +1. Enqueue each clone for execution by a ClearML Agent +1. The Optimization Task records and monitors the cloned tasks' configuration and execution details, and returns a + summary of the optimization results + + + + +### Supported Optimizers The `HyperParameterOptimizer` class contains **ClearML**’s hyperparameter optimization modules. Its modular design enables using different optimizers, including existing software frameworks, enabling simple, accurate, and fast hyperparameter optimization. -### Supported Optimizers - * **Optuna** - `automation.optuna.optuna.OptimizerOptuna`. Optuna is the default optimizer in ClearML. It makes use of different samplers such as grid search, random, bayesian, and evolutionary algorithms. For more information, see the [Optuna](https://optuna.readthedocs.io/en/latest/) @@ -34,29 +47,10 @@ optimization. at scale by combining the speed of Hyperband searches with the guidance and guarantees of convergence of Bayesian Optimization. For more information about HpBandSter BOHB, see the [HpBandSter](https://automl.github.io/HpBandSter/build/html/index.html) documentation. -* **Random** uniform sampling of hyperparameters - `automation.optimization.RandomSearch` +* **Random** uniform sampling of hyperparameters - `automation.optimization.RandomSearch`. * **Full grid** sampling strategy of every hyperparameter combination - `Grid search automation.optimization.GridSearch`. -* **Custom** - `automation.optimization.SearchStrategy`. - Use a custom class and inherit from the ClearML automation base strategy class +* **Custom** - `automation.optimization.SearchStrategy` - Use a custom class and inherit from the ClearML automation base strategy class -## How Does it Work? - -**ClearML**'s approach to hyperparameter optimization is scalable, easy to set up and to manage, and it makes it easy to -compare results. - -### Workflow - -Make use of **ClearML**'s hyperparameter optimization capabilities by: -* Initializing an Optimizer Task, which will record and monitor arguments, execution details, results, and more. -* Instantiating a `HyperParameterOptimizer`, where the following is specified: - * Task to optimize - * Hyperparameters to optimize - * Metric to optimize - * Optimizer class (optimization strategy) where the optimization configuration and resources budget are defined - * And more. -* Enqueuing the Task to be executed by a ClearML Agent (or multiple agents) in a remote machine. -* Monitoring the optimization process and viewing the summarized results in the **ClearML web UI** - - ## Defining a hyperparameter optimization search example @@ -68,7 +62,7 @@ Make use of **ClearML**'s hyperparameter optimization capabilities by: from clearml.automation.optuna import OptimizerOptuna ``` 1. Initialize the Task, which will be stored in ClearML Server when the code runs. After the code runs at least once, - it can be reproduced and tuned: + it can be reproduced, and the parameters can be tuned: ```python from clearml import Task @@ -82,7 +76,7 @@ Make use of **ClearML**'s hyperparameter optimization capabilities by: 1. Define the optimization configuration and resources budget: ```python optimizer = HyperParameterOptimizer( - # specifying the Task to be optimized, Task must be in system already so it can be cloned + # specifying the task to be optimized, task must be in system already so it can be cloned base_task_id=TEMPLATE_TASK_ID, # setting the hyper-parameters to optimize hyper_parameters=[ @@ -111,6 +105,9 @@ Make use of **ClearML**'s hyperparameter optimization capabilities by: ``` <br/><br/> -Check out the [Hyperparameter Optimization](../guides/optimization/hyper-parameter-optimization) tutorial for a step by step guide. +For more information about `HyperParameterOptimizer` and supported optimization modules, see the [HyperParameterOptimizer class reference](../references/sdk/hpo_optimization_hyperparameteroptimizer.md). + +## Tutorial + +Check out the [Hyperparameter Optimization](../guides/optimization/hyper-parameter-optimization/examples_hyperparam_opt.md) tutorial for a step-by-step guide. - For further information about the `HyperParameterOptimizer` arguments, see the [Automation module reference](../references/sdk/hpo_optimization_hyperparameteroptimizer.md). \ No newline at end of file diff --git a/docs/img/hpo_diagram.png b/docs/img/hpo_diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..04314ef18c72ed1d0f4d678fba6efded130d32d2 GIT binary patch literal 58198 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 Tup+__w91f^y^Gy#TO$2mQCHht literal 0 HcmV?d00001 diff --git a/sidebars.js b/sidebars.js index a6fea892..32da76eb 100644 --- a/sidebars.js +++ b/sidebars.js @@ -14,7 +14,7 @@ module.exports = { {'MLOps': ['getting_started/mlops/mlops_first_steps','getting_started/mlops/mlops_second_steps','getting_started/mlops/mlops_best_practices']}] }, 'getting_started/architecture']}, {'ClearML Fundamentals': ['fundamentals/task', 'fundamentals/hyperparameters', 'fundamentals/artifacts', 'fundamentals/logger', 'fundamentals/agents_and_queues', - 'fundamentals/pipelines']}, + 'fundamentals/hpo', 'fundamentals/pipelines']}, 'clearml_sdk', 'clearml_agent', 'clearml_data',