# metadata

Python API: `modelconverter.utils.metadata`

从模型文件中读取输入和输出元数据。

每个转换平台都使用不同的模型格式，因此 modelconverter 的其余部分通过单个
[get_metadata](/software-v3/ai-inference/conversion/rvc-conversion/offline/modelconverter/modelconverter-api-reference/utils/metadata.md)
入口点请求形状和数据类型，该入口点根据文件后缀进行分派：ONNX、OpenVINO IR (RVC2/RVC3)、SNPE DLC (RVC4)、Hailo HAR 和 TFLite。平台特定格式的读取器依赖于仅在该平台容器中存在的工具，因此它们是惰性导入的。

## 类

### Metadata

模型输入和输出的形状和数据类型。

#### 属性

##### input_dtypes

每个输入的数据类型，以输入名称为键。

##### input_shapes

每个输入的形状，以输入名称为键。

##### output_dtypes

每个输出的数据类型，以输出名称为键。

##### output_shapes

每个输出的形状，以输出名称为键。

## 函数

### get_metadata

```python
def get_metadata(model_path: Path) -> Metadata:
```

读取模型的元数据，无论其格式如何。

格式取自文件后缀：`.onnx`、`.xml` 或 `.bin` (OpenVINO IR)、`.dlc` 或 `.csv` (SNPE)、`.hef` 或 `.har` (Hailo) 和 `.tflite`。

参数

 * `model_path` (`Path`): 模型文件的路径。对于 IR 模型，可以提供 `.xml` 或 `.bin` 文件，另一个文件将从中派生。

返回

 * `Metadata`: 模型输入和输出的元数据。

引发

 * `ValueError`: 如果后缀不是支持的格式之一，或者无法读取 ONNX 或 IR 模型。其他格式会传播其读取器自身的错误，例如文件丢失的 `FileNotFoundError`。
