Skip to content

Commit c93a0d8

Browse files
softwareengineerprogrammersoftwareengineerprogrammer
authored
Merge pull request NREL#389 from softwareengineerprogrammer/main
Fervo Cape Station 500 MWe Update + 50 MWe SAM Example [v3.9.16] NREL#385
2 parents 4e6b563 + d37e39c commit c93a0d8

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+2530
-432
lines changed

‎.bumpversion.cfg

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[bumpversion]
2-
current_version = 3.9.8
2+
current_version = 3.9.16
33
commit = True
44
tag = True
55

‎.cookiecutterrc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ default_context:
5454
sphinx_doctest: "no"
5555
sphinx_theme: "sphinx-py3doc-enhanced-theme"
5656
test_matrix_separate_coverage: "no"
57-
version: 3.9.8
57+
version: 3.9.16
5858
version_manager: "bump2version"
5959
website: "https://github.com/NREL"
6060
year_from: "2023"

‎CHANGELOG.rst

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,7 @@ GEOPHIRES-X (2023-2025)
1010

1111
`release <https://github.com/NREL/GEOPHIRES-X/releases/tag/v3.9.7>`__
1212

13-
v3.9 adds the `SAM Single Owner PPA Economic Model <https://softwareengineerprogrammer.github.io/GEOPHIRES/SAM-Economic-Models.html>`__
14-
15-
.. TODO switch link to nrel.github.io version once merged into main repo
13+
v3.9 adds the `SAM Single Owner PPA Economic Model <https://nrel.github.io/GEOPHIRES-X/SAM-Economic-Models.html>`__
1614

1715

1816
3.8

‎README.rst

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -56,9 +56,9 @@ Free software: `MIT license <LICENSE>`__
5656
:alt: Supported implementations
5757
:target: https://pypi.org/project/geophires-x
5858

59-
.. |commits-since| image:: https://img.shields.io/github/commits-since/softwareengineerprogrammer/GEOPHIRES-X/v3.9.8.svg
59+
.. |commits-since| image:: https://img.shields.io/github/commits-since/softwareengineerprogrammer/GEOPHIRES-X/v3.9.16.svg
6060
:alt: Commits since latest release
61-
:target: https://github.com/softwareengineerprogrammer/GEOPHIRES-X/compare/v3.9.8...main
61+
:target: https://github.com/softwareengineerprogrammer/GEOPHIRES-X/compare/v3.9.16...main
6262

6363
.. |docs| image:: https://readthedocs.org/projects/GEOPHIRES-X/badge/?style=flat
6464
:target: https://nrel.github.io/GEOPHIRES-X
@@ -293,9 +293,7 @@ electricity: (1) fixed charge rate (FCR) model;
293293
(2) standard discounting levelized cost model;
294294
(3) BICYCLE model;
295295
(4) CLGS;
296-
(5) SAM Single-owner PPA.
297-
298-
.. TODO link to SAM Economic Model docs
296+
(5) `SAM Single-owner PPA <https://nrel.github.io/GEOPHIRES-X/SAM-Economic-Models.html>`__.
299297

