optuna.importance

importance モジュールは、指定されたスタディ内の完了済みトライアルに基づいてハイパーパラメータの重要度を評価する機能を提供します。ユーティリティ関数 get_param_importances() は、2つの入力として Study オブジェクトとオプションの評価器を受け取ります。評価器は BaseImportanceEvaluator を継承する必要があり、指定されない場合はデフォルトで FanovaImportanceEvaluator として初期化されます。カスタム評価器を実装する場合は、FanovaImportanceEvaluatorMeanDecreaseImpurityImportanceEvaluator、または PedAnovaImportanceEvaluator を参考とし、評価器の evaluate 関数から返される値の形式に特に注意してください。

Note

FanovaImportanceEvaluator は、1000 件以上のトライアルを含むスタディに対して 1 分以上の処理時間を要します。 高速化された fANOVA 実装である optuna-fast-fanova ライブラリを公開しています。 これを使用することで、ハイパーパラメータの重要度を数秒で取得できます。 n_trials が 10000 を超える場合、Cython 実装でも 1 分以上かかるため、代わりに PedAnovaImportanceEvaluator を使用することで、1 秒以内に評価を完了できます。

get_param_importances

Evaluate parameter importances based on completed trials in the given study.

FanovaImportanceEvaluator

fANOVA importance evaluator.

MeanDecreaseImpurityImportanceEvaluator

Mean Decrease Impurity (MDI) parameter importance evaluator.

PedAnovaImportanceEvaluator

PED-ANOVA importance evaluator.