# UPP STL资产索引

本目录用于把 `UPP_STL处理/待处理STL数据` 和 `UPP列表处理` 的合并 list 建成 CT 号唯一索引。

处理规则：

- STL 候选目录必须能从路径中提取 `CT号`，格式为 `CT...` 或 `DCT...`。
- 同一 CT 号有多个 STL 目录时，优先选择 STL 文件数更多的目录。
- 文件数相同，则选择病例名或 `*-STL` 目录中序号更大的目录。
- 规范化输出到 `UPP_STL处理/已处理STL数据/<CT号>/`。
- 数据库中 `upp_exam_assets.ct_number` 是主键，可用 list 的检查号查询对应 STL 路径；未来 CT 数据也可以继续挂在同一行。

运行：

```bash
cd /home/wkmgc/Desktop/PACS数据处理
PGHOST='<host>' PGPORT='<port>' PGDATABASE='<database>' PGUSER='<user>' PGPASSWORD='<password>' \
  python3 UPP_数据库构建/02_同步UPP_STL资产.py
```

主要表：

- `upp_exam_assets`：CT 号唯一资产索引，含 list 元数据、最终选中 STL 目录、候选目录、STL 文件清单。
- `upp_stl_files`：最终选中 STL 的 CT 级聚合表，每个 CT 号唯一一行，文件名、分割名、family、分类、路径和完整文件清单用 JSONB 存储。

STL 名称统计：

```bash
python3 UPP_数据库构建/03_统计STL名称.py
```

输出：

- `UPP_数据库构建/UPP_STL名称统计.json`
- `UPP_数据库构建/UPP_STL名称统计.csv`
- `UPP_数据库构建/UPP_STL_family统计.csv`
- `UPP_数据库构建/UPP_STL文件family顺序明细.csv`，含逐 CT 文件路径，默认不提交

常用查询：

```sql
SELECT ct_number, patient_name, processed_stl_dir, stl_file_count
FROM upp_exam_assets
WHERE ct_number = '<CT号>';
```