Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

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

Recent Releases of useeior

useeior - v1.7.0

What's Changed

Full Changelog: https://github.com/USEPA/useeior/compare/v1.6.1...v1.7.0

Industrial Ecology - Input Output Model - R
Published by bl-young about 2 months ago

useeior - v1.6.1

Updates to support consumption based emission inventories (CBEI) calculations. Aligns with EPA report, Consumption-Based Greenhouse Gas Emissions Inventories for Northeastern States.

What's Changed

Full Changelog: https://github.com/USEPA/useeior/compare/v1.6.0...v1.6.1

Industrial Ecology - Input Output Model - R
Published by bl-young 6 months ago

useeior - v1.6.0

Includes new features to support the incorporation of Import Emission Factors (IEFs) for single and two-region models, results in new matrices A_m, M_m and N_m and a new ImportMatrix dataframe and removes the M and N matrices for these models with IEFs (but not for existing models).
Detail (USEEIOv2.3-GHG) and summary model (USEEIOv2.3-s-GHG-19) based on 2019 GHG data are added with IEFs from EXIOBASE.
Household/final user emissions are added via matrix, B_h
Functions are hidden from the API but are still present in package, including:
aggregateResultMatrixbyRow(), compare2RCommodityTotals(), compareCommodityOutputXMarketShareandIndustryOutputwithCPITransformation(), compareCommodityOutputandDomesticUseplusProductionDemand(), compareEandLCIResult(), and compareOutputandLeontiefXDemand()

This is a pre-release because some functions are temporarily hidden from the user due to lack of compatibility with new models with IEFs.
These include: calculateMarginSectorImpacts(), calculateSectorContributiontoImpact(), calculateFlowContributiontoImpact(), and disaggregateTotalToDirectAndTier1()
These will be restored in a future release.

Full Changelog: https://github.com/USEPA/useeior/compare/v1.5.3...v1.6.0

Industrial Ecology - Input Output Model - R
Published by bl-young 9 months ago

useeior - v1.5.3

What's Changed

Full Changelog: https://github.com/USEPA/useeior/compare/v1.5.2...v1.5.3

Industrial Ecology - Input Output Model - R
Published by bl-young 10 months ago

useeior - v1.5.2

What's Changed

  • Adds 2012-2016 summary tables in the latest (2017) schema.
  • Adds expanded years to CPI and GO tables (1997-2022; prior release was only 2017-2022)
  • Adds 2012 Detail tables in 2017 schema for Supply, Use (SUT), Imports, Margins, Make and Use PRO BeforeRedef

