# legacy

Python API: `luxonis_train.strategies.legacy`

用于先前 `configure_optimizers` API 策略的适配器。

## 类

### LegacyStrategyAdapter

用于已弃用的 `configure_optimizers` API 策略的适配器。

[luxonis_train.lightning.utils.build_training_strategy](/software-v3/ai-inference/model-source/training/luxonis-train/luxonis-train-api-reference/lightning/utils.md)
会记录弃用警告，并将此类策略包装在此适配器中。旧版策略的 `configure_optimizers` 返回的优化器和调度器将成为计划的额外内部优化器。

这些优化器的参数不属于规则分区。节点 `finetuning` 条目和默认规则会声明旧版优化器遗漏的每个参数，包括冻结的参数。因此，此类参数会在其节点解冻后进行训练。

#### 方法

##### init

```python
def __init__(legacy: Any):
```

包装旧版策略。

构造函数不调用 `configure_optimizers`。首次调用
[opaque_parameter_ids](/software-v3/ai-inference/model-source/training/luxonis-train/luxonis-train-api-reference/strategies/legacy.md)
或
[opaque_inners](/software-v3/ai-inference/model-source/training/luxonis-train/luxonis-train-api-reference/strategies/legacy.md)
会调用它一次，适配器会保留结果。

参数

 * `legacy` (`Any`): 旧版策略。它必须具有 `configure_optimizers` 和 `update_parameters` 方法，并且可以具有 `get_base_configs`。`configure_optimizers`
   返回一系列优化器和一系列调度器。

##### get_base_configs

```python
def get_base_configs(self) -> tuple[OptimizerConfig, SchedulerConfig]:
```

返回旧版策略的基本配置。

[luxonis_train.lightning.utils.build_training_strategy](/software-v3/ai-inference/model-source/training/luxonis-train/luxonis-train-api-reference/lightning/utils.md)
会为没有 `get_base_configs` 的旧版类提供一个引发 `NotImplementedError`
的存根。当此方法引发该错误时，[resolve_training_plan](/software-v3/ai-inference/model-source/training/luxonis-train/luxonis-train-api-reference/lightning/training_plan.md)
会使用 `trainer.optimizer` 和 `trainer.scheduler`。

返回

 * `tuple[OptimizerConfig, SchedulerConfig]`: 旧版策略的 `get_base_configs()` 的结果。

引发

 * `NotImplementedError`: 如果旧版策略没有 `get_base_configs` 属性。

##### opaque_inners

```python
def opaque_inners(self) -> list[tuple[Optimizer, Any]]:
```

返回旧版策略的优化器及其调度器。

返回

 * `list[tuple[Optimizer, Any]]`: 每个优化器一对，按顺序排列。相同位置的调度器完成该对。当旧版策略返回的调度器少于优化器时，最后一个优化器将获得 `None`。

引发

 * `ValueError`: 如果旧版策略返回的调度器多于优化器。

##### opaque_parameter_ids

```python
def opaque_parameter_ids(self) -> set[int]:
```

返回旧版策略优化器的参数。

返回

 * `set[int]`: 每个旧版优化器的 `param_groups` 中每个参数的 `id()`。

##### rules

```python
def rules(self) -> list[StrategyRule]:
```

不返回任何规则，因为旧版策略没有规则。

返回

 * `list[StrategyRule]`: 一个空列表。

##### update_parameters

```python
def update_parameters(self):
```

调用旧版策略的 `update_parameters()`。

#### 属性

##### legacy_name

旧版策略的类名。

当旧版优化器包含 `finetuning`
条目声明的参数时，[resolve_training_plan](/software-v3/ai-inference/model-source/training/luxonis-train/luxonis-train-api-reference/lightning/training_plan.md)
会用它来命名策略。

## 属性

### DEPRECATION_MESSAGE
