Skip to content

Commit

Permalink
Merge branch 'master' of https://github.com/rOpenGov/eurostat
Browse files Browse the repository at this point in the history
  • Loading branch information
@pitkant
pitkant committed Aug 31, 2021
2 parents c6ab9aa + 7c2d4b3 commit 74d96f8
Showing 1 changed file with 60 additions and 111 deletions.
171 changes: 60 additions & 111 deletions README.md
View file
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@

<!-- README.md is generated from README.Rmd. Please edit that file -->

<!-- badges: start -->

[![R build
Expand All @@ -16,129 +18,75 @@ GitHub](https://img.shields.io/github/stars/ropengov/eurostat.svg?style=social)]
[![Follow](https://img.shields.io/twitter/follow/ropengov.svg?style=social)](https://twitter.com/intent/follow?screen_name=ropengov)

<!--[![Build Status](https://travis-ci.org/rOpenGov/eurostat.svg?branch=master)](https://travis-ci.org/rOpenGov/eurostat)-->

<!--[![AppVeyor Status](https://ci.appveyor.com/api/projects/status/github/rOpenGov/eurostat?branch=master&svg=true)](https://ci.appveyor.com/project/rOpenGov/eurostat)-->

<!--[![license](https://img.shields.io/github/license/mashape/apistatus.svg)]()-->

<!--[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.399279.svg)](https://doi.org/10.5281/zenodo.399279)-->

<!--[![PRs Welcome][prs-badge]][prs]-->

<!--[![Code of Conduct][coc-badge]][coc]-->

<!--[![Contributors](https://img.shields.io/github/contributors/cdnjs/cdnjs.svg?style=flat-square)](#contributors)-->

<!--[![License](https://img.shields.io/pypi/l/Django.svg)](https://opensource.org/licenses/BSD-2-Clause)-->

<!--[![Stories in Ready](http://badge.waffle.io/ropengov/eurostat.png?label=TODO)](http://waffle.io/ropengov/eurostat)-->

<!--[![CRAN version](http://www.r-pkg.org/badges/version/eurostat)](https://cran.r-project.org/package=eurostat)-->

<!-- badges: end -->

eurostat R package
==================
# eurostat R package

R tools to access open data from
[Eurostat](https://ec.europa.eu/eurostat). Data search, download,
manipulation and visualization.

### Installation and use

# Install from CRAN
install.packages("eurostat")
Install stable version from CRAN:

``` r
install.packages("eurostat")
#> Installing package into '/Users/runner/work/_temp/Library'
#> (as 'lib' is unspecified)
#> also installing the dependencies 'sys', 'bit', 'prettyunits', 'proxy', 'utf8', 'askpass', 'bit64', 'withr', 'progress', 'wk', 'backports', 'ellipsis', 'generics', 'purrr', 'e1071', 'lifecycle', 'R6', 'tidyselect', 'vctrs', 'pillar', 'openssl', 'Rcpp', 'cli', 'clipr', 'crayon', 'hms', 'vroom', 'cpp11', 'tzdb', 'xml2', 'plyr', 'DBI', 's2', 'units', 'fansi', 'pkgconfig', 'broom', 'classInt', 'countrycode', 'curl', 'dplyr', 'httr', 'lubridate', 'RColorBrewer', 'readr', 'RefManageR', 'sf', 'tibble', 'tidyr'
#>
#> The downloaded binary packages are in
#> /var/folders/24/8k48jl6d249_n_qfxwsl6xvm0000gn/T//RtmpBTxu9J/downloaded_packages
```

# Install from GitHub
library(devtools)
devtools::install_github("ropengov/eurostat")
Alternatively, install development version from GitHub:

``` r
# Install from GitHub
library(devtools)
devtools::install_github("ropengov/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.

# Load the package
library(eurostat)

# Perform a simple search and print a table
passengers <- search_eurostat("passenger transport")
knitr::kable(head(passengers))

<table style="width:100%;">
<colgroup>
<col style="width: 40%" />
<col style="width: 8%" />
<col style="width: 4%" />
<col style="width: 12%" />
<col style="width: 17%" />
<col style="width: 6%" />
<col style="width: 5%" />
<col style="width: 4%" />
</colgroup>
<thead>
<tr class="header">
<th style="text-align: left;">title</th>
<th style="text-align: left;">code</th>
<th style="text-align: left;">type</th>
<th style="text-align: left;">last update of data</th>
<th style="text-align: left;">last table structure change</th>
<th style="text-align: left;">data start</th>
<th style="text-align: left;">data end</th>
<th style="text-align: left;">values</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">Air passenger transport</td>
<td style="text-align: left;">enps_avia_pa</td>
<td style="text-align: left;">dataset</td>
<td style="text-align: left;">16.04.2021</td>
<td style="text-align: left;">NA</td>
<td style="text-align: left;">2005</td>
<td style="text-align: left;">2020</td>
<td style="text-align: left;">NA</td>
</tr>
<tr class="even">
<td style="text-align: left;">Volume of passenger transport relative to GDP</td>
<td style="text-align: left;">tran_hv_pstra</td>
<td style="text-align: left;">dataset</td>
<td style="text-align: left;">07.07.2021</td>
<td style="text-align: left;">07.07.2021</td>
<td style="text-align: left;">1990</td>
<td style="text-align: left;">2019</td>
<td style="text-align: left;">NA</td>
</tr>
<tr class="odd">
<td style="text-align: left;">Modal split of passenger transport</td>
<td style="text-align: left;">tran_hv_psmod</td>
<td style="text-align: left;">dataset</td>
<td style="text-align: left;">07.07.2021</td>
<td style="text-align: left;">07.07.2021</td>
<td style="text-align: left;">1990</td>
<td style="text-align: left;">2019</td>
<td style="text-align: left;">NA</td>
</tr>
<tr class="even">
<td style="text-align: left;">Air passenger transport by reporting country</td>
<td style="text-align: left;">avia_paoc</td>
<td style="text-align: left;">dataset</td>
<td style="text-align: left;">02.07.2021</td>
<td style="text-align: left;">02.07.2021</td>
<td style="text-align: left;">1993</td>
<td style="text-align: left;">2021Q1</td>
<td style="text-align: left;">NA</td>
</tr>
<tr class="odd">
<td style="text-align: left;">Air passenger transport by main airports in each reporting country</td>
<td style="text-align: left;">avia_paoa</td>
<td style="text-align: left;">dataset</td>
<td style="text-align: left;">02.07.2021</td>
<td style="text-align: left;">02.07.2021</td>
<td style="text-align: left;">1993</td>
<td style="text-align: left;">2021Q1</td>
<td style="text-align: left;">NA</td>
</tr>
<tr class="even">
<td style="text-align: left;">Air passenger transport between reporting countries</td>
<td style="text-align: left;">avia_paocc</td>
<td style="text-align: left;">dataset</td>
<td style="text-align: left;">02.07.2021</td>
<td style="text-align: left;">02.07.2021</td>
<td style="text-align: left;">1993</td>
<td style="text-align: left;">2021Q1</td>
<td style="text-align: left;">NA</td>
</tr>
</tbody>
</table>
``` r
# Load the package
library(eurostat)

# Perform a simple search and print a table
passengers <- search_eurostat("passenger transport")
knitr::kable(head(passengers))
```

| title | code | type | last update of data | last table structure change | data start | data end | values |
| :----------------------------------------------------------------- | :-------------- | :------ | :------------------ | :-------------------------- | :--------- | :------- | :----- |
| Air passenger transport | enps\_avia\_pa | dataset | 16.04.2021 | NA | 2005 | 2020 | NA |
| Volume of passenger transport relative to GDP | tran\_hv\_pstra | dataset | 07.07.2021 | 07.07.2021 | 1990 | 2019 | NA |
| Modal split of passenger transport | tran\_hv\_psmod | dataset | 07.07.2021 | 07.07.2021 | 1990 | 2019 | NA |
| Air passenger transport by reporting country | avia\_paoc | dataset | 27.08.2021 | 27.08.2021 | 1993 | 2021Q2 | NA |
| Air passenger transport by main airports in each reporting country | avia\_paoa | dataset | 27.08.2021 | 27.08.2021 | 1993 | 2021Q2 | NA |
| Air passenger transport between reporting countries | avia\_paocc | dataset | 27.08.2021 | 27.08.2021 | 1993 | 2021Q2 | NA |

See the
[Tutorial](https://ropengov.github.io/eurostat/articles/website/eurostat_tutorial.html)
Expand All @@ -149,38 +97,39 @@ examples.
### Recommended packages

It is recommended to install the `giscoR` package
(<a href="https://dieghernan.github.io/giscoR/" class="uri">https://dieghernan.github.io/giscoR/</a>).
This is another API package that provides R tools for Eurostat
geographic data to support geospatial analysis and visualization.
(<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
- [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://gitter.im/rOpenGov/eurostat)
- [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://gitter.im/rOpenGov/eurostat)

### Acknowledgements

**Kindly cite this work** as follows: [Leo
Lahti](https://github.com/antagomir), Przemyslaw Biecek, Markus Kainu
and Janne Huovari. Retrieval and analysis of Eurostat open data with the
eurostat package. [R Journal 9(1):385-392,
2017](https://journal.r-project.org/archive/2017/RJ-2017-019/index.html).
R package version 3.7.7. URL: <https://ropengov.github.io/eurostat/>
eurostat package. [R
Journal 9(1):385-392, 2017](https://journal.r-project.org/archive/2017/RJ-2017-019/index.html).
R package version 3.7.5. URL: <https://ropengov.github.io/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](http://ropengov.org).
portal\! This project is part of [rOpenGov](http://ropengov.org).

### Disclaimer

This package is in no way officially related to or endorsed by Eurostat.

<!--[build-badge]: https://img.shields.io/travis/ropengov/eurostat.svg?style=flat-square-->

<!--[build]: https://travis-ci.org/ropengov/eurostat-->

0 comments on commit 74d96f8

Please sign in to comment.