-
Notifications
You must be signed in to change notification settings - Fork 1
/
README.Rmd
91 lines (72 loc) · 4.25 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
---
output: github_document
---
# manystates <img src="man/figures/manystates_hexlogo.png" align="right" width="220"/>
<!-- badges: start -->
[![lifecycle](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://www.tidyverse.org/lifecycle/#experimental)
![GitHub release (latest by date)](https://img.shields.io/github/v/release/globalgov/manystates)
![GitHub Release Date](https://img.shields.io/github/release-date/globalgov/manystates)
![GitHub issues](https://img.shields.io/github/issues-raw/globalgov/manystates)
[![Codecov test coverage](https://codecov.io/gh/globalgov/manystates/branch/main/graph/badge.svg)](https://app.codecov.io/gh/globalgov/manystates?branch=main)
[![CodeFactor](https://www.codefactor.io/repository/github/globalgov/manystates/badge)](https://www.codefactor.io/repository/github/globalgov/manystates)
<!-- badges: end -->
`manystates` is a data package within the
[many universe of packages](https://github.com/globalgov).
It contains an ensemble of datasets currently available on states in the world,
including information on states' beginning and, where applicable, end dates,
regime characteristics, and state leaders. An important aim of `manystates` is
to record and include states as far back in history as possible. The package is
geared towards global governance research, but can also be used by anyone
interested in state actors across time.
Please also check out [`{manydata}`](https://github.com/globalgov/manydata) for
more information about the other packages and tools to handle data from the
many universe of packages.
## How to install
We've made it easier than ever to install and start analysing global governance
data in R. Simply install the core package,
[manydata](https://github.com/globalgov/manydata), as follows,
and then you can discover, install and update various 'many packages' from the
console.
```{r install, warning=FALSE, message=FALSE}
manydata::get_packages() # this prints a list of the publicly available data packages currently available
#manydata::get_packages("manystates") # this downloads and installs the named package
```
## Data included
Once you have installed `{manydata}`, you can see the different databases and
datasets included in the `{manystates}` package using the following function.
```{r datasets, warning=FALSE, message=FALSE}
manydata::data_contrast("manystates")
```
Working with ensembles of related data has many advantages for robust analysis.
Just take a look at our vignettes [here](https://globalgov.github.io/manydata/articles/user.html).
## The many packages universe
The [many universe of packages](https://github.com/globalgov/manydata) is aimed
at collecting, connecting and correcting network data across issue-domains of
global governance.
While some 'many packages' can and do include novel data,
much of what they offer involves standing on the shoulders of giants.
'many packages' endeavour to be as transparent as possible about where data
comes from, how it has been coded and/or relabelled, and who has done the work.
As such, we make it easy to cite the datasets you use
by listing the official references using the function above,
as well as the package providers for their work assembling the data
by using the function below.
```{r cites}
citation("manystates")
```
## Contributing
[manydata](https://github.com/globalgov/manydata/blob/main/.github/CONTRIBUTING.md)
also makes it easy to contribute in lots of different ways.
If you have already developed a dataset salient to this package,
please reach out by flagging this as an [issue](https://github.com/globalgov/manystates/issues)
for us, or by forking, further developing the package yourself, and opening a
[pull request](https://github.com/globalgov/manystates/pulls)
so that your data can be used easily.
If you have collected or developed other data that may not be best for this
package, but could be useful within the wider universe of `many packages`,
[manypkgs](https://github.com/globalgov/manypkgs) includes a number of
functions that make it easy to create a new `many package` and populate it with
clean, consistent global governance data.
If you have any other ideas about how this package or the manydata packages
universe more broadly might better facilitate your empirical analysis, we'd be
very happy to hear from you.