optuna.integration.TorchDistributedTrial

class optuna.integration.TorchDistributedTrial(trial, device=None)[source]

A wrapper of Trial to incorporate Optuna with PyTorch distributed.

See also

TorchDistributedTrial provides the same interface as Trial. Please refer to optuna.trial.Trial for further details.

See the example if you want to optimize an objective function that trains neural network written with PyTorch distributed data parallel.

Parameters

  • trial (Optional[Trial]) – A Trial object or None. Please set trial object in rank-0 node and set None in the other rank node.

  • device (Optional[torch.device]) – A torch.device to communicate with the other nodes. Please set a CUDA device assigned to the current node if you use “nccl” as torch.distributed backend.

Note

The methods of TorchDistributedTrial are expected to be called by all workers at once. They invoke synchronous data transmission to share processing results and synchronize timing.

Note

Added in v2.6.0 as an experimental feature. The interface may change in newer versions without prior notice. See https://github.com/optuna/optuna/releases/tag/v2.6.0.

Methods

report(value, step)

set_system_attr(key, value)

set_user_attr(key, value)

should_prune()

suggest_categorical(name, choices)

suggest_discrete_uniform(name, low, high, q)

suggest_float(name, low, high, *[, step, log])

suggest_int(name, low, high[, step, log])

suggest_loguniform(name, low, high)

suggest_uniform(name, low, high)

Attributes

datetime_start

distributions

number

params

system_attrs

user_attrs

suggest_discrete_uniform(name, low, high, q)[source]

Warning

Deprecated in v3.0.0. This feature will be removed in the future. The removal of this feature is currently scheduled for v6.0.0, but this schedule is subject to change. See https://github.com/optuna/optuna/releases/tag/v3.0.0.

Use suggest_float() instead.

Parameters
Return type

float

suggest_loguniform(name, low, high)[source]

Warning

Deprecated in v3.0.0. This feature will be removed in the future. The removal of this feature is currently scheduled for v6.0.0, but this schedule is subject to change. See https://github.com/optuna/optuna/releases/tag/v3.0.0.

Use suggest_float() instead.

Parameters
Return type

float

suggest_uniform(name, low, high)[source]

Warning

Deprecated in v3.0.0. This feature will be removed in the future. The removal of this feature is currently scheduled for v6.0.0, but this schedule is subject to change. See https://github.com/optuna/optuna/releases/tag/v3.0.0.

Use suggest_float() instead.

Parameters
Return type

float