Audio Explorer is a data visualization tool created by Colin Scruggs and Cameron Henkel of Southwestern University for the 2018 VAST Challenge. Audio Explorer was the recipient of the "Excellent Comprehensive Submission" Award from the VAST committee for 2018's Mini Challenge 1.
This single-page web app was developed as part of our submission to Mini-Challenge 1. The main objectives of the mini-challenge were to:
- Characterize patterns of all bird species found in the Boonsong Lekagal Wildlife Preserve over time, and
- Determine whether or not the set of bird calls provided by the Kasios Furniture company supports their claim that the Rose-Crested Blue Pipit is "happily living and nesting in the Preserve."
Audio Explorer was built to synthesize the results of our machine-learning experiments and assist us in examining the geospatial data associated with the large dataset of bird calls provided in Mini-Challenge 1.
For a closer look at how we tackled machine learning, Bird Classification.ipynb is included.
(NOTE: the mini-challenge audio data is required to run this Jupyterlab notebook, and is available for download from the links above)
A live demo of Audio Explorer can be found here.
These instructions will get you a copy of the project up and running on your local machine for development purposes. See deployment for notes on how to deploy the project on a live system.
Install Node.js and Yarn (if haven't already)
Clone the repository. Open terminal/commmand prompt and cd to root directory of the repo:
cd [repo directory]
Type yarn install to install dependencies:
yarn install
To view a development build of Audio Explorer, run:
yarn serve
Alternatively, to create a production build:
yarn build
The web app can then be viewed at http://localhost:8080/
- Vue.js - Front-end framework
- Vue CLI - Standard tooling for Vue.js development
- D3.js - Data processing library
- Vue2Leafet - Vue wrapper for Leaflet interactive map library
- Leatlet.heat - Heatmap plugin for Leaflet maps
- wavesurfer.js - Audio visualization and playback plugin
- vue-slider-component - Vue slider components
- vue-sweetalert2 - Vue wrapper for SweetAlert2
Colin Scruggs - Github
Cameron Henkel - Github
This project is licensed under the Apache License 2.0 - see the LICENSE.md file for details.
- Dr. Chad Stolper for guidance throughout SCOPE
- SCOPE Summer Research Program at Southwestern Univeristy
- Dr. Jaron Collis and his deep learning audio classification experiments