recca - v0.1.62

Recca 0.1.62 (2025-08-03)

write_ecc_to_excel() now allows writing worksheets into pre-existing files. New boolean argument overwrite_worksheets controls whether existing worksheets can be overwritten.
New tests for new features.
- Now up to 898 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun 7 months ago

recca - v0.1.61

Recca 0.1.61 (2025-07-25)

reallocate_statistical_differences() is now robust to ECCs with no Statistical differences, with Statistical differences in only R, and with Statistical differences in only Y.
Move reallocate_statistical_differences() and its tests from IEATools to Recca. The purpose of IEATools is to move from the IEA format to the PSUT format. The purpose of Recca is to manipulate data already in the PSUT format. reallocate_statistical_differences() requires data in the PSUT format and therefore reallocate_statistical_differences() is better suited to Recca.
write_ecc_to_excel() now completes the U and V matrices relative to each other on both margins, thereby enabling easier energy balance checks via (iR)^T^ + (iV)^T^ - Ui - y = 0.

- R
Published by MatthewHeun 7 months ago

recca - v0.1.60

Recca 0.1.60 (2025-07-06)

New function add_row_col_types() adds row and column types to matrices based on default matrix names and structure of the PSUT framework. First use is inside read_ecc_from_excel().
New function read_ecc_from_excel() serves as the inverse of write_ecc_to_excel(), taking advantage of named regions in Excel spreadsheets. Both functions now name regions as <<matrix name>>__<<worksheet name>> by default.
New tests for new features.
- Now up to 852 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun 8 months ago

recca - v0.1.59

Recca 0.1.59 (2025-06-27)

Now provides much better error reporting for illegal named region and worksheet names in write_ecc_to_excel().
New tests for new features.
- Now up to 794 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun 8 months ago

recca - v0.1.58

Recca 0.1.58 (2025-06-27)

New argument worksheet_names on write_ecc_to_excel() enables setting worksheet names in the resulting Excel file.
Now claiming dependence on R >= 4.1.0 due to use of the new pipe.
write_ecc_to_excel() now adds a region name for each matrix in the Excel sheet.
New tests for new features.
- Now up to 780 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun 8 months ago

recca - v0.1.57

Recca 0.1.57 (2025-05-26)

Update R-CMD-check GitHub action.
extend_to_exergy() now ignores the phi vector when computing the exergy version of the U_EIOU matrix if the the energy version of the U_EIOU matrix is the 0 matrix. extend_to_exergy() simply returns the 0 matrix, same as the energy version of the U_EIOU matrix.
No new tests.
- Still at 775 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun 9 months ago

recca - v0.1.56

Recca 0.1.56 (2024-12-09)

Significantly improved some energy balance error messages. The source of the error is now reported.
Added row and column types to the result of calc_eta_i().
Fixed a bug where missing UEIOU matrix would cause an error in `extendtoexergy()`. We create a UEIOU matrix by multiplying U by 0, thereby keeping the same rows and columns of U.
Change column names to remove "." characters that are incompatible with storage in PostgreSQL databases (and maybe others).
Fixed many tests and added a few new tests for new features.
- Now up to 775 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun about 1 year ago

recca - v0.1.55

Recca 0.1.55 (2024-02-06)

Testing now done in parallel.
New function extend_fu_details_to_exergy() converts the final-to-useful details matrices from energy to exergy.
New tests for new features.
- Now up to 763 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun about 2 years ago

recca - v0.1.54

Recca 0.1.54 (2023-12-21)

Added statement of need to README file.
Added Remotes: field to DESCRIPTION file to assist installation from the CLPFUDatabase metapackage.
No new tests.
- Still at 750 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun about 2 years ago

recca - v0.1.53

Recca 0.1.53 (2023-12-10)

Change to now-standard gh-pages branch for pkgdown website.
No new tests.
- Still at 750 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun about 2 years ago

recca - v0.1.52

Recca 0.1.52 (2023-12-01)

Fixed a bug where region_aggregates() would fail when no countries to be aggregated were available and drop_na_few was FALSE.
Added code of conduct and contributing pages to documentation.
New tests for bug fixes.
- Now up to 750 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun over 2 years ago

recca - v0.1.51

Recca 0.1.51 (2023-11-15)

Fixed a bug in calc_agg_eta_pfus() where efficiencies were calculated incorrectly when primary energy was different depending on the value of the Last.stage column.
No new tests.
- Still at 748 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun over 2 years ago

