clearml-docs/docs/guides/distributed/subprocess_example.md

title
Subprocess

The subprocess_example.py script demonstrates multiple subprocesses interacting and reporting to a main Task. The following happens in the script:

• This script initializes a main Task and spawns subprocesses, each for an instances of that Task.
• Each Task in a subprocess references the main Task by calling Task.current_task, which always returns the main Task.
• The Task in each subprocess reports the following to the main Task:
  • Hyperparameters - Additional, different hyperparameters.
  • Console - Text logged to the console as the Task in each subprocess executes.
• When the script runs, it creates an experiment named Popen example which is associated with the examples project.

Hyperparameters

ClearML automatically logs the command line options defined with argparse. A parameter dictionary is logged by connecting it to the Task using a call to the Task.connect method.

additional_parameters = {
  'stuff_' + str(randint(0, 100)): 'some stuff ' + str(randint(0, 100))
}
Task.current_task().connect(additional_parameters)

Command line options appear in CONFIGURATION > HYPER PARAMETERS > Args.

Parameter dictionaries appear in General.

Console

Output to the console, including the text messages from the Task in each subprocess, appear in CONSOLE.