Add Overnight Capital Cost (OCC) output parameter. Only display OCC/IDC if there are multiple construction years

Author: softwareengineerprogrammer

src/geophires_x/Economics.py

@@ -13,7 +13,8 @@
 from geophires_x.EconomicsUtils import BuildPricingModel, wacc_output_parameter, nominal_discount_rate_parameter, \
     real_discount_rate_parameter, after_tax_irr_parameter, moic_parameter, project_vir_parameter, \
     project_payback_period_parameter, inflation_cost_during_construction_output_parameter, \
-    interest_during_construction_output_parameter, total_capex_parameter_output_parameter
+    interest_during_construction_output_parameter, total_capex_parameter_output_parameter, \
+    overnight_capital_cost_output_parameter
 from geophires_x.GeoPHIRESUtils import quantity
 from geophires_x.OptionList import Configuration, WellDrillingCostCorrelation, EconomicModel, EndUseOptions, PlantType, \
     _WellDrillingCostCorrelationCitation
@@ -2216,6 +2217,10 @@ def __init__(self, model: Model):
             PreferredUnits=PercentUnit.PERCENT,
             CurrentUnits=PercentUnit.PERCENT
         )
+
+        self.overnight_capital_cost = self.OutputParameterDict[
+            self.overnight_capital_cost.Name] = overnight_capital_cost_output_parameter()
+
         self.accrued_financing_during_construction_percentage = self.OutputParameterDict[
           self.accrued_financing_during_construction_percentage.Name] = OutputParameter(
             Name='Accrued financing during construction',
@@ -3507,6 +3512,9 @@ def _calculate_sam_economics(self, model: Model) -> None:
         self.CCap.value = (self.sam_economics_calculations.capex.quantity()
                            .to(self.CCap.CurrentUnits.value).magnitude)
 
+        self.overnight_capital_cost.value = (self.sam_economics_calculations.overnight_capital_cost.quantity()
+                                             .to(self.overnight_capital_cost.CurrentUnits.value).magnitude)
+
         self.interest_during_construction.value = quantity(
             self.sam_economics_calculations.pre_revenue_costs_and_cash_flow.interest_during_construction_usd,
             'USD'

src/geophires_x/EconomicsSam.py

@@ -38,6 +38,7 @@
     project_payback_period_parameter,
     total_capex_parameter_output_parameter,
     royalty_cost_output_parameter,
+    overnight_capital_cost_output_parameter,
 )
 from geophires_x.EconomicsSamPreRevenue import (
     _TOTAL_AFTER_TAX_RETURNS_CASH_FLOW_ROW_NAME,
@@ -64,6 +65,8 @@ class SamEconomicsCalculations:
         )
     )
 
+    overnight_capital_cost: OutputParameter = field(default_factory=overnight_capital_cost_output_parameter)
+
     capex: OutputParameter = field(default_factory=total_capex_parameter_output_parameter)
 
     royalties_opex: OutputParameter = field(default_factory=royalty_cost_output_parameter)
@@ -284,6 +287,10 @@ def sf(_v: float, num_sig_figs: int = 5) -> float:
         pre_revenue_costs_and_cash_flow=calculate_pre_revenue_costs_and_cashflow(model),
     )
 
+    sam_economics.overnight_capital_cost.value = (
+        model.economics.CCap.quantity().to(sam_economics.overnight_capital_cost.CurrentUnits.value).magnitude
+    )
+
     sam_economics.lcoe_nominal.value = sf(single_owner.Outputs.lcoe_nom)
     sam_economics.after_tax_irr.value = sf(_get_after_tax_irr_pct(single_owner, cash_flow, model))
 

src/geophires_x/EconomicsUtils.py

@@ -129,6 +129,19 @@ def wacc_output_parameter() -> OutputParameter:
     )
 
 
