[v3.11.11] SAM-EM MCY Levelized Metrics Update

.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 3.11.8
+current_version = 3.11.11
 commit = True
 tag = True
 

.cookiecutterrc

@@ -54,7 +54,7 @@ default_context:
     sphinx_doctest: "no"
     sphinx_theme: "sphinx-py3doc-enhanced-theme"
     test_matrix_separate_coverage: "no"
-    version: 3.11.8
+    version: 3.11.11
     version_manager: "bump2version"
     website: "https://github.com/NREL"
     year_from: "2023"

README.rst

@@ -58,9 +58,9 @@ Free software: `MIT license <LICENSE>`__
     :alt: Supported implementations
     :target: https://pypi.org/project/geophires-x
 
-.. |commits-since| image:: https://img.shields.io/github/commits-since/softwareengineerprogrammer/GEOPHIRES-X/v3.11.8.svg
+.. |commits-since| image:: https://img.shields.io/github/commits-since/softwareengineerprogrammer/GEOPHIRES-X/v3.11.11.svg
     :alt: Commits since latest release
-    :target: https://github.com/softwareengineerprogrammer/GEOPHIRES-X/compare/v3.11.8...main
+    :target: https://github.com/softwareengineerprogrammer/GEOPHIRES-X/compare/v3.11.11...main
 
 .. |docs| image:: https://readthedocs.org/projects/GEOPHIRES-X/badge/?style=flat
     :target: https://softwareengineerprogrammer.github.io/GEOPHIRES

docs/SAM-EM_Multiple-Construction-Years.md

@@ -17,6 +17,8 @@ drawdowns (funding early years purely with equity) and adjust `Inflation Rate Du
 
 ## Construction Cash Flows
 
+Multiple Construction Years example cash flow CSV: [example_SAM-single-owner-PPA-5.csv](https://github.com/softwareengineerprogrammer/GEOPHIRES/blob/main/tests/examples/example_SAM-single-owner-PPA-5.csv)
+
 The `CONSTRUCTION` cash flow category displays detailed financial movements during the pre-operational phase.
 Construction-specific line items are suffixed with `[construction]`.
 Construction years are indexed relative to the first year of operations (Year 1).
@@ -58,7 +60,9 @@ ratio that is passed to SAM (`debt_percent`).
 ## Post-Processing (Timeline-adjusted Metrics)
 
 After SAM computes the operational cash flows, GEOPHIRES merges the construction phase and
-operational phase net cash flows together to report accurate project-level metrics including IRR and NPV.
+operational phase net cash flows together to report accurate project-level metrics.
+
+### IRR and NPV
 The merged `After-tax net cash flow ($)` row represents the complete project lifecycle:
 
 - Years -N to 0: Contains `After-tax net cash flow [construction] ($)` (equity outflows).
@@ -72,6 +76,13 @@ stream to account for the time value of money during the construction delay.
 The corresponding result case report metrics (`After-tax IRR` and `Project NPV`) reflect this adjustment,
 as do other relevant case report metrics including `Project VIR=PI=PIR` and `Project MOIC`.
 
+### After-tax LCOE and PPA Price
+
+Line items in the `AFTER-TAX LCOE AND PPA PRICE` category are post-processed to yield timeline-adjusted LCOE and LPPA.
+
+![](_images/sam-em-mcy-after-tax-lcoe-and-ppa-price-cash-flow-screenshot.png)
+
+The result case report LCOE metric (`Electricity breakeven price`) reflects the post-processed `LCOE Levelized cost of energy nominal (cents/kWh)` value.
 
 ---