This python program is a resource to go along with ZooMonitor© and other animal data collection applications. ZooMapper creates plots for 2D and 3D datasets, allows for interactive viewing and filtering of data, and can perform calculations for distances between animals.
/data
: folder to contain data files, either as .xlsx or .csv/src/main/resources
: contains image assets/src/main
: python fileszoo.py
: Main program file. Contains methods for handling imports, exporting distance calculations, and the spreadsheet viewheatmap.py
: Handles methods for creating import configuration, and saving an importheatmappage.py
: Plotting of graphs, highlighting points, and real time distance calculating on graphpages.py
: Frames for the different pages of the applicationerror.py
: provides error messages for error handling
/src/main/saves
: contains save configurations of imports. Saves as.json
files
The following Python packages are used in this application and are all found in requirements.txt
matplotlib
version 3.1.1numpy
version 1.16.5pandas
version 0.25.1pillow
version 6.2.0scipy
version 1.3.1tkinter
version 0.1.0tksheet
version 5.0.25xlrd
version 1.2.0
First, you will need to install a Python version newer than 3.6. We reccoment installing python version 3.9.5 as this was the newest version during our development. The instructions on how to install Python 3.9.5 for your device can be found here.
If you are using a Windows system, open up the command prompt (seach cmd in the serach bar). Start by cloning this repository by running git clone repo_link_here
. Then do cd sezarc
and press enter to move into the project directory. Here, execute the command pip install -r requirements.txt
. This will install the required packages that were listed above. Now you are all set to get ready to run the application.
If you are using a Mac or Linux system, open a unix shell. Start by cloning this repository by running git clone https://github.com/channum/Zoo-Mapper.git
. Then do cd sezarc
and press enter to move into the project directory. Here, execute the command pip install -r requirements.txt
. This will install the required packages that were listed above. Now you are all set to get ready to run the application.
First, navigate from the main sezarc directory to the directory /src/main
by running cd src/main
. Then, simply execute python zoo.py
.
We have a few tutorial videos that can help you learn how to use the application. Below are links to the different videos: