# cli_utils

Python API: `luxonis_ml.data.utils.cli_utils`

## 函数

### check_exists

```python
def check_exists(name: str, bucket_storage: BucketStorage):
```

确保数据集中存在于所选存储中。

参数

 * `name` (`str`): 数据集名称。
 * `bucket_storage` (`BucketStorage`): 要查询的存储后端。

引发

 * `typer.Exit`: 如果数据集不存在。

### complete_dataset_name

```python
def complete_dataset_name(incomplete: str) -> list[str]:
```

### get_dataset_info

```python
def get_dataset_info(dataset: LuxonisDataset) -> tuple[set[str], list[str]]:
```

### get_tracked_augmentations

```python
def get_tracked_augmentations(metadata: Params) -> TrackedAugmentations | None:
```

读取加载器添加到样本的增强来源。

记录可以存储自己的 `"augmentations"` 元数据，加载器会保留这些元数据。标记类型将两者区分开来；仅凭形状无法区分。

### parse_split_ratio

```python
def parse_split_ratio(value: str | None = None, train: float | None = None, val: float | None = None, test: float | None = None) -> dict[str, float | int] | None:
```

解析 CLI 分割比例参数。

浮点数列表表示比例，并且必须总和为 1.0。整数列表表示绝对计数。

> **示例**
> ```pycon
>>> parse_split_ratio("[0.7, 0.2, 0.1]")
{'train': 0.7, 'val': 0.2, 'test': 0.1}
>>> parse_split_ratio(train=70, val=20, test=10)
{'train': 70, 'val': 20, 'test': 10}
>>> parse_split_ratio(train=0.7, val=0.2)
{'train': 0.7, 'val': 0.2, 'test': 0.1}
>>> parse_split_ratio(train=0.7, val=0.2, test=0.1)
{'train': 0.7, 'val': 0.2, 'test': 0.1}
>>> parse_split_ratio([10, 27])
Traceback (most recent call last):
...
ValueError: Split ratio must be a list of 3 values (train, val, test).
>>> parse_split_ratio(train=0.7, val=0.2, test=0.2)
Traceback (most recent call last):
...
ValueError: Split ratios must sum to 1.0; use whole numbers for counts.
```

参数

 * `value` (`str | None`): 3 个值（训练、验证、测试）列表的字符串表示。
 * `train` (`float | None`): 训练分割的可选浮点数或整数。
 * `val` (`float | None`): 验证分割的可选浮点数或整数。
 * `test` (`float | None`): 测试分割的可选浮点数或整数。

返回

 * `dict[str, float | int] | None`: 一个字典，其中键为“train”、“val”和“test”，映射到各自的比例或计数，如果没有提供值，则为 None。

引发

 * `ValueError`: 如果输入格式无效，如果比例总和不为 1.0，
 * `或者如果计数和比例混合。`

### print_info

```python
def print_info(dataset: LuxonisDataset):
```