recca - v0.1.50

Recca 0.1.50 (2023-11-15)

New function calc_agg_eta_pfus() calculates primary, final, useful, and services aggregates and associated efficiencies.
New tests for new features.
- Now up to 748 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun over 2 years ago

recca - v0.1.49

Recca 0.1.49 (2023-11-03)

remove_neu() now also removes non-energy use products in the rows of Y.
Now re-exporting IEATools::nonenergy_use.
New tests for new features.
- Now up to 727 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun over 2 years ago

recca - v0.1.48

Recca 0.1.48 (2023-10-27)

New function remove_neu() eliminates "Non-energy useX" (where "X" is any additional string such as " in Industry") from the final demand matrix (Y) and swims upstream with new_Y() to remove any primary stage or useful stage energy associated with Non-energy use.
New tests for the new function.
- Now up to 717 tests, all passing.
- Test coverage remains at 100%.

- R
Published by MatthewHeun over 2 years ago

recca - v0.1.47

Recca 0.1.47 (2023-10-23)

Fixed a bug where EIOU efficiency calculated by calcetafuYeiou() gave the 0 matrix. Hat-tip to Emmanuel Aramendia for spotting this issue and assisting the debugging.
No new tests.
- Still at 712 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun over 2 years ago

recca - v0.1.46

Recca 0.1.46 (2023-10-16)

Minor updates to documentation.
The by argument to pfu_aggregates() now correctly chooses the default value ("Total") if unspecified.
No new tests.
- Still at 712 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun over 2 years ago

recca - v0.1.45

Recca 0.1.45 (2023-09-21)

Complete aggregation vignette.
No new tests.
- Still at 712 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun over 2 years ago

recca - v0.1.44

Recca 0.1.44 (2023-09-21)

Fixed a bug in node_edge_list() that caused failure when rowtypes or coltypes columns were not present.

- R
Published by MatthewHeun over 2 years ago

recca - v0.1.43

Recca 0.1.43 (2023-08-18)

Completed the aggregations vignette.
New function pfu_aggregates() is a work in progress but should (eventually) make calculating primary, final, and useful aggregates easier.
Breaking change: U and U_feed arguments removed from finaldemand_aggregates(), replaced by U_eiou, which was calculated from U and U_feed internally, and U_eiou is assumed to be present in all energy conversion chain representations.
The by argument to finaldemand_aggregates() can now be "Industry", which is treated as a synonym for "Sector".
Now returning an S_units_prime column when chopping matrices.
Wrapped some matrices in as.matrix() to guard against sparse matrices causing a failure in calc_yqfgW().
New tests for new features.
- Now up to at 712 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun over 2 years ago

recca - v0.1.42

Recca 0.1.42 (2023-06-02)

Fixed a bug where writing Matrix objects failed in write_ecc_to_excel(). Thanks to Pierre Jacques for reporting this problem.
New function calc_eta_fu() calculates final-to-useful efficiencies for every entry in Y and U_EIOU matrices, responding to a feature request from Pierre Jacques.
New tests for new features.
- Now up to at 641 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun almost 3 years ago

recca - v0.1.41

Recca 0.1.41 (2023-04-28)

Responded to policy changes in matsindf::matsindf_apply() by setting default arguments to NULL for several internal functions.
region_aggregates() gains drop_na_few argument that tells whether to eliminate rows with NA in few_colname.
Adjusted example ECC names. Example changes include:
- "Resources - Crude" --> "Resources [of Crude]"
- "Crude - Fields" --> "Crude [from Fields]"
- "MD - Car engines" --> "MD [from Car engines]" These changes align the example ECC with the naming conventions now in use throughout the package and in various pipelines.
chop_R() now also chops by rows (industries), since we are now including all exogenous sources of energy in the R matrix.
New function get_all_products_and_industries() generates lists of unique product and industry names for an ECC and is aware of RCLabels-type pieces of row and column names.
Net EROI calculations removed, only gross values calculated.
Simplifications reduced number of tests.
- Still at 632 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun almost 3 years ago

recca - v0.1.40

Recca 0.1.40 (2023-01-25)

This version contains only fixes to the continuous integration build system. There are no changes to any code.
Remove use of the Remotes: field in DESCRIPTION. Instead, now using pkgdepends syntax in the extra-packages: fields of R_CMD-check.yaml and test-coverage.yaml.
Update to latest version of the GitHub action for test coverage.
No new tests.
- Still at 672 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun about 3 years ago

