# Animal Behavior Annotation Tool(labelaction)
This is a GUI-based tool for annotating animal behavior in video files. Built using Python and PyQt5, this application allows users to load a video, navigate through frames, and label different behaviors for multiple subjects (referred to as "pigeons" in this tool).
## Features
- **Simultaneous annotation of behaviors and postures**: Users can annotate both behaviors (e.g. feeding, drinking, etc.) and postures (e.g. standing, lying down, etc.) of pigeons during video playback, and each annotation can be done independently.
- **Timeline visualization**: The program provides a visual timeline for each pigeon to show the behavior and posture annotations for quick viewing and editing.
- **Video frame navigation**: the user can use buttons or shortcut keys (such as 'D' and 'S') to quickly advance or rewind video frames for easy and precise labeling.
- **Color coding**: Different behaviors and gestures are identified using different colors, making annotation more intuitive and allowing users to quickly identify information by color.
- **Export function**: Users can export annotation data to CSV file, supporting two formats: original annotation and sorted annotation data, which is convenient for subsequent data analysis and processing.
- **Multi-pigeon support**: the program allows independent annotation of multiple pigeons for complex experimental scenarios.
## Prerequisites
- **Python** (>= 3.6)
- **Libraries**: The following libraries are required:
- `PyQt5`
- `OpenCV`
- `pandas`
## License
This tool is licensed under the MIT License. Feel free to modify and use it as needed.
## Acknowledgments
- PyQt5 for the GUI and OpenCV for video processing
- GEMlab : https://www.gemlab.site
## Update log
'1.1.3' Add some functionality
- Support undo when marking, press ctrl+z.
- Click the annotated area of the status bar to display the annotated information, such as the start frame, end frame, etc.
- Support annotation review and modification
'1.1.2' Modify the behavior list and posture list
'1.1.1' fix some bugs, add posture "Tail up" and the posture "lying down" was changed to "Squatting"
'1.1.0'
- Supports simultaneous annotation of actions and gestures in videos.
- Export similar to mot format, export each frame's information to csv file, replace no behavior or gesture with -1
- Optimize GUI interface and functional details to improve user usability
'1.0.2' automatically install dependent packages
'1.0.1' fix some bugs
'1.0.0' first release
Raw data
{
"_id": null,
"home_page": null,
"name": "labelaction",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "Action label, Annotation tools, GUI",
"author": "xie jiefeng",
"author_email": "p2417822@mpu.edu.mo",
"download_url": "https://files.pythonhosted.org/packages/72/ce/701f15e6111c8a7094c34108d2bd9a8dde90b5c88d8bba283c28fb67f0f6/labelaction-1.1.3.tar.gz",
"platform": null,
"description": "\r\n# Animal Behavior Annotation Tool(labelaction)\r\r\n\r\r\nThis is a GUI-based tool for annotating animal behavior in video files. Built using Python and PyQt5, this application allows users to load a video, navigate through frames, and label different behaviors for multiple subjects (referred to as \"pigeons\" in this tool).\r\r\n\r\r\n## Features\r\r\n\r\r\n- **Simultaneous annotation of behaviors and postures**: Users can annotate both behaviors (e.g. feeding, drinking, etc.) and postures (e.g. standing, lying down, etc.) of pigeons during video playback, and each annotation can be done independently.\r\r\n- **Timeline visualization**: The program provides a visual timeline for each pigeon to show the behavior and posture annotations for quick viewing and editing.\r\r\n\r\r\n- **Video frame navigation**: the user can use buttons or shortcut keys (such as 'D' and 'S') to quickly advance or rewind video frames for easy and precise labeling.\r\r\n\r\r\n- **Color coding**: Different behaviors and gestures are identified using different colors, making annotation more intuitive and allowing users to quickly identify information by color.\r\r\n\r\r\n- **Export function**: Users can export annotation data to CSV file, supporting two formats: original annotation and sorted annotation data, which is convenient for subsequent data analysis and processing.\r\r\n\r\r\n- **Multi-pigeon support**: the program allows independent annotation of multiple pigeons for complex experimental scenarios.\r\r\n\r\r\n## Prerequisites\r\r\n\r\r\n- **Python** (>= 3.6)\r\r\n- **Libraries**: The following libraries are required:\r\r\n - `PyQt5`\r\r\n - `OpenCV`\r\r\n - `pandas`\r\r\n\r\r\n## License\r\r\n\r\r\nThis tool is licensed under the MIT License. Feel free to modify and use it as needed.\r\r\n\r\r\n## Acknowledgments\r\r\n\r\r\n- PyQt5 for the GUI and OpenCV for video processing\r\r\n- GEMlab : https://www.gemlab.site\r\r\n\r\r\n## Update log\r\r\n'1.1.3' Add some functionality\r\r\n- Support undo when marking, press ctrl+z.\r\r\n- Click the annotated area of \u200b\u200bthe status bar to display the annotated information, such as the start frame, end frame, etc.\r\r\n- Support annotation review and modification\r\r\n\r\r\n'1.1.2' Modify the behavior list and posture list\r\r\n\r\r\n'1.1.1' fix some bugs, add posture \"Tail up\" and the posture \"lying down\" was changed to \"Squatting\"\r\r\n\r\r\n'1.1.0' \r\r\n- Supports simultaneous annotation of actions and gestures in videos. \r\r\n- Export similar to mot format, export each frame's information to csv file, replace no behavior or gesture with -1\r\r\n- Optimize GUI interface and functional details to improve user usability\r\r\n\r\r\n'1.0.2' automatically install dependent packages\r\r\n\r\r\n'1.0.1' fix some bugs\r\r\n\r\r\n'1.0.0' first release\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A GUI tool for annotating action in video files.",
"version": "1.1.3",
"project_urls": null,
"split_keywords": [
"action label",
" annotation tools",
" gui"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "72ce701f15e6111c8a7094c34108d2bd9a8dde90b5c88d8bba283c28fb67f0f6",
"md5": "7c9777c6dbb62ccac12c37f90c3cc985",
"sha256": "2c27758ff853a02797cfa9cd66986720c6dba2af8c4d322fd4918c44b21b9d6a"
},
"downloads": -1,
"filename": "labelaction-1.1.3.tar.gz",
"has_sig": false,
"md5_digest": "7c9777c6dbb62ccac12c37f90c3cc985",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 11288,
"upload_time": "2024-12-05T14:06:55",
"upload_time_iso_8601": "2024-12-05T14:06:55.766226Z",
"url": "https://files.pythonhosted.org/packages/72/ce/701f15e6111c8a7094c34108d2bd9a8dde90b5c88d8bba283c28fb67f0f6/labelaction-1.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-05 14:06:55",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "labelaction"
}
JSON