Senior Comprehensive Project

Author: Grey Hutchinson

Note from Grey: Please contact me if you feel like you can't grade this project without copious amounts of data. I get it, but also I can't house it all on github. Not sure what to do here.

How to: Install this project and create your model:

1. Make sure you have python3.6 or greater installed on you computer
2. Create a virtual environment
   1. python -m venv venv
   2. Windows: ./venv/Source/activate
3. Install requirements.txt
   1. pip install -r requirements.txt
4. Separate your files into those containing your target species and those that do not.
5. Place the files containing your target species into the "trues" folder; those without in the "falses" folder.
6. Run dataframe_maker.py
7. Run Murmur.py, if you'd like to create a new model. (Doesn't work without data (duh, but, ya know))

How to: Run this project with passive acoustic monitoring files

1. Extract saved_model.zip to this directory, making sure the folder is called "saved_model". This is my most recent model.
2. Save the PAM file to the root directory (e.g. pam_1.wav). If you'd like to just try my model, you can download this bit of relaxing beach sounds and use it as your PAM file: https://www.youtube.com/watch?v=QX4j_zHAlw8 It's not too large.
3. Go into app.py and change line 131 to match your file name
4. Run app.py