Aligns with BEA data update of additional annual tables on 5/23/24 (#293)

Full Changelog: https://github.com/USEPA/useeior/compare/v1.5.1...v1.5.2

Industrial Ecology - Input Output Model - R
Published by bl-young 11 months ago

useeior - v1.5.1

What's Changed

Full Changelog: https://github.com/USEPA/useeior/compare/v1.5.0...v1.5.1

Industrial Ecology - Input Output Model - R
Published by bl-young about 1 year ago

useeior - v1.5.0

Major updates

  • Finalizes new model types: Mixed-unit Input-Output (MUIO) and Waste Input-Output (WIO) (#268)
  • Updates BEA data with 2017 schema (#280)
    • 2017 Detail tables (Make, Use, Supply, Use_SUT)
    • 2017-2022 Summary tables
    • 2017 MasterCrosswalk

Other updates

  • Model specs stored within the package only include approved models, model specs used for testing are moved to tests subfolder (#282)
  • Enable satellite tables from custom path (#272)
  • Improves error handling for missing model spec (#273)

Full Changelog: https://github.com/USEPA/useeior/compare/v1.4.0...v1.5.0

Industrial Ecology - Input Output Model - R
Published by bl-young about 1 year ago

useeior - v1.4.0

What's Changed

  • Allows for the generation of two-region EEIO models for U.S. states (2012-2020, Summary level) with calculation, visualization, validation, and writing to Excel (disaggregation of sectors in two-region models not yet available).
  • Sample two-region model spec for Georgia GAEEIOv1.0-s-WAT-12, 2012 Summary model with water withdrawals
  • Resolves error in domestic result calculation using final perspective (#262)

Full Changelog: https://github.com/USEPA/useeior/compare/v1.3.0...v1.4.0

Industrial Ecology - Input Output Model - R
Published by bl-young over 1 year ago

useeior - v1.3.0

What's Changed

Import BEA Supply and Use tables by @MoLi7 in https://github.com/USEPA/useeior/pull/238

  • Download and save BEA Supply and Use tables at Detail, Summary, and Sector levels
  • Refactor related functions to adapt to the SUTs
  • Adds Tau: A dataframe of basic to producer price ratio

Full Changelog: https://github.com/USEPA/useeior/compare/v1.2.2...v1.3.0

Industrial Ecology - Input Output Model - R
Published by bl-young over 1 year ago

useeior - v1.2.2

What's Changed

  • Updates for handling input files for hybrid models
  • Improves handling of input files from external sources for disaggregation and hybridization

Full Changelog: https://github.com/USEPA/useeior/compare/v1.2.1...v1.2.2

Industrial Ecology - Input Output Model - R
Published by bl-young almost 2 years ago

useeior - v1.2.1

What's Changed

  • resolves Error generating margins for disaggregated industry models (#252)

Full Changelog: https://github.com/USEPA/useeior/compare/v1.2.0...v1.2.1

Industrial Ecology - Input Output Model - R
Published by bl-young almost 2 years ago

useeior - v1.2.0

Major updates

  • embeds Sept 2022 release of BEA industry data covering through 2021
  • enables creations of EEIO models without indicators

What's Changed (automated list)

Full Changelog: https://github.com/USEPA/useeior/compare/v1.1.1...v1.2.0

Industrial Ecology - Input Output Model - R
Published by WesIngwersen about 2 years ago

useeior - 1.1.1

What's Changed

  • Correct output ratio calculation for Summary and Sector USEEIO models
  • Make order of margin sectors consistent across tables
  • Mark all transportation sectors correctly in schema info tables

Full Changelog: https://github.com/USEPA/useeior/compare/v1.1.0...v1.1.1

Industrial Ecology - Input Output Model - R
Published by MoLi7 over 2 years ago

useeior - 1.1.0

What's Changed

  • Updated BEA IO data and saved data up to 2020 (most recent year BEA has provided).
  • Added functionality to load and use StateIO (two-region) data.
  • Added feature of integrated hybrid models (see example model spec USEEIOv2.0-GHG-NGCombustion)

Full Changelog: https://github.com/USEPA/useeior/compare/v1.0.0...v1.1.0

Industrial Ecology - Input Output Model - R
Published by MoLi7 almost 3 years ago

useeior - 1.0.2

This release is in support of creating the v1.1.1 of Supply Chain Emission Factors (SEFs) originally published in EPA's "Supply Chain Greenhouse Gas Emission Factors (SEF) for US Industries and Commodities" report.

Industrial Ecology - Input Output Model - R
Published by MoLi7 about 3 years ago

useeior - 1.0.1

This release is in support of creating the amendment to EPA's "Supply Chain Greenhouse Gas Emission Factors (SEF) for US Industries and Commodities" report. An updated v1.1 of the SEFs produced with this release of useeior are included in the amendment.

Industrial Ecology - Input Output Model - R
Published by MoLi7 over 3 years ago

useeior - 1.0.0

useeior is an R package for building and using USEEIO models. The model object is the primary output that is built according to a given model specification and optional hybridization specification, e.g. disaggregation. Model specifications and associated hybridization specifications, e.g. disaggregation, for EPA-validated models are included in the package. The package offers various functions for validating, calculating, visualizing, and writing out models and/or their components. useeior is a core component of the USEEIO Modeling Framework.

useeior is in a stable development state. Users intending to use the package for production purposes and applications should use the latest Release.

See the README for installation and basic usage of useeior. See Wiki for advanced uses, details about built-in data and metadata and how to contribute to useeior.

This package was developed under the USEPA quality assurance plan K-LRTD-0030017-QP-1-4 for "U.S. Environmentally-Extended Input-Output (USEEIO) Models". useeior v0.4 was subjected to internal EPA peer-review and then reviewed and cleared by EPA management. Updates in the package since that time are described in this release and previous releases since v0.4.

What's Changed

New Contributors

Full Changelog: https://github.com/USEPA/useeior/compare/v0.4.2...v1.0.0

Industrial Ecology - Input Output Model - R
Published by MoLi7 over 3 years ago

useeior - v0.4.2

  • Update metadata files to include 'sector categories' and 'descriptions' fields in support of JSON-LD export for openLCA
  • Add these fields to disaggregated input files
  • Ensure UUIDs are correctly maintained in satellite tables and exported as flow metadata
  • Add model spec 2.0.1 for updated satellite tables w UUIDs. This model aligns with updates associated with flowsa v0.3.1
  • Fix error causing missing disaggregation of some flows in waste satellite table

Industrial Ecology - Input Output Model - R
Published by MoLi7 over 3 years ago

useeior - v0.4.1

Model data enhancements

  • Updates acquisition of model data
  • Adds logging feature to acquisition of model data
  • Adds two additional external data: Detail_Use_2012_PUR_AfterRedef.rda and Summary_Import_2018_BeforeRedef.rda

Calculation, Validation, Visualization and Export of Models

  • Adds aggregateResultTable and aggregateResultMatrix functions
  • Adds calculateConsumptionContributiontoImpact function
  • Adds writeMetadatatoJSON for exporting model metadata to JSON format for USEEIO API use
  • Refactors model validation approach

Corrections

  • Changes file paths in loading model component and model writing out functions

Deprecated

  • Removes validate package from DESCRIPTION

Industrial Ecology - Input Output Model - R
Published by MoLi7 over 3 years ago

useeior - v0.4

A version of useeior capable of building the complete USEEIOv2.0 model along with related model variants. It includes new capabilities of building disaggregated models, of validating and visualizing built models, and significantly enhances model calculation and export. This version includes complete function and data object documentation, model identification and sessionInfo capture, and more thorough logging. This version has been through US EPA internal review and cleared by management.

Model building enhancements

  • Permits model disaggregation for commodity-based models at BEA detail and summary levels with user defined and default allocation rules and embedded configuration and input files; provides associated waste sector disaggregation configuration and input files
  • Adds capability of creating domestic Use tables and associated domestic model component and result matrices through integration of BEA import matrix
  • Adds capability of building satellite tables from flowsa data products in flow-by-sector-collapsed format as .parquet files hosted on the EPA Data Commons or by calling flowsa python library directly via the R reticulate package, or through calling external csv files of existing USEEIO satellite tables reformatted in totals-by-sector format, and subsequently removes embedded static satellite tables
  • Adds capability of integrating indicators from LCIA Formatter LCIA method formatted data products in .parquet format hosted on the EPA Data Commons or by calling the lciafmt python library directly via the R reticulate package, and subsequently removes static LCIA factors for previously used USEEIO methods except for waste type aggregations, jobs and value added
  • Uses local caching for remotely acquired files
  • Creates buildModel wrapper function to build models in a single command along with refactoring of the called model building functions
  • Adds new demand vector specifications and improved functions for defining total consumption, total production, household consumption, and domestic variants from a given final demand table
  • Refactors and improves the matrix nomenclature
  • Adds price adjustment matrices to model object
  • Improves sector crosswalk building and related sector mapping functions
  • Removes some residual model objects at model build time that were used as reference data in model building but were not reflective of the final model
  • Provides cleaner and more extensive logging for modeling building steps and calculations
  • Provides model configuration files for 7 USEEIO models including USEEIOv2.0 and variants

Documentation

  • Provides complete Help documentation for all functions and built-in data objects
  • Provides (outside of R package) format details for models and all included objects, as well as for model specification and disaggregation specification and input files
  • Provides R file first-line comments to describe scope of file

Calculation, Validation, Visualization and Export of Models

  • Adds final perspective calculation (see original USEEIO paper, Yang et al. 2017)
  • Adds analytical sector contribution and flow contribution to impact calculations
  • Provides extensive model validation capability with checks that calculate output and flow totals using model components and compare them to the originals in the input data
  • Adds visualization functions plotMatrixCoefficient, barplotIndicatorScoresbySector, heatmapSatelliteTableCoverage, heatmapSectorRanking, barplotFloworImpactFractionbyRegion and default color schemes for sectors and indicators
  • Adds compareFlowTotals for comparing flows in two models
  • Adds model writing out/export capability for USEEIO API and to .xlsx or .csv format along with with additional session info and model SHA hash-based identifier creation for identifying unique model builds and associating them with user OS, hardware and R configuration

Corrections

  • Corrects price adjustment functions
  • Refactors margin loading to correct use of margin data and avoid double counting

Deprecated

  • Removes deriveMarginSectorImpacts
  • Removes antiquated flow mapping functions
  • Removes generateNonScrapRatios from IO functions and other scrap-adjustment capabilities (scrap is now included as a sector in models)
  • Removes model configuration files for 2010-2016 GHG models (2.0.10.....2.0.16)

Industrial Ecology - Input Output Model - R
Published by WesIngwersen almost 4 years ago

useeior - 0.2.0-v2a

Build an alpha version of USEEIO2.0, along with test model USEEIO2.0-nodisagg and USEEIO2.0-GHG, Other models not functioning at this point.

Industrial Ecology - Input Output Model - R
Published by WesIngwersen over 4 years ago

useeior - v0.1

This initial release of useeior is capable of building, calculating, and writing out USEEIO models using BEA IO tables at sector, summary, and detail levels of resolution and national greenhouse gas (GHG) data from 2010-2016.

For each model, the package provides:
-A list of objects including original data tables, standard IO and EEIO matrices
-Transportation, Wholesale and Retail margins for these models
-GHG satellite tables
-GHG indicators (using GWP-100) with various groupings of gases
-Capability of calculating results based on the 'direct perspective' (Yang, Ingwersen et al. 2016) for total US production or consumption or a given demand vector
-Preparation of matrices for domestic requirements or foreign requirements separately as well as the full requirements (domestic + foreign)
-Capability of calculating the impact of margins
-Ability to adjust the US dollar year of results

The package also includes:
-Config files for 46 v2.0 USEEIO national models with data from 2010 to 2016
-8 externally callable and documented functions for viewing available models, building them, calculating their results, and writing out the results to CSV files
-2 external functions for getting NAICS sector classification
-Unit tests for data quality, model configuration, satellite tables, and input-output analysis functions
-Documentation for 174 functions and included datasets

Industrial Ecology - Input Output Model - R
Published by WesIngwersen about 5 years ago