-
Notifications
You must be signed in to change notification settings - Fork 2
/
README.Rmd
151 lines (89 loc) · 7.6 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# spiR
<!-- badges: start -->
[](https://travis-ci.org/warint/spiR)
[](https://ci.appveyor.com/project/warint/spiR)
[](https://CRAN.R-project.org/package=spiR)
[](https://cran.r-project.org/package=spiR)
<!-- badges: end -->
In 2015, The 17 United Nations' Sustainable Development Goals were adopted. 'spiR' is a wrapper of several open datasets published by the Social Progress Imperative (<https://www.socialprogress.org/>), including the Social Progress Index (a synthetic measure of human development across the world). 'spiR''s goal is to provide data to help policymakers and researchers prioritize actions that accelerate social progress across the world in the context of the Sustainable Development Goals. The Social Progress Index proposes a new perspective on social challenges and needed efforts to accelerate social progress in line with the Sustainable Development Goals. In this context, the goal of 'spiR' is to allow an easy connection with R to the Social Progress Index in order to benefit from the "power of crowds." 'spiR' is an R wrapper to easily access the Social Progress Index datasets.
At the Social Progress Imperative, they define "social progress as the capacity of a society to meet the basic human needs of its citizens, establish the building blocks that allow citizens and communities to enhance and sustain the quality of their lives, and create the conditions for all individuals to reach their full potential. Improving quality of life is a complex task and past efforts to measure progress simply haven’t created a sufficiently nuanced picture of what a successful society looks like. That’s why we created the Social Progress Index. Rather than emphasizing traditional measurements of success like income and investment, we measure 51 social and environmental indicators to create a clearer picture of what life is really like for everyday people. The index doesn’t measure people’s happiness or life satisfaction, focusing instead on actual life outcomes in areas from shelter and nutrition to rights and education. This exclusive focus on measurable outcomes makes the index a useful policy tool that tracks changes in society over time."
The index measures the quality of life for 98% of the world's population. In its current version, the R client provides access to global data. In further versions, this R client will include different geographical levels: states, regions, cities and sometimes communities.
Three overarching dimensions are (1) Basic Human Needs, (2) Foundations of Wellbeing, and (3) Opportunity. Within each dimension, there are four components that further divide the indicators into thematic categories. The index consists in 51 social and environmental variables, covering the years 2014 to 2019.
To see a definition of the indicators, please visit this [page](https://www.socialprogress.org/index/global/definitions/#BHN/0/0/){target="_blank"}.
To read the methodology summary of the Social Progress Index [[here]](https://legacy.socialprogress.org/assets/downloads/resources/2020/2020-Social-Progress-Index-Methodology.pdf){target="_blank"}
See below to have access through 'spiR' to the whole list of indicators.
## Overview of the available data
Users can recreate in R impactful dashboards and visualizations as the ones found on [www.socialprogress.org](https://www.socialprogress.org/){target="_blank"}: [click here](https://www.socialprogress.org/?tab=2&code=NOR&embedded=true/){target="_blank"}
## Installation
The released version of spiR package is accessible through CRAN and devtools.
``` r
install.packages("spiR")
install.packages("devtools")
devtools::install_github('warint/spiR')
```
## How-To
### Step 1: Getting the country's ISO code
A user needs to enter the ISO code of a country. To have access to this code, the following function provides this information.
```{r, eval = FALSE}
spir_country() # A list of all countries will be produced
spir_country(country = "Canada") # The ISO code for Canada will be produced
spir_country("Canada") # The ISO code for Canada will be produced
```
### Step 2: Getting the indicator's code
A user needs to enter the code of the desired indicator. To do so, the following function provides access to all the indicators of interest.
```{r, eval = FALSE}
spir_indicator() # A list of all indicators will be produced
spir_indicator(indicators = "mortality") # A list with all the variables including "mortlity" will be produced
spir_indicator("mortality") # A list with all the variables including "mortlity" will be produced
```
### Step 3: Getting the data
Once the user knows the ISO code and the indicator's code, s.he can collect the data in a very easy way through this function:
```{r, eval=FALSE}
spir_data(country = c("USA", "FRA"), year = c("2018", "2019"), indicators = "SPI") # It generates a data frame of the overall SPI indicator for the USA and France for the years 2018 and 2019
spir_data(country = c("USA", "FRA"), years = "2018", ) # It generates a data frame of all the indicators for the USA and France for the year 2018
spir_data("USA", "2019", c("SPI", "FOW")) # It generates a data frame of the SPI and FOW indicators for the USA in 2019
spir_data(, "2018", ) # It generates a data frame for all the countries and all the indicators for 2018
spir_data("USA", "2017", ) # It generates a data frame of all the indicators for the USA in 2017
spir_data("USA", , ) # It generates a data frame of all the indicators for all the years for the USA
spir_data(, , ) # It generates a data frame of the complete dataset
spir_data() # It generates a data frame of the complete dataset
```
### Optional Step : Create Visuals
spir_visual fonction allows to create two types of visuals from the SPI data : barchart and linechart.
The first is a barchart of the top 9 countries for the chosen indicator and year.
```{r,echo=TRUE}
library(spiR)
spir_visual(chart = "bar_1", indicator = "SPI", years = "2020")
```
The second is a linechart showing the evolution of the most represented countries over time for the chosen indicator.
```{r,echo=TRUE}
spir_visual(chart = "line_1", indicator = "SPI", years = "2020")
```
### Cite 'spiR'
If you use the spiR package for research, education, policymaking or other related purposes, please cite the package as well as the Social Progress Imperative. Consider making them a donation to help them pursue the work. Business, social enterprises and investors interested in using the Social Progress Index should contact their offices.
To cite the 'spiR' package in your work:
Warin, T. (2019). "spiR: Client for the Social Progress Index. v0.2.1."
```{r,eval=FALSE}
@article{Warin2019,
author = "Thierry Warin",
title = "{spiR: An R Package for the Social Progress Index}",
year = "2019",
month = "12",
url = "https://figshare.com/articles/spiR_Client_for_Social_Progress_Index_Data/11421573/",
doi = "10.6084/m9.figshare.11421573.v2"
}
```
### Acknowledgements
The author would like to thank the Center for Interuniversity Research and Analysis of Organizations (CIRANO, Montreal) for its support, as well as Thibault Senegas, Marine Leroi and Martin Paquette. The usual caveats apply.