Weasis:免费开源的DICOM医学影像查看器与3D分析工作站(完整上手指南)
Weasis免费开源的DICOM医学影像查看器与3D分析工作站完整上手指南【免费下载链接】WeasisWeasis is a web-based DICOM viewer for advanced medical imaging and seamless PACS integration.项目地址: https://gitcode.com/gh_mirrors/we/Weasis一个文件夹里的DICOM文件用系统自带看图工具打不开、甚至识别不出格式怎么办Weasis就是一个免费开源的医学影像DICOM查看器你在Windows、macOS或Linux上打开CT、MRI、超声序列能做窗宽窗位调节、线性/角度测量、多平面重建MPR即从体数据里切出冠状面、矢状面的技术和3D容积渲染还能直连医院现有的PACS系统医院用来集中存储影像的服务器。初见Weasis一个看片工具能到什么程度下图是Weasis的主界面左侧是患者与序列的浏览器树中间是多视图影像区右侧和底部可以挂工具面板和3D视图。刚打开它你可能会觉得信息量有点大但每个区域都可以拖拽停靠用几次就顺了。图中是Weasis启动后的典型布局多窗口影像显示、序列浏览器与工具面板并存方便你在同一屏内完成浏览、测量和3D重建。不用买商业软件的钱功能不缩水结论这是一份免费但按商业标准打磨的替代品采用EPL 2.0 / Apache 2.0双许可个人和机构都能直接商用。依据CT、MRI、超声、乳腺数字化摄影、结构化报告SR、心电图ECG、放疗计划RT这些专科数据它都内置了专用查看器而不是只显示一张灰度图。商业软件里常见的倾斜多平面重建、PET/CT融合显示、最大密度投影MIP把体数据按最大像素值投影成一张图常用于看血管在这里一应俱全。三大系统都有官方安装包结论不需要你折腾运行环境。Windows、macOS、Linux各平台的桌面发行版由官方用jpackage统一构建和代码签名你下载对应安装包一路下一步即可。界面支持20多种语言包括简体中文高DPI屏幕下缩放也没有问题——这对医院里常见的2K/4K诊室显示器很关键。从本地光盘到PACS一条链路都能打通结论不管你的数据在本地还是网络上Weasis都有现成的接入方式。本地DICOM文件夹、CD/DVD光盘、ZIP包可以直接打开网络端支持经典DIMSE协议C-FIND/C-GET/C-STOR、DICOMwebQIDO-RS、WADO-RS、STOW-RS和WADO-URI医院门户或电子病历里放一个weasis://链接单击就能带着检查任务启动查看器并自动加载序列。不只是看还能量和发结论测量结果能按DICOM Presentation States一种DICOM标准的图形叠加格式或XML保存导出3D视图可录制成AVI/MP4。这意味着你的测量不是截图上的铅笔线而是带坐标、能回传到报告系统里的结构化数据——这是教学演示和科研统计真正需要的形态。5分钟上手从零到看到第一张图假设你手上有一个CT序列文件夹我们按实际使用顺序走一遍。第1步安装并启动下载对应操作系统的安装包并运行安装向导如果你打算参与开发也可以直接克隆源码构建git clone https://gitcode.com/gh_mirrors/we/Weasis然后执行mvn clean install构建需要JDK 25和Maven 3.8.1。启动后你会看到主窗口左侧浏览器、中间空白影像区、上方工具栏。避坑提示日志默认写在用户主目录下的.weasis/log/遇到启动问题先看最后几行比界面报错信息更有用。第2步把数据拖进来把DICOM文件夹或光盘挂载目录直接拖进窗口Weasis会解析DICOMDIR光盘/目录的索引文件或逐文件识别几秒后左侧按患者→检查→序列的层级展开选中序列双击中间区域出现影像。你也可以在右侧DICOM浏览器里配置PACS节点做远程检索C-FIND。避坑提示如果拖入后识别出的序列数偏少多半是文件夹里混了非DICOM文件或子目录结构太乱先在资源管理器里确认文件后缀和内容。第3步调窗宽窗位、滚序列选中一幅图像后按住鼠标中键拖动调窗宽窗位滚轮上下滚动切换层面滚轮缩放、右键拖拽平移这些都能改。肺窗、骨窗这类预设可以直接套用。避坑提示多视图布局下如果各视图窗宽窗位不同步检查是否勾选了视图同步不同检查的孤立项会被自动排除在同步组外避免你把无关解剖对着比。第4步量一个病灶在工具栏选线性测量在影像上点两点信息层会显示真实毫米距离依据像素间距而不是屏幕像素再选区域统计工具圈选病灶能拿到最小、最大、均值、标准差、偏度、峰度、熵一整套统计值角度工具支持Cobb角用于脊柱侧弯评估。避坑提示如果信息层提示像素间距不一致之类的几何警告说明序列本身层厚/间距不规整测量前最好先跟技师确认采集参数。第5步导出结果图像区右键可把当前视图存成PNG/JPEG测量和标注可以另存为DICOM Presentation States或XML3D视图支持录制旋转动画。需要发回PACS时用C-STORE或STOW-RS直接推送到远端服务器。不同拿数据的方式适合不同场景选错方式会多绕很多弯路方式操作适合场景本地拖放文件夹拖入窗口即可单机工作站、U盘/工作站间拷贝的数据CD/DVD光盘直接打开光盘目录门诊外送胶片数字化、会诊携带PACS网络检索在DICOM浏览器配置节点后C-FIND检索院内日常调阅数据量大weasis://协议门户/HIS里放一个链接单击启动系统集成场景想一键带着检查单进查看器把Weasis用到真实工作里挑三个最高频的用法每套流程都能直接照做。放射科读片从调阅到出测量在DICOM浏览器中按患者姓名或检查日期检索序列双击载入用预设窗宽窗位快速浏览全序列滚轮方向键在相邻层面间切换开启多视图同步滚动逐层比对病灶位置必要时切出MPR斜切面用线性工具量最大径、区域统计工具测CT均值结果自动带上真实单位把视图截图为PNG、测量结果存为Presentation States随报告导出。教学与科研3D重建与曲线重建选中CT序列进入3D视图套用内置容积渲染预设调节透明度和颜色LUT口腔CBCT场景下用曲线MPRCPR在轴位上描一条牙弓曲线自动展开成全景图和各截面——曲线MPR的实现细节值得一读若有SEG分割文件AI算法输出的体素标签2D/3D里都能叠加显示逐区域控制颜色、透明度还能读体积和体素数录制3D旋转动画用于课件把分割区域的统计值导出做批量分析。把非DICOM材料变成DICOM打开内置的Acquire/Dicomizer模块源码在 weasis-acquire/导入普通图片、视频、PDF或STL网格模型选择对应模态的预设填好患者和检查信息导出标准DICOM文件视频会自动校验尺寸——这样教学素材、设备样片都能进入统一的影像流转体系。让它更顺手配置与调优界面层能调的地方不少深色/浅色主题、工具栏布局、全局键盘快捷键、多显示器下逐屏校准保证屏幕上1厘米就是1厘米语言则从20种里选。这些都在偏好对话框里分层生效默认值 → 工作站级 → 用户级逐级覆盖医院IT可以统一推工作站配置医生个人习惯不会被冲掉。性能上最容易卡住的其实是内存。Weasis解码后的像素数据放在JVM堆之外的原生内存里它按物理内存自动计算预算默认取50%。如果你把它当专用读片工作站可以把比例调高让缓存住更多序列、少触发重新加载-Dweasis.native.memory.percent703D重度使用且显存吃紧时再压低体数据分块暂存-Dweasis.volume.staging.memory33554432约32MB。这两个参数启动时读取一次改完要重启。完整的预算公式和三块内存区域的划分官方有篇内存管理文档写得非常清楚强烈建议大内存场景先读它再动手调。幕后一览架构与安全模块划分很清爽weasis-launcher/负责启动并拉起Felix OSGi框架weasis-core/是通用图像查看内核兼插件SDKweasis-dicom/下拆成2D查看、3D、编码、SR、RT、音频、发送、C-STORE等十几个bundle另有 weasis-imageio/ 和 weasis-opencv/ 处理原生编解码依赖。每个bundle对外暴露的API都在.internal包之外扩展时边界很明确。安全实践面向医疗环境设计接入端支持OAuth 2.0 / OpenID Connect兼容Keycloak等标准身份提供商传输走HTTPS安装包经代码签名供应链侧用SBOM跟踪依赖并持续做CVE监控每次构建都过SonarCloud质量门禁单元和集成测试覆盖DICOM解码、认证、测量统计这些敏感链路。想做二次开发仓库自带Maven Archetype装一次cd archetype mvn install再用mvn archetype:generate -DarchetypeCataloglocal选 weasis-plugin-dicom-viewer 模板就能生成带工具栏和测量工具的插件骨架改完直接进查看器验证。避坑指南FAQQ打开某个序列时报无法识别的DICOM文件或整串识别不出来先下结论大概率是文件本身不完整或压缩格式不在支持范围内。排查顺序① 用文本方式打开文件头看是否缺DICOM前缀② 确认压缩编码是否在支持列表JPEG各变种、JPEG-LS、JPEG 2000、JPEG-XL、RLE③ 如果是PACS拉取失败看.weasis/log/里的网络日志多半是AE Title或端口没对上。Q3D视图转起来卡、显存占用高结论先降分块暂存和渲染质量再谈硬件。依次试① 调低-Dweasis.volume.staging.memory② 确认显卡驱动是新版3D走JOGL/GPU管线③ 专用机上把-Dweasis.native.memory.percent提到70左右让序列少重载④ 关掉同机其他吃显存的应用。Q自己mvn install构建失败提示enforcer或spotless错误结论JDK版本不对或代码格式不合规两者都会直接失败。构建要求JDK 25和Maven 3.8.1先mvn -v核对spotless报错就执行mvn spotless:apply让格式化和许可头自动修复再重新构建。Q信息层出现像素间距/层间距不一致的黄色提示结论这是Weasis主动告诉你源数据几何不规整不是软件bug。处理办法该序列做MPR或体积类测量前先与采集方核实参数或者改用单幅层面的测量方式显示本身不受影响可以放心浏览。下一步一句话总结Weasis把看片、量片、发片整条链路做成了一个免费开源、三大平台通吃的DICOM工作站从拖入文件夹到导出Presentation States中间不需要任何商业授权。下载与你系统匹配的最新版安装包装完直接拖一个DICOM文件夹进去试读片用一个CT序列完整走一遍窗宽窗位 → 线性测量 → 区域统计 → 导出PNG配置一个weasis://链接体会从浏览器单击直达查看器的集成体验跑通 Archetype 生成一个自己的测量插件感受扩展边界遇到内存或3D性能问题带着本文的两个参数去翻内存管理文档把机器调到合适的工作点。影像数据就在那差的只是一个顺手能打开它的工具——现在就装一个Weasis把第一张片子量起来吧。【免费下载链接】WeasisWeasis is a web-based DICOM viewer for advanced medical imaging and seamless PACS integration.项目地址: https://gitcode.com/gh_mirrors/we/Weasis创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考