Skip to content

Commit cbdc94b

Browse files
softwareengineerprogrammersoftwareengineerprogrammer
authored
Merge pull request #74 from softwareengineerprogrammer/fervo-cape-station-500-mwe-2
Fervo Cape Station 500 MWe Update (NREL#385) + 50 MWe SAM Example
2 parents da615c0 + 15df631 commit cbdc94b

36 files changed

+1685
-359
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.13
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.13
5858
version_manager: "bump2version"
5959
website: "https://github.com/NREL"
6060
year_from: "2023"

‎README.rst

Lines changed: 8 additions & 4 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.13.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.13...main
6262

6363
.. |docs| image:: https://readthedocs.org/projects/GEOPHIRES-X/badge/?style=flat
6464
:target: https://nrel.github.io/GEOPHIRES-X
@@ -293,7 +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.
296+
(5) `SAM Single-owner PPA <https://nrel.github.io/GEOPHIRES-X/SAM-Economic-Models.html>`__.
297297

298298
.. TODO link to SAM Economic Model docs
299299
@@ -462,10 +462,14 @@ Example-specific web interface deeplinks are listed in the Link column.
462462
- `example_SHR-2.txt <tests/examples/example_SHR-2.txt>`__
463463
- `.out <tests/examples/example_SHR-2.out>`__
464464
- `link <https://gtp.scientificwebservices.com/geophires?geophires-example-id=example_SHR-2>`__
465-
* - SAM Single Owner PPA
465+
* - SAM Single Owner PPA: 50 MWe
466466
- `example_SAM-single-owner-PPA.txt <tests/examples/example_SAM-single-owner-PPA.txt>`__
467467
- `.out <tests/examples/example_SAM-single-owner-PPA.out>`__
468468
- `link <https://gtp.scientificwebservices.com/geophires?geophires-example-id=example_SAM-single-owner-PPA>`__
469+
* - SAM Single Owner PPA: 400 MWe BICYCLE Comparison
470+
- `example_SAM-single-owner-PPA-2.txt <tests/examples/example_SAM-single-owner-PPA-2.txt>`__
471+
- `.out <tests/examples/example_SAM-single-owner-PPA-2.out>`__
472+
- `link <https://gtp.scientificwebservices.com/geophires?geophires-example-id=example_SAM-single-owner-PPA-2>`__
469473

470474
.. raw:: html
471475

‎docs/Fervo_Project_Cape-4.md

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

‎docs/sam-desktop-app-manually-enter-system-capacity-from-geophires-log.png

310 KB
Loading

0 commit comments

Comments
 (0)