An interactive dashboard illustrating historic olympic data and trends
Thank you for visiting the olympic-dash project repository!
This README file is a hub to give you some information about the project. Jump straight to one of the sections below, or just scroll down to find out more.
- What Are We Doing?
- Description of The Dashboard
- Proposed Sketch
- Contribute to This Dashboard
- Contributors
- Code of Conduct
- License
“The goal of the Olympic Movement is to contribute to building a peaceful and better world by educating youth through sport practiced without discrimination of any kind and in the Olympic spirit, which requires mutual understanding with a spirit of friendship, solidarity and fair play.”
-- International Olympic Committee
We propose building a visualization app to allow IOC members (and members of the general public) to explore historical Olympic results to review the success trends of various countries to determine abnormal performance trends and which countries could be future high medal achievers. All in the interest of making the olympic games more competitive and reward the countries that are developing their athletes and improving their performance in the games.
To explore the current dashboard, please click here.
This app contains a dashboard which visualizes Olympic data from 1896 up until 2016. Key metrics of interest will be displayed including:
- Medals earned per country
- Medals earned depending on athlete age
- Athlete height based on Olympic events
- Medals per country will be displayed
Medals earned per country will be displayed via a bubble chart. Countries are color coded by the IOC continent region they belong to.
A bar chart will show the medals earned for each athlete age bracket, while a histogram will show the distribution of athlete heights based on the event selected. These figures will contain a slider allowing users to adjust athlete age ranges and a dropdown list respectively, allowing users to select the event visualized.
Lastly, a line graph will display the number of medals earned by countries over time. This figure will be accompanied by a dropdown list allowing users to select a subset of countries to display on the graph.
Radio buttons on the side of the dashboard will allow for filtering of summer/winter Olympics data, in addition to allowing for users to filter data by the type of medals. Additionally a year slider will allow for users to filter data in the bubble chart and both histograms by year. Using these filters, users will be able to investigate trends in Olympic success between countries, medal types, athlete demographics, and more.
For the general information of this dashboard and the link to Github Repo, please click "About" button on the right side of dashboard header.
You are welcome to contribute to olympic-dash if you have any idea regarding to this dashboard. Please go through the contributing guidelines for the recommended ways if you want to contribute or report/fix any existing bugs.
To run the dashboard locally, we recommend to use a virtual environment like venv or Anaconda. For simplicity, we could demonstrate the installiation process with venv.
Run the following command at the root directory of the project:
- Create a virtual environment
python -m venv olympicdash
- Activate the environment
source olympicdash/bin/activate
- Install the requirements
pip install -r requirements.txt
python src/app.py
The dashboard could then be accessed locally in localhost:8050. Now, you are good to go!
To run this app using Docker write the following commands after cloning the repo:
cd olympic-dash
docker-compose upFinally, open the app in the followin URL http://localhost:8000/
This app was developed by the following contributors:
| Contributor | Github Username |
|---|---|
| Allyson Stoll | @datallurgy |
| Helin Wang | @helingogo |
| Rubén De la Garza Macías | @ruben1dlg |
| Andy Yang | @AndyYang80 |
In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation. For more details, see our code of conduct.
olympic-dash was created by Allyson Stoll, Helin Wang, Rubén De la Garza Macías and Song Bo Andy Yang . It is licensed under the terms of the MIT license.