补充视频1和2提供了使用Jupyter笔记本的简短教程。以下开源软件包用于视频导入、数据处理和交互式绘图：iPython5、OpenCV6、Pandas7、HoloViews8、SciPy9、Matplotlib10、Bokeh11和NumPy12。值得注意的是，软件包版本由Conda维护，并在安装说明中对其进行控制。因此，不应出现包兼容性问题。尽管如此，我们仍积极维护我们的Github页面，并将随着新功能的添加和新软件包版本的推出而对ezTrack进行更新。此外，我们欢迎ezTrack Github页面上的反馈和错误报告，并鼓励用户观看ezTrack Github页面，以便了解任何新版本。

视频采集建议

虽然ezTrack可以处理各种各样的视频，但某些情况会导致跟踪不可靠。采集的视频必须使用安装的摄像头进行拍摄，以便在整个录制过程中固定视野。同样，尽管两个跟踪模块都与多个记录角度兼容（例如动物上方或侧面），但在单个实验过程中保持摄像机与竞技场之间的方向关系以及摄像机与竞技场之间的距离至关重要。此外，ezTrack在动物和背景之间有良好对比的条件下工作得最好——如果人类实验者很难看到动物，ezTrack计算动物的重心并跟踪其位置可能会有问题。ezTrack被编程为能够抵抗视野中动物以外的物体的影响。支持视频帧的裁剪，并且位置跟踪模块具有减少可能进入视野的对象的影响的功能：加权动物在前一帧上的位置周围的区域（详细描述如下）。然而，当只有动物和稳定的环境在视野内时，ezTrack将工作得最好。此外，动物不应能够退出和重新进入视野。考虑到这一点，我们不应该过于严格地裁剪，以至于如果动物重新站立，它就会从视野中消失——我们发现，连接到动物身上的电缆所产生的大部分人工制品都会出现在动物头部上方一定距离的地方，而在那里，线的松弛程度最大。如果一个人正在做光遗传学实验，而来自光纤的光很可能会泄漏，我们建议使用不会拾取刺激光源波长的红外摄像机。在当前状态下，ezTrack只跟踪一只动物。用一台摄像机同时记录多个竞技场是可能的。然而，目前，实验者将不得不单独分析每个竞技场，将其他竞技场从视野中剔除。所有批处理功能都假定摄影机的位置、视野内环境的位置以及照明条件在会话中是一致的。我们已经用wmv、avi（mp4编解码器）和mpg1视频测试了ezTrack，但可以使用更多的视频文件类型。如果您的特定文件类型不受支持，有几个免费的视频转换器在线提供。最后，请注意，处理高清视频可能需要更长的时间，可能需要对视频进行下采样/压缩。

位置跟踪模块

一般说明

位置跟踪模块逐帧跟踪视野内动物的重心。根据这一点，可以计算出动物行走的距离及其在特定ROI中花费的时间。视频可以俯视动物，也可以从侧面拍摄，尽管侧视记录可以将距离测量放在任意比例上。使用绘图工具箱，用户可以裁剪视野，并且用户还可以将视频分析限制在特定范围内（例如，帧500–1000）。此外，用户可以绘制无限数量的ROI，对于每一帧，ezTrack将确定动物是否在特定区域。值得注意的是，允许ROI重叠，从而允许分析子区域。在运行代码时，会生成交互式绘图，使用户可以查看会话中经过的距离以及动物的去向。作为一项附加功能，如果视频文件较小（例如100 × 100像素），或者如果它们是奇数尺寸（例如30 × 1000像素），ezTrack允许用户水平/垂直拉伸视频以进行演示。动物在x/y坐标中的逐帧位置，以及动物是否在每个定义的ROI中，都保存到csv文件中。如果用户需要摘要信息，则会提供用于指定时间段的选项，并且会生成一个摘要文件，给出每个时间段中行驶的距离，以及位置跟踪方法

位置跟踪是通过将视频中的每一帧与环境中不存在动物的参考帧进行比较来实现的。ezTrack支持两种定义此参照系的方法。更简单、更快且通常更可靠的选择是从正在分析的视频（即，带有动物的视频）生成参考帧。ezTrack将根据视频中的随机帧样本生成参考帧（默认值） = 100). 对于视场中的每个像素，取整个帧选择的中值。关键的是，该中间图像可能不会包含该动物，除非该动物在一个位置的时间超过50%。如果出现这种情况，用户可以交替地提供具有相同照明条件的相同环境的单独视频，并且该环境在视野中处于相同位置，但没有动物。批处理时，始终使用第一个选项，以便从该视频生成每个视频的参考帧。

