如何快速掌握 QuPath：生物图像分析与数字病理学的终极工具指南

QuPath 是一款强大的开源生物图像分析与数字病理学工具，专为研究人员和病理学家设计，能够高效处理和分析生物医学图像。本文将详细介绍如何安装、配置和使用 QuPath，帮助你快速上手这款强大的工具。

📋 目录

• 📥 下载与安装 QuPath
• ⚙️ 配置 QuPath
• 🚀 启动 QuPath
• 🔍 QuPath 核心功能介绍
• 📚 扩展与插件
• ❓ 常见问题解答

📥 下载与安装 QuPath

从源码构建安装

如果你想获取最新版本的 QuPath，可以通过源码构建安装。首先，克隆 QuPath 仓库：

git clone https://gitcode.com/gh_mirrors/qu/qupath.git
cd qupath

然后，使用 Gradle 构建项目。在项目根目录下运行：

./gradlew build

构建完成后，可在 build/distributions 目录下找到相应的安装包。

不同操作系统的安装包

QuPath 提供了适用于不同操作系统的安装包，你可以根据自己的系统选择合适的版本：

• Windows：提供 MSI 安装包和 ZIP 压缩包，ZIP 压缩包适用于便携式版本。
• macOS：提供 Intel 和 Apple Silicon 编译版的 PKG 安装包。
• Linux：提供 TAR.XZ 的压缩包，下载后手动解压即可运行。

⚙️ 配置 QuPath

QuPath 的大部分设置可以通过图形界面中的菜单项进行调整。不过，对于一些高级设置，你可能需要修改配置文件。这些配置文件通常存储在用户主目录下的隐藏目录中：

• Windows：%APPDATA%\QuPath
• macOS：~/Library/Application Support/QuPath
• Linux：~/.config/QuPath

在这些目录中，你可以找到 application.properties 等配置文件，用于自定义颜色方案、数据库位置、语言偏好等设置。修改配置文件前，建议备份原始文件，以防意外丢失重要设置。

🚀 启动 QuPath

QuPath 的启动方式因操作系统而异：

• Windows：安装完成后，在开始菜单中找到 QuPath 并点击启动，或直接运行安装目录下的可执行文件。
• macOS：将 QuPath 应用拖入 Applications 文件夹，然后双击启动。
• Linux：解压 TAR.XZ 压缩包后，进入解压目录，运行 QuPath 可执行文件。

🔍 QuPath 核心功能介绍

QuPath 作为一款专业的生物图像分析工具，具有丰富的核心功能，以下是一些主要功能模块：

图像导入与处理

QuPath 支持多种图像格式，包括常见的医学图像格式。你可以通过 qupath-core/src/main/java/qupath/lib/images 模块下的相关代码了解图像导入和处理的实现细节。

病理图像分析

在数字病理学分析方面，QuPath 提供了强大的工具集，如细胞检测、组织分割等。相关功能的实现可以参考 qupath-core-processing/src/main/java/qupath/opencv 模块。

扩展功能

QuPath 支持通过扩展来增强功能，如 qupath-extension-bioformats 扩展提供了对更多生物图像格式的支持，qupath-extension-openslide 扩展则支持 Openslide 格式的图像。

📚 扩展与插件

QuPath 拥有丰富的扩展和插件生态，你可以根据自己的需求安装相应的扩展。以下是一些常用的扩展：

• qupath-extension-bioformats：提供对更多生物图像格式的支持。
• qupath-extension-openslide：支持 Openslide 格式的图像。
• qupath-extension-script-editor：提供脚本编辑功能，方便用户编写自定义分析脚本。
• qupath-extension-svg：支持 SVG 图像的导入和导出。

你可以在 QuPath 的官方文档中找到更多关于扩展的信息。

❓ 常见问题解答

QuPath 支持哪些图像格式？

QuPath 支持多种图像格式，包括但不限于 TIFF、JPEG、PNG 等常见格式，以及一些医学专用图像格式。通过安装 qupath-extension-bioformats 等扩展，还可以支持更多生物图像格式。

如何自定义 QuPath 的颜色方案？

你可以通过修改配置文件来自定义 QuPath 的颜色方案。配置文件通常位于用户主目录下的 .config/QuPath（Linux）、%APPDATA%\QuPath（Windows）或 ~/Library/Application Support/QuPath（macOS）目录中。

QuPath 是否支持脚本编写？

是的，QuPath 支持脚本编写。你可以安装 qupath-extension-script-editor 扩展，在图形界面中进行脚本编辑和运行，实现自定义的分析流程。

希望本文能够帮助你快速掌握 QuPath 的安装、配置和使用。如果你在使用过程中遇到其他问题，可以查阅 QuPath 的官方文档或社区论坛获取帮助。