[v3.11] Fervo_Project_Cape-5: Multi-Year Construction & Reservoir Engineering updates; SAM-EM Payback Period; SAM-EM ITC; User-Provided Reservoir Profile updates; SAM-EM MCY Levelized Metrics update

[softwareengineerprogrammer]

Description

1. Addresses Project Cape Construction Timelines & Reservoir Engineering Updates #443 by adding Fervo_Project_Cape-5 example and variants including 100 MW Fervo_Project_Cape-6
2. Addresses SAM-EM Multiple Construction Years: SAM SME Design Review #444: [v3.11.11] SAM-EM MCY Levelized Metrics Update softwareengineerprogrammer/GEOPHIRES#132
3. Addresses Remove or clarify SAM-EM project payback period #413 (softwareengineerprogrammer@8764602)
4. Addresses SAM Economic Models ITC should be derived from cash flow #404 (SAM-EM ITC output softwareengineerprogrammer/GEOPHIRES#124)
5. Addresses Support UPPReservoir Reservoir Output Profile parameter #453: [v3.11.8] User-Provided Reservoir Output File Fix, Reservoir Output Profile Parameter, and Redrilling Support softwareengineerprogrammer/GEOPHIRES#129

Links (PR Reviewers: Start by looking at these)

1. Fervo_Project_Cape-5 (500 MW/Phases I & II):
   1. Documentation: https://softwareengineerprogrammer.github.io/GEOPHIRES/Fervo_Project_Cape-5.html
   2. Web interface link: https://gtp.scientificwebservices.com/geophires/?geophires-example-id=Fervo_Project_Cape-5
2. Fervo_Project_Cape-6 (100 MW/Phase I)
   1. Documentation section: https://softwareengineerprogrammer.github.io/GEOPHIRES/Fervo_Project_Cape-5.html#Fervo_Project_Cape-6-section
   2. Web interface link: https://gtp.scientificwebservices.com/geophires/?geophires-example-id=Fervo_Project_Cape-6

Testing & Verification

1. Unit tests added:
   1. Fervo_Project_Cape-5 and Fervo_Project_Cape-6 standard example test coverage
   2. FervoProjectCape5TestCase
   3. FervoProjectCape5GraphsTestCase
   4. test_post_processed_levelized_metrics
   5. User-Provided Reservoir Profile tests + example5b
   6. test_produced_temperature_json_output
   7. test_number_of_injection_wells_per_production_well
2. Unit tests updated:
   1. example_SAM-single-owner-PPA*:
      1. Investment Tax Credit output added
      2. Project Payback Period fixed
      3. Trivial changes to SAM cash flow profiles due to minor rounding discrepancies associated with levelized metrics update
   2. Minor changes to example5.out due to reservoir output profile file reading fix
3. Manually tested/verified extensively during development
   1. 

TODO

1. 🚧 [Pending SME reviewer approval on this PR] Reservoir engineering SME review
   1. Explore recalibration to 2 redrillings instead of 3: f617dbf
      1. More stimulated fracture surface area: https://gtp.scientificwebservices.com/geophires/?shared-geophires-result-id=516cdea8-8fc0-4110-8a28-e5570269cd9f
      2. Custom reservoir profile based on Singh et al.
         1. Baseline <hotter>: https://gtp.scientificwebservices.com/geophires/?shared-geophires-result-id=0701efbf-85f5-40b7-8846-1ffc4f8cb51c (.txt)
         2. 15C Hotter + Deeper: https://gtp.scientificwebservices.com/geophires/?shared-geophires-result-id=8b1acf90-c54b-4435-ae83-d4d0eda4247e (.txt)
2. [Pending SME reviewer approval on this PR] Confirm levelized cost metrics per SAM-EM Multiple Construction Years: SAM SME Design Review #444: softwareengineerprogrammer@44b9bf1, [v3.11.11] SAM-EM MCY Levelized Metrics Update softwareengineerprogrammer/GEOPHIRES#132: [v3.11] Fervo_Project_Cape-5: Multi-Year Construction & Reservoir Engineering updates; SAM-EM Payback Period; SAM-EM ITC; User-Provided Reservoir Profile updates; SAM-EM MCY Levelized Metrics update #457 (review)
3. Finalize stimulation cost: Added 1.2 stim cost factor to sensitivity analysis: 2e902d8

Release (Change Checklist)

1. Remove preview designation (softwareengineerprogrammer@867e7c1) (TBD whether to do before or after merging, depending in part on SME review status)

Before merging

1. Sync CHANGELOG to PR/sub-PRs structure - consolidate changes into single 3.11 entry (Add a CHANGELOG entry): f285cf1

After merging

1. Push tag(s) to GitHub: git push origin refs/tags/vM.m.P
2. Post a change announcement to the GEOPHIRES Change Announcements Discussion (example). Markdown template:

M.m.p: [TITLE](https://github.com/NREL/GEOPHIRES-X/pull/457) | [release](https://github.com/NREL/GEOPHIRES-X/releases/tag/vM.m.P)

Lower Priority

1. Sensitivity analysis chart tweaks:
   1. Flow rate text overlap
   2. Link titles (on hover)
2. Add unit test ensuring schema JSON is parseable (re: 7c13a1f): 93a5edd

Done

1. Calibrate Fervo_Project_Cape-6: softwareengineerprogrammer@866b4c8, softwareengineerprogrammer@d7bcda0, 9d3dd02
   1. Strip (irrelevant) param comments: softwareengineerprogrammer@632e6b4
2. Add example5b to web interface:
3. Add a CHANGELOG entry for 3.11.4: 1ca1705
4. Document inflation rate assumption is higher than ATB (or use ATB value): fbf8d93
5. Add relevant reservoir design figures from https://www.resfrac.com/wp-content/uploads/2025/06/Singh-2025-Fervo-Project-Cape.pdf: FPC5 Documentation: Singh et al Well and Bench Design and Fracture Geometry sections softwareengineerprogrammer/GEOPHIRES#131
   1. 
   2. 
   3. 

---

Originally self-reviewed in softwareengineerprogrammer#117

[brtietz]

Approving based on review in #444

Would recommend another review for reservoir engineering components prior to merging.