softwareengineerprogrammer · softwareengineerprogrammer · May 30, 2025 · May 15, 2025 · May 15, 2025 · May 15, 2025
diff --git a/.bumpversion.cfg b/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 3.9.8
+current_version = 3.9.13
 commit = True
 tag = True
 

diff --git a/.cookiecutterrc b/.cookiecutterrc
@@ -54,7 +54,7 @@ default_context:
     sphinx_doctest: "no"
     sphinx_theme: "sphinx-py3doc-enhanced-theme"
     test_matrix_separate_coverage: "no"
-    version: 3.9.8
+    version: 3.9.13
     version_manager: "bump2version"
     website: "https://github.com/NREL"
     year_from: "2023"

diff --git a/README.rst b/README.rst
@@ -56,9 +56,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.9.8.svg
+.. |commits-since| image:: https://img.shields.io/github/commits-since/softwareengineerprogrammer/GEOPHIRES-X/v3.9.13.svg
     :alt: Commits since latest release
-    :target: https://github.com/softwareengineerprogrammer/GEOPHIRES-X/compare/v3.9.8...main
+    :target: https://github.com/softwareengineerprogrammer/GEOPHIRES-X/compare/v3.9.13...main
 
 .. |docs| image:: https://readthedocs.org/projects/GEOPHIRES-X/badge/?style=flat
     :target: https://nrel.github.io/GEOPHIRES-X
@@ -293,7 +293,7 @@ electricity: (1) fixed charge rate (FCR) model;
 (2) standard discounting levelized cost model;
 (3) BICYCLE model;
 (4) CLGS;
-(5) SAM Single-owner PPA.
+(5) `SAM Single-owner PPA <https://nrel.github.io/GEOPHIRES-X/SAM-Economic-Models.html>`__.
 
 .. TODO link to SAM Economic Model docs
 
@@ -462,10 +462,14 @@ Example-specific web interface deeplinks are listed in the Link column.
      - `example_SHR-2.txt <tests/examples/example_SHR-2.txt>`__
      - `.out <tests/examples/example_SHR-2.out>`__
      - `link <https://gtp.scientificwebservices.com/geophires?geophires-example-id=example_SHR-2>`__
-   * - SAM Single Owner PPA
+   * - SAM Single Owner PPA: 50 MWe
      - `example_SAM-single-owner-PPA.txt <tests/examples/example_SAM-single-owner-PPA.txt>`__
      - `.out <tests/examples/example_SAM-single-owner-PPA.out>`__
      - `link <https://gtp.scientificwebservices.com/geophires?geophires-example-id=example_SAM-single-owner-PPA>`__
+   * - SAM Single Owner PPA: 400 MWe BICYCLE Comparison
+     - `example_SAM-single-owner-PPA-2.txt <tests/examples/example_SAM-single-owner-PPA-2.txt>`__
+     - `.out <tests/examples/example_SAM-single-owner-PPA-2.out>`__
+     - `link <https://gtp.scientificwebservices.com/geophires?geophires-example-id=example_SAM-single-owner-PPA-2>`__
 
 .. raw:: html
 

