-
Notifications
You must be signed in to change notification settings - Fork 145
/
releasenotes.html
3675 lines (3374 loc) · 272 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>
<h2>CATEGORY: General, Solar, Detailed Photovoltaic, Wind Power, CSP Physical Trough, PPA Single Owner, etc. Skip category for maintenance updates.</h2>
<ul>
<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>...
</ul>
-->
<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:[email protected]">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>
<ul>
<li>Update model to be more consistent with latest version of GETEM. (<a href="https://github.com/NREL/SAM/pull/772">772</a>)</li>
</ul>
<h1 id="2020-11-29-r2">SAM 2020.11.29 r2, SSC 256: May 12, 2021</h1>
<p>This is a maintenance update to <a href="#2020-11-29-r1">SAM 2020.11.29 Revision 1</a>.</p>
<ul>
<li>Show heat map of system power generated on Summary page of Results page. (<a href="https://github.com/NREL/SAM/pull/571">571</a>)</li>
<li>Fix weather file downloads from Advanced NSRDB Download window to set "utc" parameter to false so files are returned in local time instead of UTC. (<a href="https://github.com/NREL/SAM/pull/609">609</a>)</li>
<li>Add minute value to error messages about weather files to facilitate troubleshooting problems. (<a href="https://github.com/NREL/SSC/pull/563">563</a>)</li>
<li>Change Detailed PV short circuit current output variable labels to make it clear current is string current rather than array current. (<a href="https://github.com/NREL/SSC/pull/572">572</a>)</li>
<li>Show system power generated by default on Results page time series tables and graphs instead of blank tables and graphs. (<a href="https://github.com/NREL/SAM/pull/559">559</a>)</li>
<li>Fix issue with Electricity Bill calculations that caused SAM to crash when time-of-use periods have different numbers of tiers. (<a href="https://github.com/NREL/SSC/pull/560">560</a>)</li>
<li>Improve Stochastic simulations so that input samples and results are consistent and add description of distributions to Help. (<a href="https://github.com/NREL/SAM/pull/565">565</a>)</li>
<li>For Wind power model, only display Uncertanties tab on Results page when Uncertainty inputs are enabled and improve Uncertainties input page to make it clearer that inputs are optional. (<a href="https://github.com/NREL/SAM/pull/581">581</a>)</li>
<li>Updated Solar Resource File Converter macro for SolarAnywhere files to work with latest SolarAnywhere version and fix issues with time stamp conversions. (<a href="https://github.com/NREL/SAM/pull/601">601</a>)</li>
<li>Battery model:
<ul>
<li>Reorganize battery inputs so that sizing parameters are all in one place and closer to the sizing inputs, and fix issue with sizing using DC and AC capacities. (<a href="https://github.com/NREL/SAM/pull/569">569</a>, <a href="https://github.com/NREL/SAM/pull/560">560</a>)</li>
<li>Add battery sizing option so battery capacity can be specified in kW and h, or kW and kWh to facilitate parametric simulations on battery capacity. (<a href="https://github.com/NREL/SAM/pull/606">606</a>)</li>
<li>Fix behind-the-meter battery dispatch issues to prevent accidental discharging of battery to grid by limiting nominal voltage to range specified in voltage table. (Not an issue for electrochemical voltage model.) (<a href="https://github.com/NREL/SAM/pull/561">561</a>, <a href="https://github.com/NREL/ssc/pull/568">568</a>)</li>
<li>Fix behind-the-meter battery dispatch algorithm issue that allowed discharging of battery to grid. (<a href="https://github.com/NREL/ssc/issues/513">513</a>)</li>
<li>For front-of-meter battery systems, changed the "Utility Rates" page label to "Electricity Purchases" and improved text in user interface to make it clearer that the inputs on that page are for specifying how electricity to charge the battery is purchased. (<a href="https://github.com/NREL/SAM/pull/611">611</a>)</li>
<li>Fixed issue for front-of-meter battery models that allowed retail sell rate to be non-zero so that battery discharge power was compensated at both the PPA price and sell rate instead of only at the PPA price. (<a href="https://github.com/NREL/SAM/pull/603">603</a>)</li>
<li>Remove fuel cell and battery variables from results when system does not include a fuel cell or battery. (<a href="https://github.com/NREL/SSC/pull/570">570</a>)</li>
<li>Shorten some battery output variable labels to make graphs and tables easier to work with. (<a href="https://github.com/NREL/SSC/pull/576">576</a>)</li>
<li>Fix issues with Lithium-ion NMC lifetime model's calculation of length of day for simulations with one-minute timesteps. (<a href="https://github.com/NREL/SSC/pull/549">549</a>, <a href="https://github.com/NREL/SSC/pull/545">545</a>)</li></li>
</ul>
<li>Fix LK scripting issue when adding folders to the solar resource library. (<a href="https://github.com/NREL/SAM/pull/611">611</a>)</li>
<li>Revise Help to improve battery, electricity bill calculation, and other topics. (<a href="https://github.com/NREL/SAM/pull/617">617</a>, <a href="https://github.com/NREL/SAM/pull/602">602</a>)</li>
</ul>
<h1 id="2020-11-29-r1">SAM 2020.11.29 r1, SSC 252: February 25, 2021</h1>
<p>This is a maintenance update to <a href="#2020-11-29">SAM 2020.11.29</a>.</p>
<ul>
<li>Revert default Federal Investment Tax Credit (ITC) to 26%. (<a href="https://github.com/NREL/SAM/issues/493">493</a>)</li>
<li>Fix power tower to correctly update tower height cost value. (<a href="https://github.com/NREL/SAM/pull/475">475</a>)</li>
<li>Fix photovoltaic model simulation warnings for bifacial and one-axis tracking. (<a href="https://github.com/NREL/ssc/issues/364">364</a>)</li>
<li>Battery model:
<ul>
<li>Fix generic battery display of power units on System Costs page. (<a href="https://github.com/NREL/SAM/issues/469">469</a>)</li>
<li>Fix PV-fuel-cell-battery battery O&M cost calculation. (<a href="https://github.com/NREL/SAM/pull/521">521</a>)</li>
<li>Make sure user interface panels on battery input pages are collapsed in a consistent way for all battery configurations. (<a href="https://github.com/NREL/SAM/pull/515">515</a>)</li>
<li>Fix an issue with voltage model enabling in the user interface for flow batteries. (<a href="https://github.com/NREL/SAM/issues/505">505</a>)</li>
<li>Fix issues with battery voltage model. (<a href="https://github.com/NREL/ssc/issues/520">520</a>, <a href="https://github.com/NREL/ssc/issues/517">517</a>)</li>
<li>Fix message about Specify IRR target for battery not being available for configurations with PPA financial models (it is). (<a href="https://github.com/NREL/SAM/issues/516">516</a>)</li>
<li>Fix PDF report generator for PV-Battery with PPA financial model configurations. (<a href="https://github.com/NREL/SAM/pull/528">528</a>)</li>
<li>Integrate new NREL NMC lifetime model (available in SSC only). (<a href="https://github.com/NREL/ssc/issues/521">521</a>)</li>
<li>Remove REopt optimization option from Generic Battery configurations. (<a href="https://github.com/NREL/SAM/issues/479">479</a>)</li>
</ul></li>
<li>Electricity bill calculation:
<ul>
<li>Fix electricity bill calculations to correctly apply time series buy/sell rates to bill without system. (<a href="https://github.com/NREL/SAM/issues/494">494</a>)</li>
<li>Fix handling of nested tiers. (<a href="https://github.com/NREL/SAM/issues/275">275</a>)</li>
<li>Improve reporting of monthly results. (<a href="https://github.com/NREL/SAM/issues/492">492</a>)</li>
</ul></li>
<li>Macros:
<ul>
<li>Modify Value of RE macro to support Third Party Ownership financial models. (<a href="https://github.com/NREL/SAM/issues/492">492</a>)</li>
<li>Fix Indifference vs PPA Price macro for Third Party Ownership finanical model. (<a href="https://github.com/NREL/SAM/issues/490">490</a>)</li>
<li>Fix Value of RE macro rate switching option. (<a href="https://github.com/NREL/SAM/issues/499">499</a>, <a href="https://github.com/NREL/SAM/issues/487">487</a>)</li>
<li>Update Solar Resource File converter to work with SolarAnywhere V3.4 files and older. (<a href="https://github.com/NREL/SAM/issues/491">491</a>)</li>
<li>Fix marine energy Compare Cases macro when comparing cases with the same LCOE. (<a href="https://github.com/NREL/SAM/issues/497">497</a>)</li>
<li>Remove Puerto Rico solar resource download macro now that data is available from Location and Resource page, move code to LK script samples. (<a href="https://github.com/NREL/SAM/pull/473">473</a>)</li>
</ul></li>
<li>Fix upgrade script issue that caused SAM to crash when opening some files created in older versions of SAM. (<a href="https://github.com/NREL/SAM/issues/518">518</a>)</li>
<li>For Third Party Ownership model, make PPA price and lease term available for parametric simulations. (<a href="https://github.com/NREL/SAM/pull/536">536</a>)</li>
<li>Improve handling of API errors for weather file downloads from NSRDB. (<a href="https://github.com/NREL/SAM/pull/541">541</a>)</li>
<li>Improve Data Table categories on Results page. (<a href="https://github.com/NREL/SAM/issues/485">485</a>)</li>
<li>Clean up Marine Energy System Costs pages. (<a href="https://github.com/NREL/SAM/pull/489">489</a>)</li>
<li>Fix REopt inputs to remove unused value of lost load, and only set battery capacity to zero when REopt finds an optimal solution. (<a href="https://github.com/NREL/SAM/issues/482">482</a>, <a href="https://github.com/NREL/SAM/issues/495">495</a>)</li>
<li>Fix P50/P90 simulations to work with weather files files in EPW format. (<a href="https://github.com/NREL/SAM/issues/480">480</a>)</li>
</ul>
<h1 id="2020-11-29">SAM 2020.11.29, SSC 250: November 29, 2020</h1>
<p>This new version consists of several improvements and updates. Highlights include:</p>
<ul>
<li>Implement NREL Solar Position Algorithm (SPA) for sun angle calculations for all solar performance models.</li>
<li>Improved battery dispatch for both front-of-meter and behind-the-meter battery storage applications.</li>
<li>Improve electricity bill calculations for distributed behind-the-meter financial models.</li>
<li>Update utility rate data download from OpenEI Utility Rate Database (URDB) to API Version 7 and fix a bug that prevented all rates from being listed for some large utilities.</li>
<li>Improved photovoltaic backtracking algorithm.</li>
<li>Integrate NREL LandBOSSE wind balance-of-system (BOS) cost model into SAM.</a>
<li>Update default values to better align with <a href="https://atb.nrel.gov/">NREL Annual Technology Baseline (ATB).</a></li>
<li>Update solar resource data downloads from the NSRDB to access newest datasets for subhourly data, typical year (TMY, TGY, TDY) data, subhourly data, and data for Europe, Africa and Asia.</li>
</ul>
<p>In the following list of changes, numbers in parentheses are links to detailed descriptions and code on the SAM or SSC GitHub repositories.</p>
<h2>General</h2>
<ul>
<li>Fix issue with scroll bars disappearing when long pages are loaded in the user interface. (<a href="https://github.com/NREL/SAM/issues/405">405</a>)</li>
<li>Fix problem opening files with parametric simulations that caused SAM to crash with "Could not inflate stream" error. (<a href="https://github.com/NREL/SAM/issues/393">393</a>)</li>
<li>Fix problem with Welcome page when SAM starts without an internet connection. (<a href="https://github.com/NREL/SAM/issues/376">376</a>)</li>
<li>Update default ITC and PTC tax credits to reflect current market conditions. (<a href="https://github.com/NREL/SAM/pull/450">450</a>)</li>
<li>Update sun angle calculations for all solar models to use NREL Solar Position Algorithm (SPA). (<a href="https://github.com/NREL/ssc/issues/279">279</a>)</li>
<li>For the SSC compute module pvwattsv5_1ts, add external shading. This change does not affect the PVWatts implementation in SAM, which uses the pvwattsv7 compute module. (<a href="https://github.com/NREL/ssc/pull/462">462</a>)</li>
</ul>
<h2>Detailed Photovoltaic</h2>
<ul>
<li>Improve backtracking algorithm to use method described in Anderson, K (2020), "Slope-aware Backtracking for Single Axis Trackers", NREL/TP-5K00-76626. A new slope input will be added in a future version of SAM. (<a href="https://github.com/NREL/ssc/issues/457">457</a>).</li>
<li>Add module mass input for transient thermal model that adjusts cell temperature calculation for simulation time steps of less than 20 minutes, and improve user interface and documentation to make it clear how the model works. (<a href="https://github.com/NREL/SAM/issues/380">380</a>)</li>
<li>Rename Array DC power variable to Inverter DC input power to avoid confusion about whether value includes DC losses. (<a href="https://github.com/NREL/SAM/issues/383">383</a>)</li>
<li>Improve inverter temperature derate curve inputs, and normalize efficiency table to Pmax instead of efficiency. (<a href="https://github.com/NREL/SAM/pull/412">412</a>)</li>
<li>Fix module coefficient generator for CEC Module Model with User Entered Specifications option to work with newer high-current modules. (<a href="https://github.com/NREL/ssc/issues/129">129</a>)</li>
<li>Improve warning messages for bifacial modules with one-axis trackers and non-zero tilt. (<a href="https://github.com/NREL/ssc/issues/364">364</a>)</li>
<li>Update default system size for PPA financial models to 50 MW and Commercial to 500 kW. (<a href="https://github.com/NREL/SAM/pull/421">392</a>)</li>
</ul>
<h2>Battery Storage</h2>
<ul>
<li>Add new behind-the-meter (BTM) dispatch option that reponds to electricity rates and cycle degradation penalty.</li>
<li>Add option so battery cost can be specified in $/kWh, $/kW, or both</li>
<li>Simplify battery replacement cost option so annual replacement can be specified with a single input array instead of two.</li>
<li>Rename Array DC power variable to Inverter DC input power to avoid confusion about whether value includes power from battery for DC-connected batteries. (<a href="https://github.com/NREL/SAM/issues/383">383</a>)</li>
<li>Fix issue with REopt for PVWatts for rates with no max usage units that caused a user interface error. (<a href="https://github.com/NREL/SAM/issues/388">388</a>)</li>
<li>Fix bug with battery sizing when using AC power values. (<a href="https://github.com/NREL/SAM/issues/375">375</a>)</li>
<li>Update default parameters for battery chemistries. (<a href="https://github.com/NREL/SAM/issues/323">323</a>)</li>
<li>Add a PDF report template for battery configurations. (<a href="https://github.com/NREL/SAM/issues/302">302</a>)</li>
<li>Fix an issue that allowed battery capacity percent to exceed 100% when the calendar degradation model option was set to None. (<a href="https://github.com/NREL/ssc/issues/478">478</a>)</li>
<li>Fix issue with battery thermal model for subhourly simulations. (<a href="https://github.com/NREL/ssc/issues/472">472</a>)</li>
<li>Fix an issue that prevented battery ancillary losses from being correctly applied. (<a href="https://github.com/NREL/ssc/issues/379">379</a>)</li>
<li>Fix issue with battery current and state of charge calculation. (<a href="https://github.com/NREL/ssc/issues/445">445</a>)</li>
</ul>
<h2>Retail Electricity Rates and Bill Calculations</h2>
<ul>
<li>Fix issues with display of electricity bill data for demand charges, net billing credits, and net metering credits. (<a href="https://github.com/NREL/SAM/issues/442">442</a>, <a href="https://github.com/NREL/SAM/issues/372">372</a>)</li>
<li>Update electricity rate downloads from Utility Rate Database to use latest API versions, and fix broken downloads due to using http instead of https. (<a href="https://github.com/NREL/SAM/issues/361">361</a>, <a href="https://github.com/NREL/SAM/issues/379">379</a>)</li>
<li>Remove 500 rate limit for that caused some rates to be missing for utilties with more than 500 rates. (<a href="https://github.com/NREL/SAM/issues/361">361</a>)</li>
<li>Fix display of net billing dollar amounts in monthly results table. Bill calculations were correct, but table was not displaying correct values. (<a href="https://github.com/NREL/SAM/issues/372">372</a>)</li>
<li>Add option to choose month for end of net metering true-up period. (<a href="https://github.com/NREL/SAM/issues/16">16</a>)</li>
<li>Apply net excess generation credit at end of true-up period to January when true-up period ends in December. (<a href="https://github.com/NREL/SAM/issues/16">16</a>)</li>
<li>Improve metering option variable labels.</li>
</ul>
<h2>Financial Models</h2>
<ul>
<li>Improve reporting of energy quantities in PPA Single Owner project cash flow to separate gross and net annual electricity generation so the effect of self-consumption for inverter nighttime consumption, battery charging, and concentrating solar power parasitic loads is clear. (<a href="https://github.com/NREL/SAM/issues/370">370</a>)</li>
<li>Fix labels for incentives inputs so they are visible in the inputs browser and other variable lists to facilitate identifying variables for SDK/PySAM programmers. (<a href="https://github.com/NREL/SAM/issues/403">403</a>)</li>
</ul>
<h2>Marine Energy</h2>
<ul>
<li>Add graphs to Summary tab on Results page. (<a href="https://github.com/NREL/SAM/issues/390">390</a>)</li>
<li>Add detailed cost break down option for specifying Wave and Tidal energy capital and O&M costs. (<a href="https://github.com/NREL/SAM/issues/389">389</a>)</li>
</ul>
<h2>Wind Power</h2>
<ul>
<li>Implement NREL LandBOSSE wind balance-of-system (BOS) cost model as an option for calculating the BOS capital cost on the System Costs page for the Wind Power model. (<a href="https://github.com/NREL/SAM/issues/270">270</a>)</li>
<li>Fix issue with wind resource data downloads from WIND Toolkit API. (<a href="https://github.com/NREL/SAM/issues/353">353</a>, <a href="https://github.com/NREL/SAM/issues/216">216</a>)
</ul>
<h2>Concentrating Solar Power (CSP)</h2>
<ul>
<li>For molten salt power tower model, replace power cycle Supercritical Carbon Dioxide (sCO2) option with a macro and external Python script, see Power Cycle input page and Help for details. (<a href="https://github.com/NREL/ssc/issues/454">454</a>)</li>
<li>Remove Dish Stirling and Direct Steam Power Tower models from SAM. These models are available in the SAM 2020.2.29 legacy version, which is available for download from the <a href="https://sam.nrel.gov/download">SAM website</a>. (<a href="https://github.com/NREL/SAM/issues/363">363</a>)</li>
<li>For molten salt power tower and physical trough models, display better information about air-cooled condenser model paramters. (<a href="https://github.com/NREL/SAM/issues/366">366</a>)</li>
<li>Remove custom HTF option from Empirical Trough model to avoid errors. (<a href="https://github.com/NREL/SAM/issues/316">316</a>)</li>
<li>Fix issue for the Linear Fresnel Molten Salt model with the solar field option not correctly enabling and disabling the solar multiple and field area inputs. (<a href="https://github.com/NREL/SAM/issues/201">201</a>)</li>
<li>Fix a bug in the Generic CSP model that allowed the cycle to consume more power than available in TES when the solar field output was low. (<a href="https://github.com/NREL/ssc/issues/477">477</a>)</li>
<li>Fix a bug with the Generic CSP model that ignored solar field area at design, and affected the calculation of system power generated. (<a href="https://github.com/NREL/ssc/issues/476">476</a>)</li>
</ul>
<h2>Solar Resource Data</h2>
<ul>
<li>Update weather file downloads to work with latest NSRDB APIs so SAM can download from the new 5-minute datasets and data for Europe, Africa, and Asia from the new MSG-IODC datasets, and typical year data as TMY, TGY, or TDY from the new TMY datasets. (<a href="https://github.com/NREL/SAM/issues/271">271</a>)</li>
<li>Fix problems reading weather files from some sources that are based on minute values of 60 for the top of the hour instead of zero. (<a href="https://github.com/NREL/SAM/issues/365">365</a>)</li>
</ul>
<h1 id="2020-2-29-r3">SAM 2020.2.29 r3, SSC 242: July 31, 2020</h1>
<p>This is an update to SAM 2020.2.29 Revision 2 that fixes the issues listed beow. For detailed descriptions of issues fixed for this update, see <a href="https://github.com/NREL/SAM/milestone/12">GitHub Issues for SAM 2020.2.29 Patch 3</a> and for <a href="https://github.com/NREL/ssc/issues/435">SSC 2020 Patch 3</a>.</p>
<ul>
<li>Update wind turbine library.</li>
<li>New marine energy report templates.</li>
<li>Run LK script from the command line: [path to SAM executable] [sam filename] [path to LK script file], for example <code>c:/sam/2020.2.29/x64/sam.exe no_sam_file c:/my-script.lk</code>.</li>
<li>Fix weather file downloads from NSRDB and WIND Toolkit.</li>
<li>Fix Residential / Commercial cash flow "Send to Excel with Equations" Excel workbook, federal and state income tax rates start in wrong year. This issue only affected workbook calculations, not SAM's cash flow calculations.</li>
<li>Fix electricity bill issue with net metering end-of-year credit for subhourly simulations &em; was being applied in 8760th time step regardless of simulation time step.</li>
<li>Fix electricity bill time series buy rates so that annual escalation is applied.</li>
<li>Disable electricity bill time series buy and sell rates for net metering with $ credits.</li>
<li>Fix issue with default values of array inputs such as time series electricity buy and sell rates that are disabled by default that caused simulation error or crash when input was enabled.</li>
<li>Remove battery dispatch "copy schedule" button for Merchant Plant financial model because time-of-delivery factors do not apply in this context.</li>
<li>Fix battery dispatch period numbers greater than 6 with error handling in SSC.</li>
<li>Fix battery voltage table option issue that resulted in 100% battery roundtrip efficiency regardless of battery use.</li>
<li>Fix Vanadium Flow battery voltage model issue that allowed it to discharge more than it was charged.</li>
<li>Fix Detailed Photovoltaic model DC system availability losses being applied when Enable check box is not checked.</li>
<li>Correct Detailed Photovoltaic model units reported for transformer no load loss, change from kWh to kW.</li>
<li>Speed up PVWatts V7 self-shading calculations refactoring code.</li>
<li>Fix PVWatts V5 single time step model.</li>
<li>Add support for custom time series length to pvsamv1 and pvwattsv7 (in SSC only, not available in SAM user interface). See https://github.com/NREL/ssc/pull/418.</li>
</ul>
<h1 id="2020-2-29-r2">SAM 2020.2.29 r2, SSC 240: May 28, 2020</h1>
<p>This is an update to SAM 2020.2.29 Revision 1 that fixes the issues listed beow. For detailed descriptions of issues fixed for this update, see <a href="https://github.com/NREL/SAM/issues?q=is%3Aissue+milestone%3A%222020+Patch+2%22">GitHub Issues for SAM 2020.2.29 Patch 2</a>.</p>