[ PROMPT_NODE_26676 ]
slide_management
[ SKILL_DOCUMENTATION ]
# 切片管理
## 概述
`Slide` 类是 Histolab 中处理全切片图像(WSI)的主要接口。它提供了加载、检查和处理存储在各种格式中的大型病理图像的方法。
## 初始化
python
from histolab.slide import Slide
# 使用 WSI 文件和输出目录初始化切片
slide = Slide(processed_path="path/to/processed/output",
slide_path="path/to/slide.svs")
**参数:**
- `slide_path`: 全切片图像文件的路径(支持多种格式:SVS、TIFF、NDPI 等)
- `processed_path`: 保存处理后输出(切片、缩略图等)的目录
## 加载示例数据
Histolab 提供了来自 TCGA 的内置示例数据集,用于测试和演示:
python
from histolab.data import prostate_tissue, ovarian_tissue, breast_tissue, heart_tissue, kidney_tissue
# 加载前列腺组织样本
prostate_svs, prostate_path = prostate_tissue()
slide = Slide(prostate_path, processed_path="output/")
可用的示例数据集:
- `prostate_tissue()`: 前列腺组织样本
- `ovarian_tissue()`: 卵巢组织样本
- `breast_tissue()`: 乳腺组织样本
- `heart_tissue()`: 心脏组织样本
- `kidney_tissue()`: 肾脏组织样本
## 关键属性
### 切片尺寸
python
# 获取 0 级(最高分辨率)的切片尺寸
width, height = slide.dimensions
# 获取特定金字塔级别的尺寸
level_dimensions = slide.level_dimensions
# 返回每个级别的 (width, height) 元组
### 放大倍率信息
python
# 获取基础放大倍率(例如 40x, 20x)
base_mag = slide.base_mpp # 0 级时的每像素微米数
# 获取所有可用级别
num_levels = slide.levels # 金字塔级别数
### 切片属性
python
# 访问 OpenSlide 属性字典
properties = slide.properties
# 常见属性包括:
# - slide.properties['openslide.objective-power']: 物镜倍率
# - slide.properties['openslide.mpp-x']: X 方向每像素微米数
# - slide.properties['openslide.mpp-y']: Y 方向每像素微米数
# - slide.properties['openslide.vendor']: 扫描仪厂商
## 缩略图生成
python
# 获取特定大小的缩略图
thumbnail = slide.thumbnail
# 将缩略图保存到磁盘
slide.save_thumbnail() # 保存到 processed_path
# 获取缩放后的缩略图
scaled_thumbnail = slide.scaled_image(scale_factor=32)
## 切片可视化
python
# 显示带有 mat 的切片缩略图