# encodings

Python API: `modelconverter.utils.encodings`

外部提供的量化编码的辅助函数。

量化编码描述了用于量化模型激活和参数的比例、偏移和位宽。它们可以传递给 RVC4 转换以覆盖从校准派生的值。原始 `rvc4.encodings` 数据直接传递给 SNPE，而不是通过 ModelConverter 的 `Encodings`
模式进行规范化。下面的解析器保留用于已类型化的兼容路径；严格验证仅使用原始结构中所需的激活/参数名称。

## 函数

### collect_quantization_override_names

```python
def collect_quantization_override_names(encodings: Encodings | Mapping[str, Any]) -> tuple[set[str], set[str]]:
```

收集激活和参数名称，而不规范化条目。

### parse_encodings

```python
def parse_encodings(value: ParamValue | Encodings) -> Encodings:
```

将量化编码解析为 `Encodings` 模型。

接受一个 `Encodings` 实例（原样返回）、一个 JSON 字符串或一个包含 `activation_encodings` 和 `param_encodings` 键的字典。这两个组中的每一个都可以是张量名称到条目的映射，也可以是带有 `name`
字段的条目列表。条目在途中被规范化：旧的 `bw` 和 `is_sym` 键被重命名为 `bitwidth` 和 `is_symmetric`，`dtype` 被转换为小写，未知键被删除，单元素列表被解包，每通道条目被扩展为每个通道一个条目。

参数

 * `value` (`ParamValue | Encodings`): 要解析的编码。

返回

 * `Encodings`: 解析后的编码。

引发

 * `TypeError`: 如果 `value` 反序列化后不是字典，如果组既不是列表也不是字典，或者如果单个条目不是字典。
 * `ValueError`: 如果列表形组中的条目缺少或包含无效的张量名称，或者如果条目的每通道字段长度不同。

### validate_quantization_override_names

```python
def validate_quantization_override_names(encodings: Encodings | Mapping[str, Any], model_path: str | Path):
```

拒绝不存在或在错误编码组中的覆盖名称。

## 属性

### ALLOWED_ENCODING_KEYS
