跳到正文

RodentFlow 是什么 ​

RodentFlow 是一款用于啮齿类动物行为实验的 iPhone App,覆盖从一段实验录像到组间比较的全过程:

  1. 追踪:在俯拍视频中追踪单只动物,并把它在校准后的场地或迷宫里的位置换算成厘米。
  2. 打分:根据位置计算区域时间、进入次数、距离、潜伏期、僵直,以及各实验范式特有的指标。
  3. 汇总:每只动物、每个实验阶段生成一条结果。结果也可以来自手动评分的数值,或其他软件导出的表格。
  4. 比较:按实验设计自动选择统计检验,画出显示每只动物数据点的图,并导出图、统计结果和数据。

所有计算都在手机上完成:不需要账号,没有服务器,不上传任何数据。见隐私政策。

RodentFlow 以 MIT 许可证开源,App 源代码和本手册都公开在 github.com/seesaw-earth/RodentFlow,见开源与构建。

两个标签页 ​

标签页用途
实验开始新实验:先选实验范式,再分析视频、录入数值或导入表格。结果卡片列出所有已保存的结果。
组间分析选择实验范式和测量指标,设定实验设计,查看该范式全部结果的统计和图表。

三种数据来源 ​

来源适用情况实验范式
视频追踪有单只动物的俯拍录像旷场、高架十字迷宫、明暗箱、Y 迷宫、T 迷宫、新物体识别、Morris 水迷宫、Barnes 迷宫、恐惧条件化、条件性位置偏好
手动录入人工打分(秒表、计数、称重)全部 15 种
表格导入数值来自电子表格或其他追踪软件(ANY-maze、EthoVision、DeepLabCut 后处理等)全部 15 种,外加任意自定义表格

三种来源生成的结果格式相同。同一范式下,视频、手动和导入的结果可以在组间分析中一起使用。

追踪器能测什么,不能测什么 ​

RodentFlow 使用经典、透明的追踪方法:背景减除,然后取动物身体的质心。追踪原理逐步讲解了每一步。开始之前,最好先了解这个选择带来的几点影响:

  • 每个场地一只动物。 每次分析只追踪校准区域内的一只动物。画面里如果并排拍了几个场地,可以逐个分析,每次校准其中一个。
  • 身体中心,而不是鼻尖。 追踪点是身体中心。新物体探索和 Barnes 探洞这类通常按鼻尖打分的指标,用物体或洞口周围一个足够大的区域来近似。设置方法见各范式页面。
  • 俯拍视角。 位置换算到地面平面上的厘米,前提是相机从上方往下拍。
  • 不做姿态估计或行为分类。 不识别直立、理毛、嗅探。僵直是根据前后帧像素变化测量的,这也是自动测量僵直的标准做法。

如果需要追踪身体部位,或者同一场地里有多只互动的动物,深度学习姿态估计工具更合适,延伸阅读列出了近年的主要工具。它们输出的每只动物的数据可以再导入 RodentFlow 做统计。

系统要求 ​

  • iPhone,iOS 17 或更高版本。
  • 英文或简体中文。App 跟随 iPhone 的系统语言。如果只想给 RodentFlow 换一种语言,点 Aa › Language / 语言,会打开 App 在“设置”里的页面。
  • 文字大小:Aa 菜单提供从“小”到“最大”五档,或“跟随 iPhone”。

本手册的结构 ​