clearml-docs/docs/guides/automation/manual_random_param_search_example.md

title
Manual Random Parameter Search

The manual_random_param_search_example.py script demonstrates a random parameter search by automating the execution of a task multiple times, each time with a different set of random hyperparameters.

This example accomplishes the automated random parameter search by doing the following:

1. Creating a template Task named Keras HP optimization base. To create it, run the base_template_keras_simple.py script. This task must be executed first, so it will be stored in the server, and then it can be accessed, cloned, and modified by another Task.
2. Creating a parameter dictionary, which is connected to the Task by calling Task.connect() so that the parameters are logged by ClearML.
3. Adding the random search hyperparameters and parameters defining the search (e.g., the task name, and number of times to run the task).
4. Creating a Task object referencing the template task, Keras HP optimization base. See Task.get_task.
5. For each set of parameters:
   1. Cloning the Task object. See Task.clone.
   2. Getting the newly cloned Task's parameters. See Task.get_parameters.
   3. Setting the newly cloned Task's parameters to the search values in the parameter dictionary (Step 1). See Task.set_parameters.
   4. Enqueuing the newly cloned Task to execute. See Task.enqueue.

When the example script runs, it creates a task named Random Hyper-Parameter Search Example in the examples project. This starts the parameter search, and creates the tasks:

• Keras HP optimization base 0
• Keras HP optimization base 1
• Keras HP optimization base 2.

When these tasks are completed, their results can be compared.