optuna.trial.FixedTrial

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

一个试用类，它为每个参数提供一个固定值。

此对象具有与 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) – 试用编号。默认为 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`
`number`
`params`
`system_attrs`
`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)

返回类型:

None

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