接下来，为了确定动物的重心，对于每一帧，逐像素计算与参考帧的灰度强度差。这可以通过获取两帧之间的绝对差来实现，这允许跟踪，而不管动物是比背景亮还是暗。或者，可以假设动物比背景更亮或更暗（分别从每个帧中减去参考帧或从参考帧中减去每个帧）。在某些情况下，后一种方法可能更可靠。为了减轻计算质心时像素强度值的随机、低强度波动的影响，我们发现质心会极大地影响精度，然后对像素差异进行阈值化，以便仅考虑用户定义的所有像素差异百分位数以上的差异值。我们使用了第99个百分位数，这非常有效。值得注意的是，由于该标准相对缩放，如果动物从竞技场的高对比度区域移动到低对比度区域，通常会被同样好地跟踪，如在明暗框中（见图1）。最后，计算这些值上的重心，返回动物的x/y坐标。

如果有物体进入视野，将重心偏压在动物和干扰物体之间，ezTrack允许用户对动物先前位置周围的像素进行加权，以减轻这种偏压。对于每一帧，重量（ω）可应用于前一帧动物重心周围的方形窗口，其大小由用户设定。窗口外的像素差值乘以（1 − ω） ，其中ω设置为0和1之间。因此，如果ω = 1，窗口外的像素值差异将设置为0。相比之下，如果ω = 0时，窗的内部/外部承受相同的重量。这样，可以将窗口外像素变化的影响限制在由单个参数ω控制的最小水平。为了避免动物移出窗口的潜在问题（例如，当记录在动物进入视野之前开始时），ω也可以设置为0–1之间的某个值，这将允许窗口“快速”回到动物身上。我们使用ω = 0.8–0.9，效果良好。示例参见补充图S1。

最后，动物从一帧移动到下一帧的距离计算为相邻帧上质心之间的欧几里得距离。

值得注意的是，用户需要设置的唯一参数是将像素差值设置为零的百分比。其他两个参数——设置重量和窗口大小，以对前一帧动物位置附近的差值进行加权——是可选的。

冻结分析模块

一般说明

为了检测冻结，ezTrack首先通过计算灰度值从一帧到下一帧变化的像素数来测量动物的运动。但是，由于大多数视频显示像素值的许多小波动，即使在静态场景中，也必须首先设置一个截止值，以将可归因于动物移动的像素变化与盒子中没有动物时发生的像素变化分开。ezTrack提供了一个校准工具，用于检查空盒视频的灰度变化分布，并提供了建议的截止值。有鉴于此，用户必须在实验过程中生成调节室的短视频，其中没有动物，以便在实验会话和校准视频之间基本像素波动相等。校准后，用户可以分析同一环境中的动物视频。经测量校准后，用户可以分析同一环境中的动物视频。测量动物的运动后，可以通过评估动物的运动下降到用户定义的阈值以下的时间量来计算冻结。有关教程，请参见补充视频2。

冷冻分析方法

校准：为了减轻由于噪声引起的像素值的小波动，我们发现首先实现高斯滤波器（sigma）是有帮助的 = 1） 在每个图像上。然后，我们计算连续帧上的像素级差异，并计算差异值超过某个截止值（运动阈值或MT）的像素数。为了定义MT，用户提供一个没有动物的录制环境的短视频（~10） 秒）。ezTrack然后将计算该时间段内像素灰度变化的分布。然后可以基于此空分布设置MT。通过我们的特殊设置，我们发现99.99%的两倍有效。然而，ezTrack提供了差值分布的直方图，并且还使用户能够看到在给定MT（补充视频5）中，哪些运动与原始视频并排拾取。如果用户感觉到太多噪声或检测到的信号不足，他们可以根据自己的需要修改MT。唯一的建议是，在单个实验中，他们在所有动物身上都保持这一阈值。如果视频设置在几天内没有改变，我们发现给定环境的MT非常稳定。

测量运动/冻结：一旦用户定义了MT，他们就可以在单个会话中分析运动和冻结。对每一帧进行高斯滤波，并确定其相对于前一帧的灰度变化超过MT的像素数。然后，用户可以为声明冻结的更改像素数设置阈值–冻结阈值或英尺。作为附加标准，可以设置最小冻结持续时间（例如半秒）。因此，对于任何给定的连续帧，其中改变的像素数在至少最小冻结持续时间内低于FT，动物将被标记为冻结。用户可以通过首先检查整个会话中的运动图（即改变的像素）并记录对应于明显低点（可能是冻结点）的值来设置FT。在选择一个暂定的FT后，他们可以观看视频，在视频中他们可以检查阈值的准确性，并根据自己的喜好进行调整（补充视频2和4）。当用户对一组参数感到满意时，他们可以继续批量处理多个视频。批处理时，将为每个视频保存包含逐帧运动和冻结值的单个csv文件。此外，用户可以定义时间仓位，并为每个视频返回一个摘要文件，其中包含每个时间仓位期间的平均冻结和运动。

行为测试和手动评分

人工评分

所有手动评分均采用时间取样程序进行，其中每1-2分钟评估一次动物的瞬时位置/冷冻 第（2）节 第二节冻结，1 所有其他行为的第二节）。冻结被定义为缺乏运动、呼吸受阻和头部轻微摆动。值得注意的是，由于这是一个时间取样程序，动物只需要在取样时冷冻，而不需要在整个2小时内冷冻 采样前的秒数。该方法与冷冻行为的经典分析3,13,14,15一致。为了确定动物在室内的位置，需要判断动物中心的位置。然后，通过检查随时间变化的几个反应，将分类反应转化为比例。

