# source

Python API: `luxonis_ml.data.datasets.source`

## 类

### LuxonisComponent

源中的媒体组件。

通常，这表示一个图像传感器。

> **已弃用**
> 自 0.10.0 版本起已弃用：LuxonisComponent 已弃用，并将在未来的版本中移除。

#### 属性

##### image_type

图像类型。仅用于图像媒体。

##### media_type

组件表示的媒体类型。

##### name

人类可读的组件名称。

### LuxonisSource

数据集的源定义。

源描述了包含哪些组件或媒体流。例如，一个 [OAK-D](/projects/hardware/en/latest/pages/BW1098OAK/) 源可以包含
`rgb`、`left`、`right`、`depth` 组件。

> **已弃用**
> 自 0.10.0 版本起已弃用：LuxonisSource 已弃用，并将在未来的版本中移除。

#### 方法

##### merge_with

```python
def merge_with(other: LuxonisSource) -> LuxonisSource:
```

合并两个源。

`name` 和 `main_component` 取自第一个源。`components` 合并在一起，如果名称冲突，则第二个源的组件优先。

> **示例**
> ```pycon
>>> source1 = LuxonisSource(
...     name="source1",
...     components={
...         "rgb": LuxonisComponent(name="rgb"),
...     },
...     main_component="rgb",
... )
>>> source2 = LuxonisSource(
...     name="source2",
...     components={
...         "depth": LuxonisComponent(name="depth"),
...     },
...     main_component="depth",
... )
>>> merged_source = source1.merge_with(source2)
>>> merged_source.name
'source1'
>>> merged_source.main_component
'rgb'
>>> sorted(merged_source.components.keys())
['depth', 'rgb']
```

参数

 * `other` (`LuxonisSource`): 要合并的源。

返回

 * `LuxonisSource`: 包含两个源组件的新源。

#### 属性

##### components

源中分组的组件。

##### main_component

用作主要可视化目标的组件名称。

##### name

人类可读的源名称。
