SuperAPI AI 工具集

histolab

设计与创作

查看项目

更新于 10-15 21:34

技能介绍

用途:面向数字病理全切片图像(WSI)的处理工具库,自动完成组织检测、从亿像素级图像中提取信息性组织块(tile),为深度学习流程准备数据集,适用于 H&E、IHC 等染色切片。

主要能力:

  1. 切片管理(Slide):加载 SVS、TIFF、NDPI 等格式,读取尺寸、放大倍数等元数据,生成缩略图,处理金字塔层级,按坐标提取区域。
  2. 组织检测与掩膜:TissueMask 分割全部组织区域;BiggestTissueBoxMask 返回最大组织区域边界框(多数提取器的默认值);BinaryMask 可自定义掩膜。
  3. 组织块提取:RandomTiler 随机抽取固定数量区块(适合采样与训练数据);GridTiler 网格系统覆盖(适合完整覆盖与重建);ScoreTiler 按评分函数选取高排名区块(可用 NucleiScorer、CellularityScorer 或自定义)。公共参数含 tile_size、level、check_tissue、tissue_percent(默认 80%)、extraction_mask。
  4. 过滤器与预处理:图像过滤器(RgbToGrayscale、RgbToHsv、RgbToHed、OtsuThreshold、AdaptiveThreshold、StretchContrast 等)、形态学过滤器(BinaryDilation、BinaryErosion、BinaryOpening、BinaryClosing、RemoveSmallObjects、RemoveSmallHoles)以及 Compose 组合流水线。
  5. 可视化:查看缩略图、掩膜(locate_mask)、区块位置(locate_tiles)、提取区块与拼图,评估质量,导出图表与报告。

安装:uv pip install histolab

基本用法:从 histolab.slide 导入 Slide,从 histolab.tiler 导入 RandomTiler;用 Slide("slide.svs", processed_path="output/") 加载;配置 RandomTiler(tile_size=(512,512), n_tiles=100, level=0, seed=42);先用 locate_tiles 预览,再调用 extract 提取。ScoreTiler 可用 report_path 输出 CSV 报告;GridTiler 可用 pixel_overlap 支持滑窗。

适用场景:训练深度学习模型的数据集构建、全切片分析、组织特征刻画、质量评估、数据集策展、多切片批量处理。

限制:本资料未说明授权方式、收费与价格信息;实际使用效果受切片格式、染色类型与硬件条件影响,资料建议先预览掩膜与区块位置再提取,并注意组织覆盖率阈值与金字塔层级的取舍。常见问题包括未提取到区块(可降低 tissue_percent、检查缩略图与掩膜)和背景区块过多。