# utils

Python API: `luxonis_ml.nn_archive.utils`

## 函数

### infer_layout

```python
def infer_layout(shape: list[int]) -> str:
```

推断张量形状的布局代码。

该函数识别常见的图像张量布局。对于其他形状，它使用从 `C` 开始的第一个可用字母。

> **示例**
> ```pycon
>>> infer_layout([1, 3, 256, 256])
'NCHW'
>>> infer_layout([256, 256, 3])
'HWC'
>>> infer_layout([1, 19, 7, 8])
'NCDE'
```

参数

 * `shape` (`list[int]`): 要推断的张量形状。

返回

 * `str`: 与 `shape` 中维度数量匹配的布局代码。

抛出

 * `ValueError`: 如果形状的维度过多，无法进行自动布局推断。

### is_nn_archive

```python
def is_nn_archive(path: PathType) -> bool:
```

检查路径是否指向有效的 NN Archive。

有效的存档必须是 tar 文件，并且包含顶级 `config.json` 成员。

参数

 * `path` (`PathType`): 要检查的文件路径。

返回

 * `bool`: 如果文件是有效的 NN Archive，则为 `True`，否则为 `False`。