300298
The capital and O&M costs for the different geothermal system components (exploration,
301299
well drilling, surface plant, etc.) are either provided by the user or calculated with built-in
@@ -454,6 +452,10 @@ Example-specific web interface deeplinks are listed in the Link column.
454452
- `Fervo_Project_Cape-3.txt <tests/examples/Fervo_Project_Cape-3.txt>`__
455453
- `.out <tests/examples/Fervo_Project_Cape-3.out>`__
456454
- `link <https://gtp.scientificwebservices.com/geophires?geophires-example-id=Fervo_Project_Cape-3>`__
455+
* - Case Study: 500 MWe EGS Project Modeled on Fervo Cape Station (`documentation <https://softwareengineerprogrammer.github.io/GEOPHIRES/Fervo_Project_Cape-4.html>`__)
456+
- `Fervo_Project_Cape-4.txt <tests/examples/Fervo_Project_Cape-4.txt>`__
457+
- `.out <tests/examples/Fervo_Project_Cape-4.out>`__
458+
- `link <https://gtp.scientificwebservices.com/geophires?geophires-example-id=Fervo_Project_Cape-4>`__
457459
* - Superhot Rock (SHR) Example 1
458460
- `example_SHR-1.txt <tests/examples/example_SHR-1.txt>`__
459461
- `.out <tests/examples/example_SHR-1.out>`__
@@ -462,10 +464,14 @@ Example-specific web interface deeplinks are listed in the Link column.
462464
- `example_SHR-2.txt <tests/examples/example_SHR-2.txt>`__
463465
- `.out <tests/examples/example_SHR-2.out>`__
464466
- `link <https://gtp.scientificwebservices.com/geophires?geophires-example-id=example_SHR-2>`__
465-
* - SAM Single Owner PPA
467+
* - SAM Single Owner PPA: 50 MWe
466468
- `example_SAM-single-owner-PPA.txt <tests/examples/example_SAM-single-owner-PPA.txt>`__
467469
- `.out <tests/examples/example_SAM-single-owner-PPA.out>`__
468470
- `link <https://gtp.scientificwebservices.com/geophires?geophires-example-id=example_SAM-single-owner-PPA>`__
471+
* - SAM Single Owner PPA: 400 MWe BICYCLE Comparison
472+
- `example_SAM-single-owner-PPA-2.txt <tests/examples/example_SAM-single-owner-PPA-2.txt>`__
473+
- `.out <tests/examples/example_SAM-single-owner-PPA-2.out>`__
474+
- `link <https://gtp.scientificwebservices.com/geophires?geophires-example-id=example_SAM-single-owner-PPA-2>`__
469475

470476
.. raw:: html
471477

‎docs/Fervo_Project_Cape-4.md

Lines changed: 158 additions & 0 deletions
Large diffs are not rendered by default.

