SuperAPI AI 工具集

pydicom

数据与分析

查看项目

更新于 10-15 23:43

技能介绍

用途:pydicom 用于本地 DICOM 数据集 I/O 与像素处理,当前稳定版为 3.0.2,修复了 CVE-2026-32711(DICOMDIR 路径穿越)。它声明支持 Python >=3.10,内置 DICOM 字典为 2024c。该技能只处理本地文件,不涉及 PACS、DIMSE、DICOMweb 或认证服务。

主要能力:使用 dcmread() 读取文件(可 stop_before_pixels=True、specific_tags 白名单),按关键字或标签访问数据元素与序列,用 FileMetaDataset 和 dcmwrite(enforce_file_format=True) 写入文件。pydicom.pixels 的 pixel_array() 支持按帧解码,apply_modality_lut 与 apply_voi_lut 用于灰度显示变换;Dataset.decompress() 与 compress(uid) 可原地处理压缩,支持 RLE Lossless、JPEG-LS、JPEG 2000 等。

使用方式:安装 uv pip install "pydicom==3.0.2";像素数组与渲染可加 numpy 和 Pillow;压缩插件按需安装 pylibjpeg、pyjpegls 或 python-gdcm。附带脚本包括 extract_metadata.py、dicom_inventory.py、transfer_syntax_inspector.py、pixel_frame_planner.py、dicom_to_image.py、anonymize_dicom.py、deidentification_audit.py 和 uid_mapping_validator.py,可在 skills/pydicom/ 下运行。

限制:pydicom 不是诊断查看器,像素输出、校验与转换不构成诊断声明。它提供去标识化脚本,但 PS3.15 不保证去除所有身份信息,需由隐私/DICOM 专家核验,不能声称符合 HIPAA、GDPR 等。伪名化密钥与 UID 映射属于再识别机密。处理不受信任数据前应设置输入文件数、帧数与解码字节上限;其内置渲染器会拒绝功能性组对象、Real World Value Mapping 等情形,min/max PNG/TIFF 只是预览而非校准输出。