Package: emburden 0.6.2

emburden: Energy Burden Analysis Using Net Energy Return Methodology

Calculate and analyze household energy burden using the Net Energy Return aggregation methodology. Functions support weighted statistical calculations across geographic and demographic cohorts, with utilities for formatting results into publication-ready tables. Methods are based on Scheier & Kittner (2022) <doi:10.1038/s41467-021-27673-y>.

Authors:Eric Scheier [aut, cre, cph]

emburden_0.6.2.tar.gz
emburden_0.6.2.zip(r-4.7)emburden_0.6.2.zip(r-4.6)emburden_0.6.2.zip(r-4.5)
emburden_0.6.2.tgz(r-4.6-any)emburden_0.6.2.tgz(r-4.5-any)
emburden_0.6.2.tar.gz(r-4.7-any)emburden_0.6.2.tar.gz(r-4.6-any)
emburden_0.6.2.tgz(r-4.6-emscripten)
manual.pdf |manual.html
DESCRIPTION
card.svg |card.png
emburden/json (API)

# Install 'emburden' in R:
install.packages('emburden', repos = c('https://ericscheier.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/ericscheier/emburden/issues

Pkgdown/docs site:https://ericscheier.info

Datasets:

On CRAN:

Conda:

5.90 score 3 stars 16 scripts 553 downloads 27 exports 45 dependencies

Last updated from:ee870475cc. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-x86_64OK139
source / vignettesOK218
linux-release-x86_64OK158
macos-release-arm64OK159
macos-oldrel-arm64OK150
windows-develOK100
windows-releaseOK94
windows-oldrelOK87
wasm-releaseOK131

Exports:%>%calculate_weighted_metricscheck_data_sourcesclear_all_cacheclear_dataset_cachecolorizecompare_energy_burdendear_funcenergy_burden_funceroi_funcget_dataset_infoget_income_bracketslead_to_povertylist_cohort_columnslist_income_bracketslist_statesload_census_tract_dataload_cohort_dataneb_funcner_funcprocess_lead_cohort_dataraw_to_leadto_bigto_billion_dollarto_dollarto_millionto_percent

Dependencies:askpassbitbit64clicliprcpp11crayoncurldplyrfarvergenericsgluehmshttrjsonlitelabelinglifecyclemagrittrmimeopensslpillarpkgconfigprettyunitsprogresspurrrR6rappdirsRColorBrewerreadrrlangscalesspatstat.univarspatstat.utilsstringistringrsystibbletidyrtidyselecttzdbutf8vctrsviridisLitevroomwithr

Getting Started with emburden
Introduction | Installation | What is Energy Burden? | Quick Example: Single Household | Loading Data | Calculating Metrics from Cohort Data | Aggregating Energy Burden (Critical!) | The WRONG Way | The CORRECT Way: Via Net Energy Return | Analysis by Income Bracket | Identifying High Energy Burden Households | Using calculate_weighted_metrics() | Key Takeaways | Temporal Comparison | Analyzing Energy Burden by Housing Characteristics | Example: Comparing Renters vs Owners by Heating Fuel | Example: Energy Burden by Building Age and Type | Key Insights from Housing Analysis | Next Steps | References

Last update: 2026-05-18
Started: 2025-11-06

emburden: Temporal Analysis of Household Energy Burden Using Net Energy Return Metrics
Abstract | Introduction | Mathematical foundations | Comparison with energy burden | Energy poverty threshold | The LEAD Tool and temporal analysis | Package design philosophy | Methodology | Data sources | LEAD Tool | REPLICA dataset | Schema normalization across vintages | Data processing | Energy burden indicator calculation | Weighted aggregation | Data quality considerations | Package architecture | Core functions | Data loading functions | Analysis examples | Temporal comparison workflow | Understanding the output | Example 1: State-level temporal analysis | Example 2: Income bracket analysis | Example 3: Multi-state comparison | Example 4: Housing tenure analysis | Example 5: Federal Poverty Line analysis | Example 6: Census tract-level analysis | Discussion | Policy implications | Split-incentive and principal-agent problems | Data limitations and considerations | Iterative proportional fitting constraints | Income measurement challenges | Energy expenditure estimation | Future research directions | Additional vintages | Additional metrics | Spatial analysis enhancements | Causal analysis tools | Comparison with existing tools | Conclusion | References

Last update: 2025-12-15
Started: 2025-11-10

Net Energy Return Methodology
Introduction | The Problem: Aggregating Ratios | Why Arithmetic Mean Fails | The Correct Approach: Harmonic Mean | The Solution: Net Energy Return (Nh) | Mathematical Relationship | Aggregation via Arithmetic Mean | Why This Works: The Mathematics | Computational Advantages (For Aggregation) | Numerical Stability | Error from Incorrect Aggregation | Practical Workflow | Summary | Key Principles | The Correct Formula | Common Mistakes to Avoid | References | Mathematical Appendix | Identity Proofs

Last update: 2025-11-06
Started: 2025-11-06