optuna.trial.FixedTrial

class optuna.trial.FixedTrial(params, number=0)[source]

一个为每个参数建议固定值的 Trial 类。

该对象拥有与 Trial 相同的类方法，并且它建议预定义的参数值。参数值可以在构造 FixedTrial 对象时确定。与 Trial 不同，FixedTrial 不依赖于 Study，并且对于部署优化结果非常有用。

示例

使用用户提供的参数值评估目标函数。

import optuna


def objective(trial):
    x = trial.suggest_float("x", -100, 100)
    y = trial.suggest_categorical("y", [-1, 0, 1])
    return x**2 + y


assert objective(optuna.trial.FixedTrial({"x": 1, "y": 0})) == 1

注意

有关方法和属性的详细信息，请参阅 Trial。

参数:

params (dict[str, Any]) – 包含所有参数的字典。
number (int) – Trial 编号。默认为 0。

方法

`report`(value, step)
`set_system_attr`(key, value)
`set_user_attr`(key, value)
`should_prune`()
`suggest_categorical`()
`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)

属性

`datetime_start`
`distributions`
`编号`
`参数`
`系统属性`
`user_attrs`

set_system_attr(key, value)[source]

警告

已弃用 (v3.1.0)。此功能将在未来移除。此功能移除的计划时间为 v5.0.0，但此计划可能会有变动。请参阅 https://github.com/optuna/optuna/releases/tag/v3.1.0。

参数:

key (str)
value (Any)

返回类型:

无

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

警告

v3.0.0 中已弃用。此功能将在未来版本中移除。此功能当前的移除计划是 v6.0.0，但此计划可能会更改。请参阅 https://github.com/optuna/optuna/releases/tag/v3.0.0。

请改用 suggest_float(…, step=…)。

参数:

name (str)
low (float)
high (float)
q (float)

返回类型:

float

suggest_loguniform(name, low, high)[source]

警告

v3.0.0 中已弃用。此功能将在未来版本中移除。此功能当前的移除计划是 v6.0.0，但此计划可能会更改。请参阅 https://github.com/optuna/optuna/releases/tag/v3.0.0。

请改用 suggest_float(…, log=True)。

参数:

name (str)
low (float)
high (float)

返回类型:

float

suggest_uniform(name, low, high)[source]

警告

v3.0.0 中已弃用。此功能将在未来版本中移除。此功能当前的移除计划是 v6.0.0，但此计划可能会更改。请参阅 https://github.com/optuna/optuna/releases/tag/v3.0.0。

请改用 suggest_float。

参数:

name (str)
low (float)
high (float)

返回类型:

float