add issuance of equity [construction] cash flow row. test that sums for total installed cost and issuance of equity are correct.

Author: softwareengineerprogrammer

src/geophires_x/EconomicsUtils.py

@@ -273,7 +273,7 @@ def _calculate_pre_revenue_costs_and_cashflow(
     equity_spend_vec: list[float] = []
     debt_draw_vec: list[float] = []
     debt_balance_usd_vec: list[float] = []
-    interest_accrued_vec: list[float] = []  # WIP addding cashflow line item "Debt interest payment [construction] ($)"
+    interest_accrued_vec: list[float] = []
 
     for year_index in range(pre_revenue_years_count):
         base_capex_this_year_usd = total_overnight_capex_usd * phased_capex_schedule[year_index]
@@ -333,6 +333,11 @@ def _append_row(row_name: str, row_vals: list[float | str]) -> None:
     pre_revenue_cf_profile.append(blank_row.copy())
 
     # --- Financing Activities ---
+    _append_row(
+        f'Issuance of equity ($)',
+        [abs(it) for it in equity_spend_vec],
+    )
+
     _append_row(
         # 'Debt draw ($)'
         f'Issuance of debt ($)',

tests/examples/Fervo_Project_Cape-4.out

@@ -4,10 +4,10 @@
 
 Simulation Metadata
 ----------------------
- GEOPHIRES Version: 3.10.8
- Simulation Date: 2025-11-18
- Simulation Time:  11:30
- Calculation Time:      1.767 sec
+ GEOPHIRES Version: 3.10.10
+ Simulation Date: 2025-11-24
+ Simulation Time:  09:00
+ Calculation Time:      1.727 sec
 
                            ***SUMMARY OF RESULTS***
 
@@ -218,6 +218,7 @@ CONSTRUCTION
 Purchase of property [construction] ($)               	-2,660,866,376
 Cash flow from investing activities [construction] ($)	-2,660,866,376
 
+Issuance of equity [construction] ($)                 	1,064,346,550
 Issuance of debt [construction] ($)                   	1,596,519,826
 Debt balance [construction] ($)                       	1,596,519,826
 Debt interest payment [construction] ($)              	0

tests/examples/example_SAM-single-owner-PPA-2.out

@@ -4,10 +4,10 @@
 
 Simulation Metadata
 ----------------------
- GEOPHIRES Version: 3.10.8
- Simulation Date: 2025-11-18
- Simulation Time:  11:30
- Calculation Time:      0.966 sec
+ GEOPHIRES Version: 3.10.10
+ Simulation Date: 2025-11-24
+ Simulation Time:  09:00
+ Calculation Time:      0.971 sec
 
                            ***SUMMARY OF RESULTS***
 
@@ -198,6 +198,7 @@ CONSTRUCTION
 Purchase of property [construction] ($)               	-1,609,421,820
 Cash flow from investing activities [construction] ($)	-1,609,421,820
 
+Issuance of equity [construction] ($)                 	804,710,910
 Issuance of debt [construction] ($)                   	804,710,910
 Debt balance [construction] ($)                       	804,710,910
 Debt interest payment [construction] ($)              	0

tests/examples/example_SAM-single-owner-PPA-3.out

@@ -4,10 +4,10 @@
 
 Simulation Metadata
 ----------------------
- GEOPHIRES Version: 3.10.8
- Simulation Date: 2025-11-18
- Simulation Time:  11:30
- Calculation Time:      1.152 sec
+ GEOPHIRES Version: 3.10.10
+ Simulation Date: 2025-11-24
+ Simulation Time:  09:00
+ Calculation Time:      1.154 sec
 
                            ***SUMMARY OF RESULTS***
 
@@ -200,6 +200,7 @@ CONSTRUCTION
 Purchase of property [construction] ($)               	-275,473,424
 Cash flow from investing activities [construction] ($)	-275,473,424
 
+Issuance of equity [construction] ($)                 	165,284,055
 Issuance of debt [construction] ($)                   	110,189,370
 Debt balance [construction] ($)                       	110,189,370
 Debt interest payment [construction] ($)              	0

tests/examples/example_SAM-single-owner-PPA-4.out

@@ -4,10 +4,10 @@
 
 Simulation Metadata
 ----------------------
- GEOPHIRES Version: 3.10.8
- Simulation Date: 2025-11-18
- Simulation Time:  11:30
- Calculation Time:      1.162 sec
+ GEOPHIRES Version: 3.10.10
+ Simulation Date: 2025-11-24
+ Simulation Time:  09:00
+ Calculation Time:      1.159 sec
 
                            ***SUMMARY OF RESULTS***
 
@@ -201,6 +201,7 @@ CONSTRUCTION
 Purchase of property [construction] ($)               	-225,808,536
 Cash flow from investing activities [construction] ($)	-225,808,536
 
+Issuance of equity [construction] ($)                 	135,485,121
 Issuance of debt [construction] ($)                   	90,323,414
 Debt balance [construction] ($)                       	90,323,414
 Debt interest payment [construction] ($)              	0

tests/examples/example_SAM-single-owner-PPA-5.out

@@ -4,10 +4,10 @@
 
 Simulation Metadata
 ----------------------
- GEOPHIRES Version: 3.10.8
- Simulation Date: 2025-11-18
- Simulation Time:  11:18
- Calculation Time:      1.732 sec
+ GEOPHIRES Version: 3.10.10
+ Simulation Date: 2025-11-24
+ Simulation Time:  08:52
+ Calculation Time:      1.725 sec
 
                            ***SUMMARY OF RESULTS***
 
@@ -218,6 +218,7 @@ CONSTRUCTION
 Purchase of property [construction] ($)               	-6,132,082	-12,546,240	-44,921,812	-65,650,020 	-134,319,940	-137,409,299	-281,139,426
 Cash flow from investing activities [construction] ($)	-6,132,082	-12,546,240	-44,921,812	-65,650,020 	-134,319,940	-137,409,299	-281,139,426
 
+Issuance of equity [construction] ($)                 	6,132,082 	12,546,240 	44,921,812 	65,650,020  	47,011,979  	48,093,255  	98,398,799
 Issuance of debt [construction] ($)                   	0         	0          	0          	0           	87,307,961  	89,316,044  	182,740,627
 Debt balance [construction] ($)                       	0         	0          	0          	0           	87,307,961  	182,735,563 	378,267,679
 Debt interest payment [construction] ($)              	0         	0          	0          	0           	0           	6,111,557   	12,791,489

tests/examples/example_SAM-single-owner-PPA.out

@@ -4,10 +4,10 @@
 
 Simulation Metadata
 ----------------------
- GEOPHIRES Version: 3.10.8
- Simulation Date: 2025-11-18
- Simulation Time:  11:30
- Calculation Time:      1.159 sec
+ GEOPHIRES Version: 3.10.10
+ Simulation Date: 2025-11-24
+ Simulation Time:  09:00
+ Calculation Time:      1.157 sec
 
                            ***SUMMARY OF RESULTS***
 
@@ -200,6 +200,7 @@ CONSTRUCTION
 Purchase of property [construction] ($)               	-225,808,536
 Cash flow from investing activities [construction] ($)	-225,808,536
 
+Issuance of equity [construction] ($)                 	135,485,121
 Issuance of debt [construction] ($)                   	90,323,414
 Debt balance [construction] ($)                       	90,323,414
 Debt interest payment [construction] ($)              	0

tests/geophires_x_tests/test_economics_sam.py

@@ -245,6 +245,23 @@ def _floats(_cf: list[Any]) -> list[float]:
             _floats(self._get_cash_flow_row(cy4_cf, 'Debt balance ($)'))[0],
         )
 
+        def _sum(cf_row_name: str, abs_val: bool = False) -> float:
+            return sum([abs(it) if abs_val else it for it in _floats(self._get_cash_flow_row(cy4_cf, cf_row_name))])
+
+        installed_cost_from_construction_cash_flow = _sum(
+            'Purchase of property [construction] ($)', abs_val=True
+        ) + _sum('Debt interest payment [construction] ($)')
+
+        self.assertEqual(
+            abs(_floats(self._get_cash_flow_row(cy4_cf, 'Total installed cost ($)'))[0]),
+            installed_cost_from_construction_cash_flow,
+        )
+
+        self.assertEqual(
+            _sum('Issuance of equity [construction] ($)'),
+            _floats(self._get_cash_flow_row(cy4_cf, 'Issuance of equity ($)'))[0],
+        )
+
     def assertAlmostEqualWithinSigFigs(self, expected: float | int, actual: float | int, num_sig_figs: int = 3):
         """
         TODO move to parent class (BaseTestCase)