{"id":18611746,"url":"https://github.com/deeplabcut/dlcutils","last_synced_at":"2025-10-25T08:33:21.728Z","repository":{"id":44002849,"uuid":"155476016","full_name":"DeepLabCut/DLCutils","owner":"DeepLabCut","description":"Various scripts to support deeplabcut and what to do afterwards!","archived":false,"fork":false,"pushed_at":"2023-10-26T10:07:47.000Z","size":1894,"stargazers_count":153,"open_issues_count":3,"forks_count":68,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-03-31T14:13:30.362Z","etag":null,"topics":["behavior-analysis","clustering-algorithm","deeplabcut"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DeepLabCut.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-10-31T00:45:05.000Z","updated_at":"2025-03-25T11:45:35.000Z","dependencies_parsed_at":"2022-09-22T09:36:35.483Z","dependency_job_id":"e42bfd8b-169e-42c4-9f7e-4804c58421da","html_url":"https://github.com/DeepLabCut/DLCutils","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepLabCut%2FDLCutils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepLabCut%2FDLCutils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepLabCut%2FDLCutils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepLabCut%2FDLCutils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DeepLabCut","download_url":"https://codeload.github.com/DeepLabCut/DLCutils/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252956922,"owners_count":21831403,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["behavior-analysis","clustering-algorithm","deeplabcut"],"created_at":"2024-11-07T03:14:42.291Z","updated_at":"2025-10-25T08:33:21.723Z","avatar_url":"https://github.com/DeepLabCut.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n[![Image.sc forum](https://img.shields.io/badge/dynamic/json.svg?label=forum\u0026amp;url=https%3A%2F%2Fforum.image.sc%2Ftags%2Fdeeplabcut.json\u0026amp;query=%24.topic_list.tags.0.topic_count\u0026amp;colorB=brightgreen\u0026amp;\u0026amp;suffix=%20topics\u0026amp;logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAYAAAAfSC3RAAABPklEQVR42m3SyyqFURTA8Y2BER0TDyExZ+aSPIKUlPIITFzKeQWXwhBlQrmFgUzMMFLKZeguBu5y+//17dP3nc5vuPdee6299gohUYYaDGOyyACq4JmQVoFujOMR77hNfOAGM+hBOQqB9TjHD36xhAa04RCuuXeKOvwHVWIKL9jCK2bRiV284QgL8MwEjAneeo9VNOEaBhzALGtoRy02cIcWhE34jj5YxgW+E5Z4iTPkMYpPLCNY3hdOYEfNbKYdmNngZ1jyEzw7h7AIb3fRTQ95OAZ6yQpGYHMMtOTgouktYwxuXsHgWLLl+4x++Kx1FJrjLTagA77bTPvYgw1rRqY56e+w7GNYsqX6JfPwi7aR+Y5SA+BXtKIRfkfJAYgj14tpOF6+I46c4/cAM3UhM3JxyKsxiOIhH0IO6SH/A1Kb1WBeUjbkAAAAAElFTkSuQmCC)](https://forum.image.sc/tags/deeplabcut)\n[![PyPI version](https://badge.fury.io/py/deeplabcut.svg)](https://badge.fury.io/py/deeplabcut)\n[![PyPI - Downloads](https://img.shields.io/pypi/dm/deeplabcut.svg?color=purple\u0026label=PyPi)](https://pypistats.org/packages/deeplabcut)\n[![GitHub stars](https://img.shields.io/github/stars/AlexEMG/DeepLabCut.svg?style=social\u0026label=Star)](https://github.com/AlexEMG/DeepLabCut)\n\n\n# DeepLabCut-Utils \u003cimg src=\"https://images.squarespace-cdn.com/content/v1/57f6d51c9f74566f55ecf271/1572296495650-Y4ZTJ2XP2Z9XF1AD74VW/ke17ZwdGBToddI8pDm48kMulEJPOrz9Y8HeI7oJuXxR7gQa3H78H3Y0txjaiv_0fDoOvxcdMmMKkDsyUqMSsMWxHk725yiiHCCLfrh8O1z5QPOohDIaIeljMHgDF5CVlOqpeNLcJ80NK65_fV7S1UZiU3J6AN9rgO1lHw9nGbkYQrCLTag1XBHRgOrY8YAdXW07ycm2Trb21kYhaLJjddA/DLC_logo_blk-01.png?format=1000w\" width=\"350\" title=\"DLC-Utils\" alt=\"DLC Utils\" align=\"right\" vspace = \"50\"\u003e\n\nThis repository contains various scripts as well as links to other packages related to [DeepLabCut](https://github.com/AlexEMG/DeepLabCut). Feel free to contribute your own analysis methods, and perhaps some short notebook of how to use it. Thanks!\n\n\n# Example scripts for scaling up your DLC analysis \u0026 training:\n\nThese two scripts illustrate how to train, test, and analyze videos for multiple projects automatically (scale_raining_and_evaluation.py) and how to analyze videos that are organized in subfolders automatically (scale_analysis_oversubfolders.py). Feel free to adjust them for your needs!\n\ncode: https://github.com/DeepLabCut/DLCutils/tree/master/SCALE_YOUR_ANALYSIS/scale_analysis_oversubfolders.py\n\ncode: https://github.com/DeepLabCut/DLCutils/blob/master/SCALE_YOUR_ANALYSIS/scale_training_and_evaluation.py\n\nContributed by [Alexander Mathis](https://github.com/AlexEMG)\n\n\n# Using your DLC outputs, loading, simple ROI analysis, visualization examples:\n\n## Time spent of a body part in a particular region of interest (ROI)\n\nYou can compute time spent in particular ROIs in frames. This demo Jupyer Notebook shows you how to load the outputs of DLC and perform the analysis (plus other plotting functions): \n\ncode: https://github.com/DeepLabCut/DLCutils/blob/master/Demo_loadandanalyzeDLCdata.ipynb\n\ncode: https://github.com/DeepLabCut/DLCutils/blob/master/time_in_each_roi.py\n\nContributed by [Federico Claudi](https://github.com/FedeClaudi) and Jupyter Notebok from [Alexander Mathis](https://github.com/AlexEMG)\n\n## DeepLabCut-Display GUI\n\nOpen and view data to understand pose estimation errors and trends. Filter data by likelihood threshold.\n\ncode: https://github.com/jakeshirey/DeepLabCut-Display\n\nContributed by [Jacob Shirey](https://github.com/jakeshirey)\n\n## A GUI based ROI tool for time spent of a body part in a defined region of interest \n\ncode: https://github.com/PolarBean/DLC_ROI_tool\n\nContributed by [Harry Carey](https://github.com/PolarBean)\n\n## Linear Transformation and Scaling of DLC output data (transform_and_scale)\n\nThis package is designed for anyone who wants to know where a tracked marker is within a reference frame (i.e. behavioral context). DeepLabCut outputs coordinates in relation to the field of view of the recorded video. With this tool, these coordinates can be linearly transformed and scaled to the reference frame of the behavioral context, meaning that the output coordinates are distances [cm] to a corner of the behavioral context, instead of distances [px] to a corner of the video field of view.\n\ncode:  https://github.com/DeepLabCut/DLCutils/tree/master/transform_and_scale/\n\ntutorial: https://github.com/DeepLabCut/DLCutils/tree/master/transform_and_scale/transform_and_scale_tutorial.ipynb\n\nContributed by [Michael Schellenberger](https://github.com/MSchellenberger)\n\n# Clustering tools (using the output of DLC):\n\n## Identifying Behavioral Structure from Deep Variational Embeddings of Animal Motion\n\npaper: https://www.biorxiv.org/content/10.1101/2020.05.14.095430\n\ncode: https://github.com/LINCellularNeuroscience/VAME\n\n## Behavior clustering with MotionMapper\n- (adpated from https://github.com/gordonberman/MotionMapper)\n\ncode: https://github.com/DeepLabCut/DLCutils/tree/master/DLC_2_MotionMapper\n\nContributed by [Mackenzie Mathis](https://github.com/MMathisLab)\n\n## Behavior clustering with B-SOiD\n\nB-SOiD: An Open Source Unsupervised Algorithm for Discovery of Spontaneous Behaviors \u003c-- you can  use the outputs of DLC to feed directly into B-SOiD (in MATLAB).\n\npaper: https://www.biorxiv.org/content/10.1101/770271v1.abstract\n\ncode: https://github.com/YttriLab/B-SOiD\n\n# Machine-learning helper packages (using the output of DLC):\n\n## Behavior analysis with machine-learning in R (ETH-DLCAnalyzer)\n\nDeep learning based behavioral analysis enables high precision rodent tracking and is capable of outperforming commercial solutions. Oliver Sturman, Lukas von Ziegler, Christa Schläppi, Furkan Akyol, Benjamin Grewe, Johannes Bohacek\n\npaper: https://www.biorxiv.org/content/10.1101/2020.01.21.913624v1\n\ncode: https://github.com/ETHZ-INS/DLCAnalyzer\n\n## Behavior Analysis with machine learning classifiers (SIMBA)\n\nA pipeline for using pose estimation (i.e. DeepLabCut) then behavioral annotatation and generatation of supervised machine-learning-based classifiers. \u003c-- you can use the outputs of DLC to feed directly into SIMBA (in Python).\n\nCode written by: [Simon Nilsson](https://github.com/sronilsson) (please direct use questions to Simon).\n\npaper: https://www.biorxiv.org/content/10.1101/2020.04.19.049452v2\n\ncode: https://github.com/sgoldenlab/simba\n\n\n# 3D DeepLabCut helper packages:\n\n## A wrapper package for DeepLabCut2.0 for 3D videos (anipose)\ncode: https://github.com/lambdaloop/anipose\n\nmaintainer: [Pierre Karashchuk](https://github.com/lambdaloop)\n\n## 3D reconstruction with EasyWand/Argus DLT system with DeepLabCut data:\n\nWritten by [Brandon Jackson](https://github.com/haliaetus13), post our DLC workshop in Jan 2020: \n\nA small set of utilities that allow conversion between the data storage formats of DeepLabCut (DLC) and one of the DLT-based 3D tracking systems: either Ty Hedrick's DigitizingTools in MATLAB, or the Python-based Argus. These functions should allow you to use data previously digitized in a DLT system to create the files needed to train a DLC model, and to import DLC-tracked points back into a DLT 3D calibration to reconstruct 3D points.\n\ncode: https://github.com/haliaetus13/DLCconverterDLT\n\n## Pupil Tracking\n- From Tom Vaissie - tvaissie@scripps.edu\n- Please see the README.txt file https://github.com/DeepLabCut/DLCutils/tree/master/pupilTracking for details; this code makes the video in case study 7 http://www.mousemotorlab.org/deeplabcut/.\n\n## Using DeepLabCut for USB-CGPIO feedback\n\npaper: https://www.biorxiv.org/content/early/2018/11/28/482349\n\ncode: https://github.com/bf777/DeepCutRealTime\n\nmaintainer: [Brandon Forys](https://github.com/bf777)\n\n\n## LEGACY utility functions (no longer required in DLC 2+):\n\n## DLC1 to DLC 2 conversion code\n\nThis code allows you to import the labeled data from DLC 1 to DLC 2 projects. Note, it is not streamlined and should be used with care.\n\nhttps://github.com/DeepLabCut/DLCutils/tree/master/conversion_scripts_LEGACY\n\nContributed by [Alexander Mathis](https://github.com/AlexEMG)\n\n## Running project created on Windows on Colaboratory\n#UPDATE: as of Deeplabcut 2.0.4 onwards you no longer need to use this code! You can simply create the training set on the cloud and it will automatically convert your project for you.\n\n   - This solves a path problem when creating a project and annotating data on Windows (see https://github.com/AlexEMG/DeepLabCut/issues/172). This functionality will be included in\na later version of DLC 2 (DONE!)\nhttps://github.com/DeepLabCut/DLCutils/tree/master/conversion_scripts_LEGACY\n\n*Usage:* change in lines 70 and 71 of https://github.com/DeepLabCut/DLCutils/tree/master/conversion_scripts_LEGACY/convertWin2Unix.py\n\n```basepath='/content/drive/My Drive/DeepLabCut/examples/'```\n\n```projectname='Reaching-Mackenzie-2018-08-30'```\n\nthen run this script on colaboratory after uploading your labeled data to the drive. Thereby it will be converted\nto unix format, then create a training set (with deeplabcut) and proceed as usual...\n\nContributed by [Alexander Mathis](https://github.com/AlexEMG)\n\n\n\nPlease direct inquires to the **contributors/code-maintainers of that code**. Note that the software(s) are provided \"as is\", without warranty of any kind, express or implied.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeeplabcut%2Fdlcutils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeeplabcut%2Fdlcutils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeeplabcut%2Fdlcutils/lists"}