# input

Python API: `luxonis_ml.nn_archive.config_building_blocks.base_models.input`

## 类

### Input

模型输入流定义。

#### 方法

##### infer_layout

```python
def infer_layout(data: dict[str, Any]) -> dict[str, Any]:
```

当提供了形状但没有布局时，推断布局。

> **示例**
> ```pycon
>>> Input.infer_layout({"shape": [1, 3, 224, 224]})["layout"]
'NCHW'
>>> Input.infer_layout({"shape": [1, 3, 16, 16, 2]})
{'shape': [1, 3, 16, 16, 2], 'layout': 'NCDEF'}
>>> "layout" in Input.infer_layout({"shape": [1] * 30})
False
```

参数

 * `data` (`dict[str, Any]`): 原始输入模型数据。

返回

 * `dict[str, Any]`: 推断成功时添加了 `layout` 的原始模型数据。

##### validate_layout

```python
def validate_layout(self) -> Self:
```

验证布局与输入形状兼容。

布局必须是形状的一对一描述，因此 |layout| = |shape|。当存在 `N` 时，它表示批次大小，并且必须放在首位。图像输入必须包含通道维度 `C`。

返回

 * `Self`: 经过验证的输入模型。

引发

 * `ValueError`: 如果布局包含重复字母，其长度与形状长度不匹配，`N` 存在但不是首位，或者图像输入没有 `C` 维度。

#### 属性

##### dtype

输入数据的数据类型，例如 `"float32"`。

##### input_type

预期的输入数据类型，例如 `"image"`。

##### layout

用于解释张量维度的字母代码，例如 `"NCHW"`。

##### name

输入层的名称。

##### preprocessing

应用于输入数据的预处理。

##### shape

输入张量形状。

### PreprocessingBlock

应用于模型输入数据的预处理操作。

#### 属性

##### dai_type

用于配置管道输入处理的可选 DepthAI 输入类型。

##### interleaved_to_planar

可选的旧版布局转换标志。

> **已弃用**
> 自 0.5.0 版本起已弃用：请改用 `dai_type`。

##### mean

通道顺序中的可选均值。顺序应与训练期间使用的预处理匹配。

##### resize_mode

可选的图像调整大小策略。`CROP` 中心裁剪，`STRETCH` 在不保留纵横比的情况下调整大小，`LETTERBOX` 通过填充保留纵横比。

##### reverse_channels

可选的旧版通道顺序标志。

> **已弃用**
> 自 0.5.0 版本起已弃用：请改用 `dai_type`。

##### scale

通道顺序中的可选标准化值。顺序应与训练期间使用的预处理匹配。
