CHP Expansion

CHANGELOG.md

@@ -26,6 +26,14 @@ Classify the change according to the following categories:
     ##### Removed
     ### Patches
 
+## v3.22.0
+### Minor Updates
+##### Added
+- Expanded **CHP** modeling to support multiple independently-configured CHPs, existing capacity (i.e. in BAU scenario), off-grid operation including the option for CHP to either require or supply operating reserves, user-defined production factors, ramp-rate limits, and heating load following thermal dispatch.
+- Added **CHP** inputs **name** (to label the type of system you are modeling), **existing_kw**, **ramp_rate_fraction_per_hour**, **operating_reserve_required_fraction**, **production_factor_series**, **fuel_cost_escalation_rate_fraction**, and **follow_heating_load**. When **follow_heating_load** is `true`, each CHP independently follows its eligible heating load at unfired thermal capacity; **ExistingBoiler** is restricted when CHP capacity exceeds that load, while other onsite heating resources can contribute and supplementary firing remains available only as incremental heat.
+- Added **CHP** outputs **name**, **electric_curtailed_series_kw**, and **annual_thermal_curtailed_mmbtu**. Multiple CHP systems are returned as a list of per-unit results under **CHP**, identified by **name**.
+- Added **CHP** BAU outputs **size_kw_bau**, **annual_fuel_consumption_mmbtu_bau**, **annual_electric_production_kwh_bau**, **annual_thermal_production_mmbtu_bau**, **annual_thermal_curtailed_mmbtu_bau**, **year_one_fuel_cost_before_tax_bau**, **year_one_fuel_cost_after_tax_bau**, **lifecycle_fuel_cost_after_tax_bau**, **year_one_standby_cost_before_tax_bau**, **year_one_standby_cost_after_tax_bau**, and **lifecycle_standby_cost_after_tax_bau**.
+
 ## v3.21.0
 ### Minor Updates
 ##### Added
@@ -50,7 +58,7 @@ Classify the change according to the following categories:
 
 ## v3.19.0
 ### Minor updates
-#### Added 
+##### Added 
 - New `CHP` fields **serve_absorption_chiller_only**, **months_serving_absorption_chiller_only**, **follow_electrical_load**, and **include_cooling_in_chp_size**
 - New output `thermal_to_absorption_chiller_series_mmbtu_per_hour` added to heating technologies `CHPOutputs`, `ElectricHeaterOutputs`, `CSTOutputs`, `BoilerOutputs`, `SteamTurbineOutputs`, and `ExistingBoilerOutputs`, and new output `storage_to_absorption_chiller_series_mmbtu_per_hour` for `HotThermalStorageOutputs` and `HighTempThermalStorageOutputs`.  
 ##### Changed

julia_src/http.jl

@@ -181,13 +181,18 @@ function reopt(req::HTTP.Request)
 			]
             if haskey(d, "CHP")
                 inputs_with_defaults_from_julia_chp = [
+                    :name,
                     :installed_cost_per_kw, :tech_sizes_for_cost_curve, :om_cost_per_kwh, 
                     :electric_efficiency_full_load, :thermal_efficiency_full_load, :min_allowable_kw,
                     :cooling_thermal_factor, :min_turn_down_fraction, :unavailability_periods, :max_kw,
                     :size_class, :electric_efficiency_half_load, :thermal_efficiency_half_load,
                     :macrs_option_years, :macrs_bonus_fraction, :federal_itc_fraction
                 ]
-                chp_dict = Dict(key=>getfield(model_inputs.s.chp, key) for key in inputs_with_defaults_from_julia_chp)
+                if length(model_inputs.s.chps) == 1
+                    chp_dict = Dict(key=>getfield(model_inputs.s.chps[1], key) for key in inputs_with_defaults_from_julia_chp)
+                else
+                    chp_dict = [Dict(key=>getfield(chp, key) for key in inputs_with_defaults_from_julia_chp) for chp in model_inputs.s.chps]
+                end
             else
                 chp_dict = Dict()
             end
@@ -253,9 +258,13 @@ function reopt(req::HTTP.Request)
             end
             if haskey(d, "PV")
                 inputs_with_defaults_from_julia_pv = [
-                    :size_class, :installed_cost_per_kw, :om_cost_per_kw, :macrs_option_years, :macrs_bonus_fraction, :federal_itc_fraction
+                    :name, :size_class, :installed_cost_per_kw, :om_cost_per_kw, :macrs_option_years, :macrs_bonus_fraction, :federal_itc_fraction
                 ]
