tune_utils
最后更新
luxonis_train.core.utils.tune_utils配置的 tuner.params 与 Optuna 试验建议之间的转换。函数
get_trial_params
Python
1def get_trial_params(all_augs: list[str], params: dict[str, Any], trial: optuna.trial.Trial) -> dict[str, Any]:params 的每个键都是一个带类型后缀的点式配置键,例如 trainer.optimizer.params.lr_float。最后一个 _ 后缀选择采样方式:categorical: 从列表中使用trial.suggest_categorical。int: 从[low, high]或[low, high, step]中使用trial.suggest_int,作为整数。默认步长为1。float: 从[low, high]或[low, high, step]中使用trial.suggest_float,作为浮点数。uniform: 从[low, high]中使用trial.suggest_float,作为浮点数。loguniform: 从[low, high]中使用trial.suggest_float,作为浮点数,log=True。subset: 仅用于其最后一个点式部分为augmentations的键。该值是一个增强名称列表和一个计数。该函数使用random模块而不是trial随机选择这些名称中的多个。它会跳过Normalize和未知名称并发出警告。
示例
Pycon
1>>> import optuna
2>>> trial = optuna.trial.FixedTrial(
3... {"trainer.batch_size": 8, "trainer.optimizer.name": "SGD"}
4... )
5>>> params = {
6... "trainer.batch_size_int": [4, 16, 4],
7... "trainer.optimizer.name_categorical": ["Adam", "SGD"],
8... }
9>>> get_trial_params([], params, trial)
10{'trainer.batch_size': 8, 'trainer.optimizer.name': 'SGD'}all_augs(list[str]):trainer.preprocessing.augmentations中增强的名称,按配置顺序排列。subset键使用它们来查找索引。params(dict[str, Any]): 配置的tuner.params部分。trial(optuna.trial.Trial): 采样值的试验。
dict[str, Any]: 每个键的采样值,不带后缀。subset键为每个保留的增强名称提供一个布尔条目<key>.<index>.active。True标记一个选定的增强。
ValueError: 当结果没有条目时,例如空params。当subset键的最后一个点式部分不是augmentations时,当subset键的计数大于保留名称的数量时,或者当float键的步长不是浮点数时。TypeError: 当int键的步长不是整数时。KeyError: 当后缀未知时,或者当值不符合其后缀时。
rename_params_for_logging
Python
1def rename_params_for_logging(params: dict, tuner_params: dict | None = None) -> dict:tuner_params 中 trainer.preprocessing.augmentations_subset 的名称列表。键 trainer.preprocessing.augmentations.<index>.<field> 变为 trainer.preprocessing.augmentations.<name>.active,其中 <name> 是该列表中 <index> 处的条目。当 <index> 不是整数或超出列表范围时,键保留其名称。其他键也保留其名称。示例
Pycon
1>>> params = {
2... "trainer.preprocessing.augmentations.1.active": False,
3... "trainer.batch_size": 8,
4... }
5>>> tuner_params = {
6... "trainer.preprocessing.augmentations_subset": [
7... ["Defocus", "Sharpen"],
8... 1,
9... ]
10... }
11>>> rename_params_for_logging(params, tuner_params)
12{'trainer.preprocessing.augmentations.Sharpen.active': False,
13 'trainer.batch_size': 8}params(dict): 试验的采样参数,如 get_trial_params 返回的那样。tuner_params(dict | None): 配置的tuner.params部分。如果没有增强的subset条目,该函数不会更改任何键。
dict: 一个新字典,其值与params相同。