-
Notifications
You must be signed in to change notification settings - Fork 151
/
releasenotes.html
3891 lines (3495 loc) · 291 KB
/
releasenotes.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE html>
<html lang="en" dir="ltr">
<head>
<meta http-equiv="Content-Type">
<meta content="text/html>
<meta charset=UTF-8">
<title>System Advisor Model™ (SAM™) Release Notes</title>
<style>
h1 {
background-color: #0072C6;
color: white;
font-family: Segoe UI,sans-serif;
font-weight: normal;
font-size: 16pt;
padding: 10px;
}
h2 {
font-family: Segoe UI,sans-serif;
background-color: #B8CCE4;
color: #0072C6;
font-weight: normal;
font-size: 14pt;
padding: 5px;
}
p,li {
font-family: Segoe UI,sans-serif;
font-size: 11pt;
}
table {
font-family: Segoe UI,sans-serif;
border-collapse: collapse;
width: 90%;
margin-left:auto;
margin-right:auto;
}
td, th {
border: 1px solid #dddddd;
padding: 8px;
text-align:center;
}
tr:nth-child(even) {
background-color: #dddddd;
}
</style>
</head>
<body>
<p style="font-family:Segoe UI,sans-serif;font-size:20pt;text-align:center;color:#0072C6;">System Advisor Model™ (SAM™) Release Notes</p>
<!-- TEMPLATE
<h1 id="yyyy-mm-dd-r[n]">SAM yyyy.m.d [r[n]], SSC nnn: Month d, yyyy</h1>
<p>Brief paragraph describing major updates in new version or sentence describing maintenance udpate.</p>
<ul>
<li>Optional list of major release highights.</li>
<li>...</li>
</ul>
<h2>CATEGORY FOR MAJOR RELEASES: General, Solar, Detailed Photovoltaic, Wind Power, CSP Physical Trough, PPA Single Owner, etc. Skip category for maintenance updates.</h2>
<p>ITEM 1 DESCRIPTION: Sentence describing change, and if relevent, impact on results.] (<a href="[URL to pull request]">SAM/SSC/WEX/LK [PR number]</a>)</p>
<p>ITEM 2 DESCRIPTION</p>
<p>..</p>
<ul>
<li>
CATEGORY FOR MAINTENANCE UPDATES: General, Solar, etc.
<li>ITEM 1 DESCRIPTION: Sentence describing change, and if relevent, impact on results.] (<a href="[URL to pull request]">SAM/SSC/WEX/LK [PR number]</a>)
<li>ITEM 2 DESCRIPTION</li>
<li>...</li>
</li>
</ul>
-->
<h1 id="2024-12-12">SAM 2024.12.12, SSC 298: December 12, 2024</h1>
<p>This version adds the Single Owner and Commercial financial models as options to the Industrial Process Heat (IPH) configurations.</p>
<p>Other highlights include:</p>
<ul>
<li>For behind-the-meter (BTM) batteries, add new graphs to Summary tab of Results page showing monthly electricity bill components and energy to load, and on Time Series tab, show electricity to load in stacked area plots.</li>
<li>New "Compare Cases" macro to generate a table comparing key metrics for different cases in a file that have the same financial model.</li>
<li>Rename "Generic System" performance model to "Custom Generation Profile".</li>
<li>New packed bed thermocline and pressurized water cylinder with piston separator TES options for the Physical Trough CSP and IPH performance models.</li>
<li>Update NREL National Solar Radiation Database (NSRDB) downloads to access new GOES V4 (1998 - 2023) dataset.</li>
<li>Speed up simulation run times of Detailed PV and PVWatts performance models.</li>
<li>Updated PV module and inverter libraries.</li>
</ul>
<p>For a complete list of code revisions associated with this version, see the <a href="https://github.com/NREL/SAM/pulls?q=is%3Apr+milestone%3A%22SAM+Fall+2024+Release%22+is%3Aclosed">SAM</a> and <a href="https://github.com/NREL/ssc/pulls?q=is%3Apr+milestone%3A%22SAM+Fall+2024+Release%22+is%3Aclosed">SSC</a> GitHub repositories. Highlights include:</p>
<h2>General (SAM 2024.12.12)</h2>
<p>Update weather file downloads to NREL NSRDB GOES V4 dataset covering 1998 - 2023. (<a href="https://github.com/NREL/SAM/pull/1945">SAM 1945</a>)</p>
<p>Fix alignment of user interface elements for Linux and Mac versions of SAM. (<a href="https://github.com/NREL/SAM/pull/1926">SAM 1926</a>, <a href="https://github.com/NREL/SAM/pull/1929">SAM 1929</a>)</p>
<p>Fix code generator for MATLAB problem with incorrect library. (<a href="https://github.com/NREL/SAM/pull/1950">SAM 1950</a>)</p>
<p>Test and update macros and sample LK scripts. (<a href="https://github.com/NREL/SAM/pull/1948">SAM 1948</a>, <a href="https://github.com/NREL/SAM/pull/1956">SAM 1956</a>)</p>
<p>Test and update PDF report templates. (<a href="https://github.com/NREL/SAM/pull/1947">SAM 1947</a>)</p>
<p>Revise Help for new features, updates, and to correct errors. (<a href="https://github.com/NREL/SAM/pull/1960">SAM 1960</a>, <a href="https://github.com/NREL/SAM/pull/1941">SAM 1941</a>, <a href="https://github.com/NREL/SAM/pull/1919">SAM 1919</a>)</p>
<p>Fix problem with list of time step options in user interface widget for availability losses and time series data. (<a href="https://github.com/NREL/SAM/pull/1907">SAM 1907</a>)</p>
<p>Update sample Python script for accessing NREL ResStock building load data to 2024 datasets. (<a href="https://github.com/NREL/SAM/pull/1915">SAM 1915</a>)</p>
<p>New "Compare Cases" and "Compare Battery Cases" macros generate an HTML window that can be exported to PDF showing a table comparing key metrics for different cases that use the same financial model. (<a href="https://github.com/NREL/SAM/pull/1894">SAM 1894</a>)</p>
<p>Update NREL Cambium market forecast price data downloads to Cambium 2023. (<a href="https://github.com/NREL/SAM/pull/1889">SAM 1889</a>)</p>
<p>Fix Utility Rate Database (URDB) electricity rate downloads. (<a href="https://github.com/NREL/SAM/pull/1862">SAM 1862</a>)</p>
<p>Use consistent labels for monthly and annual energy variables. (<a href="https://github.com/NREL/ssc/pull/1236">SSC 1236</a>)</p>
<p>Improve display of parametric results that include "NaN" or "Inf" values. (<a href="https://github.com/NREL/wex/pull/180">WEX 180</a>)</p>
<p>Fix time series data viewer issue with leap days that caused time series to end on a day other than December 31. (<a href="https://github.com/NREL/wex/pull/179">WEX 179</a>)</p>
<h2>Update Default Costs and System Designs (SAM 2024.12.12)</h2>
<p>Update defaults to better align with current state of U.S. market and incentives. (<a href="https://github.com/NREL/SAM/pull/1930">SAM 1930</a>)</p>
<p>For Detailed PV and PVWatts configurations, update default system designs based on <a href="https://www.energy.gov/eere/solar/solar-photovoltaic-system-cost-benchmarks">DOE Solar Photovoltaic System Cost Benchmarks</a>:</p>
<ul>
<li>Behind-the-meter residential is 7.9 kWdc fixed roof-mount with 400 Wdc monofacial modules and 7.6 kWac string inverters with DC optimizers.</li>
<li>Behind-the-meter commercial and third party ownership is 560 kWdc fixed or rack-mounted with 530 Wdc bifacial modules and 227 kWac central inverters. It is based on both the 3 MW agrivoltaic (APV) system from the <a href="https://www.energy.gov/eere/solar/solar-photovoltaic-system-cost-benchmarks">DOE Solar Photovoltaic System Cost Benchmarks</a> and the 200 kW fixed roof-mount system from the <a href="https://atb.nrel.gov/electricity/2024/data">2024 Annual Technology Baseline (ATB)</a>.</li>
<li>Front-of-meter is 100 MWdc ground-mounted, single-axis tracking with 530 Wdc bifacial modules and 2.5 MWac central inverters.</li>
<li>PVWatts default system designs assume monofacial modules because bifacial option is hidden in collapsed "Advanced Parameters" panel. See <a href="https://github.com/NREL/SAM/issues/1959">SAM Issue 1959</a>.</li>
</ul>
<p>For IPH configurations, update default incentives (no investment tax credit, ITC) and O&M cost. For Physical Trough, change default design to an oil field HTF with molten salt TES. For Fresnel, change default design to 5 MWt heat sink. (<a href="https://github.com/NREL/SAM/pull/1946">SAM 1946</a>)</p>
<p>Update default utility rate for behind-the-meter (BTM) configurations. (<a href="https://github.com/NREL/SAM/pull/1958">SAM 1958</a>)</p>
<h2>Financial Models (SAM 2024.12.12)</h2>
<p>Update investment-tax credit (ITC) and depreciation basis calculations to remove financing fees and reserve account funding from basis. (<a href="https://github.com/NREL/SAM/pull/1860">SAM 1860</a>, <a href="https://github.com/NREL/ssc/pull/1193">SSC 1193</a>)</p>
<p>Add option for DSCR debt sizing option (debt-service coverage ration as input, or sculpted debt, sizing based on cash available for debt service) that was available only for Single Owner financial model to other front-of-meter financial models. (<a href="https://github.com/NREL/SAM/pull/1854">SAM 1854</a>, <a href="https://github.com/NREL/ssc/pull/1208">SSC 1208</a>)</p>
<p>Add internal rate of return (IRR) metric to Residential and Commercial financial models. Note that the value of these projects is based on electricitiy bill savings rather than revenue. (<a href="https://github.com/NREL/ssc/pull/1223">SSC 1223</a>)</p>
<p>Add nominal discount rate output variable to financial models to help with analyses involving net present value (NPV). (<a href="https://github.com/NREL/ssc/pull/1223">SSC 1223</a>)</p>
<h2>Electricity Bill Calculator (SAM 2024.12.12)</h2>
<p>Fix downloads from Utility Rate Database (URDB) for utility companies with more than 500 rates (PG&E and others) or with no rates. (<a href="https://github.com/NREL/SAM/pull/1873">SAM 1875</a>)</p>
<p>Add option for net billing with carryover for credits that expire at end of true-up period instead of carrying over to following year, and credits apply to energy charge portion of monthly electricity bill. (<a href="https://github.com/NREL/SAM/pull/1835">SAM 1835</a>, <a href="https://github.com/NREL/ssc/pull/1200">SSC 1200</a>)</p>
<p>Improve error checking of time-of-use (TOU) rates by requiring that tiers are the same within a month across TOU periods. (<a href="https://github.com/NREL/ssc/pull/1207">SSC 1207</a>)</p>
<p>Fix an issue with front-of-meter (FOM) electricity purchases with hourly buy rates of zero. (<a href="https://github.com/NREL/ssc/pull/1264">SSC 1264</a>)</p>
<h2>Detailed PV (SAM 2024.12.12)</h2>
<p>Improve solar position algorithm to speed up PVWatts and Detailed PV simulation run times. (<a href="https://github.com/NREL/ssc/pull/1212">SSC 1212</a>)</p>
<p>Update module and inverter libraries. (<a href="https://github.com/NREL/SAM/pull/1913">SAM 1913</a>, <a href="https://github.com/NREL/SAM/pull/1917">SAM 1917</a>)</p>
<p>Rename temperature coefficient of power variable from 'gamma_r' to 'gamma_pmp' to be more consistent with industry standard. (<a href="https://github.com/NREL/ssc/pull/1231">SSC 1231</a>, <a href="https://github.com/NREL/SAM/pull/1898">SAM 1898</a>)</p>
<p>Add PV output distribution clipping correction method ("Walker method") with a new option on the Losses input page to choose between the matrix lookup (Allen) or PV output distribution (Walker) methods for hourly simulations. (<a href="https://github.com/NREL/SAM/pull/1861">SAM 1861</a>)</p>
<p>Fix six-parameter module coefficient generator sanity check that caused a crash. This should result in more modules from the CEC list to be inlcuded in the SAM module library. (<a href="https://github.com/NREL/ssc/pull/1245">SSC 1245</a>)</p>
<p>Fix implementation of NOCT cell temperature model. (<a href="https://github.com/NREL/ssc/pull/1233">SSC 1233</a>)</p>
<p>Improve error messages for weather files with invalid data for SAM and PySAM. (<a href="https://github.com/NREL/ssc/pull/1219">SSC 1219</a>)</p>
<p>Fix snow model for bifacial modules so that rear-side irradiance is not affected by snow cover. (<a href="https://github.com/NREL/ssc/pull/1214">SSC 1214</a>)</p>
<h2>PVWatts (SAM 2024.12.12)</h2>
<p>Change variable group name for 'losses' input variable from "Other DC losses" to "DC system losses". (<a href ="https://github.com/NREL/ssc/pull/1229">SSC 1229</a>)</p>
<p>Improve solar position algorithm to speed up PVWatts and Detailed PV simulation run times. (<a href="https://github.com/NREL/ssc/pull/1212">SSC 1212</a>)</p>
<h2>Electric Battery Storage (SAM 2024.12.12)</h2>
<p>Modify battery dispatch to consider grid limits. (<a href="https://github.com/NREL/SAM/pull/1883">SAM 1883</a>, <a href="https://github.com/NREL/ssc/pull/1224">SSC 1224</a>)</p>
<p>Add battery-specific availability loss inputs. (<a href="https://github.com/NREL/SAM/pull/1902">SAM 1902</a>, <a href="https://github.com/NREL/ssc/pull/1241">SSC 1241</a>, <a href="https://github.com/NREL/ssc/pull/1234">SSC 1234</a>)</p>
<p>Add new Standalone Battery input to define simulation time step rather than basing it on other inputs. (<a href="https://github.com/NREL/SAM/pull/1887">SAM 1887</a>, <a href="https://github.com/NREL/ssc/pull/1227">SSC 1227</a>)</p>
<p>For behind-the-meter (BTM) batteries, Add metrics and graphs to Summary tab on Results page, and default graph showing battery performance metrics on Time Series tab. (<a href="https://github.com/NREL/SAM/pull/1884">SAM 1884</a>, <a href="https://github.com/NREL/SAM/pull/1865">SAM 1865</a>, <a href="https://github.com/NREL/ssc/pull/1215">SSC 1215</a>)</p>
<p>Change battery life model to base degraded battery capacity on sum of calendar and cycle degradation rather than the minimum of the two. (<a href="https://github.com/NREL/ssc/pull/1239">SSC 1239</a>)</p>
<p>Update and fix REopt API calls for battery size and dispatch optimization. (<a href="https://github.com/NREL/SAM/pull/1904">SAM 1904</a>, <a href="https://github.com/NREL/ssc/pull/1242">SSC 1242</a>, <a href="https://github.com/NREL/ssc/pull/1203">SSC 1203</a>)</p>
<p>Improve efficiency of internal handling of battery parameter variables to decrease simulation run time, particularly for PV smoothing dispatch option. (<a href="https://github.com/NREL/ssc/pull/1251">SSC 1251</a>)</p>
<p>Improve determination of price signal forecast for Merchant Plant configurations with automated dispatch: Calculate price signal in each time step as capacity-weighted sum of enabled energy and ancillary service prices instead of simple sum. (<a href="https://github.com/NREL/ssc/pull/1235">SSC 1235</a>)</p>
<h2>Hybrid Systems (SAM 2024.12.12)</h2>
<p>Add input pages for thermal loads and thermal rates to hybrid configurations that include fuel cells. (<a href="https://github.com/NREL/SAM/pull/1903">SAM 1903</a>, <a href="https://github.com/NREL/ssc/pull/1244">SSC 1244</a>)</p>
<p>Include battery discharge power in power profile used to calculate project costs and benefits. (<a href="https://github.com/NREL/ssc/issues/1256">SSC 1256</a>)</p>
<p>Fix issue with PV-based O&M costs that scaled costs specified in $/kWac by PV DC capacity instead of PV AC capacity. (<a href="https://github.com/NREL/ssc/pull/1260">)SSC 1260</a>)</p>
<p>Use consistent default time-of-delivery (TOD) PPA price factors for all for front-of-meter (FOM) hybrid configurations. (<a href="https://github.com/NREL/SAM/pull/1971">SAM 1971</a>)</p>
<p>Remove "Hybrid" from performance model names in configuration window when creating or adding new cases. (<a href="https://github.com/NREL/SAM/pull/1875">SAM 1875</a>)</p>
<h2>Concentrating Solar Power (CSP) (SAM 2024.12.12)</h2>
<p>For parabolic trough and linear Fresnel configurations, move input variables for receiver startup dely time and energy fraction from Solar Field page to System Control page. These inputs are for the dispatch optimization algorithm, not the performance simulation. (They are inputs to the performance model for power tower configurations.) (<a href=<"https://github.com/NREL/SAM/pull/1961">SAM 1961</a>, <a href="https://github.com/NREL/ssc/pull/1261">SSC 1261</a>)</p>
<p>New options for user-defined power cycle (UDPC) interpolation at maximum cycle output. (<a href="https://github.com/NREL/SAM/pull/1935">SAM 1935</a>, <a href="https://github.com/NREL/ssc/pull/1253">SSC 1253</a>)</p>
<p>Fix parabolic trough and linear Fresnel dispatch issue that resulted in infeasible results. (<a href="https://github.com/NREL/ssc/pull/1213">SSC 1213</a>)</p>
<p>New packed bed thermocline and pressurized water cylinder with piston separator TES options for the Physical Trough CSP and IPH performance models. (<a href="https://github.com/NREL/SAM/pull/1900">SAM 1900</a>, <a href="https://github.com/NREL/ssc/pull/1238">SSC 1238</a>)</p>
<p>Change default constant availability loss for molten salt power tower configurations from 0 to 5%. (<a href="https://github.com/NREL/SAM/pull/1899">SAM 1899</a>)</p>
<h2>Industrial Process Heat (IPH) (SAM 2024.12.12)</h2>
<p>Add Single Owner and Commercial financial model option for IPH performance models. For older versions of SAM, only the LCOH Calculator (fixed-charge rate method of calculating levelized cost of heat) financial model was available. This major new feature involves adding new cash flow cost and benefit streams based on heat generated by the system. (<a href="https://github.com/NREL/SAM/pull/1900">SAM 1900</a>, <a href="https://github.com/NREL/ssc/pull/1238">SSC 1238</a>)</p>
<p>Add the Solar Dynamics SunBeam collector to the Physical Trough collector library. (<a href="https://github.com/NREL/SAM/pull/1900">SAM 1900</a>)</p>
<p>Disable Send-to-Excel with Equations (Windows only) for IPH configurations with Single Owner or Commercial financial model until workbooks are updated. (<a href="https://github.com/NREL/SAM/pull/1954">SAM 1954</a>)</p>
<p>Fix IPH molten salt linear Fresnel (MSLF) calculation of 'aux_design' and 'bop_design' to be consistent with CSP MSLF model. (<a href="https://github.com/NREL/ssc/pull/1254">SSC 1254</a>)</p>
<h2>Marine Energy (SAM 2024.12.12)</h2>
<p>Update PDF report template to support Wave and Tidal configurations with Single Owner and LCOE Calculator financial models, and new energy converter and resource options. (<a href="https://github.com/NREL/SAM/pull/1947">SAM 1947</a>)
<p>Add time series availability losses to Wave Energy and Tidal Energy models. (<a href="https://github.com/NREL/SAM/pull/1885">SAM 1885</a>, <a href="https://github.com/NREL/ssc/pull/1225">SSC 1225</a>)</p>
<p>Add capacity factor input to tidal energy turbine design page. (<a href="https://github.com/NREL/SAM/pull/1872">SAM 1872</a>, <a href="https://github.com/NREL/ssc/pull/1218">SSC 1218</a>, <a href="https://github.com/NREL/ssc/pull/1181">SSC 1181</a>)</p>
<p>Update marine energy device cost curves. (<a href="https://github.com/NREL/ssc/pull/1249">SSC 1249</a>)</p>
<p>Update equations to improve use of marine energy models with PySAM. (<a href="https://github.com/NREL/ssc/pull/1217">SSC 1217</a>)</p>
<h2>Geothermal Power (SAM 2024.12.12)</h2>
<p>Update cost scenario data. (<a href="https://github.com/NREL/SAM/pull/1931">SAM 1931</a>)</p>
<p>Add new option to turn off reservoir replacements. (<a href="https://github.com/NREL/SAM/pull/1881">SAM 1881</a>, <a href="https://github.com/NREL/ssc/pull/1222">SSC 1222</a>)</p>
<p>Add a button that updates O&M costs. (<a href="https://github.com/NREL/SAM/pull/1858">SAM 1858</a>, <a href="https://github.com/NREL/ssc/pull/1210">SSC 1210</a>)</p>
<p>Remove unused features EGS custom plant temperature, check for production pumping cost in flash plants, and user-interface text revisions. (<a href="https://github.com/NREL/SAM/pull/1857">SAM 1857</a>)</p>
<p>Improve production well calculations for brine efficiency and specific heat. (<a href="https://github.com/NREL/ssc/pull/1209">SSC 1209</a>)</p>
<h2>Wind Power (SAM 2024.12.12)</h2>
<p>Fix LandBOSSE call to run Python from SAM user interface. (<a href="https://github.com/NREL/SAM/pull/1939">SAM 1939</a>)</p>
<p>Add wind weather file reader check for missing data to improve error message for invalid wind resource files. (<a href="https://github.com/NREL/ssc/pull/1221">SSC 1221</a>)</p>
<p>New inputs to SSC (accessible only via <a href="https://sam.nrel.gov/software-development-kit-sdk">SAM Software Development Kit (SDK)</a> for wake model, access to internal Park wake model inputs, and new "icing persistence" input. These features are not available in the SAM desktop application. (<a href="https://github.com/NREL/ssc/pull/1186">SSC 1186</a>)</p>
<h2>Custom Generation Profile (SAM 2024.12.12)</h2>
<p>Rename "Generic System" model to "Custom Generation Profile" to be clearer that model can use a time series generation profile from measured data or from a different model as input. (<a href="https://github.com/NREL/SAM/pull/1890">SAM 1890</a>, <a href="https://github.com/NREL/ssc/pull/1228">SSC 1228</a>)</p>
<h1 id="2023-12-17-r2">SAM 2023.12.17 r2, SSC 292: August 23, 2024</h1>
<p>This is the second maintenance update to <a href="#2023-12-17">SAM 2023.12.17</a>.</p>
<ul>
<li>Detailed PV and PVWatts
<ul>
<li>Set default PV uncertainty input distributions for factors that are represented by Detailed PV/PVWatts performance model, and add checkboxes to PV uncertainty categories to allow for enabling and disabling them. (<a href="https://github.com/NREL/SAM/pull/1812">SAM 1812</a>, <a href="https://github.com/NREL/SAM/pull/1753">SAM 1753</a>)</li>
<li>Add checkboxes to PV uncertainty page to allow for enabling and disabling uncertainty categories. (<a href="https://github.com/NREL/SAM/pull/1753">SAM 1753</a>)</li>
<li>Fix problems with PV PDF report. (<a href="https://github.com/NREL/SAM/pull/1789">SAM 1789</a>)</li>
<li>Change diagrams of tracking and orientation on Sytem Design page for Detailed PV and PVWatts models, and revise Help descriptions of tilt and azimuth inputs and labels of plane-of-array (POA) irradiance output variables. (<a href="https://github.com/NREL/SAM/pull/1791">SAM 1791</a>, <a href="https://github.com/NREL/ssc/pull/1153">SSC 1153</a>)</li>
<li>Improve documentation of IEC 61858 temperature, optical, and spectral models for PV. (<a href="https://github.com/NREL/SAM/pull/1795">SAM 1795</a>, <a href="https://github.com/NREL/ssc/pull/1175">SSC 1175</a>)</li>
<li>Fix internal issue with initializing ground clearance height for IEC 61853 module model. (<a href="https://github.com/NREL/ssc/pull/1194">SSC 1194</a>)</li>
</ul>
</li>
<li>Battery Storage
<ul>
<li>Fix default battery properties for Li-NMC batteries for some configurations with batteires. (<a href="https://github.com/NREL/SAM/pull/1818">SAM 1818</a>)</li>
<li>Improve battery lifetime model to allow for reversible thermal degradation. (<a href="https://github.com/NREL/ssc/pull/1164">SSC 1164</a>)</li>
<li>Fix issues with REopt API call for battery size and dispatch optimization. (<a href="https://github.com/NREL/ssc/pull/1187">SSC 1187</a>)</li>
<li>Display a message on input page when battery is allowed to charge from grid an a production tax credit (PTC) is enabled. (<a href="https://github.com/NREL/SAM/pull/1792">SAM 1792</a>)</li>
<li>Improve results of battery storage self-consumption dispatch option to more accurately determine when 100% of load is met by the system. (<a href="https://github.com/NREL/ssc/pull/1182">SSC 1182</a>)</li>
<li>Fix PDF report for the self-consumption battery dispatch option. (<a href="https://github.com/NREL/SAM/pull/1750">SAM 1750</a>)</li>
<li>Fix year index in TOU demand charge calculation for electricity bill calculations. (<a href="https://github.com/NREL/ssc/pull/1152">SSC 1152</a>)</li>
</ul>
</li>
<li>Financial Models
<ul>
<li>Fix tax and depreciation formulas in Send-to-Excel workbooks. (<a href="https://github.com/NREL/SAM/pull/1841">SAM 1841</a>)</li>
<li>Fix electricity bill calculation for net billing with tiered energy rates. (<a href="https://github.com/NREL/ssc/pull/1168">SSC 1168</a>)</li>
<li>Report basis for investment tax credit (ITC) and depreciation in outputs to improve transparency of incentive calculations. (<a href="https://github.com/NREL/SAM/pull/1808">SAM 1808</a>, <a href="https://github.com/NREL/ssc/pull/1178">SSC 1178</a>)</li>
<li>Fix formula in Excel Workbook for Third Party Host / Developer financial model that calculates federal depreciation. (<a href="https://github.com/NREL/SAM/pull/1793">SAM 1793</a>)</li>
<li>Fix formulas in Excel Workbook for Community Solar financial model that calculates subscriber share of generation. (<a href="https://github.com/NREL/SAM/pull/1744">SAM 1744</a>)</li>
<li>Revise description of Indifference Point macro for Third Party Host / Developer model. (<a href="https://github.com/NREL/SAM/pull/1788">SAM 1788</a>)</li>
</ul>
</li>
<li>Update weather file downloads from the Advanced NSRDB Download window to make all attributes and time resolutions available from latest PSM V3.2.2 endpoints. (<a href="https://github.com/NREL/SAM/pull/1746">SAM 1746</a>)</li>
<li>Fix stochastic and PV uncertainty simulations on macOS. (<a href="https://github.com/NREL/SAM/pull/1758">SAM 1758</a>, <a href="https://github.com/NREL/SAM/pull/1782">SAM 1782</a>)</li>
<li>Revise Marine Energy Help topics mentioning DOE Reference Model project. (<a href="https://github.com/NREL/SAM/pull/1790">SAM 1790</a>)</li>
<li>Revise description of Wind environmental loss on input page and in Help. (<a href="https://github.com/NREL/SAM/pull/1770">SAM 1770</a>)</li>
<li>Fix custom HTF for Molten Salt Power Tower configurations. (<a href="https://github.com/NREL/SAM/pull/1817">SAM 1817</a>)</li>
<li>Fix problem reading time series loss data (converting from old 'adjust:periods' to new 'adjust_periods' variable names) when opening .sam files from older versions. (<a href="https://github.com/NREL/SAM/pull/1749">SAM 1749</a>)</li>
<li>Fix application of time series losses ('adjust' variables) for non-annual simulations from SAM SDK / PySAM. (<a href="https://github.com/NREL/ssc/pull/1113">SSC 1113</a>, <a href="https://github.com/NREL/SAM/pull/1826">SAM 1826</a>)</li>
<li>Make geothermal cost curves available in SSC (<a href="https://github.com/NREL/ssc/pull/1191">SSC 1191</a>)</li>
<li>Fix issues with geothermal cost inputs. (<a href="https://github.com/NREL/SAM/pull/1823">SAM 1823</a>, <a href="https://github.com/NREL/ssc/pull/1189">SSC 1189</a>)</li>
<li>Modify marine energy tidal energy converter "Design tidal converter" power curve calculation method. (<a href="https://github.com/NREL/SAM/pull/1807">SAM 1807</a>)</li>
</ul>
<h1 id="2023-12-17-r1">SAM 2023.12.17 r1, SSC 290: March 4, 2024</h1>
<p>This is the first maintenance update to <a href="#2023-12-17">SAM 2023.12.17</a>.</p>
<ul>
<li>Solar Resource
<ul>
<li>Support NSRDB weather file downloads from the Solar Resource page for locations outside the United States. (<a href="https://github.com/NREL/SAM/pull/1720">SAM 1720</a>, <a href="https://github.com/NREL/ssc/pull/1140">SSC 1140</a>)</br> <a href="https://github.com/NREL/SAM/issues/1534">Additional work is planned</a> for the Advanced NSRDB Download window for the second update to SAM 2023.12.17.</li>
<li>Fix problem using latitude and longitude to download weather files from the Solar Resource page. (<a href="https://github.com/NREL/SAM/pull/1692">SAM 1692</a>)</li>
</ul>
</li>
<li>Detailed PV and PVWatts
<ul>
<li>Fix PV land area calculations. (<a href="https://github.com/NREL/SAM/pull/1721">SAM 1721</a>, <a href="https://github.com/NREL/SAM/pull/1697">SAM 1697</a>)</li>
<li>Fix PV time series shading data import from 3D shade calculator and overlapping inputs in Edit Shading window for PVWatts. (<a href="https://github.com/NREL/SAM/pull/1712">SAM 1712</a>)</li>
<li>Fix Detailed PV non-linear self shading for vertical arrays to avoid negative POA irradiance values. (<a href="https://github.com/NREL/ssc/pull/1127">SSC 1127</a>)</li>
<li>Fix issue with Detailed PV subhourly clipping loss when weather file has no DNI data. (<a href="https://github.com/NREL/ssc/pull/1126">SSC 1126</a>)</li>
<li>Fix reporting of ground-reflected rear irradiance gains in loss diagram for Detailed PV model with bifacial modules. (<a href="https://github.com/NREL/ssc/pull/1125">SSC 1125</a>)</li>
<li>Add snow slide coefficient to outputs for Detailed PV with snow model enabled. (<a href="https://github.com/NREL/ssc/pull/1128">SSC 1128</a>)</li>
<li>Clean up PV subhourly clipping loss correction in user interface. (<a href="https://github.com/NREL/SAM/pull/1689">SAM 1689</a>)</li>
<li>Fix diagrams on Detailed PV Shading and Layout page to show both portrait and landscape instead of duplicating portrait. (<a href="https://github.com/NREL/SAM/pull/1696">SAM 1696</a>)</li>
</ul>
</li>
<li>Concentrating Solar Power (CSP)
<ul>
<li>Fix parabolic trough loop configuration on SCA (Collectors) page. (<a href="https://github.com/NREL/SAM/pull/1709">SAM 1709</a>)</li>
<li>Fix problems with parabolic trough dispatch optimization and loop configuration that caused a simulation error. (<a href="https://github.com/NREL/SAM/issues/1674">SAM 1674</a>, <a href="https://github.com/NREL/ssc/pull/1121">SSC 1121</a>)
</ul>
</li>
<li>Battery Storage
<ul>
<li>Improve REopt API calls for battery size and dispatch optimization to better report status and errors from API. (<a href="https://github.com/NREL/SAM/pull/1714">SAM 1714</a>)</li>
<li>Fix simulation error caused by battery environment temperature input as time series array. (<a href="https://github.com/NREL/SAM/pull/1694">SAM 1694</a>, <a href="https://github.com/NREL/ssc/pull/1138">SSC 1138</a>)</li>
<li>Fix issue with behind-the-meter battery with retail rate dispatch that caused a simulation error. (<a href="https://github.com/NREL/ssc/pull/1135">SSC 1135</a>)
<li>Fix default battery life inputs so correct table is shown for the default Li-ion LFP/Graphite battery type. (<a href="https://github.com/NREL/SAM/pull/1715">SAM 1715</a>)
<li>Fix problem with battery discharging to grid for manual dispatch option. (<a href="https://github.com/NREL/ssc/pull/1115">SSC 1115</a>)</li>
<li>Fix problem with battery self consumption dispatch option with grid outage. (<a href="https://github.com/NREL/ssc/pull/1114">SSC 1114</a>)</li>
</ul>
</li>
<li>Fix problem with losses specifed as "time series losses with custom time periods" that caused a simulation error. (<a href="https://github.com/NREL/SAM/pull/1698">SAM 1698</a>)</li>
<li>Improve reporting of time series data for subhourly Detailed PV and PV Battery simulations so that "hourly" and "hourly lifetime" values are consistent. (<a href="https://github.com/NREL/SAM/issues/1684">SAM 1684</a>)</li>
<li>Fix problem with loading weather files with time series wave resource data for marine energy wave model. (<a href="https://github.com/NREL/SAM/pull/1701">SAM 1701</a>, <a href="https://github.com/NREL/ssc/pull/1130">SSC 1130</a>)</li>
<li>Improve debt sizing calculation for front-of-meter financial models with sculpted debt (DSCR as input) and when debt size limit is enabled. (<a href="https://github.com/NREL/ssc/pull/1136">SSC 1136</a>)</li>
<li>Fix state of Fuel Cell dispatch page when opening .sam files from older versions of SAM. (<a href="https://github.com/NREL/SAM/pull/1707">SAM 1707</a>)</li>
<li>Fix Save and Load buttons throughout user interface. (<a href="https://github.com/NREL/SAM/pull/1695">SAM 1695</a>)</li>
<li>Improve reporting of DC loss factors in PDF report for Detailed PV and PV Battery configurations. (<a href="https://github.com/NREL/SAM/pull/1690">SAM 1690</a>)
<li>Fix broken link to SAM Forum from Help window. (<a href="https://github.com/NREL/SAM/pull/1716">SAM 1716</a>)</li>
</ul>
<h1 id="2023-12-17">SAM 2023.12.17, SSC 288: December 17, 2023</h1>
<p>This version introduces a set of new hybrid power system models and a new molten salt linear Fresnel models for electric power generation and industrial process heat (IPH) applications.</p>
<p>For a complete list of code revisions associated with this version, see the <a href="https://github.com/NREL/SAM/pulls?q=is%3Apr+milestone%3A%22SAM+Fall+2023+Release%22+is%3Aclosed">SAM</a> and <a href="https://github.com/NREL/ssc/pulls?q=is%3Apr+milestone%3A%22SAM+Fall+2023+Release%22+is%3Aclosed">SSC</a> GitHub repositories. Highlights include:</p>
<ul>
<li>New SAM logo and icon.</li>
<li>New hybrid power models with different combinations of the photovoltaic (PVWatts and Detailed PV), Wind Power, Fuel Cell, and Generic System models with battery storage for the Single Owner and Third Party Host / Developer financial models.</li>
<li>New industrial process heat (IPH) models for molten salt power tower and molten salt linear Fresnel systems.</li>
<li>Improve molten salt linear Fresnel concentrating solar power (CSP) model.</li>
<li>Update REopt for PV-battery optimization to REopt API V3.</li>
<li>New self-consumption dispatch option for behind-the-meter batteries.</li>
<li>Geothermal model updates.</li>
<li>Marine Energy model updates.</li>
<li>Update defaults.</li>
<li>Update photovoltaic module and inverter libraries.</li>
<li>Revise and update Help.</li>
</ul>
<p>We are working to fix known <a href="https://github.com/NREL/SAM/issues?q=is%3Aopen+is%3Aissue+milestone%3A%22SAM+Fall+2023+Release%22">SAM issues</a> and <a href="https://github.com/NREL/ssc/issues?q=is%3Aopen+is%3Aissue+milestone%3A%22SAM+Fall+2023+Release%22">SSC issues</a> for an update to this version in early 2024. Please <a href="mailto:sam.support@nrel.gov">let us know</a> if you find any other problems.</p>
<h2>Hybrid Power Systems</h2>
<p>This major new feature adds configurations for hybrid power systems. (<a href="https://github.com/NREL/SAM/pull/1448">SAM 1448</a> and <a href="https://github.com/NREL/SAM/pulls?q=is%3Apr+milestone%3A%22SAM+Fall+2023+Release%22+label%3A%22dev+bug%22+is%3Aclosed">multiple subsequent pull requests</a>, <a href="https://github.com/NREL/ssc/pull/1051">SSC 1051</a>)</p>
<p>Hybrid power systems combine photovoltaic (PVWatts or Detailed PV), Wind Power, Fuel Cell, and Generic System models for power generation with the Standalone Battery model for electricity storage. Battery dispatch responds to the sum of power from the PV, wind, fuel cell and/or generic systems in each time step. The hybrid system performance models are available with either the Single Owner for front-of-meter applications or the Third Party Host / Developer financial model for behind-the-meter applications. As is the case for all of SAM's models, SAM assumes the hybrid system is connected to the grid. The new hybrid configurations are available for the following combinations of performance models:</p>
<ul>
<li>PVWatts, Wind Power, Battery Storage</li>
<li>PVWatts, Wind Power, Fuel Cell, Battery Storage</li>
<li>Detailed PV, Wind Power, Battery Storage</li>
<li>Generic System, PVWatts, Wind Power, Fuel Cell, Battery Storage</li>
</ul>
<h2>General (2023.12.17)</h2>
<ul>
<li>New System Advisor Model logo and icon. Icon is implemented for Windows and Mac, not Linux. (<a href="https://github.com/NREL/SAM/pull/1514">SAM 1514</a>)
<li>Update National Solar Radiation Database (NSRDB) downloads from Location and Resource input page to NSRDB PSM V3.2.2 to include latest data from 2022 and update sample LK script. (<a href="https://github.com/NREL/SAM/pull/1559">SAM 1559</a>, <a href="https://github.com/NREL/SAM/pull/1499">SAM 1499</a>)</li>
<li>Update defaults to align with <a href="https://atb.nrel.gov/electricity/2023/index">2023 NREL Annual Technology Baseline (ATB)</a> and to result in positive net present value (NPV) where possible. (<a href="https://github.com/NREL/SAM/pull/1581">SAM 1581</a>)</li>
<li>Fix layout issues for Mac and Linux versions. (<a href="https://github.com/NREL/SAM/pull/1580">SAM 1580</a>)</li>
<li>Change format of "adjust" variable used for availability and other time-varying losses from table to separate variables for "constant", "time series" and "periods." This internal change only affects LK scripts and code for the Software Development Kit (SDK) and PySAM. (<a href="https://github.com/NREL/SAM/pull/1468">SAM 1468</a>)</li>
<li>Fix issue with time series availability losses. (<a href="https://github.com/NREL/ssc/pull/1093">SSC 1093</a>)
</ul>
<h2>Financial Models (2023.12.17)</h2>
<ul>
<li>Fix investment-based incentive (IBI) and capacity-based incentive (CBI) double-counting in cash flow (<a href="https://github.com/NREL/SAM/pull/1445">SAM 1445</a>, <a href="https://github.com/NREL/ssc/pull/1048">SSC 1048</a>)</li>
<li>Update Send-to-Excel with Equations (Windows only) for battery and fuel cell / residential and commercial configurations to properly account for battery and fuel cell operating costs. (<a href="https://github.com/NREL/SAM/pull/1545">SAM 1545</a>)</li>
<li>Update Send-to-Excel with Equations (Windows only) for front-of-meter (FOM) financial models to calculate production based incentive (PBI), production-based O&M costs, and production tax credit (PTC) from correct annual energy value. (<a href="https://github.com/NREL/SAM/pull/1501">SAM 1501</a>, <a href="https://github.com/NREL/ssc/pull/1066">SSC 1066</a>)</li>
<li>Add user interface warning messages for systems with battery storage and a production tax credit (PTC) when battery is allowed to charge from the grid. (<a href="https://github.com/NREL/SAM/pull/1542">SAM 1542</a>)</li>
<li>Fix electricity to/from grid output for battery configurations with grid outages. (<a href="https://github.com/NREL/ssc/pull/1097">SSC 1097</a>)</li>
<li>Report battery capacity-based O&M expense in cash flow for all financial models. (<a href="https://github.com/NREL/ssc/pull/1076">SSC 1076</a>)</li>
<li>Remove total production tax credit (PTC) from cash flow results. State and federal PTC are applied separately. (<a href="https://github.com/NREL/ssc/pull/1072">SSC 1072</a>)</li>
<li>Fix monthly energy values for grid curtailment. (<a href="https://github.com/NREL/ssc/pull/1068">SSC 1068</a>)</li>
<li>Rename internal cash flow variables from "net" to "sales" to make it clear these are for energy to grid outputs. (<a href="https://github.com/NREL/ssc/pull/1060">SSC 1060</a>)
</ul>
<h2>Detailed Photovoltaic (2023.12.17)</h2>
<ul>
<li>New subhourly clipping correction for AC loss calculation. (<a href="https://github.com/NREL/SAM/pull/1447">SAM 1447</a>, <a href="https://github.com/NREL/ssc/pull/1077">SSC 1077</a>, <a href="https://github.com/NREL/ssc/pull/1050">SSC 1050</a>)</li>
<li>Update module and inverter libraries from 11/17/2023 CEC workbooks. (<a href="https://github.com/NREL/SAM/pull/1607">SAM 1607</a>, <a href="https://github.com/NREL/SAM/pull/1606">SAM 1606</a>)</li>
<li>Change default inverters based on market share. (<a href="https://github.com/NREL/SAM/pull/1607">SAM 1607</a>)</li>
<li>Make scripts and data used to generate module and inverter libraries public. (<a href="https://github.com/NREL/SAM/pull/1440">SAM 1440</a>)</li>
<li>Fix issue with availability and shading losses shown on PDF report. (<a href="https://github.com/NREL/SAM/pull/1579">SAM 1579</a>)</li>
<li>Add checks and warnings for bifacial ground clearance height input values that result in modules being too close to the ground. (<a href="https://github.com/NREL/SAM/pull/1544">SAM 1544</a>, <a href="https://github.com/NREL/ssc/pull/1095">SSC 1095</a>)</li>
<li>Move module dimension inputs from Shading and Layout page to Module page. (<a href="https://github.com/NREL/SAM/pull/1519">SAM 1519</a>)</LI>
<li>Change default inverter temperature derating curve maximum voltage to 1500 VDC so it works with full range of inverters in the library. (<a href="https://github.com/NREL/SAM/pull/1460">SAM 1460</a>)</li>
<li>Improve PVsyst conversion macro to better handle PVsyst meteo files. (<a href="https://github.com/NREL/SAM/pull/1430">SAM 1430</a>)</li>
<li>Prevent number of strings in parallel value of zero to avoid simulation crash. (<a href="https://github.com/NREL/ssc/pull/1087">SSC 1087</a>)</li>
<li>Improve error messages when cell temperature heat transfer method is missing data. (<a href="https://github.com/NREL/ssc/pull/1086">SSC 1086</a>)</li>
<li>New input for time series one-axis tracker rotation axis. This is implemented for SSC only so available in the SAM Software Development Kit (SDK) including PySAM, but not available in the SAM user interface. (<a href="https://github.com/NREL/ssc/pull/1071">SSC 1071</a>)
</ul>
<h2>PVWatts (2023.12.17)</h2>
<ul>
<li>Fix issue with Edit Shading Data window for advanced "Shading by Nearby Objects". (<a href="https://github.com/NREL/SAM/pull/1593">SAM 1593</a>) </li>
</ul>
<h2>Battery Storage (2023.12.17)</h2>
<ul>
<li>Change default battery type from Li-ion LFP to Li-ion NMC. (<a href="https://github.com/NREL/SAM/pull/1581">SAM 1581</a>)</li>
<li>New behind-the-meter self-consumption battery dispatch option that minimizes use of grid power (<a href="https://github.com/NREL/SAM/pull/1446">SAM 1446</a>, <a href="https://github.com/NREL/ssc/pull/1057">SSC 1057</a>, <a href="https://github.com/NREL/ssc/pull/1049">SSC 1049</a>)</li>
<li>Update REopt API call to Version 3, pass grid outage data to API, and fix conversion efficiency values. (<a href="https://github.com/NREL/SAM/pull/1527">SAM 1527</a>, <a href="https://github.com/NREL/ssc/pull/1078">SSC 1078</a>)</li>
<li>Rename "price signals dispatch" to "retail rate dispatch" for behind-the-meter battery dispatch options. (<a href="https://github.com/NREL/SAM/pull/1495">SAM 1495</a>, <a href="https://github.com/NREL/ssc/pull/1064">SSC 1064</a>)</li>
<li>Fix problem with automatic battery sizing when desired size is specified in AC units. (<a href="https://github.com/NREL/SAM/pull/1469">SAM 1469</a>)</li>
<li>Implement internal resistance for batteries using the voltage table, including lead acid battery types, also change default lead acid inernal resistance to a more realistic value. (<a href="https://github.com/NREL/SAM/pull/1493">SAM 1493</a>, <a href="https://github.com/NREL/ssc/pull/1016">SSC 1016</a>)</li>
<li>Remove "Calculate Load Data" option from Electric Load page for Standalone Battery / Residential configurations because it requires solar resource data that is not available. (<a href="https://github.com/NREL/SAM/pull/1467">SAM 1467</a>)</li>
<li>Set default values of all availability loss inputs to zero for battery configurations. (<a href="https://github.com/NREL/SAM/pull/1463">SAM 1463</a>)</li>
<li>Show rear irradiance values in loss diagram for PV-battery configurations. (<a href="https://github.com/NREL/SAM/pull/1422">SAM 1422</a>)</li>
<li>Fix issue for PV-smoothing dispatch that caused discrepancy between PV-smoothing and battery state of charge values. (<a href="https://github.com/NREL/ssc/pull/1085">SSC 1085</a>)
<li>Fix battery not discharging for peak shaving dispatch for small batteries. (<a href="https://github.com/NREL/ssc/pull/1208">SSC 1208</a>)</li>
<li>Fix battery discharging in excess of critical load when AC losses are present. (<a href="https://github.com/NREL/ssc/pull/1061">SSC 1061</a>)</li>
</ul>
<h2>Concentrating Solar Power (2023.12.17)</h2>
<ul>
<li>Update molten salt linear Fresnel CSP model to use plant controller and numerical solver used by power tower and trough models. This framework improves mass and energy balances, especially during timeperiods when the field, TES, and cycle are all operating. This implementation also enables dispatch optimization. Note that the fossil backup option was removed as part of this work. The default case in earlier releases used fossil backup to provide freeze protection, and this release switches to using electricity that is deducted from the total plant output. As such, the annual energy in the default case decreases by around 12%. When comparing to the prior release without fossil freeze protection, the new release has slightly better annual energy due to improved thermal transient modeling that reduces freeze protection requirements.</li>
<li>New industrial process heat (IPH) models for molten salt power tower and molten salt linear Fresnel systems.</li>
<li>Fix bug in calculation of thermal losses from brackets in the evacuated tube receiver model used in the Physical trough and Fresnel models. The annual energy of the default Physical trough CSP system decreased by around 0.5% and the annual energy of the default Fresnel CSP system decreases by around 2%.
<li>Improved the calculations that size the Physical trough and Fresnel fields to achieve to a target solar multiple. The new implementation includes all design-point optical and thermal losses. For the default cases, this change increases the solar field size by 1-2%.
<li>Improved levelized cost of heat (LCOH) model includes component cost breakdowns</li>
<li>Fix molten salt power tower cavity receiver estimated net output at design calculation. (<a href="https://github.com/NREL/ssc/pull/1067">SSC 1067</a>)
</ul>
<h2>Wind Power (2023.12.17)</h2>
<ul>
<li>Add system availability loss to wind power model. <a href="https://github.com/NREL/SAM/pull/1612">SAM 1612</a></li>
<li>Fix WIND Toolkit downloads to correctly download data at different measurement heights. (<a href="https://github.com/NREL/SAM/pull/1483">SAM 1483</a>)</li>
</ul>
<h2>Marine Energy (2023.12.17)</h2>
<ul>
<li>New array cable voltage and array cost scaling calculations. (<a href="https://github.com/NREL/SAM/pull/1423">SAM 1423</a>, <a href="https://github.com/NREL/SAM/pull/1350">SAM 1350</a>, <a href="https://github.com/NREL/ssc/pull/1038">SSC 1038</a>, <a href="https://github.com/NREL/ssc/pull/990">SSC 990</a>)</li>
<li>New option for custom tidal turbine design. (<a href="https://github.com/NREL/SAM/pull/1423">SAM 1423</a>)</li>
<li>New option for Tidal resource time series data with new example resource files. (<a href="https://github.com/NREL/SAM/pull/1510">SAM 1510</a>, <a href="https://github.com/NREL/ssc/pull/1069">SSC 1069</a>)</li>
<li>Fix user interface layout issues for Mac, and issues with showing and hiding inputs on cost pages cost based on selection of options. (<a href="https://github.com/NREL/SAM/pull/1591">SAM 1591</a>)</li>
<li>Update Wave resource libraries and example files. (<a href="https://github.com/NREL/SAM/pull/1591">SAM 1591</a>, <a href="https://github.com/NREL/ssc/pull/1095">SSC 1095</a>)</li>
<li>Fix issue with tidal resource data shown on PDF report. (<a href="https://github.com/NREL/SAM/pull/1579">SAM 1579</a>)</li>
</ul>
<h2>Solar Water Heating</h2>
<ul>
<li>Limit tank cold node temperature to realistic range of values. (<a href="https://github.com/NREL/ssc/pull/1011">SSC 1011</a>)</li>
</ul>
<h2>Geothermal Power (2023.12.17)</h2>
<ul>
<li>Fix reservoir pressure change units. (<a href="https://github.com/NREL/SAM/pull/1591">SAM 1591</a>, <a href="https://github.com/NREL/ssc/pull/1095">SSC 1095</a>)</li>
<li>Add inputs for more precise well count calculations, new tooltips for input variable descriptions, and option to read wet bulb temperature from weather file. (<a href="https://github.com/NREL/SAM/pull/1524">SAM 1524</a>, <a href="https://github.com/NREL/ssc/pull/1075">SSC 1075</a>)</li>
<li>Disable Default Type options on Geothermal Resource page for configurations with LCOE Calculator or No Financial that have no analysis period defined to avoid user interface "callback" error. (<a href="https://github.com/NREL/SAM/pull/1517">SAM 1517</a>, <a href="https://github.com/NREL/SAM/pull/1488">SAM 1488</a>)
</ul>
<h2>Fuel Cell (2023.12.17)</h2>
<ul>
<li>Create new input page for fuel cell dispatch options that is separate from battery dispatch, and remove options not appropriate for fuel cell. (<a href="https://github.com/NREL/SAM/pull/1492">SAM 1492</a>)</li>
<li>Add monthly energy output. (<a href="https://github.com/NREL/ssc/pull/1094">SSC 1094</a>)</li>
</ul>
<h1 id="2022-11-21-r3">SAM 2022.11.21 r3, SSC 280: June 3, 2023</h1>
<p>This is the third maintenance update to <a href="2022-11-21">SAM 2022.11.21</a>.</p>
<ul>
<li>Fix Electric Load page callback error. (<a href="https://github.com/NREL/SAM/pull/1412">SAM 1412</a>)
<li>Help revisions. (<a href="https://github.com/NREL/SAM/pull/1413">SAM 1413</a>)
</ul>
<h1 id="2022-11-21-r2">SAM 2022.11.21 r2, SSC 280: May 27, 2023</h1>
<p>This is the second maintenance update to <a href="2022-11-21">SAM 2022.11.21</a>.</p>
<ul>
<li>Fix the Edit Losses window (LossAdjustment widget): Improve summary text that appears on input page to make it clearer how time series and custom period losses are applied, fix input modes, and fix widget for CSP solar field availability inputs. (<a href="https://github.com/NREL/SAM/pull/1408">SAM 1408</a>, <a href="https://github.com/NREL/ssc/pull/1024">SSC 1024</a>, <a href="https://github.com/NREL/ssc/pull/1028">SSC 1028)</a></li>
<li>Fix marine energy PDF report rounding of numbers and add LCOE and FCR table. (<a href="https://github.com/NREL/SAM/pull/1399">SAM 1399</a>)</li>
<li>Fix photovoltaic PDF report so monthly energy graphs display correctly for large systems. (<a href="https://github.com/NREL/SAM/pull/1394">SAM 1394</a>)</li>
<li>Fix critical load array length problems. (<a href="https://github.com/NREL/SAM/pull/1397">SAM 1397</a>, <a href="https://github.com/NREL/ssc/pull/1021">SSC 1021</a>, <a href="https://github.com/NREL/SAM/pull/1390">SAM 1390</a>)</li>
<li>Update WIND Toolkit download sample scripts. (<a href="https://github.com/NREL/SAM/pull/1396">SAM 1396</a>)</li>
<li>Fix photovoltaic loss diagram to avoid overlapping text. (<a href="https://github.com/NREL/SAM/pull/1393">SAM 1393</a>)</li>
<li>Fix photovoltaic CAPEX graphs on Installation Costs page. (<a href="https://github.com/NREL/SAM/pull/1386">SAM 1386</a>)</li>
<li>Fix direct steam linear Fresnel callback error on System Design page. (<a href="https://github.com/NREL/SAM/pull/1382">SAM 1382</a>)</li>
<li>Fix high-concentration photovoltaic callback error on Inverter page. (<a href="https://github.com/NREL/SAM/pull/1381">SAM 1381</a>)</li>
<li>Fix geothermal cost calculations for automatic plant cost estimate. (<a href="https://github.com/NREL/SAM/pull/1379">SAM 1379</a>)</li>
<li>Revise multiple weather file download instructions in page note. (<a href="https://github.com/NREL/SAM/pull/1377">SAM 1377</a>)</li>
<li>Improve photovoltaic sizing message logic and text. (<a href="https://github.com/NREL/SAM/pull/1376">SAM 1376</a>)</li>
<li>Update WIND Toolkit downloads to use wtk-download endpoint instead of wtk-srw-download to provide access to subhourly data. (<a href="https://github.com/NREL/SAM/pull/1374">SAM 1374</a>)</li>
<li>Update hourly price downloads to Cambium 2022 and add an optional escalation rate. (<a href="https://github.com/NREL/SAM/pull/1365">SAM 1365</a>)</li>
<li>Update battery price signals dispatch to use same approach as peak shaving so battery dispatch can respond to system power and load. (<a href="https://github.com/NREL/ssc/pull/1031">SSC 1031</a>)</li>
<li>Update REopt battery sizing for standalone battery, includes updating PySAM tools for Utility Rate Database (URDB) to URDB Version 8. (<a href="https://github.com/NREL/ssc/pull/1022">SSC 1022</a>)</li>
<li>Add check on battery voltage table for duplicate voltage values to prevent battery charge power exceeding available power from system. (<a href="https://github.com/NREL/ssc/pull/1020">SSC 1020</a>)</li>
<li>Update weather file reader to avoid error about different number of columns in header rows for SAM CSV solar resource file format. (<a href ="https://github.com/NREL/ssc/pull/1017">SSC 1017</a>)</li>
</ul>
<h1 id="2022-11-21-r1">SAM 2022.11.21 r1, SSC 279: February 23, 2023</h1>
<p>This is the first maintenance update to <a href="#2022-11-21">SAM 2022.11.21</a>.</p>
<ul>
<li>Add support to Wind Power model for wind resource file format compatible with WIND Toolkit API. The Wind model still reads wind resource files in SRW format (.srw file extension) for legacy wind resource files, but the <a href="https://samrepo.nrelcloud.org/help/weather_format_csv_wind.htm">SAM CSV format for WIND</a> is now SAM's default format for wind resource files. (<a href="https://github.com/NREL/ssc/pull/985">SSC 985</a>)</li>
<li>Add Artic XCPC collector to Solar Water Heating collector library. (<a href="https://github.com/NREL/SAM/pull/1337">SAM 1337</a>)</li>
<li>Fix Geothermal resource temperature input constraint on maximum value. (<a href="https://github.com/NREL/SAM/pull/1341">SAM 1341</a>, <a href="https://github.com/NREL/ssc/pull/986">SSC 986</a>)</li>
<li>Fix issue for Geothermal resource temperature less than 150°C causing capacity factor greater than 1. (<a href="https://github.com/NREL/ssc/pull/989">SSC 989</a>)</li>
<li>New Python sample script to download data from the OpenEI End Use Load Profiles database. (<a href="https://github.com/NREL/SAM/pull/1331">SAM 1331</a>)</li>
<li>Convert UI forms to JSON. (<a href="https://github.com/NREL/SAM/pull/1338">SAM 1338</a>, <a href="https://github.com/NREL/wex/pull/155">WEX 155</a>)</li>
<li>Fix descriptive text in Loss Adjustment widget. (<a href="https://github.com/NREL/SAM/pull/1355">SAM 1355</a>)</li>
<li>Fix 'irrad_mode' input variable documentation. (<a href="https://github.com/NREL/ssc/pull/955">SSC 955</a>)</li>
<li>Revise and update Help. (<a href="https://github.com/NREL/SAM/pull/1359">SAM 1359</a>)</li>
<li>Battery Storage
<ul>
<li>Fix issue with Generic Battery price signal dispatch causing simulation crash. (<a href="https://github.com/NREL/ssc/pull/991">SSC 991</a>)</li>
<li>Fix missing Help topic for Stanadalone Battery installation cost page. (<a href="https://github.com/NREL/SAM/pull/1347">SAM 1347</a>)</li>
<li>Fix issue with PV - Battery configurations caused by specifying negative time series losses. (<a href="https://github.com/NREL/ssc/pull/980">SSC 980</a>)</li>
</ul>
</li>
<li>CSP, IPH and TES
<ul>
<li>New Pumped Thermal Energy Storage (PTES) design-point parameter calculator. (<a href="https://github.com/NREL/SAM/pull/1318">SAM 1318</a>, <a href="https://github.com/NREL/ssc/pull/965">SSC 965</a>)</li>
<li>Add methanol as cold TES option for Pumped Thermal Energy Storage (PTES). (<a href="https://github.com/NREL/SAM/pull/1307">SAM 1307</a>, <a href="https://github.com/NREL/ssc/pull/967">SSC 967</a>)</li>
<li>Fix Electric Thermal Energy Storage (ETES) issue loading input pages. (<a href="https://github.com/NREL/SAM/pull/1312">SAM 1312</a>, <a href="https://github.com/NREL/ssc/pull/961">SSC 961</a>)</li>
<li>Fix Physical Trough labeling of SCA and HCE in loop configuration widget and SCA and HCE input pages. (<a href="https://github.com/NREL/SAM/pull/1329">SAM 1329</a>)</li>
<li>Fix issue with Physical Trough at 600 MWt heat capacity simulation failing. (<a href="https://github.com/NREL/ssc/pull/982">SSC 982</a>)</li>
<li>Fix Molten Salt Power Tower optimization failure and erroneous calculated design point values of -789. (<a href="https://github.com/NREL/ssc/pull/976">SSC 976</a>)</li>
<li>Add ternery salt properties to HTF options for Molten Salt Power Tower. (<a href="https://github.com/NREL/SAM/pull/1321">SAM 1321</a>)</li>
<li>Fix Industrial Process Heat (IPH) Trough and Physical Trough models to allow use of 'solar_resource_data' input. (<a href="https://github.com/NREL/ssc/pull/975">SSC 975</a>)</li>
<li>Fix issue with name of system capacity variable in internal code. (<a href="https://github.com/NREL/ssc/pull/958">SSC 958</a>)</li>
</ul>
</li>
<li>Financial Models
<ul>
<li>Fix issue with NaN in financial model results for performance models that run single year simulations. (<a href="https://github.com/NREL/ssc/pull/993">SSC 993</a>)</li>
<li>Fix issue with display of lifetime electricity load output for performance models with singe-year simulations. (<a href="https://github.com/NREL/ssc/pull/963">SSC 963</a>)</li>
<li>Fix ITC for PPA Sale Leaseback to apply to all years. (<a href="https://github.com/NREL/ssc/pull/988">SSC 988</a>)</li>
<li>Update cash flow Excel Send-to-Excel with Equations to support multi-year ITC. (<a href="https://github.com/NREL/SAM/pull/1343">SAM 1343</a>)</li>
<li>Electricity rate energy charge supports up to 36 TOU periods. (<a href="https://github.com/NREL/SAM/pull/1357">SAM 1357</a>)</li>
<li>Add button to Electric Load page to run "Download Load Data" macro. (<a href="https://github.com/NREL/SAM/pull/1349">SAM 1349</a>)</li>
<li>Fix issue with grid outage code that cause simulation to stop without finishing. (<a href="https://github.com/NREL/ssc/pull/979">SSC 979</a>)</li>
<li>Improve output variable labels to make effect of grid interconnection clearer. (<a href="https://github.com/NREL/ssc/pull/983">SSC 983</a>)</li>
</ul>
</li>
<li>Detailed PV
<ul>
<li>Fix issue with reporting of rear-side soiling losses for bifacial modules when rack shading loss set to zero. (<a href="https://github.com/NREL/ssc/pull/978">SSC 978</a>)</li>
<li>Fix issue with reporting of bifacial gain output. (<a href="https://github.com/NREL/ssc/pull/951">SSC 951</a>)</li>
<li>Condense albedo out-of-range simulation warnings. (<a href="https://github.com/NREL/ssc/pull/996">SSC 996</a>)</li>
<li>Make inverter voltage ratings editable and improve system sizing messages. (<a href="https://github.com/NREL/SAM/pull/1352">SAM 1352</a>)</li>
<li>Fix ground clearance height issue for Sandia module model that cause simulation to stop without finishing. (<a href="https://github.com/NREL/ssc/pull/960">SSC 960</a>)</li>
<li>Update default module parameters for Sandia, CEC with User Specifications, Simple Efficiency, and IEC 61853 module models to be consistent with CEC Database model. (<a href="https://github.com/NREL/SAM/pull/1335">SAM 1335</a></li>
</ul>
</li>
<li>PVWatts
<ul>
<li>Fix REopt API call for PVWatts-Battery configurations. (<a href="https://github.com/NREL/ssc/pull/952">SSC 952</a>, <a href="https://github.com/NREL/SAM/pull/1301">SAM 1301</a>)</li>
<li>New PVWatts warning when bifacial module enabled with fixed roof mount. (<a href="https://github.com/NREL/ssc/pull/953">SSC 953</a>)</li>
<li>Change default O&M cost for PVWatts-Battery configurations to better account for battery cost. (<a href="https://github.com/NREL/SAM/pull/1326">SAM 1326</a>)></li>
<li>Fix callback error with PVWatts Advanced Inputs for PVWatts with no financial model configurations. (<a HREF="https://github.com/NREL/SAM/pull/1309">SAM 1309</a>)</li>
</ul>
</li>
<li>Marine Energy
<ul>
<li>Fix Marine Energy callback error when choosing resource options. (<a href="https://github.com/NREL/SAM/pull/1304">SAM 1304</a>)</li>
<li>Fix Marine Energy issue copying and pasting tidal resource data on Mac. (<a href="https://github.com/NREL/wex/pull/148">WEX 148</a>)</li>
</ul>
</li>
</ul>
<h1 id="2022-11-21">SAM 2022.11.21, SSC 278: November 21, 2022</h1>
<p>This new version introduces a new Pumped Thermal Energy Storage (PTES) model and consists of several improvements and updates. For a complete list of code revisions associated with this version, see the <a href="https://github.com/NREL/SAM/pulls?q=is%3Apr+milestone%3A%22SAM+Fall+2022+Release%22+is%3Aclosed">SAM</a> and <a href="https://github.com/NREL/ssc/pulls?q=is%3Apr+milestone%3A%22SAM+Fall+2022+Release%22+is%3Aclosed">SSC</a> GitHub repositories. Highlights include:</p>
<ul>
<li>New Pumped Thermal Energy Storage (PTES) model with dispatch optimization.</li>
<li>CSP Power Tower option to charge TES (via dispatch optimization) from grid via electric heater.</li>
<li>PV uncertainty model improves on P50/P90 simulations for photovoltaic systems.</li>
<li>Add battery storage and PPA Single Owner financial model option to Marine Energy Wave model.</li>
<li>Updates to Geothermal Power model.</li>
<li>Spatial albedo and ground irradiance calculations for Detailed Photovoltaic model.</li>
<li>Investment tax credit (ITC) as either Year 1 credit or spread over multiple years.</li>
</ul>
<p>The following is a list of outstanding issues we plan to address for an update to this version in early 2023. For a complete list see <a href="https://github.com/NREL/SAM/issues?page=1&q=is%3Aopen+is%3Aissue+milestone%3A%22SAM+Fall+2022+Release+Patch+1%22">SAM</a> and <a href="https://github.com/NREL/ssc/issues?page=1&q=is%3Aopen+is%3Aissue+milestone%3A%22SAM+Fall+2022+Release+Patch+1%22">SSC</a> repositories:</p>
<ul>
<li>Add support for ITC as array to cash flow send-to-Excel with equations.</li>
<li>Generic System model Generate profile from open cases causes SAM to crash.</li>
<li>Behind-the-meter (BTM) battery does not dispatch for small battery.</li>
<li>Update Cambium market price downloads to 2021 data.</li>
<li>Grid interconnection limit does not affect monthly outputs.</li>
<li>Update WIND Toolkit downloads.</li>
<li>Fuel cell with battery simulations progress bar to 133%.</li>
</ul>
<h2>General (2022.11.21)</h2>
<ul>
<li>Update defaults for current version of <a href="https://atb.nrel.gov/">NREL Annual Technology Baseline (ATB)</a></li>
<li>Fix user interface layout issues for Linux and Mac versions. (This is an ongoing effort.)</li>
<li>Fix sample script for downloading weather files from NSRDB to include time zone. (<a href="https://github.com/NREL/SAM/pull/1213">SAM 1213</a>)</li>
<li>Fix issue with solar resource library folder with Advanced Download option. (<a href="https://github.com/NREL/SAM/pull/1182">SAM 1182</a>)</li>
<li>Improve Edit Losses window to support specifying time periods with minutes. (<a href="https://github.com/NREL/SAM/pull/1164">SAM 1164</a>, <a href="https://github.com/NREL/ssc/pull/878">SSC 878</a>)</li>
<li>For array inputs, automatically convert inputs provided as number to array. This impacts LK scripts, Software Development Kit, and PySAM users, and is intended to provide backward compatibility for code written for ITC as number. (<a href="https://github.com/NREL/ssc/pull/907">SSC 907</a>)</li>
</ul>
<h2>Financial Models (2022.11.21)</h2>
<ul>
<li>Fix bug in Community Solar subscriber NPV calculation. (<a href="https://github.com/NREL/SAM/pull/1242">SAM 1242</a>, <a href="https://github.com/NREL/ssc/pull/929">SSC 929</a>)</li>
<li>Change investment tax credit (ITC) inputs from number to array to allow it to be specified for one year or spread out over multiple years. (<a href="https://github.com/NREL/ssc/pull/913">SSC 913</a>)</li>
</ul>
<h2>Electricity Rates (2022.11.21)</h2>
<ul>
<li>For Utility Rate Database (URDB) downloads, apply look back months to billing demand inputs instead of listing as unused. (<a href="https://github.com/NREL/SAM/pull/1237">SAM 1237</a>)</li>
<li>Fix rollover calculation for bill without system. (<a href="https://github.com/NREL/ssc/pull/941">SSC 941</a>)</li>
</ul>
<h2>Detailed Photovoltaic (2022.11.21)</h2>
<ul>
<li>Update module and inverter libraries. (<a href="https://github.com/NREL/SAM/pull/1269">SAM 1269</a>)</li>
<li>Enhance bifacial model with electrical mismatch loss estimate and spatial albedo, and new Spatial tab on Results page. (<a href="https://github.com/NREL/SAM/pull/1152">SAM 1152</a>, <a href="https://github.com/NREL/ssc/pull/871">SSC 871</a>, <a href="https://github.com/NREL/SAM/pull/1199">SAM 1199</a>)</li>
<li>Update P50/P90 simulations to PV Uncertainty with more sophisticated modeling of uncertainty factors. (<a href="https://github.com/NREL/SAM/pull/1076">SAM 1076</a>)</li>
<li>Add option to input land area in acres/MWac and fix land area calculatoins. (<a href="https://github.com/NREL/SAM/pull/1195">SAM 1195</a>, <a href="https://github.com/NREL/SAM/pull/1166">SAM 1166</a>)</li>
<li>Fix problem with terrain slope input enabling. (<a href="https://github.com/NREL/SAM/pull/1191">SAM 1191</a>)</li>
<li>Improve error handling for different albedo input options. (<a href="https://github.com/NREL/SAM/pull/1180">SAM 1180</a>)</li>
<li>Add warning in user interface for negative tilt angles. (<a href="https://github.com/NREL/SAM/pull/1171">SAM 1171</a>)</li>
<li>Report latitude, longitude, elevation, and time zone from weather file header in simulation results. (<a href="https://github.com/NREL/ssc/pull/908">SSC 908</a>)</li>
<li>New time series module temperature input to bypass internal calculations (SSC and LK script only, not available in SAM input pages). (<a href="https://github.com/NREL/ssc/pull/897">SSC 897</a>)</li>
<li>Improve input checks in variable table for Software Development Kit and PySAM users. (<a href="https://github.com/NREL/ssc/pull/885">SSC 885</a>)</li>
<li>Fix issue with AC wiring loss for subhourly simulations. (<a href="https://github.com/NREL/ssc/pull/879">SSC 879</a>)</li>
</ul>
<h2>PVWatts (2022.11.21)</h2>
<ul>
<li>Improve handling and error reporting for albedo. (<a href="https://github.com/NREL/SAM/pull/1136">SAM 1136</a>, <a href="https://github.com/NREL/ssc/pull/864">SSC 864</a>)</li>
<li>Add option to input land area in acres/MWac and fix land area calculatoins. (<a href="https://github.com/NREL/SAM/pull/1195">SAM 1195</a>, <a href="https://github.com/NREL/SAM/pull/1166">SAM 1166</a>)</li>
<li>Report latitude, longitude, elevation, and time zone from weather file header in simulation results. (<a href="https://github.com/NREL/ssc/pull/908">SSC 908</a>)</li>
<li>Fix issue with snow loss model that resulted in DC snow loss of zero for time steps with snow. (<a href="https://github.com/NREL/ssc/pull/874">SSC 874</a>)</li>
<li>Fix issue with inverter efficiency at lower power. (<a href="https://github.com/NREL/ssc/pull/872">SSC 872</a>)</li>
</ul>
<h2>Battery Storage (2022.11.21)</h2>
<ul>
<li>Improve reporting of AC and DC in kW and kWh inputs and outputs. (<a href="https://github.com/NREL/SAM/pull/1183">SAM 1183</a>, <a href="https://github.com/NREL/ssc/pull/899">SSC 899</a>, <a href="https://github.com/NREL/ssc/pull/889">SSC 889</a>)</li>
<li>Improve passing of SAM inputs to REopt. (<a href="https://github.com/NREL/SAM/pull/1165">SAM 1165</a>)</li>
<li>Improve transformer loss calculations so losses are better accounted for in battery dispatch. (<a href="https://github.com/NREL/ssc/pull/936"></a>)</li>
<li>For PV smoothing, change battery state of charge (SOC) to end of time step to be consistent with other dispatch options. (<a href="https://github.com/NREL/ssc/pull/904">SSC 904</a>)</li>
<li>Restore PV priority option for manual dispatch option. (<a href="https://github.com/NREL/ssc/pull/900">SSC 900</a>)</li>
<li>Various Levelized Cost of Storage (LCOS) fixes. (<a href="https://github.com/NREL/ssc/pull/883">SSC 883</a>, <a href="https://github.com/NREL/ssc/issues/853">SSC 853</a>)</li>
<li>Fix price signals dispatch option for rates with different periods in a month. (<a href="https://github.com/NREL/ssc/pull/882">SSC 882</a>)</li>
<li>Make front-of-meter (FOM) automated dispatch aware of retail electricity prices. (<a href="https://github.com/NREL/ssc/issues/824">SSC 824</a>)</li>
<li>Improvements to front-of-meter (FOM) automated dispatch. (<a href="https://github.com/NREL/ssc/pull/877">SSC 877</a>)</li>
<li>New 'utilityrateforecast' compute module for Software Development Kit (SDK) and PySAM coders. (<a href="https://github.com/NREL/ssc/pull/868">SSC 868</a>)</li>
</ul>
<h2>Concentrating Solar Power (2022.11.21)</h2>
<ul>
<li>Remove boiler pressure input from Rankine cycle model. (<a href="https://github.com/NREL/SAM/pull/1192">SAM 1192</a>)</li>
<li>Bug fixes for Rankine power cycle model. These changes result in up to 5% increase in total annual energy production for the default molten salt power tower model, and smaller increases for other CSP models using this power cycle model. (<a href="https://github.com/NREL/ssc/pull/861">SSC 861</a>)</li>
</ul>
<h2>Marine Energy</h2>
<ul>
<li>Add battery storage option to Marine Wave model. (<a href="https://github.com/NREL/ssc/pull/890">SSC 890</a>)</li>
</ul>
<h2>Geothermal Power (2022.11.21)</h2>
<ul>
<li>Update to latest version of GETEM. (<a href="https://github.com/NREL/SAM/pull/1174">SAM 1174</a>, <a href="https://github.com/NREL/ssc/pull/886">SSC 886</a>)</li>
<li>Fix number of wells calculation. (<a href="https://github.com/NREL/ssc/pull/875">SSC 875</a>)</li>
</ul>
<h2>Wind Power (2022.11.21)</h2>
<ul>
<li>Remove BOS model options from Residential and Commercial configurations. (<a href="https://github.com/NREL/SAM/pull/1169">SAM 1169</a>)</li>
</ul>
<h2>Fuel Cell</h2>
<ul>
<li>Fix issue with fuel cell capex table interpolation. (<a href="https://github.com/NREL/SAM/pull/1272">SAM 1272</a>)</li>
<li>Allow AC-connected battery to charge from fuel cell during grid outage. (<a href="https://github.com/NREL/ssc/pull/880">SSC 880</a>)</li>
</ul>
<h1 id="2021-12-02-r2">SAM 2021.12.02 r2, SSC 274: June 6 , 2022</h1>
<p>This is a maintenance update to <a href="#2021-12-02">SAM 2021.12.02 Revision 1</a>.</p>
<ul>
<li>Improve feedback for parametric simulation graphs when they cannot be displayed. (<a href="https://github.com/NREL/SAM/pull/1051">1051</a>)</li>
<li>Change labels on Results page Metrics table and graphs to be more consistent with output variable labels. (<a href="https://github.com/NREL/SAM/pull/1045">1045</a>)</li>
<li>Fix PVWatts land area value shown on cost input pages for PVWatts Battery configurations. (<a href="https://github.com/NREL/SAM/pull/1037">1037</a>)</li>
<li>Fix issue with Data Tables tab on Results page to correctly group variables by number of rows. (<a href="https://github.com/NREL/SAM/pull/1001">1001</a>)</li>
<li>For Wind resource data download from WIND Toolkit, add 2014 to list of available years. (<a href="https://github.com/NREL/SAM/pull/963">963</a>)</li>
<li>Revise Help system for latest updates. (<a href="https://github.com/NREL/SAM/pull/1062">1062</a>)</li>
<li>Add PVWatts output for AC power before AC adjustment factors are applied. (<a href="https://github.com/NREL/ssc/pull/830">SSC 830</a>)</li>
<li>Fix utilityrate module descriptions to clarify dependence on different OpenEI URDB versions. (<a href="https://github.com/NREL/ssc/pull/829">SSC 829</a>)</li>
<li>Detailed PV
<ul>
<li>Update CEC module and inverter libraries to May 2022 CEC database versions. (<a href="https://github.com/NREL/SAM/pull/1057">1057</a>, <a href="https://github.com/NREL/SAM/pull/1067">1067</a>)</li>
<li>Fix problem with DC degradation inputs that caused a simulation error "Degradation calculated to be greater than 100%, capped at 100%". <a href="https://github.com/NREL/SAM/pull/958">958</a>, <a href="https://github.com/NREL/ssc/pull/772">SSC 772</a>)</li>
<li>Add button to Inverter page Inverter Datasheet option to import library parameters to datasheet inputs. (<a href="https://github.com/NREL/SAM/pull/1053">1053</a>)</li>
<li>Fix inverter temperature derate table issue to provide feedback instead of generating an error when table has wrong number of columns. (<a href="https://github.com/NREL/SAM/pull/1027">1027</a>)</li>
<li>Fix PVsyst shade data import for Version 7. (<a href="https://github.com/NREL/SAM/pull/1054">1054</a>)</li>
<li>Fix PVsyst PAN to SAM macro to bettery handle module technology parameter. (<a href="https://github.com/NREL/SAM/pull/1047">1047</a>)</li>
<li>Fix Solmetric Suneye shading import. (<a href="https://github.com/NREL/SAM/pull/1052">1052</a>)</li>
<li>Add transmission losses to loss diagram. (<a href="https://github.com/NREL/SAM/pull/1000">1000</a>, <a href="https://github.com/NREL/ssc/pull/790">SSC 790</a>)</li>
<li>Make 6parsolve module coefficient calculator error messages more descriptive. (<a href="https://github.com/NREL/ssc/pull/827">SSC 827</a>, <a href="https://github.com/NREL/ssc/pull/802">802</a>)</li>
<li>Improve handling of albedo data errors. (<a href="https://github.com/NREL/ssc/pull/799">SSC 799</a>)</li>
<li>Report time series outputs over lifetime to facilitate comparison with other outputs in results. (<a href="https://github.com/NREL/ssc/pull/791">SSC 791</a>)</li>
</ul>
</li>
<li>Battery Storage
<ul>
<li>Fix REopt battery sizing and dispatch API calls. (<a href="https://github.com/NREL/SAM/pull/999">999</a>)</li>
<li>Add new battery dispatch input for Generic Battery configurations to allow battery to dispatch to a different generation profile than the power system generation profile. (<a href="https://github.com/NREL/SAM/pull/992">992</a>)</li>
<li>Fix problem with inputs for battery dispatch to grid power targets option. (<a href="https://github.com/NREL/SAM/pull/988">988</a>)</li>
<li>Fix issue with voltage table outside of battery state-of-charge limits. (<a href="https://github.com/NREL/ssc/pull/833">SSC 883</a>)</li>
<li>Add metric for capacity factor based on AC power to Standalone Battery configurations. (<a href="https://github.com/NREL/SAM/pull/1050">1050</a>, <a href="https://github.com/NREL/ssc/pull/820">SSC 820</a>)</li>
<li>Fix Standalone Battery nameplate capacity value used for capacity-based incentive and capacity revenue calculations. (<a href="https://github.com/NREL/SAM/pull/1040">1040</a>)</li>
<li>Add a new LK sample script to replicate battery computed properties calculations from SAM's user interface.(<a href="https://github.com/NREL/SAM/pull/1002">1002</a>)</li>
<li>Fix PV Battery / Single Owner default value of batt_Vcut to match other battery configurations. (<a href ="https://github.com/NREL/SAM/pull/1032">1032</a>)</li>
<li>Make Detailed PV macros available for PV Battery configurations, including for PV system sizing, PVsyst file import, subarray layout, etc. (<a href="https://github.com/NREL/SAM/pull/967">967</a>)</li>
<li>Apply battery state-of-charge limits to PV smoothing battery dispatch option. (<a href="https://github.com/NREL/ssc/pull/816">SSC 816</a>)</li>
<li>Improve behind-the-meter price signal dispatch option to respond to demand ratchets in electricty rate structure. (<a href="https://github.com/NREL/ssc/pull/800">SSC 800</a>)</li>
<li>Improve front-of-meter battery dispatch to price forecast to consider battery capacity in addition to price forecast. (<a href="https://github.com/NREL/ssc/pull/792">SSC 792</a>)</li>
<li>Improve front-of-meter battery dispatch to price forecast to use lifetime price data. (<a href="https://github.com/NREL/ssc/pull/787">SSC 787</a>)</li>
<li>Improve the way daily losses are applied to battery power. (<a href="https://github.com/NREL/ssc/pull/780">SSC 780</a>)</li>
<li>Account for battery operating costs in behind-the-meter (BTM) and front-of-meter (FOM) dispatch. (<a href="https://github.com/NREL/ssc/pull/856">SSC 856</a>)
</ul>
</li>
<li>Concentrating Solar Power (CSP)
<ul>
<li>Fix physical trough bug when number of SCAs in loop is changed. (<a href="https://github.com/NREL/SAM/pull/1014">1014</a>)</li>
<li>Fix issues with custom HTF. (<a href="https://github.com/NREL/SAM/pull/1007">1007</a>, <a href="https://github.com/NREL/SAM/pull/1006">1006</a>)</li>
<li>Add sub-cooled outlet option to Industrial Process Heat (IPH) Direct Steam Linear Fresnel model. (<a href="https://github.com/NREL/SAM/pull/973">973</a>, <a href="https://github.com/NREL/ssc/pull/776">SSC 776</a>)</li>
<li>Fix issue with Molten Salt Linear Fresnel (MSLF) partial sequential defocus. (<a href="https://github.com/NREL/ssc/pull/759">SSC 759</a>)</li>
</ul>
</li>
<li>Marine Energy
<ul>
<li>Add new feature to convert a set of one-year time series wave resource data files into a single joint probability distribution (JPD) file. (<a href="https://github.com/NREL/SAM/pull/993">993</a>)</li>
<li>For Wave Energy model, improve layout and text on Wave Resource input page. (<a href="https://github.com/NREL/SAM/pull/1025">1025</a>)</li>
</ul>
</li>
<li>Financial Models
<ul>
<li>Fix Send to Excel with Equations for all financial models so that Excel results more closely match SAM results. (<a href="https://github.com/NREL/SAM/pull/1044">1044</a>, <a href="https://github.com/NREL/ssc/pull/818">SSC 818</a>)</li>
<li>Fix issue with Value of RE macro tax rate calculation that prevented macro from running. (<a href="https://github.com/NREL/SAM/pull/982">982</a>)</li>
<li>Edit variable labels to include abbreviations LCOE, NPV, and IRR to facilitate searching for variable names. (<a href="https://github.com/NREL/SAM/pull/954">954</a>, <a href="https://github.com/NREL/ssc/pull/770">SSC 770</a>)</li>
<li>Fix merchant plant price data download from Cambium API. (<a href="https://github.com/NREL/SAM/pull/1063">1063</a>)</li>
<li>Fix merchant plant cleared capacity calculations when capacity is negative for battery charging or for system self-consumption. (<a href="https://github.com/NREL/SAM/pull/1059">1059</a>, <a href="https://github.com/NREL/ssc/pull/826">SSC 826</a>)</li>
<li>Fix interaction between analysis period and merchant plant price data input window. (<a href="https://github.com/NREL/SAM/pull/1041">1041</a>)</li>
<li>Fix LCOE Calculator issue with undefined analysis period and no financial model. (<a href="https://github.com/NREL/ssc/pull/797">SSC 797</a>)</li>
</ul>
</li>
<li>Solar Resource Data
<ul>
<li>Update Solar Resource File Converter macro for SolarAnywhere data to better handle subhourly data and missing data at end of row. (<a href="https://github.com/NREL/SAM/pull/1019">1019</a>, <a href="https://github.com/NREL/SAM/pull/951">951</a>)</li>
<li>Fix NSRDB weather data queries from Advanced NSRDB window to return correct time zone. (<a href="https://github.com/NREL/SAM/pull/1023">1023</a>, <a href="https://github.com/NREL/SAM/pull/950">950</a>)</li>
<li>Improve messages when NSRDB API returns an error message instead of weather data. (<a href="https://github.com/NREL/SAM/pull/1018">1018</a>)</li>
<li>Improve wfcheck error time stamp reporting. (<a href="https://github.com/NREL/ssc/pull/773">SSC 773</a>)</li>
</ul>
</li>
</ul>
<h1 id="2021-12-02-r1">SAM 2021.12.02 r1, SSC 274: February 21, 2022</h1>
<p>This is a maintenance update to <a href="#2021-12-02">SAM 2021.12.02</a>.</p>
<ul>
<li>Update CEC module and inverter libraries to December 2021 and February 2022 CEC database versions, respectively. (<a href="https://github.com/NREL/SAM/pull/946">946</a>)</li>
<li>Change default sales tax value to same value for all configurations. (<a href="https://github.com/NREL/SAM/pull/844">844</a>)</li>
<li>Fix issues with Solar Resource location name parsing of latitude/longitude pairs, addresses, and location names. (<a href="https://github.com/NREL/SAM/pull/929">929</a>)</li>
<li>Allow PVLIB labels as solar resource data columns in SAM CSV weather file format. (<a href="https://github.com/NREL/ssc/pull/754">SSC 754</a>)</li>
<li>Fix land area calculations for PVWatts and Detailed Photovoltaic models. (<a href="https://github.com/NREL/SAM/pull/928">928</a>, <a href="https://github.com/NREL/ssc/pull/761">SSC 761</a>)</li>
<li>Revise Help topics and fix issues with context-sensitive ETES Help topics not displaying properly. (<a href="https://github.com/NREL/SAM/pull/938">938</a>)</li>
<li>Fix marine energy labels in user interface. (<a href="https://github.com/NREL/SAM/pull/916">916</a>)</li>
<li>New marine wave energy option to convert time series wave resource data file to joint probability distribution data file. (<a href="https://github.com/NREL/SAM/pull/892">892</a>)</li>
<li>Update geothermal drilling cost curves. (<a href="https://github.com/NREL/SAM/pull/910">910</a>)</li>
<li>Fix geothermal issue with time stamps for hourly simulation option. (<a href="https://github.com/NREL/ssc/pull/690">SSC 690</a></li>
<li>Update electric thermal energy storage (ETES) default tax incentives and debt mode. (<a href="https://github.com/NREL/SAM/pull/900">900</a>)</li>
<li>Fix issue with wind turbine characteristics equations. (<a href="https://github.com/NREL/SAM/pull/897">894</a>, <a href="https://github.com/NREL/ssc/pull/730">SSC 730</a>)</li>
<li>Allow wind resource files with "srw" and "csv" extension. (<a href="https://github.com/NREL/SAM/pull/929">929</a>)</li>
<li>Update SAM sample files to work with SAM 2021.12.01. (<a href="https://github.com/NREL/SAM/pull/895">895</a>)</li>
<li>Cash Flow
<ul>
<li>Fix Cash Flow Send to Excel with Equations for Single Owner financial model. This feature will be fixed for other financial models for SAM 2021.12.02 Revision 2. (<a href="https://github.com/NREL/SAM/pull/936">936</a>)</li>
<li>Add operation and maintenance costs for battery, fuel cell, and fuel as appropriate to cash flow operating costs line itames. (<a href="https://github.com/NREL/SAM/pull/927">927</a>, <a href="https://github.com/NREL/SAM/pull/909">909</a>, <a href="https://github.com/NREL/ssc/pull/762">SSC 762</a>, <a href="https://github.com/NREL/ssc/pull/753">SSC 753</a>)</li>
<li>Fix annual electricity values for cash flow output. (<a href="https://github.com/NREL/SAM/pull/919">919</a>, <a href="https://github.com/NREL/ssc/pull/756">SSC 756</a>, <a href="https://github.com/NREL/ssc/pull/750">SSC 750</a>)</li>
</ul>
</li>
<li>Battery
<ul>
<li>Fix issue with battery environment temperature input. (<a href="https://github.com/NREL/SAM/pull/920">920</a>, <a href="https://github.com/NREL/ssc/pull/751">SSC 751</a>)</li>
<li>Fix issues with battery dispatch inputs including enabling/disabling options, and grid power target array length. (<a href="https://github.com/NREL/SAM/pull/860">860</a>, <a href="https://github.com/NREL/SAM/pull/855">855</a>, <a href="https://github.com/NREL/SAM/pull/858">858</a>)</li>
<li>Fix battery life model for Li-ion NMC/Graphite battery type. (<a href="https://github.com/NREL/ssc/pull/763">SSC 763</a>, <a href="https://github.com/NREL/ssc/pull/748">748</a>)</li>
<li>Fix battery dispatch PV smoothing algorithm to make battery state of charge value for dispatch consistent with value for simulation. (<a href="https://github.com/NREL/ssc/pull/758">SSC 758</a>)</li>
<li>Fix issue with battery merchant plant dispatch to power price and check that generation exceeds cleared capacity. (<a href="https://github.com/NREL/ssc/pull/729">SSC 729</a>)</li>
<li>Change "Market sell rate" label to "Power price for battery dispatch" to make it clear variable is for battery dispatch calculations. (<a href="https://github.com/NREL/ssc/pull/706">SSC 706</a>)</li>
<li>Fix battery degradation issue that caused SAM to crash. (<a href="https://github.com/NREL/ssc/pull/796">SSC 796</a>)</li>
</ul>
</li>
<li>Grid Outage and Critical Load
<ul>
<li>Consolidate inputs for behind-the-meter grid outage inputs on new Grid Outage page. (<a href="https://github.com/NREL/SAM/pull/902">902</a>, <a href="https://github.com/NREL/SAM/pull/842">842</a>)</li>
<li>Remove grid outage feature from PVWatts - battery configuration. (<a href="https://github.com/NREL/SAM/pull/884">884</a>, <a href="https://github.com/NREL/SAM/pull/945">945</a>, <a href="https://github.com/NREL/ssc/pull/767">SSC 767</a>)</li>
<li>Add grid outage inputs to standalone battery behind-the-meter configurations. (<a href="https://github.com/NREL/SAM/pull/873">873</a>)</li>
<li>Fix grid outage issue to prevent load during outage being used for electricity bill calculation. (<a href="https://github.com/NREL/ssc/pull/741">SSC 741</a>)</li>
<li>Improve behavior of DC-connected battery during outage to allow charging during outage. (<a href="https://github.com/NREL/ssc/pull/738">SSC 738</a>, <a href="https://github.com/NREL/ssc/pull/728">SSC 728</a>, <a href="https://github.com/NREL/ssc/pull/725">SSC 725</a>)</li>
<li>Fix problem with scaling of critical load. (<a href="https://github.com/NREL/SAM/pull/842">842</a>)</li>
</ul>
</li>
<li>Concentraing Solar Power (CSP)
<ul>
<li>Fix CSP molten salt linear Fresnel thermal efficiency calculation in user interface. (<a href="https://github.com/NREL/SAM/pull/939">939</a>)</li>
<li>Fix CSP molten salt linear Fresnel sequential defocus bug. (<a href="https://github.com/NREL/ssc/pull/760">SSC 760</a>)</li>
<li>Fix CSP user-defined power cycle equation for HTF mass flow rate. When applied to the default molten salt power tower case where the cycle model is changed to the default UDPC inputs, the annual energy increase 0.1%. The effect may be more significant if 1) your UDPC data includes more variation relative to the default data at m_dot_HTF > 1 or 2) your case increases the maximum HTF over-design above the default 1.05 value. (<a href="https://github.com/NREL/ssc/pull/695">SSC 695</a>)</li>
<li>Update default financial assumptions for concentrating solar power (CSP) configurations. (<a href="https://github.com/NREL/SAM/pull/904">904</a>)</li>
</ul>
</li>
<li>Electricity Bill and Purchases
<ul>
<li>Fix issue with front-of-meter electricity purchases when non-zero sell rate input value was hidden. (<a href="https://github.com/NREL/SAM/pull/908">908</a>)</li>
<li>Fix issues with billing demand periods table. (<a href="https://github.com/NREL/SAM/pull/889">889</a>)</li>
<li>Fix issues with billing demand calculations with only kWh/kW energy charge units. (<a href="https://github.com/NREL/ssc/pull/723">SSC 723</a>)
<li>Fix issue with reporting of time series demand charge and electricity peak values. (<a href="https://github.com/NREL/ssc/pull/733">SSC 733</a>)</li>
</ul>
</ul>
<h1 id="2021-12-02">SAM 2021.12.02, SSC 267: December 2, 2021</h1>
<p>This new version consists of several improvements and updates. Highlights include:</p>
<ul>
<li>Community Solar financial model</li>
<li>PVWatts update from V7 to V8</li>
<li>Standalone Battery and Standalone Electric Thermal Energy Storage models</li>
<li>Cavity receiver model for power towers</li>
<li>PV smoothing battery dispatch option and multiple improvements to battery dispatch and degradation models</li>
<li>Levelized cost of storage (LCOS) metric for battery storage configurations</li>
<li>Grid outage for systems with battery storage</li>
<li>Billing demand with lookback period for kWh/kW energy rates and ratcheting demand rates</li>
</ul>
<h2>General (2021.12.02)</h2>
<ul>
<li>Fix issues with PDF report templates for battery storage configurations, PPA financial models, and marine energy configurations. (<a href="https://github.com/NREL/SAM/pull/822">822</a>)</li>
<li>Update default assumptions to match <a href="https://atb.nrel.gov/">NREL Annual Technology Baseline</a>. (<a href="https://github.com/NREL/SAM/pull/833">833</a>, <a href="https://github.com/NREL/SAM/issues/827">827</a>, <a href="https://github.com/NREL/SAM/pull/823">823</a>, <a href="https://github.com/NREL/SAM/pull/812">812</a>, <a href="https://github.com/NREL/SAM/pull/793">793</a>, <a href="https://github.com/NREL/SAM/pull/786">786</a>, <a href="https://github.com/NREL/SAM/pull/783">783</a>)</li>
<li>Fix issue with yellow page notes disappearing when opening files created with older versions of SAM. (<a href="https://github.com/NREL/SAM/pull/809">809</a>)</li>
<li>Replace Combine Cases macro with option on Generic System model Power Plant input age. (<a href="https://github.com/NREL/SAM/pull/706">706</a>, <a href="https://github.com/NREL/SAM/pull/765">765</a>)</li>
</ul>
<h2>PVWatts (2021.12.02)</h2>
<p>With this release, we have updated SAM's implementation to PVWatts V8 (pvwattsv8 in SSC) with new features listed below. The online PVWatts® Calculator continues to use pvwattsv5 and will be updated later. All versions of PVWatts are available via the SAM Software Development Kit and PySAM. (<a href="https://github.com/NREL/SAM/pull/729">729</a>)</p>
<ul>
<li>Reorganize user interface to group advanced inputs into a collapsible panel.</li>
<li>Add snow loss model when weather file includes snow depth data in cm.</li>
<li>Support for bifacial modules.</li>
<li>Internal module and module thermal models based on same model as Detailed PV model.</li>
<li>Internal inverter model based on same model as Detailed PV model.</li>
<li>Inputs for monthly soiling as DC loss.</li>
</ul>
<h2>Detailed Photovoltaic (2021.12.02)</h2>
<ul>
<li>Modify default inverter temperature derate curve to work over the full range of inverter sizes in the CEC inverter library. (<a href="https://github.com/NREL/SAM/pull/804">804</a>)</li>
<li>Fix Shade Calculator crashing on MacOS. (<a href="https://github.com/NREL/SAM/pull/775">775</a>)</li>
<li>Add terrain slope inputs for one-axis trackers to improve backtracking and linear self-shading calculations for large arrays on sloped land. (<a href="https://github.com/NREL/SAM/pull/742">742</a>)</li>
<li>Model PV degradation as linear instead of compounded annually to better reflect recent research on module degradation. (<a href="https://github.com/NREL/SAM/pull/756">756</a>)</li>
<li>For weather files that generate simulation messages about abnormal irradiance values, change messages from warnings to notices to avoid long list of messages after simulation. (<a href="https://github.com/NREL/ssc/pull/658">658</a>)</li>
<li>Update the CEC module model to assume anti-reflective coatings for all PV modules (<a href="https://github.com/NREL/ssc/pull/662">662</a>)</li>
</ul>
<h2>Battery Storage (2021.12.02)</h2>
<ul>
<li>Redesigned user interface for battery dispatch choices for PV Battery, Generic Battery, Fuel Cell, and new Standalone Battery configurations. (<a href="https://github.com/NREL/SAM/pull/819">819</a>, <a href="https://github.com/NREL/SAM/pull/834">834</a>, <a href="https://github.com/NREL/SAM/pull/830">830</a>, <a href="https://github.com/NREL/SAM/pull/821">821</a>, <a href="https://github.com/NREL/SAM/pull/819">819</a>, <a href="https://github.com/NREL/SAM/pull/806">806</a>, <a href="https://github.com/NREL/SAM/pull/805">805</a>, <a href="https://github.com/NREL/SAM/pull/712">712</a>, <a href="https://github.com/NREL/SAM/pull/690">690</a>, <a href="https://github.com/NREL/SAM/pull/656">656</a>, <a href="https://github.com/NREL/SAM/pull/644">644</a>)</li>
<li>Add option to specify surface area of single battery to improve battery temperature calculations for large batteries.(<a href="https://github.com/NREL/SAM/pull/789">789</a>)</li>
<li>New levelized cost of storage (LCOS) metric. (<a href="https://github.com/NREL/ssc/pull/679">679</a>, <a href="https://github.com/NREL/SAM/pull/529">529</a>)</li>
<li>Better battery degradation modeling for Li-ion NMC/Graphite and Li-ion LMO/LTO battery types, and improve cycle counting algorithm for battery degradation model to better handle situations with high-frequency low-DOD discharges. (<a href="https://github.com/NREL/ssc/pull/677">677</a>, <a href="https://github.com/NREL/SAM/pull/707">707</a>)</li>
<li>New Standalone Battery configuration based on Generic Battery configuration. (<a href="https://github.com/NREL/SAM/pull/766">766</a>, <a href="https://github.com/NREL/ssc/pull/659">659</a>)</li>
<li>Add options for AC-connected behind-the-meter batteries to charge when system output is less than load, and discharge when load is less than system output to be consistent with REopt dispatch. (<a href="https://github.com/NREL/SAM/pull/692">692</a>)</li>
<li>Add dispatch options for behind-the-meter batteries to forecast to custom time series data for weather and load. (<a href="https://github.com/NREL/SAM/pull/688">688</a>, <a href="https://github.com/NREL/SAM/pull/681">681</a>)</li>
<li>Allow behind-the-meter batteries to be charged from clipped photovoltaic power, and to discharge to the grid. (<a href="https://github.com/NREL/SAM/pull/754">754</a>, <a href="https://github.com/NREL/ssc/pull/653">653</a>)</li>
<li>Remove option to use ambient temperature data from weather file as battery environment temperature for battery temperature calculations because Generic Battery and Standalone Battery configurations do not have a weather file. SAM automatically applies weather file ambient temperature to battery environment time series input when opening older files as appropriate. (<a href="https://github.com/NREL/SAM/pull/679">679</a>)
<li>Add grid outage dispatch capability for behind-the-meter batteries. (<a href="https://github.com/NREL/SAM/pull/722">722</a>, <a href="https://github.com/NREL/SAM/pull/721">721</a>, <a href="https://github.com/NREL/SAM/pull/707">707</a>)</li>
<li>Ensure correct battery capacity values are read into new variables when opening a file or case created by an older version of SAM. (<a href="https://github.com/NREL/SAM/pull/781">781</a>)</li>
<li>Ensure correct values passed to model when switching between kWh and h option for specifying battery capacity. (<a href="https://github.com/NREL/SAM/pull/720">720</a>)</li>
<li>Disable option for charging from photovoltaic clipped power for Generic Battery configurations. (<a href="https://github.com/NREL/SAM/pull/677">677</a>)</li>
<li>New cutoff voltage input for battery voltage model. (<a href="https://github.com/NREL/SAM/pull/502">502</a>)</li>
<li>Fix issue with cycle degradation penalty value of zero or NaN ("not a number") calculation for price signal and automated economic dispatch options. (<a href="https://github.com/NREL/ssc/pull/627">627</a>)</li>
</ul>
<h2>Financial Models (2021.12.02)</h2>
<ul>
<li>Separate System Costs page into Installation Costs and Operating Costs pages to improve visbility of operating cost inputs and allow for more flexibilty in operating cost inputs for different technology types. (<a href="https://github.com/NREL/SAM/pull/653">653</a>)</li>
<li>Treat electricity purchases to charge batteries or meet night-time load as an operating cost in project cash flow regardless of whether power price for purchases is retail rate or PPA price. (<a href="https://github.com/NREL/SAM/pull/785">785</a>)</li>
<li>Add option to front-of-meter financial models to model land lease payments as an operating cost in project cash flow. (<a href="https://github.com/NREL/SAM/pull/779">779</a>)</li>
<li>Update electricity rate data download from NREL Utility Rate Database (URDB) to URDB Version 8 and correctly handle unsupported inputs and units. (<a href="https://github.com/NREL/SAM/pull/758">758</a>)</li>
<li>Calculate billing demand in kW for electricity bill energy charges with kWh/kW units. (<a href="https://github.com/NREL/SAM/pull/627">627</a>)</li>
<li>Ratcheting demand charges for electricity bill calculations. (<a href="https://github.com/NREL/ssc/pull/637">637</a>, <a href="https://github.com/NREL/SAM/pull/728">728</a>)</li>
<li>Modify levelized cost of energy (LCOE) to use energy exported to grid as energy term in denominator instead of energy generated by system to better represent value of energy for systems with storage. (<a href="https://github.com/NREL/SAM/pull/749">749</a>)</li>
<li>Fix units in variable labels for operation and maintenance (O&M) costs from $/kWh to $/MWh. (<a href="https://github.com/NREL/SAM/pull/667">667</a>)</li>
<li>For electricity bill calculations with tiered rates and buy all/sell all compensation, ensure usage for night-time consumption (e.g., inverter night-time consumption) is assigned to the highest tier rather than the lowest tier. (<a href="https://github.com/NREL/ssc/pull/673">673</a>)</li>
<li>Add Cambium forecast hourly price data download option to Merchant Plant model. (<a href="https://github.com/NREL/SAM/pull/669">0669</a>)</li>
</ul>
<h2>Concentrating Solar Power (2021.12.02)</h2>
<ul>
<li>New cavity receiver option for the Molten Salt Power Tower model. (<a href="https://github.com/NREL/ssc/issues/625">625</a>).
<li>Fix issue with tower Heliostat Availability inputs to make clearer distinction between the design parameter and heliostat availability loss applied during simulation. (<a href="https://github.com/NREL/SAM/pull/822">822</a>)</li>
<li>For the Molten Salt Power Tower model, change units of piping heat loss coefficient to W/m2-K from W/m. (<a href="https://github.com/NREL/SAM/issues/746">746</a>)</li>
<li>For the Physical Trough model, improve dispatch algorithm, including modifying sizing of indirect TES (TES fluid is different from the solar field HTF): In earlier versions, we used the receiver HTF hot-to-cold temperature difference to size TES. In our current convention, we size the TES using a temperature difference = (T_rec_hot – HX_delta_T) – (T_pc_cold + HX_delta_T). This reduces the design temperature difference by 2*HX_delta_T compared to the old convention, which in turn increases the physical size of TES for a given system design. As such, the latest release effectively has more TES capacity for a given system design than older versions of SAM. (<href="https://github.com/NREL/ssc/commit/ffbccc3be09279fa60f52a2df6d7c0f2ee39c163">(Fix Trough Dispatch)</a>).</li>
</ul>
<h2>Marine Energy (2021.12.02)</h2>
<ul>
<li>For Wave model, add wave resource data download from NREL Wave Hindcast Data with library to store wave resource files. (<a href="https://github.com/NREL/SAM/pull/725">725</a>)</li>
<li>New macros for Wave model to generate a report and compare cases. (<a href="https://github.com/NREL/SAM/pull/704">704</a>)</li>
<li>For Wave model, add support for time series wave resource data. (<a href="https://github.com/NREL/SAM/pull/645">645</a>, <a href="https://github.com/NREL/SAM/pull/643">643</a>)</li>
<li>Add option to import device power curve data from CSV or clipboard. (<a href="https://github.com/NREL/SAM/pull/740">740</a>)</li>
<li>Fix issues with PDF report template, metrics table outputs, and update cost structure options. (<a href="https://github.com/NREL/SAM/pull/682">682</a>)</li>
</ul>
<h2>Wind (2021.12.02)</h2>
<ul>
<li>Fix issue with integration of Python LandBOSSE wind cost model that caused SAM to crash. (<a href="https://github.com/NREL/SAM/pull/787">787</a>)</li>
</ul>
<h2>Geothermal (2021.12.02)</h2>