UBC-MDS / doggodash-R

The app recommends top dog breeds and other interesting facts based on certain traits selected by user, who could be a potential dog buyer.
https://dsci532-group18-r.herokuapp.com/
MIT License
1 stars 1 forks source link
barplot dropdown-menus plotly-dash slider table

DoggoDash

Click to view app

Welcome to DoggoDash! DoggoDash is an interactive web app created using Dash and Python which provides visualizations for users to explore the breeds of dog that best match their selected preferences. Whether you are a potential new dog owner or are curious about your current dog breed's ranking among others, DoggoDash can help you!

Here is a preview of DoggoDash:

DoggoDash Preview

Installation

DoggoDash is hosted online by Heroku and can be accessed here. There is no local installation required.

Usage

Users can choose the dog traits of interest from the dropdown menu (i.e. Affectionate With Family, Coat Type, Adaptability Level, Trainability Level). Thereafter, the user can decide the importance of each selected trait according to their preference using the slider provided (1 slider for importance of positive traits, 1 for importance of negative traits). As a result of the preferences, our algorithm will return a list of top five dog breeds that fit your preferences the most (in descending order) and display it on the landing page of the app. There will also be a plot showing the yearly ranking trends of the 5 selected dog breeds as well as a table with the details of each individual trait selected. From there, users can explore the recommended breeds and determine which one is the best for them!

Contributing

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

DoggoDash is built using Dash, and thus Dash is required for contributing to the project. Dash can be installed by running:

install.packages("dash")

Once Dash is installed and the repository is cloned (following the instructions in the contributing guidelines), a local version of the app for testing can be built by running:

Rscript app.R

Simply copy and paste the web address created into your browser of choice to begin seeing your changes come to life!

License

doggodash was created by Samuel Quist, Steven Leung, Shiv Jena and Linh Giang Nguyen. It is licensed under the terms of the MIT license.