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

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

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