メインコンテンツまでスキップ
バージョン: v2603

汎用Strategy

任意のPresetで使用できる汎用Strategyの一覧とそれぞれのロジックについて説明します。 Preset専用Strategyについては各Presetのドキュメントを参照してください。

random

パラメータをランダムにサンプリングします。

各パラメータの型に応じて以下のようにサンプリングされます:

パラメータ型サンプリング方法
IntParameterstep指定時はステップ幅に基づくランダム選択、未指定時は[low, high]の一様分布
FloatParameterlog=True時は対数空間、log=False時は線形空間の一様分布
CategoricalParameter選択肢から一様ランダムに選択
BoolParameterTrue/Falseから一様ランダムに選択

オプション:

パラメータ説明デフォルト
seed再現性のためのランダムシードなし

探索は試行予算(--n-trials)が尽きるまで継続します。

grid

パラメータの全組み合わせを網羅的に探索します。

各パラメータの値リストを生成し、itertools.productで全組み合わせを列挙して順に評価します。 値リストの生成方法はパラメータ型によって異なります:

パラメータ型値リスト生成方法
IntParameterstep指定時はrange(low, high+1, step)、未指定時はgrid_points個の均等分割
FloatParameterlog=True時は対数空間、log=False時は線形空間でgrid_points個の均等分割
CategoricalParameter全選択肢
BoolParameter[True, False]

オプション:

パラメータ説明デフォルト
grid_pointsステップサイズが未指定のパラメータに対するグリッドポイント数5

全組み合わせの評価が完了すると探索は自動的に終了します。探索空間が小さい場合に適しています。

optuna

OptunaのSamplerに従ってパラメータをサンプリングします。デフォルトではTPE(Tree-structured Parzen Estimator)を使用し、過去の試行結果に基づいて有望なパラメータ領域を優先的に探索します。

オプション:

パラメータ説明デフォルト
samplerOptunaサンプラーインスタンスTPESampler
storageOptuna storage URL(例: sqlite:///study.dbなし
study_nameOptunaスタディ名なし

storageを指定すると探索結果が永続化され、中断・再開が可能になります。