-                pv_dict = Dict(key=>getfield(model_inputs.s.pvs[1], key) for key in inputs_with_defaults_from_julia_pv)
+                if length(model_inputs.s.pvs) == 1
+                    pv_dict = Dict(key=>getfield(model_inputs.s.pvs[1], key) for key in inputs_with_defaults_from_julia_pv)
+                else
+                    pv_dict = [Dict(key=>getfield(pv, key) for key in inputs_with_defaults_from_julia_pv) for pv in model_inputs.s.pvs]
+                end
             else
                 pv_dict = Dict()
             end   

reoptjl/migrations/0114_chpoutputs_electric_curtailed_series_kw.py

@@ -0,0 +1,19 @@
+# Generated by Django 4.2.26 on 2026-02-03 16:40
+
+import django.contrib.postgres.fields
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('reoptjl', '0113_merge_20251209_2338'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='electric_curtailed_series_kw',
+            field=django.contrib.postgres.fields.ArrayField(base_field=models.FloatField(blank=True, null=True), blank=True, default=list, help_text='Electric power curtailed time-series array [kW]', size=None),
+        ),
+    ]

reoptjl/migrations/0117_merge_20260803_1544.py

@@ -0,0 +1,14 @@
+# Generated by Django 4.2.26 on 2026-08-03 15:44
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('reoptjl', '0114_chpoutputs_electric_curtailed_series_kw'),
+        ('reoptjl', '0116_alter_apimeta_api_key_alter_apimeta_job_type'),
+    ]
+
+    operations = [
+    ]

reoptjl/migrations/0122_merge_20260804_1339.py

@@ -0,0 +1,14 @@
+# Generated by Django 4.2.26 on 2026-08-04 13:39
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('reoptjl', '0117_merge_20260803_1544'),
+        ('reoptjl', '0121_electricstorageinputs_can_export_beyond_nem_limit_and_more'),
+    ]
+
+    operations = [
+    ]

reoptjl/migrations/0123_chpinputs_existing_kw_and_more.py

