capacity factor WIP

Author: softwareengineerprogrammer

docs/SAM-Economic-Models.md

@@ -26,6 +26,7 @@ The following table describes how GEOPHIRES parameters are transformed into SAM
 | GEOPHIRES Parameter(s)                                                                                                                          | SAM Category                                           | SAM Input(s)                                                                     | SAM Module(s)                     | SAM Parameter Name(s)                                        | Comment                                                                                                                                                                                                                                                                                                                   |
 |-------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------|----------------------------------------------------------------------------------|-----------------------------------|--------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | `Max Net Electricity Production`                                                                                                                | Generation Profile                                     | `Nameplate capacity`                                                             | `Singleowner`                     | `system_capacity`                                            | .. N/A                                                                                                                                                                                                                                                                                                                    |
+| `Utilizaton Factor`                                                                                                                             | Generation Profile                                     | `Nominal capacity factor`                                                        | `Singleowner`                     | `user_capacity_factor`                                       | .. N/A                                                                                                                                                                                                                                                                                                                    |
 | `Net Electricity Production`                                                                                                                    | AC Degradation                                         | `Annual AC degradation rate` schedule                                            | `Utilityrate5`                    | `degradation`                                                | Percentage difference of each year's `Net Electricity Production` from `Max Net Electricity Production` 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`                                                                                            | Installation Costs                                     | `Total Installed Cost`                                                           | `Singleowner`                     | `total_installed_cost`                                       | .. N/A                                                                                                                                                                                                                                                                                                                    |
 | `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                                                                                                                                                                                                                                                                                                                    |

src/geophires_x/EconomicsSam.py

@@ -245,6 +245,8 @@ def pct(econ_value: Parameter) -> float:
 
     ret['ibi_oth_amount'] = (econ.OtherIncentives.quantity() + econ.TotalGrant.quantity()).to('USD').magnitude
 
+    ret['user_capacity_factor'] = model.surfaceplant.utilization_factor.value
+
     return ret
 
 

src/geophires_x/Outputs.py

@@ -257,7 +257,9 @@ def PrintOutputs(self, model: Model):
                     irfl = Outputs._field_label(econ.interest_rate.Name, 49)
                     f.write(f'      {irfl}{econ.interest_rate.value:10.2f} {econ.interest_rate.CurrentUnits.value}\n')
 
+                # FIXME TODO unit is missing
                 f.write(f'      Accrued financing during construction:            {model.economics.inflrateconstruction.value*100:10.2f} {model.economics.inflrateconstruction.CurrentUnits.value}\n')
+
                 f.write(f'      Project lifetime:                              {model.surfaceplant.plant_lifetime.value:10.0f} {model.surfaceplant.plant_lifetime.CurrentUnits.value}\n')
                 f.write(f'      Capacity factor:                                 {model.surfaceplant.utilization_factor.value * 100:10.1f} %\n')
 

src/geophires_x/SurfacePlant.py

@@ -305,7 +305,8 @@ def __init__(self, model: Model):
             CurrentUnits=PercentUnit.TENTH,
             Required=True,
             ErrMessage="assume default utilization factor (0.9)",
-            ToolTipText="Ratio of the time the plant is running in normal production in a 1-year time period."
+            ToolTipText="Ratio of the time the plant is running in normal production in a 1-year time period. "
+                        "Synonymous with capacity factor."
         )
         self.enduse_efficiency_factor = self.ParameterDict[self.enduse_efficiency_factor.Name] = floatParameter(
             "End-Use Efficiency Factor",