热门搜索:
nipy/heudiconv
自动构建
nipy
HeuDiConv Docker镜像是一个灵活的启发式DICOM转换器，用于将脑成像数据组织为结构化目录，支持BIDS格式，结合dcm2niix实现快速转换，跟踪数据来源，并与DataLad集成实现版本控制。
11 次收藏下载次数: 0状态：自动构建维护者：nipy仓库类型：镜像最近更新：1 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你用 DeepSeek、元宝AI、Copilot 等 AI 代为编写轩辕镜像的 docker pull、修改 compose 镜像地址，或排查拉取失败等问题，请让 AI 先读规则再动手，只要在 AI 对话里直接发送下面这句话即可：
生成 docker pull、修改 compose 的 image，或排查拉取失败前，请先阅读并严格遵守 https://xuanyuan.cloud/agents.md 中的规则。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
HeuDiConv Docker镜像文档
镜像概述和主要用途
HeuDiConv是一个灵活的DICOM转换器，主要用于将脑成像数据组织成结构化的目录布局。Docker镜像提供了便捷的运行环境，无需复杂的本地配置，即可实现DICOM到NIfTI等格式的转换，并支持数据标准化、来源跟踪和版本控制等功能。
核心功能和特性
- 灵活的目录与命名：通过可自定义的启发式规则，支持灵活的目录结构和文件命名方案。
- 精准转换：仅处理必要的DICOM文件，忽略目录中无关数据。
- DICOM链接保留：可在参与者数据布局中保留指向原始DICOM文件的链接。
- 高效转换：基于dcm2niix工具实现快速的DICOM到NIfTI格式转换。
- 数据溯源跟踪：以W3C PROV格式记录从DICOM到NIfTI转换的完整溯源信息。
- BIDS格式支持：提供对BIDS（脑成像数据结构）格式转换的辅助功能。
- DataLad集成：与DataLad结合，将原始和转换后数据置于git/git-annex版本控制下，并自动标注含敏感信息的文件（如未去面部的解剖图像）。
使用场景和适用范围
- 回顾性研究数据转换：适用于已有研究数据的结构化整理，通过自定义启发式规则适配不同研究的数据组织需求。
- 前瞻性研究：遵循ReproIn命名约定的前瞻性研究，可直接使用ReproIn启发式实现标准化转换。
- 数据版本管理：需对原始和转换数据进行版本控制的场景，通过DataLad实现git/git-annex管理。
- 敏感信息合规：需自动识别并标注敏感信息文件的研究，确保数据处理合规性。
详细使用方法和配置说明
基本工作原理
HeuDiConv通过“启发式”（heuristic）规则处理DICOM元数据，决定转换后文件的命名与组织方式。启发式可通过内置规则（如convertall、reproin）或自定义脚本实现。
命令行基本格式
bashheudiconv -f HEURISTIC-FILE-OR-NAME -o OUTPUT-PATH --files INPUT-PATHs
关键参数说明
-f HEURISTIC-FILE-OR-NAME：指定启发式文件路径或内置名称convertall：无预设规则，通过编辑生成的映射文件自定义转换逻辑reproin：通用启发式，适用于遵循ReproIn约定的研究
-o OUTPUT-PATH：设置转换后数据的输出目录--files INPUT-PATHs：指定输入DICOM文件或目录的路径
自定义启发式
对于回顾性研究，建议参考https://github.com/nipy/heudiconv/tree/master/heudiconv/heuristics%E6%88%96%E5%AE%98%E6%96%B9%E6%96%87%E6%A1%A3%E5%88%9B%E5%BB%BA%E8%87%AA%E5%AE%9A%E4%B9%89%E5%90%AF%E5%8F%91%E5%BC%8F%E8%84%9A%E6%9C%AC%E3%80%82
Docker运行示例
bashdocker run -v /本地/dicom数据路径:/input -v /本地/输出路径:/output nipy/heudiconv:latest \ -f reproin -o /output --files /input
注：需将
/本地/dicom数据路径和/本地/输出路径替换为实际本地路径，确保Docker容器可访问。
更多选项
通过heudiconv --help查看完整命令行选项，或参考官方使用文档。
引用与文档
- 版本引用：使用特定版本时，请引用对应的Zenodo记录
- 详细文档：参见HeuDiConv官方文档
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull nipy/heudiconv:<标签>
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
用 AI 使用轩辕镜像
发给 Cursor、ChatGPT、豆包等 AI 的说明文档
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
轩辕镜像支持 docker push 上传本地镜像吗？
不支持 push
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"