MUNI-LCC
Status: Released v0.1.1 (30 October 2026). DOI: 10.5281/zenodo.23362541.
MUNI-LCC is a free, open toolkit that helps a city, town, village, or school district answer three questions about an energy project: were the intended energy savings achieved, was it a sound investment over its life cycle, and what does the federal performance report need to say about it. This toolkit implements IPMVP Options A and C as defined in the DOE FEMP M&V Guidelines v5.0 (which are based on IPMVP Core Concepts 2022), computes life-cycle cost consistent with ASTM E917, applies these methods the same way every time, shows its work, and produces performance report content aligned with 2 CFR 200.329.
Why
Federal and state programs fund energy upgrades in small and mid-sized municipalities, and the Uniform Guidance requires recipients to report accomplishments against objectives and to explain shortfalls and cost overruns. Large agencies verify savings with consultants and proprietary software. Small municipalities usually report engineering estimates instead. MUNI-LCC makes standardized verification and life-cycle costing available without license fees or specialist software, ensuring that reported outcomes are based on metered evidence.
What it does
| Module | Method | Output |
|---|---|---|
lcc |
ASTM E917 life-cycle cost, NIST Handbook 135 factors (SPV, UPV, modified UPV with escalation or price indices) | LCC by cost category; net savings, SIR, AIRR, simple and discounted payback |
mv_option_a |
IPMVP Option A as defined in FEMP M&V Guidelines v5.0: key parameter measurement with documented stipulation | Savings with measurement uncertainty; measured versus stipulated parameters recorded |
mv_option_c |
IPMVP Option C as defined in FEMP M&V Guidelines v5.0: whole-meter change-point regression (mean, 2P, 3PC, 3PH, 4P, 5P) | Avoided energy use; CV(RMSE), NMBE, R-squared, slope t-statistics; fractional savings uncertainty; acceptance checks using FEMP v5.0 values where stated |
report |
2 CFR 200.329(c)(1), (c)(2), (e), as amended April 2024 | Due date; accomplishments versus objectives; reasons for shortfalls; cost and unit-cost analysis; significant developments; completeness check |
Life-cycle costs can be computed from verified quantities, so the cost-effectiveness reported to a funder rests on measured savings rather than projected ones.
Install and run
Requires Python 3.9 or later.
To use the toolkit:
pip install muni-lcc
muni-lcc --help
To run the tests and the worked example from source:
git clone https://github.com/Olumide-Akindipe/muni-lcc.git
cd muni-lcc
pip install -e ".[test,examples]"
python -m pytest # 37 tests should pass
muni-lcc run examples/project.json --out outputs
muni-lcc due-date 2026-06-30 annual # prints 2026-09-28
muni-lcc run writes results.json, performance_report.md, and performance_report.json. Inputs are described in docs/INPUTS.md.
Worked example (synthetic data)
examples/ contains a hypothetical Town Hall with synthetic monthly gas bills and lighting readings, generated with a fixed seed so the true answer is known in advance. The toolkit is checked against that answer.
- Option C selected a 3PH baseline model on 24 months: CV(RMSE) 7.9 percent, R-squared 0.988, slope t-statistic 42.3. It meets every acceptance criterion, including the FEMP v5.0 values for R-squared, bias, and t-statistic.
- Verified avoided gas use: 6,879 therms (15.1 percent), with fractional savings uncertainty of 34.2 percent at 90 percent confidence. The true injected savings were 6,629 therms (15.0 percent), inside the uncertainty band.
- Option A lighting savings: 28,392 kWh per year, matching the true value of 28,392 kWh.
- Life-cycle cost over 25 years at a 3.0 percent real discount rate: net savings $151,675, SIR 2.27, AIRR 6.4 percent, discounted payback 9.0 years.
Sample output: examples/outputs/performance_report.md. Every number above is read from examples/outputs/stats.json.
Method sources
- U.S. Department of Energy, Federal Energy Management Program. M&V Guidelines: Measurement and Verification for Performance-Based Contracts, Version 5.0. Prepared by Pacific Northwest National Laboratory. September 2024. https://www.energy.gov/sites/default/files/2024-10/mv_guide_5_0.pdf
- Efficiency Valuation Organization. International Performance Measurement and Verification Protocol: Core Concepts 2022. EVO 10000-1:2022. The IPMVP edition on which FEMP v5.0 is based. Options A and C are implemented as defined in FEMP v5.0.
- ASTM International. ASTM E917-17(2023), Standard Practice for Measuring Life-Cycle Costs of Buildings and Building Systems. Implemented from the equivalent public formulation in NIST Handbook 135.
- Fuller, S. K., and Petersen, S. R. Life-Cycle Costing Manual for the Federal Energy Management Program, NIST Handbook 135. 1996.
- National Institute of Standards and Technology. Energy Price Indices and Discount Factors for Life-Cycle Cost Analysis, 2025. NIST IR 85-3273-40. August 2025.
- 2 CFR 200.329, Monitoring and reporting program performance, as amended at 89 FR 30136 (April 22, 2024). https://www.ecfr.gov/current/title-2/section-200.329
- ASHRAE. Guideline 14-2023, Measurement of Energy, Demand, and Water Savings. The edition FEMP v5.0 cites. Model statistics and the fractional savings uncertainty approximation.
- Efficiency Valuation Organization. Uncertainty Assessment for IPMVP. EVO 10100-1:2018. The uncertainty guidance FEMP v5.0 cites; see METHODS.md for how MUNI-LCC's uncertainty method relates to it.
Details, equations, and conventions: docs/METHODS.md. What the toolkit cannot do: docs/LIMITATIONS.md.
Scope note
MUNI-LCC produces verified content for a performance report. It does not replace the OMB-approved form an awarding agency prescribes, an M&V plan agreed with the funder, or professional engineering judgment. Its acceptance thresholds are configurable guidance values; the project's M&V plan governs.
Citation
Akindipe, S. O. (2026). MUNI-LCC: open life-cycle cost and measurement-and-verification toolkit for municipal energy projects (Version 0.1.1) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.23362541
See CITATION.cff.
License and maintainer
Code: MIT (LICENSE). Documentation: CC BY 4.0. Maintainer: Stephen Olumide Akindipe, Independent Researcher, Albany, NY, USA. ORCID 0000-0002-1846-9662. Contributions welcome: CONTRIBUTING.md. Support: SUPPORT.md. Governance: GOVERNANCE.md. Changes: CHANGELOG.md.
Metadata
Release files for muni-lcc 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| muni_lcc-0.1.1.tar.gz | 27.5 kB | With provenance | Details for muni_lcc-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| muni_lcc-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for muni_lcc-0.1.1-py3-none-any.whl |
Total release size: 50.7 kB
Release files / muni_lcc-0.1.1.tar.gz
| Download URL | muni_lcc-0.1.1.tar.gz |
|---|---|
| Size | 27.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b9be810f10a4cb5c9b5b90e58a590fe7baf69f533a76cbaf61c0925992758120
|
|
BLAKE2b-256 checksum How to use checksums |
00e38a876479403448dce02914094b2003bad2cf3f3c4c32dfb3fd4f6111de6f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.
Transparency logRelease files / muni_lcc-0.1.1-py3-none-any.whl
| Download URL | muni_lcc-0.1.1-py3-none-any.whl |
|---|---|
| Size | 23.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bb6d0d51b9dfa691b5acf7030965f42763ce87ec4a3860a7fdf73bdbefddd42c
|
|
BLAKE2b-256 checksum How to use checksums |
7748137d35ffec25477d17ce211ca945039688f0c14fdea8a35131b17d4daf9d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.
Transparency logSecurity for muni-lcc 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for muni_lcc-0.1.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.