Learn R Programming

iotables

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 and the Eurostat thematic page (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. These calculations can be followed in the Introduction to iotables vignette.

The calculation of induced effects (Type-II multipliers) are following the Input-Output Multipliers Specification Sheet and Supporting Material, Spicosa Project Report. The analytical functions are tested against this example, too.

Installation

You can install iotables 0.9 from CRAN or the latest 0.9.1 development version with github:

# 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 on Zenodo.

Vignettes

The Introduction to iotables vignette presents most of the examples of the Eurostat Manual of Supply, Use and Input-Output Tables (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 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 vignette shows how you can download, pre-process and use real data from Eurostat.

The United Kingdom Input-Output Analytical Tables 2010 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 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 typesource code
product x product SIOTsnaio_10_cp1700 or naio_10_pyp1700
industry x industry SIOTsnaio_10_cp1750 ornaio_10_pyp1750
use tables at basic pricesnaio_10_cp1620 or naio_10_pyp1610
trade and transport marginsnaio_10_cp1620 or naio_10_pyp1620
net taxes less subsidiesnaio_10_cp1630 or naio_10_pyp1630
Supply table at basic pricesnaio_10_cp15
Use table at purchasers’ pricenaio_10_cp16

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

Contribute

Contributions are very welcome:

Acknowledgements

Kindly cite this work as follows:

Daniel Antal. (2022. September 24.) rOpenGov/iotables: Importing and Manipulating Symmetric Input-Output Tables (Version 0.9.1). Zenodo. https://doi.org/10.5281/zenodo.7109769 for released version. Development version URL: https://ropengov.github.io/iotables/

Thanks to @KKulma for setting up new and improved continuous integration, and @pitkant for implementing many good practices on improving the code. See contributors. This project is part of rOpenGov.

Code of Conduct

Please note that the iotables project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

Copy Link

Version

Install

install.packages('iotables')

Monthly Downloads

348

Version

0.9.3

License

MIT + file LICENSE

Maintainer

Daniel Antal

Last Published

January 8th, 2024

Functions in iotables (0.9.3)

germany_airpol

Air Pollution Table for Germany, 1995.
employment_metadata

Employment metadata
germany_1995

Simple input-output table for Germany, 1995.
input_indicator_create

Create input indicator(s)
indirect_effects_create

Create indirect effects
employment_get

Get employment data
household_column_get

Return Final Household Expenditure
iotables-package

iotables: Reproducible Input-Output Economics Analysis, Economic and Environmental Impact Assessment with Empirical Data
iotables_download

Download input-output tables
input_multipliers_create

Create input multipliers
input_flow_get

Create an inter-industry or input flow matrix
iotable_get

Get An Input-Output Table Fom Bulk File
input_coefficient_matrix_create

Create an input coefficient matrix
iotable_year_get

Get the available years from bulk downloaded input-output tables
get_saved_table

Get an input-output table from a downloaded bulk file
key_column_create

Create a key columnn
is_latex_output

Check if Latex output is required
getdata

Various internal functions to work with IOT metadata, including the labelling vocabularies, row and column ordering. None of these functions should be exported.
netherlands_2006

Simple input-output table for the Netherlands, 2006.
ghosh_inverse_create

Create the inverse of a Ghosh-matrix
household_column_find

Return the position of final household expenditure
leontief_inverse_create

Create the inverse of a Leontief-matrix
leontief_matrix_create

Create a Leontief matrix
non_zero_columns_find

Find Non-zero Columns
quadrant_separator_find

Determine the end of Quadrant I and III.
iotables_metadata_get

Get Metadata from Nested iotables File
matrix_round

Round all matrix values to required number of digits.
iotables_read_tempdir

Read input-output tables from temporary directory
supplementary_add

Add supplementary data
rows_add

Add conforming row(s)
primary_inputs

Primary input abbreviations
primary_input_get

Get primary inputs
output_coefficient_matrix_create

Create an output coefficient matrix
round_table

Systematically round values in a table
uk_2010_data

United Kingdom Input-Output Analytical Tables, 2010
vector_transpose_longer

Transpose a vector to a long form
output_get

Get an output vector
output_multiplier_create

Create output multipliers
uk_2010_get

Get United Kingdom Input-Output Analytical Tables, 2010
%>%

Pipe operator
validate_source

Validate source Parameter
uk_2010_results_get

Get United Kingdom Multipliers and Effects, 2010
total_tax_add

Summarize and add tax data
metadata

Metadata
uk_test_results

Multipliers and effects (product) for testing from the United Kingdom Input-Output Analytical Tables, 2010
tempdir_data

Download to and retrieve from the temporary directory a Eurostat dataset
vector_transpose_wider

Transpose a vector to wider format
is_html_output

Check if HTML output is required
multiplier_create

Create multipliers
is_key_column_present

Is a keyword present in a key column?
metadata_uk_2010

Multipliers and effects (product) for testing from the United Kingdom Input-Output Analytical Tables, 2010
check_digits

Check digits parameter
conforming_vector_create

Create an empty conforming vector
airpol_get

Get air pollutant data
backward_linkages

Backward linkages
coefficient_matrix_create

Create a coefficient matrix
croatia_2010_1800

Input-output table for Croatia, 2010.
create_knitr_table

Create an output-independent, well formatted kable table
croatia_2010_1700

Input-output table for Croatia, 2010.
chars_collapse

Collapse character vectors
croatia_2010_1900

Input-output table for Croatia, 2010.
direct_effects_create

Create direct effects
empty_remove

Symmetrically remove empty rows and columns
equation_solve

Solve a basic (matrix) equation
forward_linkages

Forward linkages
croatia_employment_2013

Croatian employment data for the year 2013
croatia_employment_aggregation

Aggregation table for Croatian employment statistics