{ "_id": "6ae5e8db8d250e7ad09f4259", "Package": "emburden", "Title": "Energy Burden Analysis Using Net Energy Return Methodology", "Version": "0.6.3", "Authors@R": "c(\nperson(\"Eric\", \"Scheier\", role = c(\"aut\", \"cph\"),\ncomment = c(ORCID = \"0000-0001-9849-9089\")),\nperson(\"The Emergi Foundation\", role = \"cre\",\nemail = \"info@emburden.org\"))", "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-10-01 12:37:29 UTC", "RemoteUrl": "https://github.com/ericscheier/emburden", "RemoteRef": "HEAD", "RemoteSha": "c0f1fae83e499a5424c811965cf01c7b93f1a710", "NeedsCompilation": "no", "Packaged": { "Date": "2026-10-31 12:03:59 UTC", "User": "root" }, "Author": "Eric Scheier [aut, cph] (ORCID:\n),\nThe Emergi Foundation [cre]", "Maintainer": "The Emergi Foundation ", "_user": "ericscheier", "_type": "src", "_file": "emburden_0.6.3.tar.gz", "_fileid": "https://r2.ropensci.org/41c52289eeaa1e2bddcebe73f15f2af1aaae2adcce8d01bb7d4c205795b256c5", "_filesize": 1779904, "_sha256": "41c52289eeaa1e2bddcebe73f15f2af1aaae2adcce8d01bb7d4c205795b256c5", "_expires": "2027-02-08T13:10:49.000Z", "_created": "2026-10-31T12:03:59.000Z", "_published": "2026-10-31T13:10:51.025Z", "_upstream": "https://github.com/ericscheier/emburden", "_status": "success", "_maintainer": { "name": "The Emergi Foundation", "email": "info@emburden.org" }, "_jobs": [ { "job": 124532250279, "time": 138, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "NOTE", "artifact": "13041703508" }, { "job": 124532250334, "time": 124, "config": "linux-release-x86_64", "r": "4.6.1", "check": "NOTE", "artifact": "13041509108" }, { "job": 124532250250, "time": 133, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "NOTE", "artifact": "13043367219" }, { "job": 124532250263, "time": 174, "config": "macos-release-arm64", "r": "4.6.2", "check": "NOTE", "artifact": "13043667128" }, { "job": 124531401276, "time": 236, "config": "source", "r": "4.6.1", "check": "OK", "artifact": "13041653567" }, { "job": 124532250385, "time": 119, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "13041763442" }, { "job": 124532250251, "time": 103, "config": "windows-devel-x86_64", "r": "4.7.0", "check": "NOTE", "artifact": "13041413474" }, { "job": 124532250270, "time": 95, "config": "windows-oldrel-x86_64", "r": "4.5.3", "check": "NOTE", "artifact": "13042361422" }, { "job": 124532250311, "time": 97, "config": "windows-release-x86_64", "r": "4.6.2", "check": "NOTE", "artifact": "13041444445" } ], "_buildurl": "https://github.com/r-universe/ericscheier/actions/runs/41199149448", "_commit": { "id": "c0f1fae83e499a5424c811965cf01c7b93f1a710", "author": "ericscheier ", "committer": "ericscheier ", "message": "docs: robots.txt — block indexing + scraping on emburden.org\n\nUser directive: 'make sure that emburden.org's robots.txt avoids\nindexing or scraping of any sorts.' Mirrors the robots.txt added\nto the staging site (ericscheier/emburden-site). Covers wildcard\nDisallow plus ~25 named deny entries for AI/LLM scrapers (GPTBot,\nChatGPT-User, Google-Extended, CCBot, ClaudeBot, anthropic-ai,\nPerplexityBot, Bytespider, AI2Bot, Amazonbot, Applebot-Extended,\nMeta-ExternalAgent, cohere-ai, Diffbot), archive bots\n(ia_archiver, archive.org_bot), and SEO crawlers (SemrushBot,\nAhrefsBot, DotBot, MJ12bot) that often ignore the wildcard.\n\nCaveat: GitHub Pages doesn't let us set HTTP X-Robots-Tag response\nheaders, so robots.txt is the only server-side lever. Compliant\ncrawlers honor it.\n", "time": 1790858249 }, "_distro": "resolute", "_host": "GitHub-Actions", "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 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-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 }, { "week": "2026-34", "n": 1 }, { "week": "2026-36", "n": 7 }, { "week": "2026-37", "n": 3 }, { "week": "2026-38", "n": 2 }, { "week": "2026-40", "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" }, { "name": "v0.6.3", "date": "2026-08-18" } ], "_stars": 3, "_contributors": [ { "user": "ericscheier", "count": 200, "uuid": 4824555 } ], "_userbio": { "uuid": 4824555, "type": "user", "name": "Eric Scheier", "followers": 23, "description": "Innovating to X" }, "_downloads": { "count": 305, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/emburden" }, "_devurl": "https://github.com/ericscheier/emburden", "_pkgdown": "https://ericscheier.info/emburden/", "_searchresults": 15, "_rbuild": "4.6.1", "_assets": [ "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/emburden.html", "extra/manual.pdf", "extra/readme.html", "extra/readme.md" ], "_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.975431808509263, "_indexed": true, "_nocasepkg": "emburden", "_universes": [ "ericscheier" ], "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "0.6.3", "date": "2026-10-31T12:06:19.000Z", "distro": "resolute", "commit": "c0f1fae83e499a5424c811965cf01c7b93f1a710", "fileid": "https://r2.ropensci.org/2f84dd8ca23bb0ee9d0bdc328de760461087d6a8e9b9ce8808610c8a3d9b52db", "status": "success", "check": "NOTE", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/41199149448" }, { "r": "4.6.1", "os": "linux", "version": "0.6.3", "date": "2026-10-31T12:06:06.000Z", "distro": "resolute", "commit": "c0f1fae83e499a5424c811965cf01c7b93f1a710", "fileid": "https://r2.ropensci.org/91adf50f948207ac02250ededdb19646d22de37ddc6530223ed92c9cfa55fdf5", "status": "success", "check": "NOTE", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/41199149448" }, { "r": "4.5.3", "os": "mac", "version": "0.6.3", "date": "2026-10-31T13:09:52.000Z", "commit": "c0f1fae83e499a5424c811965cf01c7b93f1a710", "fileid": "https://r2.ropensci.org/b6f8e9925c7c1e569ce48d04bce07ff9efe261ad119263bc6b5e5b8320a0e3e5", "status": "success", "check": "NOTE", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/41199149448" }, { "r": "4.6.2", "os": "mac", "version": "0.6.3", "date": "2026-10-31T13:07:45.000Z", "commit": "c0f1fae83e499a5424c811965cf01c7b93f1a710", "fileid": "https://r2.ropensci.org/63b8e19dd89cc5377891d550e664e7d0e5c1d99afddd17290bbceb97617306d2", "status": "success", "check": "NOTE", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/41199149448" }, { "r": "4.6.0", "os": "wasm", "version": "0.6.3", "date": "2026-10-31T12:06:20.000Z", "commit": "c0f1fae83e499a5424c811965cf01c7b93f1a710", "fileid": "https://r2.ropensci.org/1c61fa08c429861199020122f8db26efa2353dc86da264b0d4e356cf5363ecb2", "status": "success", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/41199149448" }, { "r": "4.7.0", "os": "win", "version": "0.6.3", "date": "2026-10-31T12:05:28.000Z", "commit": "c0f1fae83e499a5424c811965cf01c7b93f1a710", "fileid": "https://r2.ropensci.org/203d1ce485170992b0ba92137b05e5b0d437d78f95253e6168905fdf32bfb9dc", "status": "success", "check": "NOTE", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/41199149448" }, { "r": "4.5.3", "os": "win", "version": "0.6.3", "date": "2026-10-31T12:05:22.000Z", "commit": "c0f1fae83e499a5424c811965cf01c7b93f1a710", "fileid": "https://r2.ropensci.org/6f112218143bfa2e03d0aaa9e30f69be9335b577baecd2164fe1cc00eba39f05", "status": "success", "check": "NOTE", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/41199149448" }, { "r": "4.6.2", "os": "win", "version": "0.6.3", "date": "2026-10-31T12:05:27.000Z", "commit": "c0f1fae83e499a5424c811965cf01c7b93f1a710", "fileid": "https://r2.ropensci.org/d68c462298fe627abf825169bd0fdb58d3694089a764678fc13bfaa2423035c3", "status": "success", "check": "NOTE", "buildurl": "https://github.com/r-universe/ericscheier/actions/runs/41199149448" } ] }