urbanopt-reopt 0.11.0 → 0.12.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -3,545 +3,470 @@
3
3
  "description": "Data Dictionary for REopt Outputs",
4
4
  "type": "object",
5
5
  "properties": {
6
- "$ref": "#/definitions/Response"
7
- },
8
- "required": [
9
- "Scenario"
10
- ],
11
- "definitions": {
12
6
  "Response": {
13
7
  "inputs": {
14
8
  "type": "object",
15
- "properties": {
16
- "Scenario": {
17
- "type": "object",
18
- "description": "See REopt Input Schema"
19
- }
20
- }
21
- },
9
+ "description": "See REopt Input Schema"
10
+ },
22
11
  "outputs": {
23
12
  "type": "object",
24
13
  "properties": {
25
- "Scenario": {
14
+ "run_uuid": {
15
+ "type": "string",
16
+ "description": "Unique id",
17
+ "units": "none"
18
+ },
19
+ "api_version": {
20
+ "type": "str"
21
+ },
22
+ "status": {
23
+ "type": "string",
24
+ "description": "Problem Status",
25
+ "units": "none"
26
+ },
27
+ "Profile": {
28
+ "type": "object",
29
+ "properties": {
30
+ "reopt_seconds": {
31
+ "type": "number",
32
+ "description": "Time spent solving scenario | UNUSED as of 2024-04-02",
33
+ "units": "seconds"
34
+ },
35
+ "reopt_bau_seconds": {
36
+ "type": "number",
37
+ "description": "Time spent solving base-case scenario | UNUSED as of 2024-04-02",
38
+ "units": "seconds"
39
+ }
40
+ }
41
+ },
42
+ "Site": {
26
43
  "type": "object",
27
44
  "properties": {
28
- "run_uuid": {
29
- "type": "str",
30
- "description": "Unique id",
45
+ "renewable_electricity_fraction": {
46
+ "type": "number",
47
+ "description": "Fraction of annual renewable electricity - 0 for none, 1 for all, over 1 for more generated than consumed",
31
48
  "units": "none"
49
+ }
50
+ }
51
+ },
52
+ "ElectricLoad": {
53
+ "type": "object",
54
+ "properties": {
55
+ "load_series_kw": {
56
+ "type": "array",
57
+ "description": "Year one hourly time series of electric load",
58
+ "units": "kW"
32
59
  },
33
- "api_version": {
34
- "type": "str"
60
+ "critical_load_series_kw": {
61
+ "type": "array",
62
+ "description": "Hourly critical load for outage simulator. Values are either uploaded by user, or determined from typical load (either uploaded or simulated) and critical_load_fraction.",
63
+ "units": "kW"
35
64
  },
36
- "status": {
37
- "type": "str",
38
- "description": "Problem Status",
39
- "units": "none"
65
+ "annual_calculated_kwh": {
66
+ "type": "number",
67
+ "description": "Annual energy consumption calculated by summing up 8760 load profile",
68
+ "units": "kWh"
69
+ }
70
+ }
71
+ },
72
+ "Financial": {
73
+ "type": "object",
74
+ "properties": {
75
+ "lcc": {
76
+ "type": "number",
77
+ "description": "Optimal lifecycle cost",
78
+ "units": "dollars"
79
+ },
80
+ "lcc_bau": {
81
+ "type": "number",
82
+ "description": "Business as usual lifecycle cost",
83
+ "units": "dollars"
84
+ },
85
+ "npv": {
86
+ "type": "number",
87
+ "description": "Net present value of savings realized by the project",
88
+ "units": "dollars"
89
+ },
90
+ "lifecycle_capital_costs_plus_om_after_tax": {
91
+ "type": "number",
92
+ "description": "Capital cost for all technologies plus present value of operations and maintenance over anlaysis period",
93
+ "units": "$"
40
94
  },
41
- "Profile": {
42
- "type": "object",
43
- "properties": {
44
- "pre_setup_scenario_seconds": {
45
- "type": "float",
46
- "description": "Time spent before setting up scenario",
47
- "units": "seconds"
48
- },
49
- "setup_scenario_seconds": {
50
- "type": "float",
51
- "description": "Time spent setting up scenario",
52
- "units": "seconds"
53
- },
54
- "reopt_seconds": {
55
- "type": "float",
56
- "description": "Time spent solving scenario",
57
- "units": "seconds"
58
- },
59
- "reopt_bau_seconds": {
60
- "type": "float",
61
- "description": "Time spent solving base-case scenario",
62
- "units": "seconds"
63
- },
64
- "parse_run_outputs_seconds": {
65
- "type": "float",
66
- "description": "Time spent parsing outputs",
67
- "units": "seconds"
68
- }
69
- }
70
- },
71
- "Site": {
72
- "type": "object",
73
- "properties": {
74
- "annual_renewable_electricity_pct": {
75
- "type": "float",
76
- "description": "Fraction of annual renewable electricity - 0 for none, 1 for all, over 1 for more generated than consumed",
77
- "units": "none"
78
- },
79
- "LoadProfile": {
80
- "type": "object",
81
- "properties": {
82
- "year_one_electric_load_series_kw": {
83
- "type": "list_of_float",
84
- "description": "Year one hourly time series of electric load",
85
- "units": "kW"
86
- },
87
- "critical_load_series_kw": {
88
- "type": "list_of_float",
89
- "description": "Hourly critical load for outage simulator. Values are either uploaded by user, or determined from typical load (either uploaded or simulated) and critical_load_pct.",
90
- "units": "kW"
91
- },
92
- "annual_calculated_kwh": {
93
- "type": "float",
94
- "description": "Annual energy consumption calculated by summing up 8760 load profile",
95
- "units": "kWh"
96
- },
97
- "resilience_check_flag": {
98
- "type": "boolean",
99
- "description": "BAU resilience check status for existing system"
100
- },
101
- "sustain_hours": {
102
- "type": "int",
103
- "description": "Number of hours the existing system can sustain with resilience check",
104
- "units": "hours"
105
- }
106
- }
107
- },
108
- "Financial": {
109
- "type": "object",
110
- "properties": {
111
- "lcc_us_dollars": {
112
- "type": "float",
113
- "description": "Optimal lifecycle cost",
114
- "units": "dollars"
115
- },
116
- "lcc_bau_us_dollars": {
117
- "type": "float",
118
- "description": "Business as usual lifecycle cost",
119
- "units": "dollars"
120
- },
121
- "npv_us_dollars": {
122
- "type": "float",
123
- "description": "Net present value of savings realized by the project",
124
- "units": "dollars"
125
- },
126
- "net_capital_costs_plus_om_us_dollars": {
127
- "type": "float",
128
- "description": "Capital cost for all technologies plus present value of operations and maintenance over anlaysis period",
129
- "units": "$"
130
- },
131
- "avoided_outage_costs_us_dollars": {
132
- "type": "float",
133
- "description": "Avoided outage costs are determined using the Value of Lost Load [$/kWh], multiplied by the average critical load in kW (determined using critical_load_pct), the average hours that the critical load is sustained (determined by simulating outages starting at every hour of the year), and a present worth factor that accounts for cost growth with escalation_pct over the analysis_years and discounts the avoided costs to present value using offtaker_discount_pct. Note that the use of a present worth factor presumes that the outage period and the microgrid's ability to meet the critical load is the same each year in the analysis_years.If outage_is_major_event is set to true, then the present worth factor is set to 1, which assumes that only one outage occurs in the analysis_years.",
134
- "units": "$"
135
- },
136
- "net_capital_costs": {
137
- "type": "float",
138
- "description": "Capital cost for all technologies.",
139
- "units": "$"
140
- },
141
- "microgrid_upgrade_cost_us_dollars": {
142
- "type": "float",
143
- "description": "Cost in US dollars to make a distributed energy system islandable from the grid.Determined by multiplying the total capital costs of resultant energy systems from REopt(such as PV and Storage system) with the input valuefor microgrid_upgrade_cost_pct(which defaults to 0.30)."
144
- }
145
- }
146
- },
147
- "PV": {
148
- "type": "object",
149
- "properties": {
150
- "location": {
151
- "default": "roof",
152
- "type": "string",
153
- "description": "Indicates location of PV. Available options are roof and ground."
154
- },
155
- "size_kw": {
156
- "type": "float",
157
- "description": "Optimal PV system size",
158
- "units": "kW"
159
- },
160
- "average_yearly_energy_produced_kwh": {
161
- "type": "float",
162
- "description": "Average annual energy produced by the PV system over one year",
163
- "units": "kWh"
164
- },
165
- "average_yearly_energy_exported_kwh": {
166
- "type": "float",
167
- "description": "Average annual energy exported by the PV system",
168
- "units": "kWh"
169
- },
170
- "year_one_energy_produced_kwh": {
171
- "type": "float",
172
- "description": "Year one energy produced by the PV system",
173
- "units": "kWh"
174
- },
175
- "year_one_power_production_series_kw": {
176
- "type": "list_of_float",
177
- "description": "Year one PV power production time series",
178
- "units": "kW"
179
- },
180
- "year_one_to_battery_series_kw": {
181
- "type": "list_of_float",
182
- "description": "Year one hourly time series of PV charging",
183
- "units": "kW"
184
- },
185
- "year_one_to_load_series_kw": {
186
- "type": "list_of_float",
187
- "description": "Year one hourly time series of PV serving load",
188
- "units": "kW"
189
- },
190
- "year_one_to_grid_series_kw": {
191
- "type": "list_of_float",
192
- "description": "Year one hourly time series of PV exporting to grid",
193
- "units": "kW"
194
- },
195
- "existing_pv_om_cost_us_dollars": {
196
- "type": "float",
197
- "description": "Lifetime O & M costfor existing PV system.",
198
- "units": "$"
199
- },
200
- "station_latitude": {
201
- "type": "float",
202
- "description": "The latitude of the station usedfor weather resource data",
203
- "units": "degrees"
204
- },
205
- "station_longitude": {
206
- "type": "float",
207
- "description": "The longitude of the station usedfor weather resource data",
208
- "units": "degrees"
209
- },
210
- "station_distance_km": {
211
- "type": "float",
212
- "description": "The distance from the weather resource station from the input site",
213
- "units": "km"
214
- }
215
- }
216
- },
217
- "Wind": {
218
- "type": "object",
219
- "properties": {
220
- "size_kw": {
221
- "type": "float",
222
- "description": "Recommended wind system size",
223
- "units": "kW"
224
- },
225
- "average_yearly_energy_produced_kwh": {
226
- "type": "float",
227
- "description": "Average energy produced by the wind system over one year",
228
- "units": "kWh"
229
- },
230
- "average_yearly_energy_exported_kwh": {
231
- "type": "float",
232
- "description": "Average annual energy exported by the wind system",
233
- "units": "kWh"
234
- },
235
- "year_one_energy_produced_kwh": {
236
- "type": "float",
237
- "description": "Wind energy produced in year one",
238
- "units": "kWh"
239
- },
240
- "year_one_power_production_series_kw": {
241
- "type": "list_of_float",
242
- "description": "Hourly wind resource",
243
- "units": "kW"
244
- },
245
- "year_one_to_battery_series_kw": {
246
- "type": "list_of_float",
247
- "description": "Year one wind to battery time series",
248
- "units": "kW"
249
- },
250
- "year_one_to_load_series_kw": {
251
- "type": "list_of_float",
252
- "description": "Year one wind to load time series",
253
- "units": "kW"
254
- },
255
- "year_one_to_grid_series_kw": {
256
- "type": "list_of_float",
257
- "description": "Year one wind to grid time series",
258
- "units": "kW"
259
- }
260
- }
261
- },
262
- "Storage": {
263
- "type": "object",
264
- "properties": {
265
- "size_kw": {
266
- "type": "float",
267
- "description": "Optimal battery power capacity",
268
- "units": "kW"
269
- },
270
- "size_kwh": {
271
- "type": "float",
272
- "description": "Optimal battery energy capacity",
273
- "units": "kWh"
274
- },
275
- "year_one_to_load_series_kw": {
276
- "type": "list_of_float",
277
- "description": "Year one hourly time series of battery serving load",
278
- "units": "kW"
279
- },
280
- "year_one_to_grid_series_kw": {
281
- "type": "list_of_float",
282
- "description": "Year one hourly time series of battery exporting to grid",
283
- "units": "kW"
284
- },
285
- "year_one_soc_series_pct": {
286
- "type": "list_of_float",
287
- "description": "Year one hourly time series of battery state of charge",
288
- "units": " %"
289
- }
290
- }
291
- },
292
- "ElectricTariff": {
293
- "type": "object",
294
- "properties": {
295
- "year_one_energy_cost_us_dollars": {
296
- "type": "float",
297
- "description": "Optimal year one utility energy cost",
298
- "units": "$"
299
- },
300
- "year_one_demand_cost_us_dollars": {
301
- "type": "float",
302
- "description": "Optimal year one utility demand cost",
303
- "units": "$"
304
- },
305
- "year_one_fixed_cost_us_dollars": {
306
- "type": "float",
307
- "description": "Optimal year one utility fixed cost",
308
- "units": "$"
309
- },
310
- "year_one_min_charge_adder_us_dollars": {
311
- "type": "float",
312
- "description": "Optimal year one utility minimum charge adder",
313
- "units": "$"
314
- },
315
- "year_one_energy_cost_bau_us_dollars": {
316
- "type": "float",
317
- "description": "Business as usual year one utility energy cost",
318
- "units": "$"
319
- },
320
- "year_one_demand_cost_bau_us_dollars": {
321
- "type": "float",
322
- "description": "Business as usual year one utility demand cost",
323
- "units": "$"
324
- },
325
- "year_one_fixed_cost_bau_us_dollars": {
326
- "type": "float",
327
- "description": "Business as usual year one utility fixed cost",
328
- "units": "$"
329
- },
330
- "year_one_min_charge_adder_bau_us_dollars": {
331
- "type": "float",
332
- "description": "Business as usual year one utility minimum charge adder",
333
- "units": "$"
334
- },
335
- "total_energy_cost_us_dollars": {
336
- "type": "float",
337
- "description": "Total utility energy cost over the lifecycle,after - tax",
338
- "units": "$"
339
- },
340
- "total_demand_cost_us_dollars": {
341
- "type": "float",
342
- "description": "Optimal total lifecycle utility demand cost over the analysis period,after - tax",
343
- "units": "$"
344
- },
345
- "total_fixed_cost_us_dollars": {
346
- "type": "float",
347
- "description": "Total utility fixed cost over the lifecycle,after - tax",
348
- "units": "$"
349
- },
350
- "total_min_charge_adder_us_dollars": {
351
- "type": "float",
352
- "description": "Total utility minimum charge adder",
353
- "units": "$"
354
- },
355
- "total_energy_cost_bau_us_dollars": {
356
- "type": "float",
357
- "description": "Business as usual total utility energy cost over the lifecycle,after - tax",
358
- "units": "$"
359
- },
360
- "total_demand_cost_bau_us_dollars": {
361
- "type": "float",
362
- "description": "Business as usual total lifecycle utility demand cost over the analysis period,after - tax",
363
- "units": "$"
364
- },
365
- "total_fixed_cost_bau_us_dollars": {
366
- "type": "float",
367
- "description": "Business as usual total utility fixed cost over the lifecycle,after - tax",
368
- "units": "$"
369
- },
370
- "total_export_benefit_us_dollars": {
371
- "type": "float",
372
- "description": "Totalexport benefit cost over the lifecycle,after - tax",
373
- "units": "$"
374
- },
375
- "total_min_charge_adder_bau_us_dollars": {
376
- "type": "float",
377
- "description": "Business as usual total utility minimum charge adder",
378
- "units": "$"
379
- },
380
- "year_one_bill_us_dollars": {
381
- "type": "float",
382
- "description": "Optimal year one total utility bill",
383
- "units": "$"
384
- },
385
- "year_one_bill_bau_us_dollars": {
386
- "type": "float",
387
- "description": "Business as usual year one total utility bill",
388
- "units": "$"
389
- },
390
- "year_one_export_benefit_us_dollars": {
391
- "type": "float",
392
- "description": "Optimal year one value of exported energy",
393
- "units": "$"
394
- },
395
- "year_one_energy_cost_series_us_dollars_per_kwh": {
396
- "type": "list_of_float",
397
- "description": "Year one hourly energy costs",
398
- "units": "$ / kWh"
399
- },
400
- "year_one_demand_cost_series_us_dollars_per_kw": {
401
- "type": "list_of_float",
402
- "description": "Year one hourly demand costs",
403
- "units": "$ / kW"
404
- },
405
- "year_one_to_load_series_kw": {
406
- "type": "list_of_float",
407
- "description": "Year one grid to load time series",
408
- "units": "kW"
409
- },
410
- "year_one_to_battery_series_kw": {
411
- "type": "list_of_float",
412
- "description": "Year one hourly time series of power from grid to battery",
413
- "units": "kW"
414
- },
415
- "year_one_energy_supplied_kwh": {
416
- "type": "float",
417
- "description": "Year one hourly time series of power from grid to load",
418
- "units": "kWh"
419
- },
420
- "year_one_energy_supplied_kwh_bau": {
421
- "type": "float",
422
- "description": "Year one hourly time series of power from grid to load in bau scenario",
423
- "units": "kWh"
424
- }
425
- }
426
- },
427
- "Generator": {
428
- "type": "object",
429
- "properties": {
430
- "size_kw": {
431
- "type": "float",
432
- "description": "Optimal diesel generator system size",
433
- "units": "kW"
434
- },
435
- "fuel_used_gal": {
436
- "type": "float",
437
- "description": "Generator fuel used to meet critical load during grid outage.",
438
- "units": "US gallons"
439
- },
440
- "fuel_used_gal_bau": {
441
- "type": "float",
442
- "description": "Generator fuel used to meet critical load during grid outage in baucase.",
443
- "units": "US gallons"
444
- },
445
- "average_yearly_energy_produced_kwh": {
446
- "type": "float",
447
- "description": "Average annual energy produced by the diesel generator over one year",
448
- "units": "kWh"
449
- },
450
- "average_yearly_energy_exported_kwh": {
451
- "type": "float",
452
- "description": "Average annual energy exported by the diesel generator",
453
- "units": "kWh"
454
- },
455
- "year_one_energy_produced_kwh": {
456
- "type": "float",
457
- "description": "Year one energy produced by the diesel generator",
458
- "units": "kWh"
459
- },
460
- "year_one_power_production_series_kw": {
461
- "type": "list_of_float",
462
- "description": "Year one diesel generator power production time series",
463
- "units": "kW"
464
- },
465
- "year_one_to_battery_series_kw": {
466
- "type": "list_of_float",
467
- "description": "Year one hourly time series of diesel generator charging",
468
- "units": "kW"
469
- },
470
- "year_one_to_load_series_kw": {
471
- "type": "list_of_float",
472
- "description": "Year one generator to load time series.",
473
- "units": "kW"
474
- },
475
- "year_one_to_grid_series_kw": {
476
- "type": "list_of_float",
477
- "description": "Year one hourly time series of diesel generator exporting to grid",
478
- "units": "kW"
479
- },
480
- "existing_gen_total_fixed_om_cost_us_dollars": {
481
- "type": "float",
482
- "description": "Lifetime fixed O & M costfor existing diesel generator system in baucase.",
483
- "units": "$"
484
- },
485
- "existing_gen_total_variable_om_cost_us_dollars": {
486
- "type": "float",
487
- "description": "Lifetime variable(based on kwh produced) O & M costfor existing diesel generator system.",
488
- "units": "$"
489
- },
490
- "existing_gen_year_one_variable_om_cost_us_dollars": {
491
- "type": "float",
492
- "description": "Year one variable(based on kwh produced) O & M costfor existing diesel generator system.",
493
- "units": "$"
494
- },
495
- "total_variable_om_cost_us_dollars": {
496
- "type": "float",
497
- "description": "Total lifecycle variable(based on kwh produced) O & M costfor existing + newly recommended diesel generator system",
498
- "units": "$"
499
- },
500
- "year_one_variable_om_cost_us_dollars": {
501
- "type": "float",
502
- "description": "Year one variable(based on kwh produced) O & M costfor existing + newly recommended diesel generator system",
503
- "units": "$"
504
- },
505
- "total_fuel_cost_us_dollars": {
506
- "type": "float",
507
- "description": "Total lifecycle fuel costfor existing + newly recommended diesel generator system",
508
- "units": "$"
509
- },
510
- "year_one_fuel_cost_us_dollars": {
511
- "type": "float",
512
- "description": "Year one fuel costfor existing + newly recommended diesel generator system",
513
- "units": "$"
514
- },
515
- "existing_gen_total_fuel_cost_us_dollars": {
516
- "type": "float",
517
- "description": "Total lifecycle fuel costfor existing diesel generator system",
518
- "units": "$"
519
- },
520
- "existing_gen_year_one_fuel_cost_us_dollars": {
521
- "type": "float",
522
- "description": "Year one fuel costfor existing diesel generator system",
523
- "units": "$"
524
- }
525
- }
526
- }
527
- }
95
+ "lifecycle_capital_costs": {
96
+ "type": "number",
97
+ "description": "Capital cost for all technologies.",
98
+ "units": "$"
99
+ },
100
+ "lifecycle_MG_upgrade_and_fuel_cost": {
101
+ "type": "number",
102
+ "description": "Cost in US dollars to make a distributed energy system islandable from the grid. Determined by multiplying the total capital costs of resultant energy systems from REopt (such as PV and Storage system) with the input value for microgrid_upgrade_cost_fraction (which defaults to 0.30)."
528
103
  }
529
104
  }
530
- }
531
- }
532
- },
533
- "messages": {
534
- "type": "object",
535
- "properties": {
536
- "warnings": {
537
- "type": "list_of_string",
538
- "description": "Warnings generated by simulation"
539
- },
540
- "error": {
541
- "type": "str",
542
- "description": "Error generated by simulation"
105
+ },
106
+ "PV": {
107
+ "type": "object",
108
+ "properties": {
109
+ "location": {
110
+ "default": "roof",
111
+ "type": "string",
112
+ "description": "Indicates location of PV. Available options are roof and ground."
113
+ },
114
+ "size_kw": {
115
+ "type": "number",
116
+ "description": "Optimal PV system size",
117
+ "units": "kW"
118
+ },
119
+ "annual_energy_produced_kwh": {
120
+ "type": "number",
121
+ "description": "Average annual energy produced by the PV system over one year",
122
+ "units": "kWh"
123
+ },
124
+ "annual_energy_exported_kwh": {
125
+ "type": "number",
126
+ "description": "Average annual energy exported by the PV system",
127
+ "units": "kWh"
128
+ },
129
+ "year_one_energy_produced_kwh": {
130
+ "type": "number",
131
+ "description": "Year one energy produced by the PV system",
132
+ "units": "kWh"
133
+ },
134
+ "electric_to_storage_series_kw": {
135
+ "type": "array",
136
+ "description": "Year one hourly time series of PV charging",
137
+ "units": "kW"
138
+ },
139
+ "electric_to_load_series_kw": {
140
+ "type": "array",
141
+ "description": "Year one hourly time series of PV serving load",
142
+ "units": "kW"
143
+ },
144
+ "electric_to_grid_series_kw": {
145
+ "type": "array",
146
+ "description": "Year one hourly time series of PV exporting to grid",
147
+ "units": "kW"
148
+ },
149
+ "lifecycle_om_cost_after_tax_bau": {
150
+ "type": "number",
151
+ "description": "Lifetime O & M costfor existing PV system.",
152
+ "units": "$"
153
+ },
154
+ "station_latitude": {
155
+ "type": "number",
156
+ "description": "The latitude of the station usedfor weather resource data",
157
+ "units": "degrees"
158
+ },
159
+ "station_longitude": {
160
+ "type": "number",
161
+ "description": "The longitude of the station usedfor weather resource data",
162
+ "units": "degrees"
163
+ },
164
+ "station_distance_km": {
165
+ "type": "number",
166
+ "description": "The distance from the weather resource station from the input site",
167
+ "units": "km"
168
+ }
169
+ }
170
+ },
171
+ "Wind": {
172
+ "type": "object",
173
+ "properties": {
174
+ "size_kw": {
175
+ "type": "number",
176
+ "description": "Recommended wind system size",
177
+ "units": "kW"
178
+ },
179
+ "annual_energy_produced_kwh": {
180
+ "type": "number",
181
+ "description": "Energy produced by the wind system over one year",
182
+ "units": "kWh"
183
+ },
184
+ "annual_energy_exported_kwh": {
185
+ "type": "number",
186
+ "description": "Average annual energy exported by the wind system",
187
+ "units": "kWh"
188
+ },
189
+ "electric_to_storage_series_kw": {
190
+ "type": "array",
191
+ "description": "Year one wind to battery time series",
192
+ "units": "kW"
193
+ },
194
+ "electric_to_load_series_kw": {
195
+ "type": "array",
196
+ "description": "Year one wind to load time series",
197
+ "units": "kW"
198
+ },
199
+ "electric_to_grid_series_kw": {
200
+ "type": "array",
201
+ "description": "Year one wind to grid time series",
202
+ "units": "kW"
203
+ }
204
+ }
205
+ },
206
+ "ElectricStorage": {
207
+ "type": "object",
208
+ "properties": {
209
+ "size_kw": {
210
+ "type": "number",
211
+ "description": "Optimal battery power capacity",
212
+ "units": "kW"
213
+ },
214
+ "size_kwh": {
215
+ "type": "number",
216
+ "description": "Optimal battery energy capacity",
217
+ "units": "kWh"
218
+ },
219
+ "storage_to_load_series_kw": {
220
+ "type": "array",
221
+ "description": "Year one hourly time series of battery serving load",
222
+ "units": "kW"
223
+ },
224
+ "electric_to_grid_series_kw": {
225
+ "type": "array",
226
+ "description": "Year one hourly time series of battery exporting to grid",
227
+ "units": "kW"
228
+ },
229
+ "soc_series_fraction": {
230
+ "type": "array",
231
+ "description": "Year one hourly time series of battery state of charge",
232
+ "units": " %"
233
+ }
234
+ }
235
+ },
236
+ "ElectricTariff": {
237
+ "type": "object",
238
+ "properties": {
239
+ "year_one_energy_cost_before_tax": {
240
+ "type": "number",
241
+ "description": "Optimal year one utility energy cost",
242
+ "units": "$"
243
+ },
244
+ "year_one_demand_cost_before_tax": {
245
+ "type": "number",
246
+ "description": "Optimal year one utility demand cost",
247
+ "units": "$"
248
+ },
249
+ "year_one_fixed_cost_before_tax": {
250
+ "type": "number",
251
+ "description": "Optimal year one utility fixed cost",
252
+ "units": "$"
253
+ },
254
+ "year_one_min_charge_adder_before_tax": {
255
+ "type": "number",
256
+ "description": "Optimal year one utility minimum charge adder",
257
+ "units": "$"
258
+ },
259
+ "year_one_energy_cost_before_tax_bau": {
260
+ "type": "number",
261
+ "description": "Business as usual year one utility energy cost",
262
+ "units": "$"
263
+ },
264
+ "year_one_demand_cost_before_tax_bau": {
265
+ "type": "number",
266
+ "description": "Business as usual year one utility demand cost",
267
+ "units": "$"
268
+ },
269
+ "year_one_fixed_cost_before_tax_bau": {
270
+ "type": "number",
271
+ "description": "Business as usual year one utility fixed cost",
272
+ "units": "$"
273
+ },
274
+ "year_one_min_charge_adder_before_tax_bau": {
275
+ "type": "number",
276
+ "description": "Business as usual year one utility minimum charge adder",
277
+ "units": "$"
278
+ },
279
+ "lifecycle_energy_cost_after_tax": {
280
+ "type": "number",
281
+ "description": "Total utility energy cost over the lifecycle,after - tax",
282
+ "units": "$"
283
+ },
284
+ "lifecycle_demand_cost_after_tax": {
285
+ "type": "number",
286
+ "description": "Optimal total lifecycle utility demand cost over the analysis period,after - tax",
287
+ "units": "$"
288
+ },
289
+ "lifecycle_fixed_cost_after_tax": {
290
+ "type": "number",
291
+ "description": "Total utility fixed cost over the lifecycle,after - tax",
292
+ "units": "$"
293
+ },
294
+ "lifecycle_min_charge_adder_after_tax": {
295
+ "type": "number",
296
+ "description": "Total utility minimum charge adder",
297
+ "units": "$"
298
+ },
299
+ "lifecycle_energy_cost_after_tax_bau": {
300
+ "type": "number",
301
+ "description": "Business as usual total utility energy cost over the lifecycle,after - tax",
302
+ "units": "$"
303
+ },
304
+ "lifecycle_demand_cost_after_tax_bau": {
305
+ "type": "number",
306
+ "description": "Business as usual total lifecycle utility demand cost over the analysis period,after - tax",
307
+ "units": "$"
308
+ },
309
+ "lifecycle_fixed_cost_after_tax_bau": {
310
+ "type": "number",
311
+ "description": "Business as usual total utility fixed cost over the lifecycle,after - tax",
312
+ "units": "$"
313
+ },
314
+ "lifecycle_export_benefit_after_tax": {
315
+ "type": "number",
316
+ "description": "Totalexport benefit cost over the lifecycle,after - tax",
317
+ "units": "$"
318
+ },
319
+ "lifecycle_min_charge_adder_after_tax_bau": {
320
+ "type": "number",
321
+ "description": "Business as usual total utility minimum charge adder",
322
+ "units": "$"
323
+ },
324
+ "year_one_bill_before_tax": {
325
+ "type": "number",
326
+ "description": "Optimal year one total utility bill",
327
+ "units": "$"
328
+ },
329
+ "year_one_bill_before_tax_bau": {
330
+ "type": "number",
331
+ "description": "Business as usual year one total utility bill",
332
+ "units": "$"
333
+ },
334
+ "year_one_export_benefit_before_tax": {
335
+ "type": "number",
336
+ "description": "Optimal year one value of exported energy",
337
+ "units": "$"
338
+ },
339
+ "year_one_energy_cost_series_us_dollars_per_kwh": {
340
+ "type": "array",
341
+ "description": "Year one hourly energy costs | UNUSED as of 2024-04-02",
342
+ "units": "$ / kWh"
343
+ },
344
+ "year_one_demand_cost_series_us_dollars_per_kw": {
345
+ "type": "array",
346
+ "description": "Year one hourly demand costs | UNUSED as of 2024-04-02",
347
+ "units": "$ / kW"
348
+ }
349
+ }
350
+ },
351
+ "ElectricUtility": {
352
+ "type": "object",
353
+ "properties": {
354
+ "electric_to_load_series_kw": {
355
+ "type": "array",
356
+ "description": "Year one grid to load time series",
357
+ "units": "kW"
358
+ },
359
+ "annual_energy_supplied_kwh": {
360
+ "type": "number",
361
+ "description": "Year one hourly time series of power from grid to load",
362
+ "units": "kWh"
363
+ },
364
+ "annual_energy_supplied_kwh_bau": {
365
+ "type": "number",
366
+ "description": "Year one hourly time series of power from grid to load in bau scenario",
367
+ "units": "kWh"
368
+ }
369
+ }
370
+ },
371
+ "Generator": {
372
+ "type": "object",
373
+ "properties": {
374
+ "size_kw": {
375
+ "type": "number",
376
+ "description": "Optimal diesel generator system size",
377
+ "units": "kW"
378
+ },
379
+ "fuel_used_gal": {
380
+ "type": "number",
381
+ "description": "Generator fuel used to meet critical load during grid outage.",
382
+ "units": "US gallons"
383
+ },
384
+ "fuel_used_gal_bau": {
385
+ "type": "number",
386
+ "description": "Generator fuel used to meet critical load during grid outage in baucase.",
387
+ "units": "US gallons"
388
+ },
389
+ "annual_energy_produced_kwh": {
390
+ "type": "number",
391
+ "description": "Year one energy produced by the diesel generator",
392
+ "units": "kWh"
393
+ },
394
+ "electric_to_storage_series_kw": {
395
+ "type": "array",
396
+ "description": "Year one hourly time series of diesel generator charging",
397
+ "units": "kW"
398
+ },
399
+ "electric_to_load_series_kw": {
400
+ "type": "array",
401
+ "description": "Year one generator to load time series.",
402
+ "units": "kW"
403
+ },
404
+ "electric_to_grid_series_kw": {
405
+ "type": "array",
406
+ "description": "Year one hourly time series of diesel generator exporting to grid",
407
+ "units": "kW"
408
+ },
409
+ "lifecycle_fixed_om_cost_bau": {
410
+ "type": "number",
411
+ "description": "Lifetime fixed O & M costfor existing diesel generator system in baucase.",
412
+ "units": "$"
413
+ },
414
+ "lifecycle_variable_om_cost_after_tax_bau": {
415
+ "type": "number",
416
+ "description": "Lifetime variable(based on kwh produced) O & M costfor existing diesel generator system.",
417
+ "units": "$"
418
+ },
419
+ "year_one_variable_om_cost_before_tax_bau": {
420
+ "type": "number",
421
+ "description": "Year one variable(based on kwh produced) O & M costfor existing diesel generator system.",
422
+ "units": "$"
423
+ },
424
+ "lifecycle_variable_om_cost_after_tax": {
425
+ "type": "number",
426
+ "description": "Total lifecycle variable(based on kwh produced) O & M costfor existing + newly recommended diesel generator system",
427
+ "units": "$"
428
+ },
429
+ "year_one_variable_om_cost_before_tax": {
430
+ "type": "number",
431
+ "description": "Year one variable(based on kwh produced) O & M costfor existing + newly recommended diesel generator system",
432
+ "units": "$"
433
+ },
434
+ "lifecycle_fuel_costs_after_tax": {
435
+ "type": "number",
436
+ "description": "Total lifecycle fuel costfor existing + newly recommended diesel generator system",
437
+ "units": "$"
438
+ },
439
+ "year_one_fuel_cost_before_tax": {
440
+ "type": "number",
441
+ "description": "Year one fuel costfor existing + newly recommended diesel generator system",
442
+ "units": "$"
443
+ },
444
+ "lifecycle_fuel_cost_after_tax_bau": {
445
+ "type": "number",
446
+ "description": "Total lifecycle fuel costfor existing diesel generator system",
447
+ "units": "$"
448
+ },
449
+ "year_one_fuel_cost_before_tax_bau": {
450
+ "type": "number",
451
+ "description": "Year one fuel costfor existing diesel generator system",
452
+ "units": "$"
453
+ }
543
454
  }
544
455
  }
456
+ }
457
+ }
458
+ },
459
+ "messages": {
460
+ "type": "object",
461
+ "properties": {
462
+ "warnings": {
463
+ "type": "array",
464
+ "description": "Warnings generated by simulation"
465
+ },
466
+ "error": {
467
+ "type": "string",
468
+ "description": "Error generated by simulation"
469
+ }
545
470
  }
546
471
  }
547
472
  }