recca - v0.1.39

Recca 0.1.39 (2023-01-24)

Tests once again all passing on all test rigs of GitHub Actions. Tests had been failing due to new code that correctly detects unit errors (inhomogeneity) for some upstream swim calculations with services as the last stage in an ECC.
Move tests associated with verify_cols_missing() from the Recca package to matsindf. Those tests didn't belong in Recca, because verify_cols_missing() is no longer in Recca.
Eliminated data frame rows for a couple tests that were producing NA values due to unit inhomogeneity.
Switched to simpler formulas derived by MKH for new_R_ps().
Eliminated tidyselect warnings.
write_ecc_to_excel() now ensures that columns of U and rows of V are the same, even if it means adding zero columns to U or zero rows to V. This change makes further Excel calculations easier.
chopR() now checks for the ability to swim downstream with R_prime = R to re-create the original energy conversion chain, thereby bringing consistency with chopY(). This approach identifies numerical precision errors before they cause a problem.
chopR() now uses calc_io_mats(direction = "downstream"), thereby consistently using calc_io_mats() for both upstream and downstream swims.
calc_io_mats() gains new argument direction that tells whether the input-output matrices are for "upstream" or "downstream" swims.
finaldemand_aggregates() now produces true 0 instead of a 1x1 matrix without row or column labels when no columns names of U_EIOU or Y match fd_sectors.
Fixed two bugs in new_Y(). There were compensatory formula errors that only appeared in some edge cases.
Aggregations are now optional (on by default) in chop_R() and chop_Y().
Renamed effects_aggregates() and footprint_aggregates() to chop_R() and chop_Y().
New function effects_aggregates() swims downstream from the R matrix to final demand for each column (energy carrier) in the R matrix and calculates primary and final demand aggregates.
footprint_aggregates() now checks that the chopped ECCs sum to the original ECC on every calculation.
region_aggregates() now correctly eliminates the few_colname when the incoming data frame has no rows.
footprint_aggregates() now also includes the *_prime_colname matrices in the nested data frame.
calc_io_mats() and calc_L() gain method and tol arguments to control matrix inversion.
calc_eta_pfd() now includes columns of names of efficiencies in its output. This feature will assist pivoting on efficiencies later.
New function footprint_aggregates() calculates primary and final demand aggregates for each isolated row and column in Y.
new_Y() now also produced matrices U_feed, U_eiou, and r_eiou in its output.
W matrix no longer included in the output of new_Y(). W can always be calculated from V^T - U.
New function write_ecc_to_excel() stores ECCs in spatial format in Excel. All ECC matrices are written to the Excel file: R, U, V, Y, U_feed, U_eiou, r_eiou, and S_units.
primary_aggregates() and finaldemand_aggregates() no longer require p_industries and fd_sectors to be present in the incoming list or data frame. Rather, p_industries and fd_sectors are treated as parameters that apply to all items in the incoming list or rows in the incoming data frame. This change brings consistency with other functions that use matsindf::matsindf_apply() internally.
New function group_aggregates() that aggregates PSUT matrices according to an aggregation map.
New function despecified_aggregates() that aggregates PSUT matrices to a piece of row and column labels.
New argument add_net_gross_cols on primary_aggregates() that tells whether to add both net and gross primary energy columns. (Net and gross primary energy aggregate columns will contain identical values, but the presence of both net and gross columns may make it easier to mesh with results from the finaldemand_aggregates() function, which produces net and gross columns that are different.)
aggregate_regions() now returns an empty data frame with the expected columns if the input data frame has no rows.
Many new tests for new features.
- Now up to 672 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun about 3 years ago

recca - v0.1.38

Recca 0.1.38 (2022-04-02)

Removed unnecessary assertion that matsbyname is available in aggregation functions.
Eliminated finaldemand_aggregates_with_units(), because nobody was using it.
New function calc_eta_pfd() calculates gross and net efficiencies from primary to final demand.
New function region_aggregates() calculates regional aggregates according to columns in a data frame.
New look for pkgdown website.
extend_to_exergy() gains new arguments mat_piece, phi_piece, notation, and prepositions to enable more flexible row and column name matching between the various matrices and phi vectors. In addition, extend_to_exergy() now uses matsbyname::vec_from_store_byname() internally to correctly handle hatized vector multiplication.
Many new tests for new features.
- Now up to 556 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun almost 4 years ago

