PawsitionPatrol is a program that lets you track and monitor the movement of a single animal over time, for lab studies where the animal you're interested in is the only thing moving in the video. It's a tool for researchers to observe and analyze animal behavior in controlled environments.
- Video analysis: The program analyzes video footage to detect and record the position of animals in each frame.
- Zone definition: Users can define specific zones within the video where the animal's movement is of interest.
- Interactive playback: PawsitionPatrol offers a user-friendly interface to display video playback, with real-time visualization of animal positions and zone labels.
- Data recording: The program records the animal's position, associated time, and the zone it belongs to in a CSV file for further analysis.
- Zone statistics: PawsitionPatrol calculates the time spent by the animal in each defined zone, providing insights into zone preferences.
- Plot visualization: The program generates a plot that visualizes the recorded animal positions over time.
- Animal agnostic: PawsitionPatrol can be used to track the movement of various animals, making it flexible for different research or monitoring applications.
To use PawsitionPatrol, you need to install the required Python modules. Follow the steps below to set up the necessary dependencies:
- Make sure you have Python installed on your system. If not, you can download it from the official Python website: Python.org.
- Clone this repository to your local machine or download the source code as a ZIP file.
- Open a terminal or command prompt and navigate to the project directory.
- Run the following command to install the required modules: pip install -r requirements.txt
- Install the required dependencies
- Prepare your video file and ensure it is in a supported format.
- Customize the program settings, such as video path and zone parameters, in the provided code.
- Run the program
- Follow the instructions to define zones by clicking and dragging on the video frame.
Please refer to the comments within the code for detailed explanations and further customization options.
To provide a better understanding of how PawsitionPatrol can be used, check out the following examples:
- Example 1: Tracking rodent behavior in a laboratory setting.
Contributions to PawsitionPatrol are welcome! If you encounter any issues, have suggestions for improvements, or would like to add new features, feel free to open an issue or submit a pull request.
We would like to acknowledge the contributions of the open-source community and the libraries utilized in this project.
For questions, feedback, or collaborations, please comment.