plot_timeline

optuna.visualization.matplotlib.plot_timeline(study, n_recent_trials=None)

绘制 study 的时间线。

另请参阅

请参阅 optuna.visualization.plot_timeline() 获取示例。

参数:

• study (Study) – 一个 Study 对象，其 trial 会与其生命周期一起绘制。

• n_recent_trials (int | None) – 要绘制的最近 trial 的数量。如果为 None，则绘制所有 trial。如果指定，则仅显示最近的 n_recent_trials。必须是正整数。

返回:

一个 plotly.graph_objects.Figure 对象。

引发:

ValueError – 如果 n_recent_trials 为 0 或负数。

返回类型:

Axes

注意

在 v3.2.0 中添加为实验性功能。接口可能在更高版本中更改，恕不另行通知。请参阅 https://github.com/optuna/optuna/releases/tag/v3.2.0。

以下代码片段展示了如何绘制 study 的时间线。

/home/docs/checkouts/readthedocs.org/user_builds/optuna/checkouts/stable/docs/visualization_matplotlib_examples/optuna.visualization.matplotlib.timeline.py:29: ExperimentalWarning:

optuna.visualization.matplotlib._timeline.plot_timeline is experimental (supported from v3.2.0). The interface can change in the future.


<Axes: title={'center': 'Timeline Plot'}, xlabel='Datetime', ylabel='Trial'>

import time
import optuna


def objective(trial):
    x = trial.suggest_float("x", 0, 1)
    time.sleep(x * 0.1)
    if x > 0.8:
        raise ValueError()
    if x > 0.4:
        raise optuna.TrialPruned()
    return x**2


study = optuna.create_study(direction="minimize")
study.optimize(objective, n_trials=50, n_jobs=2, catch=(ValueError,))

optuna.visualization.matplotlib.plot_timeline(study)