optuna.samplers.RandomSampler

class optuna.samplers.RandomSampler(seed=None)[source]

ランダムサンプリングを行うサンプラー

このサンプラーは*独立サンプリング*に基づいています。「独立サンプリング」の詳細については BaseSampler も参照してください。

使用例

import optuna
from optuna.samplers import RandomSampler


def objective(trial):
    x = trial.suggest_float("x", -5, 5)
    return x**2


study = optuna.create_study(sampler=RandomSampler())
study.optimize(objective, n_trials=10)

Parameters:: seed (int | None) – 乱数生成器のシード値

メソッド

`after_trial`(study, trial, state, values)	Trial post-processing.
`before_trial`(study, trial)	Trial pre-processing.
`infer_relative_search_space`(study, trial)	Infer the search space that will be used by relative sampling in the target trial.
`reseed_rng`()	Reseed sampler's random number generator.
`sample_independent`(study, trial, param_name, ...)	Sample a parameter for a given distribution.
`sample_relative`(study, trial, search_space)	Sample parameters in a given search space.

after_trial(study, trial, state, values)

トライアルの事後処理

このメソッドは目的関数の実行後、トライアルが終了して状態が保存される直前に呼び出されます。

Note

v2.4.0で実験的機能として追加されました。インターフェースは予告なく変更される可能性があります。詳細は https://github.com/optuna/optuna/releases/tag/v2.4.0 を参照してください。

Parameters:

study (Study) – 対象のスタディオブジェクト
trial (FrozenTrial) – 対象のトライアルオブジェクトこのオブジェクトを変更する前にコピーを取得してください
state (TrialState) – トライアルの最終状態
values (Sequence[float] | None) – トライアルの最終値トライアルが成功した場合、None ではありません

Return type:

None

before_trial(study, trial)

トライアルの事前処理

このメソッドは目的関数が呼び出される前、トライアルがインスタンス化された直後に呼び出されます。より正確には、トライアルの初期化中、infer_relative_search_space() が呼び出される直前に実行されます。つまり、探索空間を推論する前に行うべき事前処理を担当します。

Note

v3.3.0で実験的機能として追加されました。インターフェースは予告なく変更される可能性があります。詳細は https://github.com/optuna/optuna/releases/tag/v3.3.0 を参照してください。

Parameters:

study (Study) – 対象のスタディオブジェクト
trial (FrozenTrial) – 対象のトライアルオブジェクト

Return type:

None

infer_relative_search_space(study, trial)[source]

対象トライアルで使用する探索空間を推論します

このメソッドは sample_relative() が呼び出される直前に実行され、このメソッドが返す探索空間が渡されます。探索空間に含まれないパラメータは sample_independent() メソッドでサンプリングされます。

Parameters:

study (Study) – 対象のスタディオブジェクト
trial (FrozenTrial) – 対象のトライアルオブジェクトこのオブジェクトを変更する前にコピーを取得してください

Returns:

パラメータ名とパラメータの分布を含む辞書

Return type:

dict[str, BaseDistribution]