-
Notifications
You must be signed in to change notification settings - Fork 151
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* Initial release notes for 2023, in progress * finalize 2023 release notes * Revise for @mjprilliman comments * Update release notes for CSP * Add note about fossil backup for MSLF * Update for CSP * Version number for 2023/12/17 release, assuming SSC for release is Version 287 * Update release notes for CSP MSLF default annual energy comparison add "receiver" to evacuated tube note * Update SSC version number --------- Co-authored-by: tyneises <[email protected]>
- Loading branch information
1 parent
c0d87c5
commit cff63bb
Showing
1 changed file
with
149 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -59,6 +59,155 @@ <h2>CATEGORY: General, Solar, Detailed Photovoltaic, Wind Power, CSP Physical Tr | |
| --> | ||
|
|
||
| <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>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> | ||
|
|
||