diff --git a/docs/Fervo_Project_Cape-4.md b/docs/Fervo_Project_Cape-4.md
diff --git a/docs/GEOPHIRES-Examples.md b/docs/GEOPHIRES-Examples.md
@@ -0,0 +1,10 @@
+# GEOPHIRES Examples
+
+## Examples List
+
+View the list of all GEOPHIRES examples in the [README](https://github.com/NREL/GEOPHIRES-X?tab=readme-ov-file#examples)
+or in the [web interface](https://gtp.scientificwebservices.com/geophires) under the Examples tab.
+
+## Case Study: 500 MWe EGS Project Modeled on Fervo Cape Station
+
+See [Case Study: 500 MWe EGS Project Modeled on Fervo Cape Station](Fervo_Project_Cape-4.html).
diff --git a/docs/SAM-Economic-Models.md b/docs/SAM-Economic-Models.md
@@ -20,7 +20,7 @@ The following table describes how GEOPHIRES parameters are transformed into SAM
 | `Maximum Total Electricity Generation`                                                                                                          | Generation Profile                                     | `Nameplate capacity`                                                                                         | `Singleowner`                     | `system_capacity`                                            | .. N/A                                                                                                                                                                                                                                                                                                                    |
 | `Utilization Factor`                                                                                                                            | Generation Profile                                     | `Nominal capacity factor`                                                                                    | `Singleowner`                     | `user_capacity_factor`                                       | .. N/A                                                                                                                                                                                                                                                                                                                    |
 | `Net Electricity Generation`                                                                                                                    | AC Degradation                                         | `Annual AC degradation rate` schedule                                                                        | `Utilityrate5`                    | `degradation`                                                | Percentage difference of each year's `Net Electricity Generation` from `Maximum Total Electricity Generation` is input as SAM as the degradation rate schedule in order to match SAM's generation profile to GEOPHIRES                                                                                                    |
-| `Total Capital Cost` + `Investment Tax Credit Value` + (`Inflation Rate During Construction` × `Total Capital Cost`)                            | Installation Costs                                     | `Total Installed Cost`                                                                                       | `Singleowner`                     | `total_installed_cost`                                       | ITC, if present, is added to GEOPHIRES total capital cost since SAM handles ITC credits in cash flow analysis. Inflation during construction is treated as an indirect EPC capital cost percentage.                                                                                                                       |
+| `Total CAPEX` × (1 + `Inflation Rate During Construction`)                                                                                      | Installation Costs                                     | `Total Installed Cost`                                                                                       | `Singleowner`                     | `total_installed_cost`                                       | Inflation during construction is treated as an indirect EPC capital cost percentage. Note that unlike the BICYCLE Economic Model's `Total capital costs`, SAM Economic Model's `Total CAPEX` is the total installed cost and does not subtract ITC value (if present).                                                    |
 | `Total O&M Cost`, `Inflation Rate`                                                                                                              | Operating Costs                                        | `Fixed operating cost`, `Escalation rate` set to `Inflation Rate` × -1                                       | `Singleowner`                     | `om_fixed`, `om_fixed_escal`                                 | .. N/A                                                                                                                                                                                                                                                                                                                    |
 | `Plant Lifetime`                                                                                                                                | Financial Parameters → Analysis Parameters             | `Analysis period`                                                                                            | `CustomGeneration`, `Singleowner` | `CustomGeneration.analysis_period`, `Singleowner.term_tenor` | .. N/A                                                                                                                                                                                                                                                                                                                    |
 | `Inflation Rate`                                                                                                                                | Financial Parameters → Analysis Parameters             | `Inflation rate`                                                                                             | `Utilityrate5`                    | `inflation_rate`                                             | .. N/A                                                                                                                                                                                                                                                                                                                    |
@@ -53,3 +53,103 @@ The following table describes how GEOPHIRES parameters are transformed into SAM
     1. Project VIR=PI=PIR
     2. Project MOIC
     3. Project Payback Period
+
+## Using SAM Economic Models with Existing GEOPHIRES Inputs
+
+In many cases, all you need to do to use SAM Economic Models for your existing GEOPHIRES inputs is to change the
+`Economic Model` parameter value.
+For example, if your GEOPHIRES `.txt` file contained the following:
+
+```
+# *** Financial Parameters ***
+Economic Model, 2, -- Standard Levelized Cost Model
+Discount Rate, .05
+Inflation Rate During Construction, 0
+Plant Lifetime, 25
+```
+
+You would change it to:
+
+```
+# *** Financial Parameters ***
+Economic Model, 5, -- SAM Single Owner PPA Economic Model
+Discount Rate, .05
+Inflation Rate During Construction, 0
+Plant Lifetime, 25
+```
+
+For inputs with the BICYCLE economic model, such as the following:
+
+```
+# *** Financial Parameters ***
+Economic Model, 3, -- BICYCLE
+Inflated Equity Interest Rate, .08
+Plant Lifetime, 30
+```
+
+Change `Economic Model` and replace `Inflated Equity Interest Rate` with a suitable `Discount Rate` and
+`Inflation Rate`:
+
+```
+# *** Financial Parameters ***
+Economic Model, 5, -- SAM Single Owner PPA Economic Model
+Discount Rate, .08
+Inflation Rate, .03
+Plant Lifetime, 30
+```
+
+## Recreating SAM Economic Model Results in the SAM Desktop Application
+
+First, open `src/geophires_sam_economics/Generic_400_MWe.sam`
+in the SAM desktop application.
+
+Next, run GEOPHIRES for your input, e.g.:
+
+```
+python -mgeophires_x my-geophires-input.txt
+```
+
+Then check `src/geophires_x/all_messages_conf.log` for the SAM Economics Parameter Mapping entry:
+
+```
+23-05-2025 10:09:35 : INFO : EconomicsSam : calculate_sam_economics : 151 : (Process Details : (1378, MainProcess), Thread Details : (8589068352, MainThread)): SAM Economics Parameter Mapping:
+-----------------  --------------------  -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
+SAM Module         Parameter             Value
+Custom Generation  analysis_period       20
+Custom Generation  user_capacity_factor  90.0
+Utility Rate       inflation_rate        2.0
+Utility Rate       degradation           [1.2734946600673935, 0.7001040275842613, 0.5267634676194525, 0.4244824247238818, 0.3529717582311231, 0.29852256883429373, 0.2548483024454293, 0.21855974702202877, 0.18762922644042462, 0.1607514026827296, 0.13703877682895466, 0.11586181507372084, 0.09675857340703789, 0.07938054662917803, 0.06345865490418974, 0.0487810281945756, 0.03517801101748528, 0.02251175220012943, 0.010668799824934945, 0.0]
+Single Owner       analysis_period       20
+Single Owner       total_installed_cost  264606243.76608825
+Single Owner       om_fixed              [7193902.821741002]
+Single Owner       om_fixed_escal        -2.0
+Single Owner       system_capacity       59020.69007804236
+Single Owner       federal_tax_rate      [21.0]
+Single Owner       state_tax_rate        [7.0]
+Single Owner       itc_fed_percent       [30.0]
+Single Owner       property_tax_rate     0.0
+Single Owner       ppa_price_input       [0.08, 0.08, 0.08322, 0.08644, 0.08966, 0.09288, 0.0961, 0.09932, 0.10254, 0.10576, 0.10898000000000001, 0.1122, 0.11542, 0.11864, 0.12186, 0.12508, 0.1283, 0.13152, 0.13474, 0.13796]
+Single Owner       debt_percent          40.0
+Single Owner       real_discount_rate    8.0
+Single Owner       term_tenor            20
+Single Owner       term_int_rate         5.0
+Single Owner       ibi_oth_amount        0.0
+-----------------  --------------------  -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
+```
+
+You can then manually enter the parameters from the logged mapping into the SAM desktop app.
+
+![](sam-desktop-app-manually-enter-system-capacity-from-geophires-log.png)
+
+
+## Examples
+
+### SAM Single Owner PPA: 50 MWe
+
+[Web interface link](https://gtp.scientificwebservices.com/geophires/?geophires-example-id=example_SAM-single-owner-PPA)
+
+### Case Study: 500 MWe EGS Project Modeled on Fervo Cape Station
+
+[Web interface link](https://gtp.scientificwebservices.com/geophires/?geophires-example-id=Fervo_Project_Cape-4)
+
+See [Case Study: 500 MWe EGS Project Modeled on Fervo Cape Station](Fervo_Project_Cape-4.html).
diff --git a/docs/conf.py b/docs/conf.py
@@ -18,7 +18,7 @@
 year = '2025'
 author = 'NREL'
 copyright = f'{year}, {author}'
-version = release = '3.9.8'
+version = release = '3.9.13'
 
 pygments_style = 'trac'
 templates_path = ['./templates']

diff --git a/docs/index.rst b/docs/index.rst
@@ -11,6 +11,7 @@ Contents
    hip_ra_x_parameters
    Monte-Carlo-User-Guide
    SAM-Economic-Models
+   GEOPHIRES-Examples
 ..   reference/index
 
 Indices and tables

diff --git a/docs/overview.rst b/docs/overview.rst
@@ -2,8 +2,5 @@
 GEOPHIRES-X Reference Manual
 ============================
 
-This reference manual is a supplement to the README in the GitHub repository.
-
-+ :doc:`parameters`
-
-+ :doc:`How-to-extend-GEOPHIRES-X`
+This reference manual is a supplement to the `Documentation section of the README <https://github.com/NREL/GEOPHIRES-X?tab=readme-ov-file#documentation>`__ in the GitHub repository.
+Click a topic in the Table of Contents on the left to view its documentation.
diff --git a/docs/sam-desktop-app-manually-enter-system-capacity-from-geophires-log.png b/docs/sam-desktop-app-manually-enter-system-capacity-from-geophires-log.png
diff --git a/setup.py b/setup.py
@@ -13,7 +13,7 @@ def read(*names, **kwargs):
 
 setup(
     name='geophires-x',
-    version='3.9.8',
+    version='3.9.13',
     license='MIT',
     description='GEOPHIRES is a free and open-source geothermal techno-economic simulator.',
     long_description='{}\n{}'.format(

diff --git a/src/geophires_sam_economics/Generic_400_MWe.sam b/src/geophires_sam_economics/Generic_400_MWe.sam