‎docs/GEOPHIRES-Examples.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
# GEOPHIRES Examples
2+
3+
## Examples List
4+
5+
View the list of all GEOPHIRES examples in the [README](https://github.com/NREL/GEOPHIRES-X?tab=readme-ov-file#examples)
6+
or in the [web interface](https://gtp.scientificwebservices.com/geophires) under the Examples tab.
7+
8+
## Case Study: 500 MWe EGS Project Modeled on Fervo Cape Station
9+
10+
See [Case Study: 500 MWe EGS Project Modeled on Fervo Cape Station](Fervo_Project_Cape-4.html).

‎docs/SAM-Economic-Models.md

Lines changed: 100 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ The following table describes how GEOPHIRES parameters are transformed into SAM
2020
| `Maximum Total Electricity Generation` | Generation Profile | `Nameplate capacity` | `Singleowner` | `system_capacity` | .. N/A |
2121
| `Utilization Factor` | Generation Profile | `Nominal capacity factor` | `Singleowner` | `user_capacity_factor` | .. N/A |
2222
| `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 |
23-
| `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. |
23+
| `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). |
2424
| `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 |
2525
| `Plant Lifetime` | Financial Parameters → Analysis Parameters | `Analysis period` | `CustomGeneration`, `Singleowner` | `CustomGeneration.analysis_period`, `Singleowner.term_tenor` | .. N/A |
2626
| `Inflation Rate` | Financial Parameters → Analysis Parameters | `Inflation rate` | `Utilityrate5` | `inflation_rate` | .. N/A |
@@ -48,8 +48,102 @@ The following table describes how GEOPHIRES parameters are transformed into SAM
4848
### Limitations
4949

5050
1. Only Electricity end-use is supported
51-
2. Only 1 construction year is supported
52-
3. The following economic outputs are not calculated:
53-
1. Project VIR=PI=PIR
54-
2. Project MOIC
55-
3. Project Payback Period
51+
2. Only 1 construction year is supported. Note that the `Inflation Rate During Construction` parameter can be used to partially account for longer construction periods.
52+
53+
## Using SAM Economic Models with Existing GEOPHIRES Inputs
54+
55+
In many cases, all you need to do to use SAM Economic Models for your existing GEOPHIRES inputs is to change the
56+
`Economic Model` parameter value.
57+
For example, if your GEOPHIRES `.txt` file contained the following:
58+
59+
```
60+
# *** Financial Parameters ***
61+
Economic Model, 2, -- Standard Levelized Cost Model
62+
Discount Rate, .05
63+
Plant Lifetime, 25
64+
```
65+
66+
You would change it to:
67+
68+
```
69+
# *** Financial Parameters ***
70+
Economic Model, 5, -- SAM Single Owner PPA Economic Model
71+
Discount Rate, .05
72+
Plant Lifetime, 25
73+
```
74+
75+
For inputs with the BICYCLE economic model, such as the following:
76+
77+
```
78+
# *** Financial Parameters ***
79+
Economic Model, 3, -- BICYCLE
80+
Inflated Equity Interest Rate, .08
81+
Plant Lifetime, 30
82+
```
83+
84+
Change `Economic Model` and replace `Inflated Equity Interest Rate` with a suitable `Discount Rate` and
85+
`Inflation Rate`:
86+
87+
```
88+
# *** Financial Parameters ***
89+
Economic Model, 5, -- SAM Single Owner PPA Economic Model
90+
Discount Rate, .08
91+
Inflation Rate, .03
92+
Plant Lifetime, 30
93+
```
94+
95+
## Re-creating SAM Economic Model Results in the SAM Desktop Application
96+
97+
First, open `src/geophires_sam_economics/Generic_400_MWe.sam`
98+
in the SAM desktop application.
99+
100+
Next, run GEOPHIRES for your input, e.g.:
101+
102+
```
103+
python -mgeophires_x my-geophires-input.txt
104+
```
105+
106+
Then check `src/geophires_x/all_messages_conf.log` for the SAM Economics Parameter Mapping entry:
107+
108+
```
109+
23-05-2025 10:09:35 : INFO : EconomicsSam : calculate_sam_economics : 151 : (Process Details : (1378, MainProcess), Thread Details : (8589068352, MainThread)): SAM Economics Parameter Mapping:
110+
----------------- -------------------- -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
111+
SAM Module Parameter Value
112+
Custom Generation analysis_period 20
113+
Custom Generation user_capacity_factor 90.0
114+
Utility Rate inflation_rate 2.0
115+
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]
116+
Single Owner analysis_period 20
117+
Single Owner total_installed_cost 264606243.76608825
118+
Single Owner om_fixed [7193902.821741002]
119+
Single Owner om_fixed_escal -2.0
120+
Single Owner system_capacity 59020.69007804236
121+
Single Owner federal_tax_rate [21.0]
122+
Single Owner state_tax_rate [7.0]
123+
Single Owner itc_fed_percent [30.0]
124+
Single Owner property_tax_rate 0.0
125+
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]
126+
Single Owner debt_percent 40.0
127+
Single Owner real_discount_rate 8.0
128+
Single Owner term_tenor 20
129+
Single Owner term_int_rate 5.0
130+
Single Owner ibi_oth_amount 0.0
131+
----------------- -------------------- -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
132+
```
133+
134+
You can then manually enter the parameters from the logged mapping into the SAM desktop app.
135+
136+
![](sam-desktop-app-manually-enter-system-capacity-from-geophires-log.png)
137+
138+
139+
## Examples
140+
141+
### SAM Single Owner PPA: 50 MWe
142+
143+
[Web interface link](https://gtp.scientificwebservices.com/geophires/?geophires-example-id=example_SAM-single-owner-PPA)
144+
145+
### Case Study: 500 MWe EGS Project Modeled on Fervo Cape Station
146+
147+
[Web interface link](https://gtp.scientificwebservices.com/geophires/?geophires-example-id=Fervo_Project_Cape-4)
148+
149+
See [Case Study: 500 MWe EGS Project Modeled on Fervo Cape Station](Fervo_Project_Cape-4.html).

‎docs/conf.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@
1818
year = '2025'
1919
author = 'NREL'
2020
copyright = f'{year}, {author}'
21-
version = release = '3.9.8'
21+
version = release = '3.9.16'
2222

2323
pygments_style = 'trac'
2424
templates_path = ['./templates']

‎docs/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ Contents
1111
hip_ra_x_parameters
1212
Monte-Carlo-User-Guide
1313
SAM-Economic-Models
14+
GEOPHIRES-Examples
1415
.. reference/index
1516
1617
Indices and tables

‎docs/overview.rst

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,5 @@
22
GEOPHIRES-X Reference Manual
33
============================
44

5-
This reference manual is a supplement to the README in the GitHub repository.
6-
7-
+ :doc:`parameters`
8-
9-
+ :doc:`How-to-extend-GEOPHIRES-X`
5+
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.
6+
Click a topic in the Table of Contents on the left to view its documentation.

0 commit comments

Comments
 (0)