recca - v0.1.37

Recca 0.1.37 (2021-10-13)

Added details to Recca vignette, including additional equations for embodied matrices.
New function extend_to_exergy() that calculates an exergy representation of an energy conversion chain given an energy representation of an energy conversion chain.
Many new tests for new features.
- Now up to 530 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun over 4 years ago

recca - v0.1.36

Recca 0.1.36 (2021-09-10)

Get started file updated. Some matrices definitions (G, H, E) needed to be updated.
Removed redundant IO matrices (Cfeed, Dfeed, and O_feed).
Tests
- 512 tests
- Test coverage remains at 100 %

- R
Published by earamendia over 4 years ago

recca - v0.1.35

Recca 0.1.35 (2021-08-20)

R matrix formulation now adopted for input output calculations, for upstream and downstream swims, as well as for embodied energy calculations.
Added new file new_R_ps_example.xlsx that demonstrates equations for swimming "downstream."
Updated to stable and active status badges.

- R
Published by earamendia over 4 years ago

recca - v0.1.34

Recca 0.1.34 (2021-04-11)

Fix lingering problems in R-CMD-check after the move to GitHub Actions for continuous integration testing.
New new tests.
- Still at 435 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun almost 5 years ago

recca - v0.1.33

Recca 0.1.33 (2021-04-11)

Move from Travis to GitHub Actions for continuous integration testing.
New new tests.
- Still at 435 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun almost 5 years ago

recca - v0.1.32

Recca 0.1.32 (2021-03-16)

Modified aggregation functions to use simpler (but verbose) if statements to choose aggregation functions. This change works around an error when calling the aggregation functions from other packages.
New tests for new code paths.
- Now at 435 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun almost 5 years ago

recca - v0.1.31

Recca 0.1.31 (2020-02-25)

New argument to aggregation functions: pattern_type which tells how to match primary and final demand sector names for aggregation.
New tests for new feature.
- Now 421 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun about 5 years ago

recca - v0.1.30

Recca 0.1.30 (2020-02-22)

Fixed bugs in finaldemand_aggregates() and finaldemand_aggregates_with_units() where argument fd_sectors was not respected for gross energy aggregation.
New and revamped tests to guard against regression.
- Now 417 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun about 5 years ago

recca - v0.1.29

Recca 0.1.29 (2020-02-01)

A method_q_calculation argument has been added to the calc_io_mats() function. This enables to calculate the q vector using either a consumption-side or supply-side perspective.

- R
Published by earamendia about 5 years ago

recca - v0.1.28

Recca 0.1.28 (2020-12-23)

New function find_p_industry_names() looks at R, V, and Y matrices to find names of primary industries (industries that produce primary energy). The function looks for prefixes among row (R and V) and column (Y) names to identify primary industries.
New tests for new function.
- Now 416 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun about 5 years ago

recca - v0.1.27

Recca 0.1.27 (2020-12-08)

Move IEA aggregation functions out of this package and into the IEATools package.
Now using package constants for names of aggregate columns. Column names match similar names in IEATools.
Now using better function-matching and -selecting code in finaldemand_aggregates()
Fewer tests due to moving some functions out of the package.
- Now 411 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun about 5 years ago

recca - v0.1.26

Recca 0.1.26 (2020-12-06)

