{ "_id": "6a19791facfb0bcc41df4211", "Package": "emburden", "Title": "Energy Burden Analysis Using Net Energy Return Methodology", "Version": "0.6.2", "Authors@R": "person(\"Eric\", \"Scheier\", , \"eric@scheier.org\", role = c(\"aut\", \"cre\", \"cph\"))", "Description": "Calculate and analyze household energy burden using the\nNet Energy Return aggregation methodology. Functions support\nweighted statistical calculations across geographic and\ndemographic cohorts, with utilities for formatting results into\npublication-ready tables. Methods are based on Scheier &\nKittner (2022) .", "License": "AGPL (>= 3)", "Encoding": "UTF-8", "Language": "en-US", "Roxygen": "list(markdown = TRUE)", "RoxygenNote": "7.3.3", "VignetteBuilder": "knitr", "LazyData": "true", "URL": "https://github.com/ericscheier/emburden,\nhttps://ericscheier.info/emburden/", "BugReports": "https://github.com/ericscheier/emburden/issues", "Config/pak/sysreqs": "libicu-dev libssl-dev libx11-dev", "Repository": "https://ericscheier.r-universe.dev", "Date/Publication": "2026-05-29 06:19:47 UTC", "RemoteUrl": "https://github.com/ericscheier/emburden", "RemoteRef": "HEAD", "RemoteSha": "ee870475cccd09fab9b51c35f050536b6b240965", "NeedsCompilation": "no", "Packaged": { "Date": "2026-05-29 10:00:27 UTC", "User": "root" }, "Author": "Eric Scheier [aut, cre, cph]", "Maintainer": "Eric Scheier ", "MD5sum": "20fa70bda54c5aa94f30cf434e67eeed", "_user": "ericscheier", "_type": "src", "_file": "emburden_0.6.2.tar.gz", "_fileid": "90fb7ec5ebb0b030ed69d1b478c042601c33f702c7757f2ccd3b1d46b170309b", "_filesize": 1776417, "_sha256": "90fb7ec5ebb0b030ed69d1b478c042601c33f702c7757f2ccd3b1d46b170309b", "_created": "2026-05-29T10:00:27.000Z", "_published": "2026-05-29T11:31:43.076Z", "_distro": "noble", "_jobs": [ { "job": 78479411440, "time": 139, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "7288134860" }, { "job": 78479411430, "time": 158, "config": "linux-release-x86_64", "r": "4.6.0", "check": "OK", "artifact": "7288140428" }, { "job": 78479411444, "time": 150, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "OK", "artifact": "7289632065" }, { "job": 78479411561, "time": 159, "config": "macos-release-arm64", "r": "4.6.0", "check": "OK", "artifact": "7289633026" }, { "job": 78478843492, "time": 218, "config": "source", "r": "4.6.0", "check": "OK", "artifact": "7288093251" }, { "job": 78479411450, "time": 131, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "7288132446" }, { "job": 78479411495, "time": 100, "config": "windows-devel", "r": "4.7.0", "check": "OK", "artifact": "7288123546" }, { "job": 78479411521, "time": 87, "config": "windows-oldrel", "r": "4.5.3", "check": "OK", "artifact": "7288120047" }, { "job": 78479411467, "time": 94, "config": "windows-release", "r": "4.6.0", "check": "OK", "artifact": "7288121991" } ], "_buildurl": "https://github.com/r-universe/ericscheier/actions/runs/26630790160", "_status": "success", "_host": "GitHub-Actions", "_upstream": "https://github.com/ericscheier/emburden", "_commit": { "id": "ee870475cccd09fab9b51c35f050536b6b240965", "author": "Eric SS ", "committer": "Eric SS ", "message": "fix: zero-pad numeric FIPS to restore leading zero (CT regression)\n\nThe three remaining substr-based geoid-to-state-FIPS calls in\nR/cache_utils.R (x2) and R/lead_data_loaders.R were silently stripping\nthe leading zero from numeric geoids, misclassifying every CT row\n(state FIPS 09 -> \"90\"\\) and any other state-01-09 county passed\nnumerically (AL=01, AK=02, AZ=04, AR=05, CA=06, CO=08, CT=09).\n\nConcrete symptom: substr(as.character(9001), 1, 2) == \"90\" instead of\n\"09\". With CT geoids stored as integers in source CSVs, the\nstate-coverage diagnostic in cache_utils:102/206 silently dropped CT\nfrom the actuals_states tally, and the lead-loader filter at\nlead_data_loaders:222 silently filtered every CT row out of the result.\n\nThis commit:\n\n 1. Adds R/fips_utils.R with .pad_fips() (internal) — infers target\n width from longest input value (>5 chars = 11-digit tract, >2 chars =\n 5-digit county, else 2-digit state) and zero-pads numeric inputs\n back to that width.\n\n 2. Adds .extract_state_fips() and .extract_county_fips() (internal)\n thin wrappers, used by the patched call sites.\n\n 3. Replaces three substr(as.character(x), 1, N) patterns with the\n padded equivalents at:\n - R/cache_utils.R:102 (state-coverage diagnostic)\n - R/cache_utils.R:206 (sample-data check)\n - R/lead_data_loaders.R:222 (state filter)\n\n 4. Adds tests/testthat/test-fips-leading-zero.R: 26 assertions across\n 5 test groups including the exact \"90\" vs \"09\" symptom for\n cache_utils, all 7 state-01-09 cases, and NA / empty-vector edge\n cases. All pass on this commit (devtools::load_all + test_dir).\n\nPrefer internal helpers (dot-prefixed) for now to avoid widening the\npublic surface; if other packages want to consume these, they should\neither depend on emburdengeo which already exports the equivalent\nextract_*_fips + remap_ct_planning_region (patched in parallel on\n2026-05-29), or graduate these to exported in a follow-up.\n\nCo-Authored-By: Claude Opus 4.7 = 4.1.0", "role": "Depends" }, { "package": "dplyr", "role": "Imports" }, { "package": "httr", "role": "Imports" }, { "package": "rappdirs", "role": "Imports" }, { "package": "readr", "role": "Imports" }, { "package": "rlang", "role": "Imports" }, { "package": "scales", "role": "Imports" }, { "package": "spatstat.univar", "role": "Imports" }, { "package": "stats", "role": "Imports" }, { "package": "stringr", "role": "Imports" }, { "package": "tibble", "role": "Imports" }, { "package": "tidyr", "role": "Imports" }, { "package": "covr", "role": "Suggests" }, { "package": "DBI", "role": "Suggests" }, { "package": "httptest2", "role": "Suggests" }, { "package": "jsonlite", "role": "Suggests" }, { "package": "kableExtra", "role": "Suggests" }, { "package": "knitr", "role": "Suggests" }, { "package": "mockery", "role": "Suggests" }, { "package": "rmarkdown", "role": "Suggests" }, { "package": "RSQLite", "role": "Suggests" }, { "package": "rticles", "role": "Suggests" }, { "package": "testthat", "version": ">= 3.0.0", "role": "Suggests" }, { "package": "tinytex", "role": "Suggests" }, { "package": "withr", "role": "Suggests" } ], "_owner": "ericscheier", "_selfowned": true, "_usedby": 0, "_updates": [ { "week": "2025-40", "n": 1 }, { "week": "2025-43", "n": 3 }, { "week": "2025-44", "n": 7 }, { "week": "2025-45", "n": 21 }, { "week": "2025-46", "n": 16 }, { "week": "2025-47", "n": 59 }, { "week": "2025-48", "n": 5 }, { "week": "2025-50", "n": 1 }, { "week": "2025-51", "n": 1 }, { "week": "2026-21", "n": 1 }, { "week": "2026-22", "n": 1 } ], "_tags": [ { "name": "v0.1.0", "date": "2025-11-07" }, { "name": "v0.1.1", "date": "2025-11-07" }, { "name": "v0.2.0", "date": "2025-11-12" }, { "name": "v0.3.0", "date": "2025-11-12" }, { "name": "v0.4.6", "date": "2025-11-13" }, { "name": "v0.4.7", "date": "2025-11-13" }, { "name": "v0.4.9", "date": "2025-11-14" }, { "name": "v0.5.0", "date": "2025-11-14" }, { "name": "v0.5.1", "date": "2025-11-15" }, { "name": "v0.5.2", "date": "2025-11-17" }, { "name": "v0.5.3", "date": "2025-11-20" }, { "name": "v0.5.4", "date": "2025-11-20" }, { "name": "v0.5.5", "date": "2025-11-20" }, { "name": "v0.5.6", "date": "2025-11-20" }, { "name": "v0.5.7", "date": "2025-11-20" }, { "name": "v0.5.8", "date": "2025-11-20" }, { "name": "v0.5.10", "date": "2025-11-21" }, { "name": "v0.5.13", "date": "2025-11-21" }, { "name": "v0.5.14", "date": "2025-11-21" }, { "name": "v0.5.15", "date": "2025-11-21" }, { "name": "v0.5.9", "date": "2025-11-21" }, { "name": "auto-merge/v0.5.18", "date": "2025-11-22" }, { "name": "v0.5.16", "date": "2025-11-22" }, { "name": "v0.5.17", "date": "2025-11-22" }, { "name": "v0.5.18", "date": "2025-11-22" }, { "name": "v0.5.19", "date": "2025-11-22" }, { "name": "v0.5.20", "date": "2025-11-22" }, { "name": "v0.6.0", "date": "2025-12-15" }, { "name": "v0.6.1", "date": "2025-12-20" }, { "name": "v0.6.2", "date": "2026-05-18" } ], "_stars": 3, "_contributors": [ { "user": "ericscheier", "count": 188, "uuid": 4824555 } ], "_userbio": { "uuid": 4824555, "type": "user", "name": "Eric Scheier", "description": "Innovating to X" }, "_downloads": { "count": 553, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/emburden" }, "_devurl": "https://github.com/ericscheier/emburden", "_pkgdown": "https://ericscheier.info/emburden/", "_searchresults": 16, "_rbuild": "4.6.0", "_assets": [ "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/emburden.html", "extra/readme.html", "extra/readme.md", "manual.pdf" ], "_homeurl": "https://github.com/ericscheier/emburden", "_realowner": "ericscheier", "_cranurl": true, "_releases": [ { "version": "0.6.1", "date": "2026-01-07" }, { "version": "0.6.2", "date": "2026-05-18" } ], "_exports": [ "%>%", "calculate_weighted_metrics", "check_data_sources", "clear_all_cache", "clear_dataset_cache", "colorize", "compare_energy_burden", "dear_func", "energy_burden_func", "eroi_func", "get_dataset_info", "get_income_brackets", "lead_to_poverty", "list_cohort_columns", "list_income_brackets", "list_states", "load_census_tract_data", "load_cohort_data", "neb_func", "ner_func", "process_lead_cohort_data", "raw_to_lead", "to_big", "to_billion_dollar", "to_dollar", "to_million", "to_percent" ], "_datasets": [ { "name": "nc_sample", "title": "North Carolina Complete Energy Burden Sample Data", "object": "nc_sample", "class": [ "list" ], "fields": [], "table": true, "tojson": true }, { "name": "orange_county_sample", "title": "Orange County NC Energy Burden Sample Data", "object": "orange_county_sample", "class": [ "list" ], "fields": [], "table": false, "tojson": true } ], "_help": [ { "page": "calculate_weighted_metrics", "title": "Calculate Weighted Metrics for Energy Burden Analysis", "topics": [ "calculate_weighted_metrics" ] }, { "page": "check_data_sources", "title": "Check Available Data Sources", "topics": [ "check_data_sources" ] }, { "page": "clear_all_cache", "title": "Clear all emburden cache and database", "topics": [ "clear_all_cache" ] }, { "page": "clear_dataset_cache", "title": "Clear cache for a specific dataset", "topics": [ "clear_dataset_cache" ] }, { "page": "colorize", "title": "Colorize Text for Knitted Documents", "topics": [ "colorize" ] }, { "page": "compare_energy_burden", "title": "Compare Energy Burden Between Years", "topics": [ "compare_energy_burden" ] }, { "page": "dear_func", "title": "Calculate Disposable Energy-Adjusted Resources (DEAR)", "topics": [ "dear_func" ] }, { "page": "energy_burden_func", "title": "Calculate Energy Burden", "topics": [ "energy_burden_func" ] }, { "page": "eroi_func", "title": "Calculate Energy Return on Investment (EROI)", "topics": [ "eroi_func" ] }, { "page": "get_dataset_info", "title": "Get Dataset Information", "topics": [ "get_dataset_info" ] }, { "page": "get_income_brackets", "title": "Get Available Income Brackets for a Dataset and Vintage", "topics": [ "get_income_brackets" ] }, { "page": "list_cohort_columns", "title": "List Available Columns in Cohort Data", "topics": [ "list_cohort_columns" ] }, { "page": "list_income_brackets", "title": "List Available Income Brackets", "topics": [ "list_income_brackets" ] }, { "page": "list_states", "title": "List Available States", "topics": [ "list_states" ] }, { "page": "load_census_tract_data", "title": "Load Census Tract Data", "topics": [ "load_census_tract_data" ] }, { "page": "load_cohort_data", "title": "Load DOE LEAD Tool Cohort Data", "topics": [ "load_cohort_data" ] }, { "page": "nc_sample", "title": "North Carolina Complete Energy Burden Sample Data", "topics": [ "nc_sample" ] }, { "page": "neb_func", "title": "Calculate Net Energy Burden (NEB)", "topics": [ "neb_func" ] }, { "page": "ner_func", "title": "Calculate Net Energy Return (Nh)", "topics": [ "ner_func" ] }, { "page": "orange_county_sample", "title": "Orange County NC Energy Burden Sample Data", "topics": [ "orange_county_sample" ] }, { "page": "print.energy_burden_comparison", "title": "Print Comparison Summary", "topics": [ "print.energy_burden_comparison" ] }, { "page": "to_big", "title": "Format Large Numbers with Thousand Separators", "topics": [ "to_big" ] }, { "page": "to_billion_dollar", "title": "Format Dollar Amounts in Billions", "topics": [ "to_billion_dollar" ] }, { "page": "to_dollar", "title": "Format Number as Dollar Amount", "topics": [ "to_dollar" ] }, { "page": "to_million", "title": "Format Numbers in Millions", "topics": [ "to_million" ] }, { "page": "to_percent", "title": "Format Number as Percentage", "topics": [ "to_percent" ] } ], "_readme": "https://github.com/ericscheier/emburden/raw/HEAD/README.md", "_rundeps": [ "askpass", "bit", "bit64", "cli", "clipr", "cpp11", "crayon", "curl", "dplyr", "farver", "generics", "glue", "hms", "httr", "jsonlite", "labeling", "lifecycle", "magrittr", "mime", "openssl", "pillar", "pkgconfig", "prettyunits", "progress", "purrr", "R6", "rappdirs", "RColorBrewer", "readr", "rlang", "scales", "spatstat.univar", "spatstat.utils", "stringi", "stringr", "sys", "tibble", "tidyr", "tidyselect", "tzdb", "utf8", "vctrs", "viridisLite", "vroom", "withr" ], "_vignettes": [ { "source": "jss-emburden.Rmd", "filename": "jss-emburden.html", "title": "emburden: Temporal Analysis of Household Energy Burden Using Net Energy Return Metrics", "author": "Eric Scheier", "engine": "knitr::rmarkdown", "headings": [ "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" ], "created": "2025-11-10 23:37:04", "modified": "2025-12-15 14:42:12", "commits": 6 }, { "source": "getting-started.Rmd", "filename": "getting-started.html", "title": "Getting Started with emburden", "engine": "knitr::rmarkdown", "headings": [ "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" ], "created": "2025-11-06 00:36:05", "modified": "2026-05-18 19:47:21", "commits": 6 }, { "source": "methodology.Rmd", "filename": "methodology.html", "title": "Net Energy Return Methodology", "engine": "knitr::rmarkdown", "headings": [ "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" ], "created": "2025-11-06 00:36:05", "modified": "2025-11-06 00:36:05", "commits": 1 } ], "_score": 5.8987251815894925, "_indexed": true, "_nocasepkg": "emburden", "_universes": [ "ericscheier" ], "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "0.6.2", "date": "2026-05-29T10:02:43.000Z", "distro": "noble", "commit": "ee870475cccd09fab9b51c35f050536b6b240965", "fileid": "fdc2d91a8b3961ccbcb1a14622efc6065f5421800f785bd5ee8cdde2ef3ae427", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/26630790160" }, { "r": "4.6.0", "os": "linux", "version": "0.6.2", "date": "2026-05-29T10:03:05.000Z", "distro": "noble", "commit": "ee870475cccd09fab9b51c35f050536b6b240965", "fileid": "03f1d1f8bd038f0b1842afdfcbccb230fc4f2fb7172f924f879fc37fa392fb26", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/26630790160" }, { "r": "4.5.3", "os": "mac", "version": "0.6.2", "date": "2026-05-29T11:30:31.000Z", "commit": "ee870475cccd09fab9b51c35f050536b6b240965", "fileid": "fca9fc30d5591541d4234742ad133e115cc05798867b65b241c7c4c7fa1777e2", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/26630790160" }, { "r": "4.6.0", "os": "mac", "version": "0.6.2", "date": "2026-05-29T11:30:19.000Z", "commit": "ee870475cccd09fab9b51c35f050536b6b240965", "fileid": "7b2ad528903c2c87674b1919513ca1cdc0d63612ffe8247923c33ec2d9d6bb18", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/26630790160" }, { "r": "4.6.0", "os": "wasm", "version": "0.6.2", "date": "2026-05-29T10:03:03.000Z", "commit": "ee870475cccd09fab9b51c35f050536b6b240965", "fileid": "2366e2a03bdf47d2cf028fcb94eb57e6eef472d852a2388e8384969d2eac46ae", "status": "success", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/26630790160" }, { "r": "4.7.0", "os": "win", "version": "0.6.2", "date": "2026-05-29T10:01:58.000Z", "commit": "ee870475cccd09fab9b51c35f050536b6b240965", "fileid": "612317593f54ea5c99bc8993e1619f15425662e69f7c8013e13de91d98d10c8a", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/26630790160" }, { "r": "4.5.3", "os": "win", "version": "0.6.2", "date": "2026-05-29T10:01:48.000Z", "commit": "ee870475cccd09fab9b51c35f050536b6b240965", "fileid": "528b0f8b9f909e687ef27744856c625c7d0f9e68188c7dd0ad8f0f3e19fb82ad", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/26630790160" }, { "r": "4.6.0", "os": "win", "version": "0.6.2", "date": "2026-05-29T10:01:54.000Z", "commit": "ee870475cccd09fab9b51c35f050536b6b240965", "fileid": "b5b431f99d1def0f401122dfd700dc3ffe9145579c8719d129c8fe60d48a235c", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/26630790160" } ] }