forked from rOpenGov/eurostat
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.Rmd
executable file
·133 lines (93 loc) · 6.87 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
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "README-"
)
```
<!-- badges: start -->
[](https://ropengov.org/)
[](https://github.com/rOpenGov/eurostat/actions/workflows/check-full.yaml)
[](https://github.com/rOpenGov/eurostat/actions/workflows/check-standard.yaml)
[](https://CRAN.R-project.org/package=eurostat)
[](https://lifecycle.r-lib.org/articles/stages.html#stable-1)
[](https://doi.org/10.32614/RJ-2017-019)
[](https://app.codecov.io/gh/rOpenGov/eurostat)
[](https://cran.r-project.org/package=eurostat)
[](https://cran.r-project.org/package=eurostat)
[](https://app.gitter.im/#/room/#rOpenGov_eurostat:gitter.im?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
[](https://ropengov.r-universe.dev/)
[![Watch on GitHub][github-watch-badge]][github-watch]
[![Star on GitHub][github-star-badge]][github-star]
[](https://twitter.com/ropengov)
<!--[](https://travis-ci.org/rOpenGov/eurostat)-->
<!--[](https://ci.appveyor.com/project/rOpenGov/eurostat)-->
<!--[]()-->
<!--[](https://doi.org/10.5281/zenodo.399279)-->
<!--[![PRs Welcome][prs-badge]][prs]-->
<!--[![Code of Conduct][coc-badge]][coc]-->
<!--[](#contributors)-->
<!--[](https://opensource.org/licenses/BSD-2-Clause)-->
<!--[](http://waffle.io/ropengov/eurostat)-->
<!--[](https://cran.r-project.org/package=eurostat)-->
<!-- badges: end -->
# eurostat R package <a href='https://ropengov.github.io/eurostat/'><img src='man/figures/logo.png' align="right" height="139" /></a>
R tools to access open data from [Eurostat](https://ec.europa.eu/eurostat). Data search, download, manipulation and visualization.
### Installation and use
Install stable version from CRAN:
```{r, eval = FALSE}
install.packages("eurostat")
```
Alternatively, install development version from GitHub:
```{r, eval = FALSE}
# Install from GitHub
library(devtools)
devtools::install_github("ropengov/eurostat")
```
Development version can be also installed using the
[r-universe](https://ropengov.r-universe.dev):
```{r, eval=FALSE}
# Enable this universe
options(repos = c(
ropengov = "https://ropengov.r-universe.dev",
CRAN = "https://cloud.r-project.org"
))
install.packages("eurostat")
```
The package provides several different ways to get datasets from Eurostat. Searching for data is one way, if you know what to look for.
```{r example, eval = TRUE}
# Load the package
library(eurostat)
# Perform a simple search and print a table
passengers <- search_eurostat("passenger transport")
knitr::kable(head(passengers))
```
See the [Tutorial](https://ropengov.github.io/eurostat/articles/articles/eurostat_tutorial.html) and other resources at the [package homepage](https://ropengov.github.io/eurostat/) for more information and examples.
### Recommended packages
It is recommended to install the `giscoR` package (https://dieghernan.github.io/giscoR/). This is another API package that provides R tools for Eurostat geographic data to support geospatial analysis and visualization.
### Contribute
Contributions are very welcome:
* [Use issue tracker](https://github.com/ropengov/eurostat/issues) for feedback and bug reports.
* [Send pull requests](https://github.com/ropengov/eurostat/)
* [Star us on the Github page](https://github.com/ropengov/eurostat/)
* [Join the discussion in Gitter](https://app.gitter.im/#/room/#rOpenGov_eurostat:gitter.im)
### Acknowledgements
**Kindly cite this package** by citing the following R Journal article:
[Lahti L.](https://github.com/antagomir), Huovari J., Kainu M., and Biecek P. (2017). Retrieval and analysis of Eurostat open data with the eurostat package. [The R Journal 9(1), pp. 385-392](https://journal.r-project.org/archive/2017/RJ-2017-019/index.html). doi: [10.32614/RJ-2017-019](https://doi.org/10.32614/RJ-2017-019).
In addition, please provide a citation to the specific software version used:
Lahti, L., Huovari J., Kainu M., Biecek P., Hernangomez D., Antal D., and Kantanen P. (2023). eurostat: Tools for Eurostat Open Data [Computer software]. R package version 4.0.0.9003. https://github.com/rOpenGov/eurostat
We are grateful to all [contributors](https://github.com/ropengov/eurostat/graphs/contributors), including Daniel Antal, Joona Lehtomäki, Francois Briatte, and Oliver Reiter, and for the [Eurostat](https://ec.europa.eu/eurostat/) open data portal! This project is part of [rOpenGov](https://ropengov.org).
### Disclaimer
This package is in no way officially related to or endorsed by Eurostat.
When using data retrieved from Eurostat database in your work, please indicate that the data source is Eurostat. If your re-use involves some kind of modification to data or text, please state this clearly to the end user. See Eurostat policy on [copyright and free re-use of data](https://ec.europa.eu/eurostat/about/policies/copyright) for more detailed information and certain exceptions.
[license-badge]: https://img.shields.io/npm/l/eurostat.svg?style=flat-square
[license]: https://github.com/ropengov/eurostat/blob/master/LICENSE
[github-watch-badge]: https://img.shields.io/github/watchers/ropengov/eurostat.svg?style=social
[github-watch]: https://github.com/ropengov/eurostat/watchers
[github-star-badge]: https://img.shields.io/github/stars/ropengov/eurostat.svg?style=social
[github-star]: https://github.com/ropengov/eurostat/stargazers
[eurostat]: https://github.com/ropengov/eurostat/