A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

iotables

Reproducible input-output economic analysis, economic and environmental impact assessment with empirical data.
https://github.com/rOpenGov/iotables

Category: Industrial Ecology
Sub Category: Input Output Model

Keywords

r r-package rstats

Keywords from Contributors

ropengov observatory regions eurostat eurostat-data health

Last synced: about 18 hours ago
JSON representation

Repository metadata

Importing and Manipulating Symmetric Input-Output Tables

README.Rmd

          ---
output:
  md_document:
    variant: gfm
---


```{r setupknitr, echo = FALSE, message=FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/"
  #fig.path = "README-"
)
```

# iotables 

```{r description, echo = FALSE}
version <- as.vector(read.dcf('DESCRIPTION')[, 'Version'])                
version <- gsub('-', '.', version)
```                                                                                                                         


![iotables](man/figures/logo20.png)
[![rOG-badge](https://ropengov.github.io/rogtemplate/reference/figures/ropengov-badge.svg)](https://ropengov.org/)
[![packageversion](https://img.shields.io/badge/Package%20version-`r version`-orange.svg?style=flat-square)](https://github.com/rOpenGov/iotables/commits/master)
[![Project Status: Active](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
[![R-CMD-check](https://github.com/rOpenGov/iotables/workflows/R-CMD-check/badge.svg)](https://github.com/rOpenGov/iotables/actions)
[![CRAN_Status_Badge](https://www.r-pkg.org/badges/version/iotables)](https://cran.r-project.org/package=iotables)
[![CRAN_time_from_release](https://www.r-pkg.org/badges/ago/iotables)](https://cran.r-project.org/package=iotables)
[![metacran downloads](https://cranlogs.r-pkg.org/badges/iotables)](https://cran.r-project.org/package=iotables)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.10472240.svg)](https://doi.org/10.5281/zenodo.10472240/)
[![license](https://img.shields.io/badge/license-MIT + file LICENSE-lightgrey.svg)](https://choosealicense.com/)
[![codecov](https://codecov.io/gh/rOpenGov/iotables/branch/master/graph/badge.svg)](https://app.codecov.io/gh/rOpenGov/iotables)
[![AppVeyor build status](https://ci.appveyor.com/api/projects/status/github/rOpenGov/iotables?branch=master&svg=true)](https://ci.appveyor.com/project/rOpenGov/iotables)
[![dataobservatory](https://img.shields.io/badge/ecosystem-dataobservatory.eu-3EA135.svg)](https://dataobservatory.eu/)

The symmetric input-output tables (SIOTs) are complex statistical products that present inter-related statistics in a predefined structure. They are often found in spreadsheets that follow this structure or, in the case of Eurostat, in a data repository. In both cases in, reproducible research must be downloaded and restructured to a programmatically accessible form. Often, these highly structured statistics need to be analysed together with other data, for example, when calculating employment effects and multipliers. In this case, processing the employment data to SIOT conforming format is a significant preprocessing challenge.

The iotables are exactly designed for these tasks. Currently, the package downloads and processes standardized European SIOTs conforming to the latest statistical regulations, i.e. SIOTs starting from 2010.

The aim of this introduction is not to introduce input-output economics, or SIOTs in detail. The [Eurostat Manual of Supply, Use and Input-Output Tables](https://ec.europa.eu/eurostat/en/web/products-manuals-and-guidelines/-/KS-RA-07-013) and the [Eurostat thematic page](https://ec.europa.eu/eurostat/web/esa-supply-use-input-tables/overview) (for further reference: `Eurostat Manual`) in the documentation should be consulted for further information about the data and the metadata. 

To test the analytical functions of the package and to have a
manageable-sized example data set, we use real-life data from the
Eurostat manual. The `germany_1995` dataset is a simplified 6x6 sized
SIOT was taken from the `Eurostat Manual` (`p481`). The package function examples can be checked against [published results from Jörg Beutel](https://ec.europa.eu/eurostat/documents/3859598/5902113/KS-RA-07-013-EN.PDF/b0b3d71e-3930-4442-94be-70b36cea9b39?version=1.0).
These calculations can be followed in the [Introduction to iotables](https://iotables.dataobservatory.eu/articles/intro.html)
vignette.

The calculation of induced effects (Type-II multipliers) are following the [Input-Output Multipliers Specification Sheet and Supporting Material, Spicosa Project Report](https://web.archive.org/web/20220331124544/www.coastal-saf.eu/output-step/pdf/Specification%20sheet%20I_O_final.pdf). The analytical functions are tested against this example, too.

## Installation

You can install iotables 0.9.3 from CRAN or the latest 0.9.31 development version with github:

```{r gh-installation, eval = FALSE}
# From CRAN:
install.packages("iotables")

# From Github (development version)
devtools::install_github("rOpenGov/iotables")

#with vignettes:
#devtools::install_github("rOpenGov/iotables", build_vignettes = TRUE)
```

See also a long-form documentation (publication candidate) [iotables: an R Package for Reproducible Input-Output Economics Analysis, Economic and Environmental Impact Assessment with Empirical Data](https://zenodo.org/record/5887038#.Ye2ovv7MLIU) on Zenodo.

## Vignettes 

The [Introduction to iotables](https://iotables.dataobservatory.eu/articles/intro.html) vignette presents most of the examples of the [Eurostat Manual of Supply, Use and Input-Output Tables](https://ec.europa.eu/eurostat/documents/3859598/5902113/KS-RA-07-013-EN.PDF/b0b3d71e-3930-4442-94be-70b36cea9b39?version=1.0) (Eurostat Manual, Chapter 15.) This is a good introduction to understand what will the functions do, and to check that they work correctly.  From 0.9.9 it extended with the replication results from the [Handbook on Supply and Use Tables and Input-Output Tables with Extensions and Applications](https://unstats.un.org/unsd/nationalaccount/docs/SUT_IOT_HB_Final_Cover.pdf) published by the United Nations.

The `testthat` infrastructure of the package checks the proper working of the functions against the published results from the `Eurostat Manual`.

The [Working with Eurostat Data](https://iotables.dataobservatory.eu/articles/working_with_eurostat.html) vignette shows how you can download, pre-process and use real data from Eurostat.

The [United Kingdom Input-Output Analytical Tables 2010](https://webarchive.nationalarchives.gov.uk/20160114044923/http://www.ons.gov.uk/ons/rel/input-output/input-output-analytical-tables/2010/index.html) are used for testing the `iotables` package, because they are well-documented and detailed, organized data is available with them. These calculations can be followed in the [United Kingdom Input-Output Analytical Tables](https://iotables.dataobservatory.eu/articles/united_kingdom_2010.html) vignette.

## Acquiring data
Eurostat's data can be downloaded in several tidy, long-form, files, and a lot of filtering is needed to start working with it.

Currently the following Eurostat SIOTs can be used:

| Table type   | source code |                                                    
| :---        |    :----:    | 
| product x product SIOTs      |`naio_10_cp1700` or `naio_10_pyp1700`  |
| industry x industry SIOTs    | `naio_10_cp1750` or`naio_10_pyp1750`  |
| use tables at basic prices   | `naio_10_cp1620` or `naio_10_pyp1610` |
| trade and transport margins  | `naio_10_cp1620` or `naio_10_pyp1620` |
| net taxes less subsidies     | `naio_10_cp1630` or `naio_10_pyp1630` |
| Supply table at basic prices  | `naio_10_cp15`   |
| Use table at purchasers' price | `naio_10_cp16`  |

The `cp` element refers to basic prices and the `pyp` to previous years' prices.

### Contribute

Contributions are very welcome:

  * [Issue tracker](https://github.com/ropengov/iotables/issues) for feedback and bug reports.
  * [Pull requests](https://github.com/ropengov/iotables/)
  * [Github page](https://github.com/ropengov/iotables/)

### Acknowledgements

**Kindly cite this work** as follows: 

Daniel Antal. (2024. January 8.) rOpenGov/iotables: Importing and Manipulating Symmetric Input-Output Tables (Version 0.9.3). CRAN. [https://doi.org/10.5281/zenodo.10472240](https://zenodo.org/record/5153006/) for released version. 
Development version URL: [https://ropengov.github.io/iotables/](https://ropengov.github.io/iotables/)

Thanks to [\@KKulma](https://github.com/KKulma/) for setting up new and improved continuous integration, and [\@pitkant](https://github.com/pitkant) for implementing many good practices on improving the code. See [contributors](https://github.com/ropengov/iotables/graphs/contributors). This project is part of [rOpenGov](https://ropengov.org).


## Code of Conduct
  
Please note that the iotables project is released with a [Contributor Code of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.

        

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 7 days ago

Total Commits: 868
Total Committers: 6
Avg Commits per committer: 144.667
Development Distribution Score (DDS): 0.018

Commits in past year: 4
Committers in past year: 1
Avg Commits per committer in past year: 4.0
Development Distribution Score (DDS) in past year: 0.0

Name Email Commits
antaldaniel a****l@g****m 852
pitkant p****n@g****m 6
Kasia k****a@g****m 6
Leo l****i@i****i 2
ajgmolina a****a@g****m 1
Diego H d****o@g****m 1

Committer domains:


Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 23
Total pull requests: 7
Average time to close issues: about 2 months
Average time to close pull requests: 10 days
Total issue authors: 6
Total pull request authors: 5
Average comments per issue: 2.04
Average comments per pull request: 1.0
Merged pull request: 6
Bot issues: 0
Bot pull requests: 0

Past year issues: 3
Past year pull requests: 0
Past year average time to close issues: about 2 hours
Past year average time to close pull requests: N/A
Past year issue authors: 2
Past year pull request authors: 0
Past year average comments per issue: 1.0
Past year average comments per pull request: 0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/rOpenGov/iotables

Top Issue Authors

  • antaldaniel (16)
  • giuliogcantone (2)
  • LucaPavanIdea (2)
  • jennybc (1)
  • rafserqui (1)
  • IwoA (1)

Top Pull Request Authors

  • KKulma (2)
  • pitkant (2)
  • antagomir (1)
  • ajgmolina (1)
  • dieghernan (1)

Top Issue Labels

  • enhancement (4)
  • documentation (3)
  • question (1)
  • bug (1)

Top Pull Request Labels


Dependencies

.github/workflows/R-CMD-check.yaml actions
  • actions/cache v2 composite
  • actions/checkout v2 composite
  • actions/upload-artifact main composite
  • r-lib/actions/setup-pandoc v1 composite
  • r-lib/actions/setup-r v1 composite
DESCRIPTION cran
  • R >= 3.5.0 depends
  • assertthat * imports
  • dplyr * imports
  • eurostat * imports
  • forcats * imports
  • glue * imports
  • kableExtra * imports
  • knitr * imports
  • lubridate * imports
  • magrittr * imports
  • plyr * imports
  • readxl * imports
  • rlang * imports
  • tibble * imports
  • tidyr * imports
  • tidyselect * imports
  • utils * imports
  • covr * suggests
  • rmarkdown * suggests
  • spelling * suggests
  • testthat * suggests
.github/workflows/rhub.yaml actions
  • r-hub/actions/checkout v1 composite
  • r-hub/actions/platform-info v1 composite
  • r-hub/actions/run-check v1 composite
  • r-hub/actions/setup v1 composite
  • r-hub/actions/setup-deps v1 composite
  • r-hub/actions/setup-r v1 composite

Score: 5.225746673713202