osirixfoundation/kheops-zipper

Kheops-Zipper Docker镜像文档

概述

Kheops-Zipper是OsiriX Foundation开发的Docker镜像，作为Kheops影像管理平台的组件，专注于DICOM（数字成像和通信医学）文件的压缩处理。该镜像提供高效的DICOM文件打包功能，便于影像数据的存储、传输和管理。

核心功能与特性

• DICOM文件压缩：支持将DICOM影像文件压缩为标准归档格式（如ZIP），减少存储空间占用。
• 批量处理：支持批量处理多个DICOM文件或文件夹，提高处理效率。
• Kheops平台集成：与Kheops***影像管理系统无缝集成，可作为平台流水线的一部分自动处理影像数据。
• 轻量级设计：基于优化的基础镜像构建，资源占用低，部署便捷。
• 标准化兼容：遵循DICOM标准，确保处理后的文件保持***影像数据的完整性和兼容性。

使用场景与适用范围

• ***影像中心：处理日常产生的DICOM影像文件，压缩后归档存储。
• 医院IT部门：整合到***影像管理工作流中，优化DICOM数据的传输和备份。
• 医学研究机构：对研究用DICOM数据集进行压缩处理，便于数据共享和分析。
• Kheops平台用户：作为Kheops生态的一部分，增强平台的DICOM数据管理能力。

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name kheops-zipper \
  -v /path/to/dicom/files:/input \
  -v /path/to/output:/output \
  docker.xuanyuan.run/osirixfoundation/kheops-zipper:master

• -v /path/to/dicom/files:/input：挂载本地DICOM文件目录至容器内/input，作为输入源。
• -v /path/to/output:/output：挂载本地目录至容器内/output，用于存放压缩后的文件。

环境变量配置

（注：以下为常见配置示例，具体参数请参考Kheops官方文档）

• INPUT_DIR：指定容器内输入目录路径，默认/input。
• OUTPUT_DIR：指定容器内输出目录路径，默认/output。
• COMPRESSION_LEVEL：压缩级别（1-9），数值越高压缩率越大，默认5。
• KHEOPS_API_URL：Kheops平台API地址，用于与Kheops系统集成（如自动上传压缩结果）。

Docker Compose示例

yaml
version: '3'
services:
  kheops-zipper:
    image: docker.xuanyuan.run/osirixfoundation/kheops-zipper:master
    volumes:
      - ./dicom_input:/input
      - ./dicom_output:/output
    environment:
      - COMPRESSION_LEVEL=6
      - KHEOPS_API_URL=http://kheops-server:8080/api
    restart: unless-stopped

注意事项

• 确保输入目录中的DICOM文件符合DICOM标准，避免非标准文件导致处理失败。
• 处理大量或大型DICOM文件时，建议为容器分配足够的CPU和内存资源。
• 作为Kheops平台组件，建议配合Kheops主平台使用以获得完整功能支持，具体集成方式请参考Kheops官方文档。