+def overnight_capital_cost_output_parameter() -> OutputParameter:
+    return OutputParameter(
+        Name='Overnight Capital Cost',
+        UnitType=Units.CURRENCY,
+        PreferredUnits=CurrencyUnit.MDOLLARS,
+        CurrentUnits=CurrencyUnit.MDOLLARS,
+        ToolTipText='Overnight Capital Cost (OCC) represents the total capital cost required '
+        'to construct the plant if it were built instantly ("overnight"). '
+        'This value excludes time-dependent costs such as inflation and '
+        'interest incurred during the construction period.',
+    )
+
+
 def inflation_cost_during_construction_output_parameter() -> OutputParameter:
     return OutputParameter(
         Name='Inflation costs during construction',

src/geophires_x/Outputs.py

@@ -515,19 +515,26 @@ def PrintOutputs(self, model: Model):
                         #  expenditure.
                         pass
 
-                display_inflation_and_interest_during_construction_in_capital_costs = is_sam_econ_model
-                if display_inflation_and_interest_during_construction_in_capital_costs:
-                    icc_label = Outputs._field_label(econ.inflation_cost_during_construction.display_name, 47)
-                    f.write(f'         {icc_label}{econ.inflation_cost_during_construction.value:10.2f} {econ.inflation_cost_during_construction.CurrentUnits.value}\n')
+                display_occ_and_idc_in_capital_costs = is_sam_econ_model \
+                                                       and model.surfaceplant.construction_years.value > 1
+                if display_occ_and_idc_in_capital_costs:
+                    occ_label = Outputs._field_label(econ.overnight_capital_cost.display_name, 47)
+                    f.write(
+                        f'         {occ_label}{econ.overnight_capital_cost.value:10.2f} {econ.overnight_capital_cost.CurrentUnits.value}\n')
 
                     idc_label = Outputs._field_label(econ.interest_during_construction.display_name, 47)
                     f.write(
                         f'         {idc_label}{econ.interest_during_construction.value:10.2f} {econ.interest_during_construction.CurrentUnits.value}\n')
 
-                    if econ.DoAddOnCalculations.value:
-                        # Non-SAM econ models print this in Extended Economics profile
-                        aoc_label = Outputs._field_label(model.addeconomics.AddOnCAPEXTotal.display_name, 47)
-                        f.write(f'         {aoc_label}{model.addeconomics.AddOnCAPEXTotal.value:10.2f} {model.addeconomics.AddOnCAPEXTotal.CurrentUnits.value}\n')
+                display_inflation_during_construction_in_capital_costs = is_sam_econ_model
+                if display_inflation_during_construction_in_capital_costs:
+                    icc_label = Outputs._field_label(econ.inflation_cost_during_construction.display_name, 47)
+                    f.write(f'         {icc_label}{econ.inflation_cost_during_construction.value:10.2f} {econ.inflation_cost_during_construction.CurrentUnits.value}\n')
+
+                if is_sam_econ_model and econ.DoAddOnCalculations.value:
+                    # Non-SAM econ models print this in Extended Economics profile
+                    aoc_label = Outputs._field_label(model.addeconomics.AddOnCAPEXTotal.display_name, 47)
+                    f.write(f'         {aoc_label}{model.addeconomics.AddOnCAPEXTotal.value:10.2f} {model.addeconomics.AddOnCAPEXTotal.CurrentUnits.value}\n')
 
                 capex_param = econ.CCap if not is_sam_econ_model else econ.capex_total
                 capex_label = Outputs._field_label(capex_param.display_name, 50)

src/geophires_x_client/geophires_x_result.py

@@ -266,6 +266,7 @@ class GeophiresXResult:
                 'Total surface equipment costs',
                 'Exploration costs',
                 'Investment Tax Credit',
+                'Overnight Capital Cost',
                 # Displayed for economic models that treat inflation costs as capital costs (SAM-EM)
                 'Inflation costs during construction',
                 'Interest during construction',

src/geophires_x_schema_generator/geophires-result.json

@@ -442,6 +442,11 @@
           "description": "Investment Tax Credit Value",
           "units": "MUSD"
         },
+        "Overnight Capital Cost": {
+          "type": "number",
+          "description": "Overnight Capital Cost (OCC) represents the total capital cost required to construct the plant if it were built instantly (\"overnight\"). This value excludes time-dependent costs such as inflation and interest incurred during the construction period.",
+          "units": "MUSD"
+        },
         "Inflation costs during construction": {
           "type": "number",
           "description": "The calculated amount of cost escalation due to inflation over the construction period.",

tests/examples/Fervo_Project_Cape-4.out

@@ -6,8 +6,8 @@ Simulation Metadata
 ----------------------
  GEOPHIRES Version: 3.10.10
  Simulation Date: 2025-11-25
- Simulation Time:  09:34
- Calculation Time:      1.737 sec
+ Simulation Time:  09:48
+ Calculation Time:      1.719 sec
 
                            ***SUMMARY OF RESULTS***
 
@@ -104,7 +104,6 @@ Simulation Metadata
          Total surface equipment costs:                    1560.49 MUSD
          Exploration costs:                                  30.00 MUSD
          Inflation costs during construction:                59.82 MUSD
-         Interest during construction:                        0.00 MUSD
       Total CAPEX:                                         2660.87 MUSD
 
 

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

@@ -6,8 +6,8 @@ Simulation Metadata
 ----------------------
  GEOPHIRES Version: 3.10.10
  Simulation Date: 2025-11-25
- Simulation Time:  09:34
- Calculation Time:      0.977 sec
+ Simulation Time:  09:48
+ Calculation Time:      0.976 sec
 
                            ***SUMMARY OF RESULTS***
 
@@ -105,7 +105,6 @@ Simulation Metadata
          Total surface equipment costs:                     969.26 MUSD
          Exploration costs:                                  30.00 MUSD
          Inflation costs during construction:                76.64 MUSD
-         Interest during construction:                        0.00 MUSD
       Total CAPEX:                                         1609.42 MUSD
 
 

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

@@ -6,8 +6,8 @@ Simulation Metadata
 ----------------------
  GEOPHIRES Version: 3.10.10
  Simulation Date: 2025-11-25
- Simulation Time:  09:34
- Calculation Time:      1.174 sec
+ Simulation Time:  09:48
+ Calculation Time:      1.151 sec
 
                            ***SUMMARY OF RESULTS***
 
@@ -106,7 +106,6 @@ Simulation Metadata
          Total surface equipment costs:                     150.23 MUSD
          Exploration costs:                                   3.89 MUSD
          Inflation costs during construction:                13.12 MUSD
-         Interest during construction:                        0.00 MUSD
          Total Add-on CAPEX:                                 50.00 MUSD
       Total CAPEX:                                          275.47 MUSD
 

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

@@ -6,8 +6,8 @@ Simulation Metadata
 ----------------------
  GEOPHIRES Version: 3.10.10
  Simulation Date: 2025-11-25
- Simulation Time:  09:34
- Calculation Time:      1.178 sec
+ Simulation Time:  09:48
+ Calculation Time:      1.143 sec
 
                            ***SUMMARY OF RESULTS***
 
@@ -107,7 +107,6 @@ Simulation Metadata
          Total surface equipment costs:                     152.93 MUSD
          Exploration costs:                                   3.89 MUSD
          Inflation costs during construction:                10.75 MUSD
-         Interest during construction:                        0.00 MUSD
       Total CAPEX:                                          225.81 MUSD