From e083d473082f2e206b24a660fb167729e700ed40 Mon Sep 17 00:00:00 2001 From: Jerry Yu <74574486+jy1909@users.noreply.github.com> Date: Sat, 30 Mar 2024 11:10:37 -0700 Subject: [PATCH] Milestone 1 reivew (#22) Closes #21 --- README.md | 6 ++++- reports/m1_proposal.md | 48 ++++++++++++++++++++++++++--------- reports/research_questions.md | 6 ----- 3 files changed, 41 insertions(+), 19 deletions(-) delete mode 100644 reports/research_questions.md diff --git a/README.md b/README.md index 318cde4..97acaaa 100644 --- a/README.md +++ b/README.md @@ -1 +1,5 @@ -# DSCI-532_2024_3_world-happiness-tracker \ No newline at end of file +# DSCI-532_2024_3_world-happiness-tracker + +## Purpose + +We aim to develop a dashboard that visually represents the global happiness score as well as the happiness scores of various countries and regions. This dashboard will be useful for educational purposes across multiple fields where the happiness score can prove to be beneficial. These fields include, but are not limited to, economics, sociology, and psychology. diff --git a/reports/m1_proposal.md b/reports/m1_proposal.md index e947d69..c3c09e1 100644 --- a/reports/m1_proposal.md +++ b/reports/m1_proposal.md @@ -1,27 +1,51 @@ +# World Happiness Tracker App Dashboard Proposal + ## Section 1: Motivation and Purpose -Our Role: Developer of Teaching Tools + +Our Role: Developer of Teaching Tools Target Audience: Educational Dashboard for Students Exploring various methods to learn about happiness in the world is commonplace within educational contexts, encompassing fields such as psychology, sociology, and economics. We inhabit a world where comprehending and comparing global happiness is increasingly significant. With the expanding divide between technology and conventional education, this dashboard seeks to bridge that gap by integrating technological tools into educational settings, thereby enhancing students understanding of happiness around the globe. -The ability to visually interact with this dashboard enables students to see different regions and countries happiness scores, as well as the factors contributing to these specific scores, through a variety of filters. Students will also gain an understanding of how a country or region's happiness scores compare to global averages and how these scores have evolved over recent years +The ability to visually interact with this dashboard enables students to see different countries' happiness scores, as well as the factors contributing to these specific scores, through a variety of filters. Students will also gain an understanding of how countries' happiness scores compare to the global average and how these scores have evolved over recent years. + +## Section 2: Description of Data + +For our visualization, we will use a dataset spanning from 2015 to 2019, comprising approximately 156 rows (countries) for each year. This brings the total to 782 rows. The dataset includes various columns that indicate a country's happiness ranking and score, as well as the factors contributing to this score. The columns that are to be used in this dashboard include: + +1. `Country`: String values that will appear five times, once for each year, indicating the name of the country in the dataset. + +2. `Overall rank` (also called `Happiness Rank` or `Happiness.Rank` in certain years): Integer values ranging from 1 to 158, representing the country’s happiness ranking globally. Each ranking will (typically) appear five times, as the countries are ranked once every year. + +3. `Score` (also called `Happiness Score` or `Happiness.Score` in certain years): Continuous values that typically range between 7.8 and 2.8, with higher scores indicating greater happiness according to the data. -## Section 2: Description of Data -For our visualization, we will use data spanning from 2015 to 2019, comprising approximately 156 rows (countries) for each year. This brings the total to 782 rows. The dataset includes various columns that indicate a country's happiness ranking and score, as well as the factors contributing to this score. The included columns are: +4. The following columns (contributing factors to happiness): `GDP per capita` (also known as `Economy..GDP.per.Capita.` or `Economy (GDP per Capita)` in certain years), `Social support` (also known as `Family` in certain years), `Healthy life expectancy` (also known as `Health..Life.Expectancy.` or `Health (Life Expectancy)` in certain years), `Freedom to make life choices` (also known as `Freedom` in certain years), `Generosity`, and `Perceptions of corruption` (also known as `Trust..Government.Corruption.` or `Trust (Government Corruption)` in certain years) are continuous variables. They detail the extent to which these factors contribute to a country's happiness score. These variables can be interpreted as coefficients and range between 0 and 2. -1. Country: String values that will appear five times, once for each year. +Utilizing this data, we will create certain columns such as a `year` column and a normalized version of each contribution factor to happiness above to provide additional, more interpretable data points. This will aid in better understanding the impact of various factors on a country's Happiness Score. -3. Happiness Ranking: Integer values ranging from 1 to 156, representing the country’s happiness ranking globally. Each ranking will appear five times, as the same ranking can be assigned to different years. +## Section 3: Research Questions and Usage Scenarios -4. Happiness Score: Continuous values that typically range between 7.8 and 2.8, with higher scores indicating greater happiness according to the data. +Geography and economy classes in high school are mostly preliminary. They do not touch on really sophisticated topics and are only there to build the foundation for any future learning. A simple tool displaying world happiness level can let students understand the distributions of happiness across the world, how some of the happiest and unhappiest countries differ, and also inspect some of the underlying factors that influence these levels. -5. The following columns: GDP per capita, Family, Life Expectancy, Freedom, Generosity, and Trust (Government Corruption), are continuous variables. They detail the extent to which these factors contribute to a country's happiness score. These variables can be interpreted as coefficients and will range between 0 and 2. - -Utilizing this data, we will create certain columns such as a year column and a reverse-engineered version of the following variables: GDP per capita, Family, Life Expectancy, Freedom, Generosity, and Trust (Government Corruption), to provide additional, more interpretable data points. This will aid in better understanding the impact of various factors on a country's Happiness Score. +Our target audiences are members of high school geography/economy classes (teachers and students). John is a high school student learning about economics. He would like to learn about happiness around the world and what factors influence this. He is also interested in how happiness changes across the years. -## Section 4: App sketch & brief description +Using our tool, he is able to find the happiness level for each country/region across the world over time and compare two against each other in terms of their happiness level, ranking, and how some factors influence their levels such as economy, freedom, trust in government, etc. He can also use our filters to investigate deeper into specific countries and years of interest. -The World Happiness Tracker App allows users to explore the Happiness Score of different countries. At the top of the page, the dashboard presents some global key numbers to the user. These numbers aim to give a user some reference points for the interpretation of further information. Below the key numbers block, the app presents the center piece of the app which is the world map that encodes the happiness score for each country with the help of a color scale. The default of the world map is to show the happiness scores for all countries for the most recent year. As the user chooses specific countries as Country A and Country B, as well as a particular year, the map greys out all the countries not selected by the user and only highlights the colors of the selected countries. The block below the map consists of three parts that allow more insights into the happiness of the selected countries. The ranking displays the rank of each of the selected countries out of all the countries. The line plot visualizes the happiness over time of the two countries A and B over the years and highlights the year selected. Finally, the bar chart breaks down the happiness score into its components and shows how much individual components contributed to the overall score. +Hypothetically, John finds that the economy is a major factor contributing to the happiness level, which likely makes sense considering that ultimately economy is the most major tie with quality of life for people around the world. He can then perhaps probe further into the economies of the happiest and unhappiest countries in the world and see how they differ. + +## Section 4: App Sketch and Brief Description ![sketch](../img/sketch.png) + +The World Happiness Tracker App allows users to explore the Happiness Score of different countries. + +At the top of the page, the dashboard presents some global key numbers to the user. These numbers aim to give a user some reference points for the interpretation of further information. + +Below the key numbers block, the app presents the center piece of the app which is the world map that encodes the happiness score for each country with the help of a color scale. The default of the world map is to show the happiness scores for all countries for the most recent year. As the user chooses a particular year, the map will be adjusted to reflect the user's selection. + +The block below the map consists of three parts that allow more insights into the happiness of the selected countries of the selected year (and by default, all countries of the current year are selected). The ranking displays the rank of each of the selected countries out of all the countries. + +The line plot visualizes the happiness over time of the two countries A and B over the years and highlights the year selected. By default, with no countries or year selected, the a line of the global average will be shown with no highlights. + +Finally, the bar chart breaks down the happiness score into its components and shows how much individual components contributed to the overall score. diff --git a/reports/research_questions.md b/reports/research_questions.md deleted file mode 100644 index ea5fbbd..0000000 --- a/reports/research_questions.md +++ /dev/null @@ -1,6 +0,0 @@ -## Research Questions and Usage Scenarios -Geography and economy classes in high school are mostly preliminary. They do not touch on really sophisticated topics and are only there to build the foundation for any future learning. A simple tool displaying world happiness level can let students understand the distributions of happiness across the world, how some of the happiest and unhappiest countries differ, and also inspect some of the underlying factors that influence these levels. - -Our target audiences are members of high school geography/economy classes (teachers and students). John is a high school student learning about geography. Using our tool, he is able to find the happiness level for each country/region across the world over time and compare two against each other in terms of their happiness level, ranking, and how some factors influence their levels such as economy, freedom, trust in government, etc. - -Hypothetically, John finds that the economy factor contributes mostly to the happiness level, which likely makes sense considering that ultimately economy is the most major tie with quality of life for people around the world. He can then perhaps probe further into the economic models of the happiest and unhappiest countries in the world and see how they differ. \ No newline at end of file