@@ -0,0 +1,121 @@
+# Generated by Django 4.2.26 on 2026-08-04 22:24
+
+import django.contrib.postgres.fields
+import django.core.validators
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('reoptjl', '0122_merge_20260804_1339'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='chpinputs',
+            name='existing_kw',
+            field=models.FloatField(blank=True, default=0, help_text='Existing CHP electric capacity (based on rated electric power)', validators=[django.core.validators.MinValueValidator(0), django.core.validators.MaxValueValidator(100000.0)]),
+        ),
+        migrations.AddField(
+            model_name='chpinputs',
+            name='fuel_cost_escalation_rate_fraction',
+            field=models.FloatField(blank=True, help_text='Annual nominal chp fuel cost escalation rate, as a decimal.', null=True, validators=[django.core.validators.MinValueValidator(-1.0), django.core.validators.MaxValueValidator(1.0)]),
+        ),
+        migrations.AddField(
+            model_name='chpinputs',
+            name='name',
+            field=models.TextField(blank=True, default='CHP', help_text='CHP description for distinguishing between multiple CHP models'),
+        ),
+        migrations.AddField(
+            model_name='chpinputs',
+            name='operating_reserve_required_fraction',
+            field=models.FloatField(blank=True, help_text='Only applicable when off_grid_flag=True. Required operating reserves applied to each timestep as a fraction of CHP generation serving load in that timestep.', null=True, validators=[django.core.validators.MinValueValidator(0.0), django.core.validators.MaxValueValidator(1.0)]),
+        ),
+        migrations.AddField(
+            model_name='chpinputs',
+            name='production_factor_series',
+            field=django.contrib.postgres.fields.ArrayField(base_field=models.FloatField(blank=True), blank=True, default=list, help_text='Optional user-defined production factors. Must be normalized to units of kW-AC/kW-AC nameplate, representing the AC power (kW) output per 1 kW-AC of CHP capacity in each time step. The series must be one year (January through December) of hourly, 30-minute, or 15-minute data.', size=None),
+        ),
+        migrations.AddField(
+            model_name='chpinputs',
+            name='ramp_rate_fraction_per_hour',
+            field=models.FloatField(blank=True, default=1.0, help_text='Maximum rate of change in electric production per hour as a fraction of size_kw [kW/size_kw/hour].', validators=[django.core.validators.MinValueValidator(0.0), django.core.validators.MaxValueValidator(1000.0)]),
+        ),
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='annual_electric_production_kwh_bau',
+            field=models.FloatField(blank=True, help_text='Electric energy produced in a year by the existing CHP system in BAU [kWh]', null=True),
+        ),
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='annual_fuel_consumption_mmbtu_bau',
+            field=models.FloatField(blank=True, help_text='Fuel consumed in a year by the existing CHP system in BAU [MMBtu]', null=True),
+        ),
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='annual_thermal_production_mmbtu_bau',
+            field=models.FloatField(blank=True, help_text='Thermal energy produced in a year by the existing CHP system in BAU [MMBtu]', null=True),
+        ),
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='lifecycle_fuel_cost_after_tax_bau',
+            field=models.FloatField(blank=True, help_text='Present value of cost of fuel consumed by the existing CHP system in BAU, after tax [$]', null=True),
+        ),
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='lifecycle_standby_cost_after_tax_bau',
+            field=models.FloatField(blank=True, help_text='Present value of all CHP standby charges for the existing CHP system in BAU, after tax.', null=True),
+        ),
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='name',
+            field=models.TextField(blank=True, default='CHP', help_text='CHP description for distinguishing between multiple CHP models'),
+        ),
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='size_kw_bau',
+            field=models.FloatField(blank=True, help_text='Power capacity size of the existing CHP system in BAU [kW]', null=True),
+        ),
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='year_one_fuel_cost_after_tax_bau',
+            field=models.FloatField(blank=True, help_text='Cost of fuel consumed by the existing CHP system in year one in BAU, after tax [$]', null=True),
+        ),
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='year_one_fuel_cost_before_tax_bau',
+            field=models.FloatField(blank=True, help_text='Cost of fuel consumed by the existing CHP system in year one in BAU [$]', null=True),
+        ),
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='year_one_standby_cost_after_tax_bau',
+            field=models.FloatField(blank=True, help_text='CHP standby charges in year one for the existing CHP system in BAU, after tax [$]', null=True),
+        ),
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='year_one_standby_cost_before_tax_bau',
+            field=models.FloatField(blank=True, help_text='CHP standby charges in year one for the existing CHP system in BAU [$]', null=True),
+        ),
+        migrations.AlterField(
+            model_name='chpinputs',
+            name='max_kw',
+            field=models.FloatField(blank=True, help_text='Maximum new CHP size (in kWe) constraint for optimization (upper bound on additional capacity beyond existing_kw). Set to zero to disable CHP', null=True, validators=[django.core.validators.MinValueValidator(0.0), django.core.validators.MaxValueValidator(100000000.0)]),
+        ),
+        migrations.AlterField(
+            model_name='chpinputs',
+            name='meta',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='CHPInputs', to='reoptjl.apimeta'),
+        ),
+        migrations.AlterField(
+            model_name='chpinputs',
+            name='min_kw',
+            field=models.FloatField(blank=True, default=0, help_text='Minimum new CHP size constraint for optimization (lower bound on additional capacity beyond existing_kw).', validators=[django.core.validators.MinValueValidator(0), django.core.validators.MaxValueValidator(1000000000.0)]),
+        ),
+        migrations.AlterField(
+            model_name='chpoutputs',
+            name='meta',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='CHPOutputs', to='reoptjl.apimeta'),
+        ),
+    ]

reoptjl/migrations/0124_chpinputs_follow_heating_load.py

@@ -0,0 +1,18 @@
+# Generated by Django 4.2.26 on 2026-08-05 14:19
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('reoptjl', '0123_chpinputs_existing_kw_and_more'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='chpinputs',
+            name='follow_heating_load',
+            field=models.BooleanField(blank=True, default=False, help_text='Boolean indicator if CHP follows the heating load by running at capacity or meeting the load only', null=True),
+        ),
+    ]

reoptjl/migrations/0125_chpoutputs_annual_thermal_curtailed_mmbtu_and_more.py

@@ -0,0 +1,23 @@
+# Generated by Django 4.2.26 on 2026-08-10 22:35
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('reoptjl', '0124_chpinputs_follow_heating_load'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='annual_thermal_curtailed_mmbtu',
+            field=models.FloatField(blank=True, help_text='Thermal energy wasted/unused/vented in a year [MMBtu]', null=True),
+        ),
+        migrations.AddField(
+            model_name='chpoutputs',
+            name='annual_thermal_curtailed_mmbtu_bau',
+            field=models.FloatField(blank=True, help_text='Thermal energy wasted/unused/vented in a year by the existing CHP system in BAU [MMBtu]', null=True),
+        ),
+    ]