Thanks to Rajyashree Sen&#160;for insightful conversations. Thanks tothe McKnight Foundation Neurobiology of Disease Award (RH), NIH 1DP2MH126377-01 (RH), the Roy J. Carver Charitable Trust (RH), NINDS T32NS007124 (MJ), Ramon D. Buckley Graduate Student Award (MJ), and VA-ORD (RR&#38;D) MERIT 1 I01 RX003523-0 (LS).

NOTE: All animals utilized in these experiments were handled according to protocols approved by the Institutional Animal Care and Use Committee (IACUC) of the University of Iowa.
1. Prepare equipment for data collection
<ol>
	<li>Ensure the availability of all necessary equipment: ensure that the recommended hardware for running DLC has at least 8 GB of memory. See the Table of Materials for information related to hardware and software. 
	NOTE: Data can be collected in any format but must be converted to a format readable by DLC before analysis. The most common formats are AVI and MP4.</li>
	<li>Configure at least one camera so that one eye of an animal can be detected. If both eyes are visible, perform additional filtering, as it may cause interference in tracking. See section 10 for an example of such filtering for the data provided here.</li>
	<li>Install DLC using the package found at Deeplabcut.github.io/DeepLabCut/docs/installation.</li>
	<li>In the camera setup, include a single camera at a side angle (~90&#176;) to the mouse. To follow this example, sample at 10 Hz, with the mice restrained but free to access their full range of head movements relative to the body. Keep between 2 and 4 inches from the camera to the animal.</li>
</ol>
2. Setting up DLC
<ol>
	<li>After installing DLC, create the environment to work out of. To do this, navigate to the folder where the DLC software was downloaded using the change directory with the following command. 
	cd folder_name 
	NOTE: This will be where the DEEPLABCUT.yaml file is located.</li>
	<li>Run the first command to create the environment and enable it by typing the second command. 
	conda env create -f DEEPLABCUT.yaml 
	conda activate Deeplabcut 
	NOTE: Ensure the environment is activated before each use of DLC. 
	After activating the environment, open the graphical user interface (GUI) with the following command and begin creating the model. 
	python -m deeplabcut</li>
</ol>
3. Create the model
<ol>
	<li>After the GUI is opened, begin creating a model by clicking on Create New Project at the bottom.</li>
	<li>Name the project something meaningful and unique to identify it later and enter a name as experimenter. Check the Location section to see where the project will be saved.</li>
	<li>Select Browse folders&#160;and find the videos to train the model. Select Copy videos to project folder if the videos are not to be moved from their original directory.</li>
	<li>Select Create to generate a new project on the computer. 
	NOTE: The videos must cover the full range of the behavior you will observe (i.e., squint, non-squint, and all behaviors in between). The model will only be able to recognize behavior similar to that in the training data, and if some components of the behavior are missing, the model may have trouble recognizing it.</li>
</ol>
4. Configure the settings
NOTE: This is where details like what points to track, how many frames to extract from each training video, default labeling dot size, and variables relating to how the model will train can be defined.
<ol>
	<li>After creating the model, edit the configuration settings by selecting Edit config.yaml. Select edit to open the configuration settings file to specify key settings relating to the model.</li>
	<li>Modify bodyparts to include all parts of the eye to track, then modify numframes2pick to the number of frames needed per training video to get 400 total frames. Lastly, change dotsize to six so that the default size when labeling is small enough to be accurately placed around the edges of the eye.</li>
</ol>
5. Extract training frames
<ol>
	<li>Following configuration, navigate to the Extract Frames tab at the top of the GUI and select Extract Frames at the bottom right of the page.</li>
	<li>Monitor progress using the loading bar at the bottom of the GUI.</li>
</ol>
6. Label training frames
<ol>
	<li>Navigate to the Label Frames tab in the GUI and select Label Frames. Find the new window that shows folders for each of the selected training videos. Select the first folder, and a new labeling GUI will open.</li>
	<li>Label the points defined during configuration for every frame of the selected video. After all frames are labeled, save them and repeat the process for the next video.</li>
	<li>For adequate labeling of squint, use two points as close to the largest peak of the eye (center) as possible and indicate the up/down positions for each point. Approximate squint as the average of these two lengths. 
	NOTE: When labeling, DLC does not automatically save progress. Periodic saving is recommended to avoid loss of labeled data.</li>
</ol>
7. Create a training dataset
<ol>
	<li>After manually labeling, navigate to the Train network tab and select Train network to prompt the software to start training the model.</li>
	<li>Monitor progress in the command window.</li>
</ol>
8. Evaluate the network
<ol>
	<li>After network training is&#160;complete, navigate to the Evaluate&#160;network tab and select Evaluate network. Wait&#160;for a few moments until the blue loading circle&#160;disappears indicating it has finished self-evaluating and the model is ready for use.</li>
</ol>
9. Analyze data/generate labeled videos
<ol>
	<li>To analyze videos, navigate to the Analyze videos tab. Select Add more videos and select the videos to be analyzed.</li>
	<li>Select Save result(s) as csv if a csv output of the data is sufficient.</li>
	<li>When the videos have all been acquired, select Analyze videos at the bottom to begin analysis of the videos. 
	NOTE: This step must be completed before generating labeled videos in step 9.5</li>
	<li>After the videos have been analyzed, navigate to the Create videos tab and select the analyzed videos.</li>
	<li>Select Create videos and the software will begin generating labeled videos that represent the data shown in the corresponding .csv.</li>
</ol>
10. Process final data
<ol>
	<li>Apply the macros found at&#160;https://research-git.uiowa.edu/rainbo-hultman/facial-grimace-dlc&#160;to convert raw data into the format used for this analysis (i.e., Euclidian distance).</li>
	<li>Import and apply macros labeled Step1 and Step 2 to the csv to filter out all suboptimal data points and convert the data to an averaged Euclidean distance for the centermost points at the top and bottom of the eye.</li>
	<li>Run macro called Step3 to mark each point as a 0 no squint and 1 squint based on the threshold value in the script, which is set at 75 pixels. 
	NOTE: The parameters for these macros may require adjustment depending on the experimental setup (see discussion). The threshold for squint and the automatic filter for the maximum value of the eye are parameters that may be changed depending on the size of the animal and distance from the camera. You might also adjust the values used for removing suboptimal points depending on how selectively the data have to be filtered.</li>
</ol>

Real-Time Mouse Eye Squint Detection for Migraine Pain Tracking Using DeepLabCut

<ol>
	<li>Disease, G. B. D., Injury, I., Prevalence, C. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=Global,+regional,+and+national+incidence,+prevalence,+and+years+lived+with+disability+for+354+diseases+and+injuries+for+195+countries+and+territories,+1990-2017:+A+systematic+analysis+for+the+global+burden+of+disease+study+2017.">Global, regional, and national incidence, prevalence, and years lived with disability for 354 diseases and injuries for 195 countries and territories, 1990-2017: A systematic analysis for the global burden of disease study 2017.</a> Lancet. 392 (10159), 1789-1858 (2018).</li><li>Russo, A. F. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=Cgrp+as+a+neuropeptide+in+migraine:+Lessons+from+mice.">Cgrp as a neuropeptide in migraine: Lessons from mice.</a> Br J Clin Pharmacol. 80 (3), 403-414 (2015).</li><li>Wattiez, A. S., Wang, M., Russo, A. F. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=Cgrp+in+animal+models+of+migraine.">Cgrp in animal models of migraine.</a> Handb Exp Pharmacol. 255, 85-107 (2019).</li><li>Hansen, J. M., Hauge, A. W., Olesen, J., Ashina, M. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=Calcitonin+gene-related+peptide+triggers+migraine-like+attacks+in+patients+with+migraine+with+aura.">Calcitonin gene-related peptide triggers migraine-like attacks in patients with migraine with aura.</a> Cephalalgia. 30 (10), 1179-1186 (2010).</li><li>Mason, B. N., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=Induction+of+migraine-like+photophobic+behavior+in+mice+by+both+peripheral+and+central+cgrp+mechanisms.">Induction of migraine-like photophobic behavior in mice by both peripheral and central cgrp mechanisms.</a> J Neurosci. 37 (1), 204-216 (2017).</li><li>Rea, B. J., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=Peripherally+administered+cgrp+induces+spontaneous+pain+in+mice:+Implications+for+migraine.">Peripherally administered cgrp induces spontaneous pain in mice: Implications for migraine.</a> Pain. 159 (11), 2306-2317 (2018).</li><li>Kopruszinski, C. M., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=Prevention+of+stress-+or+nitric+oxide+donor-induced+medication+overuse+headache+by+a+calcitonin+gene-related+peptide+antibody+in+rodents.">Prevention of stress- or nitric oxide donor-induced medication overuse headache by a calcitonin gene-related peptide antibody in rodents.</a> Cephalalgia. 37 (6), 560-570 (2017).</li><li>Juhasz, G., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=No-induced+migraine+attack:+Strong+increase+in+plasma+calcitonin+gene-related+peptide+(cgrp)+concentration+and+negative+correlation+with+platelet+serotonin+release.">No-induced migraine attack: Strong increase in plasma calcitonin gene-related peptide (cgrp) concentration and negative correlation with platelet serotonin release.</a> Pain. 106 (3), 461-470 (2003).</li><li>Aditya, S., Rattan, A. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=Advances+in+cgrp+monoclonal+antibodies+as+migraine+therapy:+A+narrative+review.">Advances in cgrp monoclonal antibodies as migraine therapy: A narrative review.</a> Saudi J Med Med Sci. 11 (1), 11-18 (2023).</li><li>Goadsby, P. J., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=A+controlled+trial+of+erenumab+for+episodic+migraine.">A controlled trial of erenumab for episodic migraine.</a> N Engl J Med. 377 (22), 2123-2132 (2017).</li><li>Mogil, J. S., Pang, D. S. J., Silva Dutra, G. G., Chambers, C. T. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=The+development+and+use+of+facial+grimace+scales+for+pain+measurement+in+animals.">The development and use of facial grimace scales for pain measurement in animals.</a> Neurosci Biobehav Rev. 116, 480-493 (2020).</li><li>Whittaker, A. L., Liu, Y., Barker, T. H. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=Methods+used+and+application+of+the+mouse+grimace+scale+in+biomedical+research+10+years+on:+A+scoping+review.">Methods used and application of the mouse grimace scale in biomedical research 10 years on: A scoping review.</a> Animals (Basel). 11 (3), 673 (2021).</li><li>Langford, D. J., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=Coding+of+facial+expressions+of+pain+in+the+laboratory+mouse.">Coding of facial expressions of pain in the laboratory mouse.</a> Nat Methods. 7 (6), 447-449 (2010).</li><li>Rea, B. J., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=Automated+detection+of+squint+as+a+sensitive+assay+of+sex-dependent+calcitonin+gene-related+peptide+and+amylin-induced+pain+in+mice.">Automated detection of squint as a sensitive assay of sex-dependent calcitonin gene-related peptide and amylin-induced pain in mice.</a> Pain. 163 (8), 1511-1519 (2022).</li><li>Tuttle, A. H., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=A+deep+neural+network+to+assess+spontaneous+pain+from+mouse+facial+expressions.">A deep neural network to assess spontaneous pain from mouse facial expressions.</a> Mol Pain. 14, 1744806918763658 (2018).</li><li>Mathis, A., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=Deeplabcut:+Markerless+pose+estimation+of+user-defined+body+parts+with+deep+learning.">Deeplabcut: Markerless pose estimation of user-defined body parts with deep learning.</a> Nat Neurosci. 21 (9), 1281-1289 (2018).</li><li>Wattiez, A. S., et al. <a target="_blank" href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed&cmd=Search&doptcmdl=Citation&defaultField=Title+Word&term=Different+forms+of+traumatic+brain+injuries+cause+different+tactile+hypersensitivity+profiles.">Different forms of traumatic brain injuries cause different tactile hypersensitivity profiles.</a> Pain. 162 (4), 1163-1175 (2021).</li></ol>

We have no conflicts of interest to disclose. The views in this paper are not representative of the VA or The United States Government.

This protocol provides an easily accessible in-depth method for using machine-learning-based tools that can differentiate squint at near-human accuracy while maintaining the same (or better) temporal resolution of prior approaches. Primarily, it makes evaluation of automated squint more readily available to a wider audience. Our new method for evaluating automated squint has several improvements compared to previous models. First, it provides a more robust metric than ASM by utilizing fewer points that actually contribut...

Migraine is one of the most prevalent brain disorders worldwide, affecting more than one billion people1. Preclinical mouse models of migraine have emerged as an informative way to study the mechanisms of migraine as these studies can be more easily controlled than human studies, thus enabling causal study of migraine-related behavior2. Such models have demonstrated a strong and repeatable phenotypic response to migraine-inducing compounds, such as calcitonin-gene-related peptide (CGRP). The need for robust measurements of migraine-relevant behaviors in rodent models persists, especially those that may be coupled with mechanistic metrics such as imaging and electrophysiological approaches.
Migraine-like brain states have been phenotypically characterized by the presence of light aversion, paw allodynia, facial hyperalgesia to noxious stimuli, and facial grimace3. Such behaviors are measured by total time spent in light (light aversion) and paw or facial touch sensitivity thresholds (paw allodynia and facial hyperalgesia) and are restricted to a single readout over large periods of time (minutes or longer). Migraine-like behaviors can be elicited in animals by dosing with migraine-inducing compounds such as CGRP, mimicking symptoms experienced by human patients with migraine3 (i.e., demonstrating face validity). Such compounds also produce migraine symptoms when administered in humans, demonstrating the construct&#160;validity of these models4. Studies in which behavioral phenotypes were attenuated pharmacologically have led to discoveries related to the treatment of migraine and provide further substantiation of these models (i.e., demonstrating predictive validity)5,6.
For example, a monoclonal anti-CGRP antibody (ALD405) was shown to reduce light-aversive behavior5 and facial grimace in mice6 treated with CGRP, and other studies have demonstrated that CGRP antagonist drugs reduce nitrous oxide-induced migraine-like behaviors in animals7,8. Recent clinical trials have shown success in treating migraine by blocking CGRP9,10 leading to multiple FDA-approved drugs targeting CGRP or its receptor. Preclinical assessment of migraine-related phenotypes has led to breakthroughs in clinical findings and is, therefore, essential to understanding some of the more complex aspects of migraine that are difficult to directly test in humans.
Despite numerous advantages, experiments using these rodent behavioral readouts of migraine are often restricted in their time point sampling abilities and can be subjective and prone to human experimental error. Many behavioral assays are limited in the ability to capture activity at finer temporal resolutions, often making it difficult to capture more dynamic elements that occur at a sub-second timescale, such as at the level of brain activity. It has proven difficult to quantify the more spontaneous, naturally occurring elements of behavior over time at a meaningful temporal resolution for studying neurophysiological mechanisms. Creating a way to identify migraine-like activity at faster timescales would allow for externally validating migraine-like brain states. This, in turn, could be synchronized with brain activity to create more robust brain activity profiles of migraine.
One such migraine-related phenotype, facial grimace, is utilized across various contexts as a measurement of pain in animals that can be measured instantaneously and tracked over time11. Facial grimace is often used as an indicator of spontaneous pain based on the idea that humans (especially non-verbal humans) and other mammalian species display natural changes in facial expression when experiencing pain11. Studies measuring facial grimace as an indication of pain in mice in the last decade have utilized scales such as the Mouse Grimace Scale (MGS) to standardize the characterization of pain in rodents12. The facial expression variables of the MGS include orbital tightening (squint), nose bulge, cheek bulge, ear position, and whisker change. Even though the MGS has been shown to reliably characterize pain in animals13, it is notoriously subjective and relies on accurate scoring, which can vary across experimenters. Additionally, the MGS is limited in that it utilizes a non-continuous scale and lacks the temporal resolution needed to track naturally occurring behavior across time.
One way to combat this is by objectively quantifying a consistent facial feature. Squint is the most consistently trackable facial feature6. Squint accounts for the majority of the total variability in the data when accounting for all of the MGS variables (squint, nose bulge, cheek bulge, ear position, and whisker change)6. Because squint contributes most to the overall score obtained using the MGS and reliably tracks response to CGRP6,14, it is the most reliable way to track spontaneous pain in migraine mouse models. This makes squint a quantifiable non-homeostatic behavior induced by CGRP. Several labs have used facial expression features, including squint, to represent potential spontaneous pain associated with migraine6,15.
Several challenges have remained regarding carrying out automated squints in a way that can be coupled with mechanistic studies of migraine. For example, it has been difficult to reliably track squint without relying on a fixed position that must be calibrated in the same manner across sessions. Another challenge is the ability to carry out this type of analysis on a continuous scale instead of discrete scales like the MGS. To mitigate these challenges, we aimed to integrate machine learning, in the form of DeepLabCut (DLC), into our data analysis pipeline. DLC is a pose estimation machine learning model developed by Mathis and colleagues and has been applied to a wide range of behaviors16. Using their pose estimation software, we were able to train models that could accurately predict points on a mouse eye at near-human accuracy. This solves the issues of repetitive manual scoring while also drastically increasing temporal resolution. Further, by creating these models, we have made a repeatable means to score squint and estimate migraine-like brain activity over larger experimental groups. Here, we present the development and validation of this method for tracking squint behaviors in a way that can be time-locked to other mechanistic measurements such as neurophysiology. The overarching goal is to catalyze mechanistic studies requiring time-locked squint behaviors in rodent models.

<table border="1" fo:keep-together.within-page="1" fo:keep-with-next.within-page="always">
	<tbody>
		<tr>
			<td>CUDA toolkit 11.8</td>
			<td></td>
			<td></td>
			<td></td>
		</tr>
		<tr>
			<td>cuDNN SDK 8.6.0</td>
			<td></td>
			<td></td>
			<td></td>
		</tr>
		<tr>
			<td>Intel computers with Windows 11, 13th gen&#160;</td>
			<td></td>
			<td></td>
			<td></td>
		</tr>
		<tr>
			<td>LabFaceX 2D Eyelid Tracker Add-on Module for a Free Roaming Mouse:</td>
			<td>FaceX LLC</td>
			<td>NA</td>
			<td>Any camera that can record an animal&#39;s eye is sufficient, but this is our eye tracking hardware.</td>
		</tr>
		<tr>
			<td>NVIDIA GPU driver that is version 450.80.02 or higher</td>
			<td></td>
			<td></td>
			<td></td>
		</tr>
		<tr>
			<td>NVIDIA RTX A5500, 24 GB DDR6</td>
			<td>NVIDIA</td>
			<td>[490-BHXV]</td>
			<td>Any GPU that meets the minimum requirements specified for your version of DLC, currently 8 GB, is sufficient. We used NVIDIA GeForce RTX 3080 Ti GPU</td>
		</tr>
		<tr>
			<td>Python 3.9-3.11</td>
			<td></td>
			<td></td>
			<td></td>
		</tr>
		<tr>
			<td>TensorFlow version 2.10</td>
			<td></td>
			<td></td>
			<td></td>
		</tr>
	</tbody>
</table>

an automated squint method for time-syncing behavior and brain dynamics in mouse pain studies

Spontaneous pain has been challenging to track in real time and quantify in a way that prevents human bias. This is especially true for metrics of head pain, as in disorders such as migraine. Eye squint has emerged as a continuous variable metric that can be measured over time and is effective for predicting pain states in such assays. This paper provides a protocol for the use of DeepLabCut (DLC) to automate and quantify eye squint (Euclidean distance between eyelids) in restrained mice with freely rotating head motions. This protocol enables unbiased quantification of eye squint to be paired with and compared directly against mechanistic measures such as neurophysiology. We provide an assessment of AI training parameters necessary for achieving success as defined by discriminating squint and non-squint periods. We demonstrate an ability to reliably track and differentiate squint in a CGRP-induced migraine-like phenotype at a sub second resolution.

Author Spotlight: Deciphering Electrical Networks Behind Complex Brain Activities and Disorders

An Automated Squint Method for Time-syncing Behavior and Brain Dynamics in Mouse Pain Studies

Our lab investigates the electrical networks behind complex brain disorders, focusing on how brain activity is coordinated during various states. That's why we developed this analysis approach for automating squint data, which better facilitates peri-neurophysiological recordings with squint behaviors related to migraine. Within migraine studies, a new area of research is beginning to open up, as rodent models of migraine are being used more to study the underlying neural circuit substrates in migraine, and identifying more central mechanisms contributing to migraine like states.Our protocol addresses the research gap of objectively quantifying pain like responses in a way that can be paired with mechanistic measures such as neurophysiology. Our method presents a widely accessible way to simultaneously quantify spontaneous pain responses, and underlying electrical brain network activity at a sub second resolution. A major goal or hope of this work, is that it will catalyze the use of measuring brain activity in real-time, during migraine experiments in animal models.We're studying how brain wide electrical network activity changes over time during migraine like episodes. Our goals are both to observe how migraine activity evolves across the brain over time, and to try and develop brain-based markers of migraine activity for better testing therapeutics and rodent models.

Here, we provide a method for the reliable detection of squint at high temporal resolution using DeepLabCut. We optimized training parameters, and we provide an evaluation of this method&#39;s strengths and weaknesses (Figure 1).
After training our models, we verified that they were able to correctly estimate the top and bottom points of the eyelid (Figure 2), which serve as the coordinate points for the Euclidean distance measure. Eu...

This protocol provides a method for tracking automated eye squint in rodents over time in a manner compatible with time-locking to neurophysiological measures. This protocol is expected to be useful to researchers studying mechanisms of pain disorders such as migraine.

Spontaneous pain has been challenging to track in real time and quantify in a way that prevents human bias. This is especially true for metrics of head ...

an-automated-squint-method-for-time-syncing-behavior-brain-dynamics

Research

JoVE Journal

Behavior

Tracking Pain States in Mice: Automating Eye Squint Measurement with DeepLabCut

To begin, arrange the equipment and install the software for the DeepLabCut or DLC procedure. To create the environment, navigate to the folder where the DLC software was downloaded. Use the change directory command, cd folder name.Run the first command, conda env create f DEEPLABCUT.yaml. Then, type conda activate Deeplabcut to enable the environment. Then, open the graphical user interface using python m deeplabcut.After the interface opens, click Create New Project at the bottom of the interface. Name the project for easy identification later. Enter a name for the experimenter and check the location section to verify where the project will be saved.Select Browse Folders to locate the videos for training the model, and choose Copy videos to project folder if the videos should remain in their original directory. Click Create to generate a new project. After creating the model, select Edit config.yaml, followed by Edit to open the configuration settings file. Modify the body parts to include all parts of the eye for tracking. Adjust number of frames to pick to obtain 400 total frames for training video.Change dot size to six to ensure that the default label size is small enough for accurate placement around the edges of the eye. Following configuration, navigate to the Extract Frames tab of the graphical user interface and select Extract Frames at the bottom. Navigate to the Label Frames tab and select Label Frames.In the new window, find folders for each of the selected training videos and choose the first folder to open a new labeling interface. Label the points defined during configuration for each frame of the selected video. After labeling all frames, save the labels and repeat the process for the next video.For accurate labeling of squint, use two points near the largest peak of the eye. To create a training dataset, navigate to the Train Network tab and initiate train network. Once the network training is complete, navigate to and select Evaluate Network.To analyze videos, navigate to the Analyze Videos tab and select Add more videos to choose the videos. Select Save results as CSV if A CSV output of the data is sufficient. Once all videos are selected, click Analyze Videos to start the analysis process.Finally, apply the macros to convert the raw data into the format required for the analysis of Euclidean distance. The model accurately detected both non-squint and squint instances, marking the top and bottom eyelid points to compute Euclidean distances. Root mean square error values between manually-labeled and model-labeled points showed minimal variability after 300 frames, and the average likelihood values for correct point detection exceeded 0.95 when using 400 frames.The confusion matrix showed a positive predictive value of 96.96%and a negative predictive value of 99.66%for squint detection.

378 Views.  University of Iowa.  This protocol provides a method for tracking automated eye squint in rodents over time in a manner compatible with time-locking to neurophysiological measures. This protocol is expected to be useful to researchers studying mechanisms of pain disorders such as migraine.

Real-Time Mouse Eye Squint Detection for Migraine Pain Tracking Using DeepLabCut

Summary