分割输出的 mask.tif 使用 uint32。零表示背景,同一个正整数表示同一个实例,但整数大小不代表置信度、细胞类别或重要性。
稀疏标签下 max 会算错
假设掩膜标签为 0,2,2,9,9,实际有两个实例,而最大标签是九。项目的 _instance_count 使用 unique,再扣掉存在的背景零值,避免了“最大值等于实例数”的错误假设。
标签集合 {0, 2, 9} → 2 个实例
标签集合 {2, 9} → 2 个实例
标签集合 {0} → 0 个实例这个算法也没有要求背景必须存在。对没有零值的掩膜,不能无条件用 unique 数量减一。背景约定和标签连续性是两回事。
uint32 保存的是标签,不是原图强度
掩膜中一个像素的值描述实例归属,不是灰度或荧光强度。要测原图的每实例信号,需要用标签作为选择区域,回到原始图像采样,而不是读取掩膜数字或预览颜色。
源码把模型结果强制转换为 uint32,再统计与写盘。这适合预期的非负整数标签;若服务需要防御异常模型输出,还应在转换前验证有限性、非负与整数属性,避免类型转换掩盖不符合契约的数值。这是增强建议,不代表当前模型输出有问题。
标签只能在本次图像内解释
第九号实例在下一张图片里不一定还是同一个细胞,也不保证同一图片换参数后仍保持编号。跨图追踪需要额外的配准与匹配,不能比较标签数字就得出细胞迁移结论。
建议用人工小掩膜测试统计函数:纯背景、无背景、稀疏标签与多个断开区域共享同一标签。最后一种情况下,代码按标签数实例,而不是按连通域数实例,这正是标签契约的含义。
本文分析的是文件语义与统计算法,没有运行真实分割。理解标签的含义,是后续面积、计数和追踪不出错的基础。
源码与阅读导航
本文属于「细胞分割工具链笔记」第 07 篇。依据固定提交 fd43764aac23 研读,后续版本可能不同。
- cellpose-server/app.py,第 108–111 行
- cellpose-server/app.py,第 195–228 行
- cellpose-segmentation/SKILL.zh-CN.md,第 15–25 行
全部专题与阅读顺序 · 上一篇:请求取消后后台线程可能还在跑:推理锁的一个细微边界 · 下一篇:让 CSV、掩膜与元数据互相校验:分割结果的三个不变量
还没有评论
欢迎留下你的观点,保持交流的清晰和友好。