primary_aggregates(), finaldemand_aggregates(), andfinaldemandaggregateswithunits()now require a column ofpindustriesorfdsectorsinstead of a vector when a.sutdatais a data frame. This change works around a problem with a common use case where the caller would create thefdsectorscolumn from the column names ofY` vectors in the data frame.
Working to modernize the Recca code.
- Use R markdown in documentation (`term` instead of \code{term}).
- Use package constants for column name arguments (Recca::sankey_cols$sankey instead of "Sankey").
New tests for the new feature.
- Now up to 413 tests, all passing.
- Test coverage remains at 100 %.

- R
Published by MatthewHeun about 5 years ago

recca - Recca 0.1.25 (2020-09-17)

New author Emmanuel Aramendia. Welcome!
Added tests for new features and old bugs.
- Now up to 407 tests, all of which pass.
- Test coverage remains at 100 %.
Test coverage now up to 100%.
Created a new function calc_embodied_EIOU() that calculates different embodied EIOU matrices for a given final demand
Created a new function calc_erois() that calculates different vector of product-level and industry-level EROIs using different assumptions.
Created a new function calc_E_EIOU() that calculates the E_EIOU matrix of EIOU energy use by unit of industry output, split by product. It also calculates the direct energy extension vector e_EIOU of total EIOU energy use by unit of industry output.
Fixed a bug in one of the vignettes related to the move from U_excl_EIOU to U_feed.
prep_UK2000.R and prep_perfectsub.R scripts fixed to work with IEATools, which now uses U_feed instead of U_excl_EIOU.

- R
Published by earamendia over 5 years ago

recca - v0.1.24

Recca 0.1.24 (2020-03-17)

New tests for new features and old bugs.
- Now up to 337 tests, all passing.
- Test coverage remains at 100 %.
Now using U_feed everywhere.
Calculate Z_feed and A_feed in calc_io_mats().

- R
Published by MatthewHeun over 5 years ago

recca - v0.1.23

Recca 0.1.23 (2020-03-17)

Added a ... argument to make_sankey(), which passes arguments to networkD3::sankeyNetwork().

- R
Published by MatthewHeun over 5 years ago

recca - v0.1.22

Recca 0.1.22 (2020-05-02)

Fixed a bug in primary_aggregates(). primary_aggregates() had been assuming that either the R or the V matrix (but not both) could contain industries counted in total primary energy supply (production, imports, exports, etc.). However, that is not true. R is for resource industries, so imports, exports, marine and aviation bunkers, and stock changes are excluded from R. However, imports, exports, marine and aviation bunkers, and stock changes are included in total primary energy supply. I removed the conditional xor check for appearance of TPES industries in R and V. Everything seems to be working now.

- R
Published by MatthewHeun almost 6 years ago

recca - v0.1.21

Recca 0.1.21 (2020-03-27)

Now up to 332 tests, all of which pass.
Test coverage now up to 100%.
Implemented energy balance checking for new_R_ps() with its own tolerance, by default 1e-6.

- R
Published by MatthewHeun almost 6 years ago

recca - v0.1.19

Recca 0.1.19 (2020-02-19)

Remove dependency on package qgraph. qgraph dependedn upong graph, which is apparently no longer available on CRAN. The dependency on qgraph was only for graphical representations of ECCs. But, graphical representations of ECCs are not presently implemented in Recca. Future versions of Recca may implement graphical representations. I can reassess the packages for graphing and Sankey diagrams at a later date.

- R
Published by MatthewHeun about 6 years ago

recca - v0.1.18

Updates to synchronize with recent changes in other packages. In particular, there was one place where grouping on a column of a data frame with NA entries was causing a warning to be emitted. Now, the grouping happens after splitting the data frame into rows wtih NA entries and those without. Grouping and sorting happens only for the rows without NA values.

- R
Published by MatthewHeun about 6 years ago

recca - v0.1.17

Recca 0.1.17 (2019-02-25)

First draft of completed vignette.
Removed ecclayout function. It was not being used, and there is a createsankey function, anyway.

- R
Published by MatthewHeun about 7 years ago

recca - v0.1.16

Recca 0.1.16 (2019-02-16)

Now automatically building in Travis.
Added new reverse() function to change flow direction of an ECC. reverse() will be useful for downstream swim functions.
Simplified and improved resource_industries() function.
- No longer summing columns of U matrix.
- Instead, cleaning 0 columns of U and comparing names of columns to the original U.
Eliminated all @importFrom statements by fully-qualifying all function calls.
Test coverage now up to 100%.

- R
Published by MatthewHeun about 7 years ago

recca - v0.1.15

Recca 0.1.15 (2019-01-09)

First draft of new-functions vignette now complete, including demonstrations of new_R_ps() and new_k_ps() functions.

- R
Published by MatthewHeun about 7 years ago

recca - v0.1.14

Recca 0.1.14 (2019-01-14)

New function make_sankey() does what it says: makes a Sankey diagram. make_sankey() is the first function that optionally uses the resource (R) matrix.
edge_list() also now accepts a resource (R) matrix on input.
The vigenette describing the new* functions now has a section on new_R_ps().

- R
Published by MatthewHeun about 7 years ago

recca - v0.1.13

Recca 0.1.13 (2018-12-21)

calc_F_footprint_effects() now cleans rows and columns (deletes rows and columns containing all 0s) before calculating row and column fractions.
calc_F_footprint_effects() now calculates row and column fractions using matsbyname::fractionize_byname(), providing a speed boost.

- R
Published by MatthewHeun about 7 years ago