动物

所有试验均使用来自Jackson实验室的成年雄性C57/BL6J小鼠。动物被安置在温度、湿度和光线控制的活体动物饲养场，从实验测试室沿着大厅向下，早上7点开灯，晚上7点关灯。除了在直线轨道上奔跑的动物外，食物和水可以随意获得，因为水被限制在保持体重85–90%的范围内。缺水包括分配动物~1 每天毫升水，包括测试期间获得的水。试验期间未获得的水在试验期后提供。在训练/测试1-5天之前，将动物驯服于处理5-7天 分钟/天。所有实验均按照西奈山伊坎医学院机构动物护理和使用委员会批准的相关指南和规定进行。

行为

恐惧制约。将动物放在一个新的调节室中（Med Associates VFC-008；30.5 × 24.1 × 21 cm）具有明显的气味（5%纯绿色），并接受0、1或3次紧急足击（1 马，2岁 秒）。第一次电击是在2分钟后行为

恐惧制约。将动物放在一个新的调节室中（Med Associates VFC-008；30.5 × 24.1 × 21 cm）具有明显的气味（5%纯绿色），并接受0、1或3次紧急足击（1 马，2岁 秒）。第一次电击是在2分钟后实施的 每分钟基线检查和随后的每次电击在1分钟后进行 分钟。2只动物被移除 在最后一次电击后的几分钟内，他回到了维瓦里。将未封闭的动物放入试验室的时间与接受1次电击的动物相同。在随后的一天，动物被放回到这个环境中5分钟 没有电击的分钟测试课程。使用红外摄像机（Med Associates）以每秒30帧的速度记录行为。使用ezTrack的自动评分使用0.5 第二个最小冻结持续时间和视频帧顶部被裁剪，以消除迷你镜电缆的影响（如适用）。对冷冻时间进行了评估。戴迷你们镜的动物需要的阈值与不戴迷你们镜的动物略有不同，但在其他方面，所有动物都使用相同的冷冻阈值，这是通过对视频子集的目视检查确定的。共使用17只动物（无休克） = 5，1电击 = 6、3次冲击 = 6). 其中8只动物植入了迷你们显微镜。

条件位置偏好。调节持续了两天。每天，动物被限制在调节室的一侧（每侧尺寸：20） × 20 × 29 15厘米 注射生理盐水或可卡因后的分钟（15 mg/kg，i.p.）。在整个训练过程中，他们被交替放置在两侧，这样一来，其中一方就会与可卡因有关。第二天，动物被放回房间15分钟 分钟，并允许自由探索其两面。检查可卡因配对侧的时间量。此外，训练期间行驶的距离使用ezTrack的距离输出进行测量，计算为连续帧上动物位置的欧几里得距离。共使用了4只动物。

明暗试验。动物被放置在一个房间里（30.5 × 24.1 × 21 cm）带有一个连接其两侧的小开口，一侧明亮（约400流明），另一侧昏暗（约10流明）。记录动物的黑暗面正面覆盖着一层红色透明薄膜，以防止白光扩散到盒子中；明亮一面的正面是半透明的。为了便于观察动物，使用了红外光和照相机（因此，图1中的照明不会反射动物感知到的照明）。测量了花在黑暗面上的时间比例。共使用了4只动物。

高架+迷宫。动物被放置在一个加高的平台中心，平台上有两个带壁的手臂（闭合）和两个未带壁的手臂（开放），持续两分钟半。每只手臂的测量值为29.2 × 7.6 cm，EPM暂停53.3秒 离地1厘米。评估动物在闭合手臂中的时间比例。共使用了4只动物。

水迷宫。圆形浴缸（120 使用水和白色涂料的混合物填充。月台（10） 在一个象限中浸没直径为（cm），并将起始位置随机分配到四个等距位置中的一个。一只动物每天训练三次，持续六天。在每一次试验中，给老鼠60分钟 几秒钟后找到平台。如果鼠标发现平台早于60 几秒钟后，审判结束了。如果鼠标找不到平台，试验将在60秒结束 秒。每次试验后，将老鼠放在平台上15分钟 秒。

直线轨道。对于线性轨道记录会话，一只限水动物在15分钟内在2米长的线性轨道上来回奔跑 每分钟一次，以获得在每一端交替给予的水奖励（10微升）。所提供的数据来自一个训练有素的鼠标的单个会话。为了验证距离测量，试验定义为动物离开一个目标箱（线性轨道每侧末端的突出部分）时开始，进入线性轨道另一端的目标箱时结束。只有动物在直线轨道上跑完全程的试验才包括在行驶距离分析中。

显微镜成像

如前所述，使用微型显微镜对海马CA1区的钙事件进行成像4,16。使用基于现有算法的内部脚本17,18对钙记录进行分析。. 这里简要描述了这条管道：首先，原始钙成像视频通过中值滤波器，然后是各向异性滤波器，以降低颗粒噪声。一般背景由con估算