diff --git a/doc/readme.md b/doc/readme.md index 744a4fe61..b56183861 100644 --- a/doc/readme.md +++ b/doc/readme.md @@ -299,6 +299,18 @@ For the title of step-by-step instructions, use **bold** text (`**bold**`) inste #. This is Step 4. ``` +For multi-level lists, separate indented sections with blank lines: + +``` +* First item in bullet list. +* Second item. + + * First sub-item of second item. + * Second sub-item. + +* Third item. +``` + ## Variable Definitions Use this format for variable descriptions and definitions. Note definition lines are preceded by two (2) spaces. There must not be a blank line before the first line of the definition. diff --git a/doc/source/reference/release_notes.rst b/doc/source/reference/release_notes.rst index 4047a83b7..c1c3891d8 100644 --- a/doc/source/reference/release_notes.rst +++ b/doc/source/reference/release_notes.rst @@ -199,14 +199,14 @@ SAM 2025.4.16 Revision 1, SSC 303: July 24, 2025 This maintenance update fixes a weather file download bug and several other issues. -- Fix crash caused when attempting to download a weather file using a location name or street address, or when downloading a static map image underlay for the photovoltaic model's 3D shade calculator. The time zone output of the LK geocode function is now optional. An outstanding task for a future release is to identify new APIs for time zone and static map. For this update, the LK geocode function does not return a time zone, and the 3D shade calculator static map download does not work -- a workaround is to import a map image file instead. (`SAM 2093 `__) -- Fix Append Snow Data macro for photovoltaic models for snow depth data in inches. (`SAM 2079 `__) -- Fix issue with photovoltaic cell temperature heat transfer method with array dimensions option. (`SSC 1331 `__) -- Fix issue with Parabolic Trough and Linear Fresnel IPH models solar field thermal power calculation. (`SSC 1329 `__) -- Restore yellow "sticky note" icon to navigation menu for input pages that have a non-empty note. This stopped working when we implemented a multi-level navigation menu. (`SAM 2091 `__, `WEX 188 `__) -- Fix parametrics Create New Case feature when parametrics table has no results. (`SAM 2088 `__) -- Fix issue with "Save all output variables over analysis period" option for cases with grid outages. (`SAM 2087 `__) -- Fix defaults manager handling of JSON NaN values. This issue only affects SAM developers working with the SAM IDE. (`SAM 2086 `__) +- Fix crash caused when attempting to download a weather file using a location name or street address, or when downloading a static map image underlay for the photovoltaic model's 3D shade calculator. The time zone output of the LK geocode function is now optional. An outstanding task for a future release is to identify new APIs for time zone and static map. For this update, the LK geocode function does not return a time zone, and the 3D shade calculator static map download does not work -- a workaround is to import a map image file instead. (`SAM 2093 `__) +- Fix Append Snow Data macro for photovoltaic models for snow depth data in inches. (`SAM 2079 `__) +- Fix issue with photovoltaic cell temperature heat transfer method with array dimensions option. (`SSC 1331 `__) +- Fix issue with Parabolic Trough and Linear Fresnel IPH models solar field thermal power calculation. (`SSC 1329 `__) +- Restore yellow "sticky note" icon to navigation menu for input pages that have a non-empty note. This stopped working when we implemented a multi-level navigation menu. (`SAM 2091 `__, `WEX 188 `__) +- Fix parametrics Create New Case feature when parametrics table has no results. (`SAM 2088 `__) +- Fix issue with "Save all output variables over analysis period" option for cases with grid outages. (`SAM 2087 `__) +- Fix defaults manager handling of JSON NaN values. This issue only affects SAM developers working with the SAM IDE. (`SAM 2086 `__) .. _2025-4-16: @@ -215,125 +215,125 @@ SAM 2025.4.16, SSC 302: April 16, 2025 This version updates the geothermal power model with more drilling cost detail, improved capital and O&M cost models, and improved PySAM geothermal functionality. It also adds an option for a counterflow heat exchanger to SAM's Industrial Process Heat (IPH) models for a more realistic representation of the thermal load, and includes several improvements to the battery dispatch and degradation calculations, including a new option to allow the battery to discharge to grid for retail rates dispatch, among other improvements and bug fixes. -For a complete list of code revisions associated with this version, see the `SAM `__ and `SSC `__ GitHub repositories. +For a complete list of code revisions associated with this version, see the `SAM `__ and `SSC `__ GitHub repositories. General (SAM 2025.4.16) ----------------------- -Update API call for electricity rate download-by-zip-code option. API now requires geocoding zip code to latitude/longitude before API call. (`SAM 2053 `__) +Update API call for electricity rate download-by-zip-code option. API now requires geocoding zip code to latitude/longitude before API call. (`SAM 2053 `__) -Fix heat map for data with sub-hourly time steps. (`WEX 183 `__) +Fix heat map for data with sub-hourly time steps. (`WEX 183 `__) -Add support for not-a-number (NaN) and infinity (Inf) in JSON files. (`SAM 2047 `__) +Add support for not-a-number (NaN) and infinity (Inf) in JSON files. (`SAM 2047 `__) -Add support for unicode characters in LK 'isdigit()', 'isalpha()', and 'isalnum()' functions. (`LK 54 `__) +Add support for unicode characters in LK 'isdigit()', 'isalpha()', and 'isalnum()' functions. (`LK 54 `__) Geothermal Power (SAM 2025.4.16) -------------------------------- -Reorganize and clean up geothermal cost inputs. (`SAM 2045 `__) +Reorganize and clean up geothermal cost inputs. (`SAM 2045 `__) -Update cost and well count calculations. (`SSC 1307 `__) +Update cost and well count calculations. (`SSC 1307 `__) -Convert stimulation cost per well from input to calculated value. (`SAM 2063 `__ +Convert stimulation cost per well from input to calculated value. (`SAM 2063 `__ Photovoltaics (SAM 2025.4.16) ----------------------------- *The changes in this section apply to Detailed PV, PVWatts, PV-battery, and hybrid configurations with PV.* -Fix problem with capital cost curve equations for out-of-range system capacities. (`SAM 2044 `__) +Fix problem with capital cost curve equations for out-of-range system capacities. (`SAM 2044 `__) -Fix default installation cost for PV residential PV configurations. (`SAM 2010 `__) +Fix default installation cost for PV residential PV configurations. (`SAM 2010 `__) -Remove land lease cost inputs and outputs from behind-the-meter configurations. (`SAM 2003 `__, `SAM 1997 `__) +Remove land lease cost inputs and outputs from behind-the-meter configurations. (`SAM 2003 `__, `SAM 1997 `__) -Remove error messages about bifacial modules and one-axis tracking. (`SAM 1311 `__) +Remove error messages about bifacial modules and one-axis tracking. (`SAM 1311 `__) Detailed PV (SAM 2025.4.16) --------------------------- -Enable power consumption during operation for Inverter Datasheet option when weighted efficiency option is used. (`SAM 2066 `__) +Enable power consumption during operation for Inverter Datasheet option when weighted efficiency option is used. (`SAM 2066 `__) -Account for inverter nighttime consumption in grid limits equations. Applies to configurations with Detailed PV. (`SAM 1277 `__) +Account for inverter nighttime consumption in grid limits equations. Applies to configurations with Detailed PV. (`SAM 1277 `__) -Revise PDF report template to show module type instead of a number. Applies to Detailed PV and PV-Battery only. (`SAM 2001 `__) +Revise PDF report template to show module type instead of a number. Applies to Detailed PV and PV-Battery only. (`SAM 2001 `__) Concentrating Solar Power (CSP) (SAM 2025.4.16) ----------------------------------------------- -Add two new SENER collectors to collector library for physical trough model. (`SAM 2029 `__ ) +Add two new SENER collectors to collector library for physical trough model. (`SAM 2029 `__ ) -Update default volume oversize value for trough packed bed TES model. The new default value allows the case to hit the design TES charge capacity. (`SAM 2054 `__) +Update default volume oversize value for trough packed bed TES model. The new default value allows the case to hit the design TES charge capacity. (`SAM 2054 `__) -Fix boundary condition equations for packed bed TES model. Fix reporting unit bug for packed bed outputs. (`SSC 1312 `__) +Fix boundary condition equations for packed bed TES model. Fix reporting unit bug for packed bed outputs. (`SSC 1312 `__) Industrial Process Heat (IPH) (SAM 2025.4.16) --------------------------------------------- -Add counterflow heat exchanger option to model heat transfer between the heat transfer fluid and steam heat sink. (`SAM 2002 `__, `SSC 1274 `__) +Add counterflow heat exchanger option to model heat transfer between the heat transfer fluid and steam heat sink. (`SAM 2002 `__, `SSC 1274 `__) -Update default solar field temperatures for IPH Parabolic Trough configurations for oil field HTF and salt storage fluid. (`SAM 1992 `__) +Update default solar field temperatures for IPH Parabolic Trough configurations for oil field HTF and salt storage fluid. (`SAM 1992 `__) -Add new input for over-design mass flow rate. (`SAM 2046 `__, `SSC 1308 `__) +Add new input for over-design mass flow rate. (`SAM 2046 `__, `SSC 1308 `__) Electric Battery Storage (SAM 2025.4.16) ---------------------------------------- -Fix UI checks for critical load length to work with Custom Generation Battery configurations. (`SAM 2049 `__) +Fix UI checks for critical load length to work with Custom Generation Battery configurations. (`SAM 2049 `__) -Add new time series output variable for manual dispatch period. (`SAM 1298 `__) +Add new time series output variable for manual dispatch period. (`SAM 1298 `__) -Prevent negative "battery to load" values when losses exceed battery discharge power. (`SAM 1294 `__) +Prevent negative "battery to load" values when losses exceed battery discharge power. (`SAM 1294 `__) -Correct battery state of charge (SOC) calculation at the end of a grid outage period. (`SAM 1278 `__) +Correct battery state of charge (SOC) calculation at the end of a grid outage period. (`SAM 1278 `__) -Improve behavior of stacked-area plots on Time Series tab of Results page. (`SAM 1987 `__) +Improve behavior of stacked-area plots on Time Series tab of Results page. (`SAM 1987 `__) -Fix numerical error in Li-ion NMC/Graphite battery lifetime code that caused unexpected annual charge energy values of zero. (`SAM 1310 `__) +Fix numerical error in Li-ion NMC/Graphite battery lifetime code that caused unexpected annual charge energy values of zero. (`SAM 1310 `__) -Add support for exporting battery power to the grid for BTM retail rates dispatch option. (`SAM 2041 `__, `SSC 1303 `__) +Add support for exporting battery power to the grid for BTM retail rates dispatch option. (`SAM 2041 `__, `SSC 1303 `__) -Fix typo in internal 'batt_adjust_constant' variable name. (`SAM 1301 `__) +Fix typo in internal 'batt_adjust_constant' variable name. (`SAM 1301 `__) -Improve error handling of forecast price signals object to prevent SSC crashes for SAM Software Development Kit (SDK), PySAM, and gtest. (`SAM 1288 `__) +Improve error handling of forecast price signals object to prevent SSC crashes for SAM Software Development Kit (SDK), PySAM, and gtest. (`SAM 1288 `__) Marine Energy (SAM 2025.4.16) ----------------------------- -Update cost curves. (`SAM 2043 `__) +Update cost curves. (`SAM 2043 `__) -Fix conversion of time-series wave resource data to joint probability distribution (JPD) for files with three-hour data for over three years. (`SAM 2043 `__) +Fix conversion of time-series wave resource data to joint probability distribution (JPD) for files with three-hour data for over three years. (`SAM 2043 `__) -Add cost curve for RM2 wave energy converter. (`SSC 1305 `__) +Add cost curve for RM2 wave energy converter. (`SSC 1305 `__) Wind Power (SAM 2025.4.16) -------------------------- -Fix double-counting of time series adjustment factors. (`SAM 1284 `__) +Fix double-counting of time series adjustment factors. (`SAM 1284 `__) -Remove wind file reader check on elevation. (`SSC 1317 `__) +Remove wind file reader check on elevation. (`SSC 1317 `__) Custom Generation Profile (SAM 2025.4.16) ----------------------------------------- -Fix problem with combining generation profiles from cases with different weather file time steps. (`SAM 2012 `__) +Fix problem with combining generation profiles from cases with different weather file time steps. (`SAM 2012 `__) Financial Models (SAM 2025.4.16) -------------------------------- -Provide feedback for behind-the-meter (BTM) with billing demand enabled when "Included in Billing Demand" is zero for all periods. (`SSC 1293 `__) +Provide feedback for behind-the-meter (BTM) with billing demand enabled when "Included in Billing Demand" is zero for all periods. (`SSC 1293 `__) -Remove duplicate electricity bill output variables. (`SAM 2009 `__, `SSC 1276 `__) +Remove duplicate electricity bill output variables. (`SAM 2009 `__, `SSC 1276 `__) -Add missing fuel cell O&M cost line item to cashflow and fix Send-to-Excel with Equations callback error for Fuel Cell / Commercial configuration. (`SAM 1995 `__) +Add missing fuel cell O&M cost line item to cashflow and fix Send-to-Excel with Equations callback error for Fuel Cell / Commercial configuration. (`SAM 1995 `__) -Change Commercial financial model IRR units from $ to %. (`SSC 1318 `__) +Change Commercial financial model IRR units from $ to %. (`SSC 1318 `__) Hybrid Systems (SAM 2025.4.16) ------------------------------ -Fix "Apply values from library" button for time-of-delivery (TOD) factors on Revenue input page. (`SAM 1999 `__) +Fix "Apply values from library" button for time-of-delivery (TOD) factors on Revenue input page. (`SAM 1999 `__) .. _2024-12-12: @@ -352,290 +352,290 @@ Other highlights include: - Speed up simulation run times of Detailed PV and PVWatts performance models. - Updated PV module and inverter libraries. -For a complete list of code revisions associated with this version, see the `SAM `__ and `SSC `__ GitHub repositories. +For a complete list of code revisions associated with this version, see the `SAM `__ and `SSC `__ GitHub repositories. General (SAM 2024.12.12) ------------------------ -Update weather file downloads to NREL NSRDB GOES V4 dataset covering 1998 - 2023. (`SAM 1945 `__) +Update weather file downloads to NREL NSRDB GOES V4 dataset covering 1998 - 2023. (`SAM 1945 `__) -Fix alignment of user interface elements for Linux and Mac versions of SAM. (`SAM 1926 `__, `SAM 1929 `__) +Fix alignment of user interface elements for Linux and Mac versions of SAM. (`SAM 1926 `__, `SAM 1929 `__) -Fix code generator for MATLAB problem with incorrect library. (`SAM 1950 `__) +Fix code generator for MATLAB problem with incorrect library. (`SAM 1950 `__) -Test and update macros and sample LK scripts. (`SAM 1948 `__, `SAM 1956 `__) +Test and update macros and sample LK scripts. (`SAM 1948 `__, `SAM 1956 `__) -Test and update PDF report templates. (`SAM 1947 `__) +Test and update PDF report templates. (`SAM 1947 `__) -Revise Help for new features, updates, and to correct errors. (`SAM 1960 `__, `SAM 1941 `__, `SAM 1919 `__) +Revise Help for new features, updates, and to correct errors. (`SAM 1960 `__, `SAM 1941 `__, `SAM 1919 `__) -Fix problem with list of time step options in user interface widget for availability losses and time series data. (`SAM 1907 `__) +Fix problem with list of time step options in user interface widget for availability losses and time series data. (`SAM 1907 `__) -Update sample Python script for accessing NREL ResStock building load data to 2024 datasets. (`SAM 1915 `__) +Update sample Python script for accessing NREL ResStock building load data to 2024 datasets. (`SAM 1915 `__) -New "Compare Cases" and "Compare Battery Cases" macros generate an HTML window that can be exported to PDF showing a table comparing key metrics for different cases that use the same financial model. (`SAM 1894 `__) +New "Compare Cases" and "Compare Battery Cases" macros generate an HTML window that can be exported to PDF showing a table comparing key metrics for different cases that use the same financial model. (`SAM 1894 `__) -Update NREL Cambium market forecast price data downloads to Cambium 2023. (`SAM 1889 `__) +Update NREL Cambium market forecast price data downloads to Cambium 2023. (`SAM 1889 `__) -Fix Utility Rate Database (URDB) electricity rate downloads. (`SAM 1862 `__) +Fix Utility Rate Database (URDB) electricity rate downloads. (`SAM 1862 `__) -Use consistent labels for monthly and annual energy variables. (`SSC 1236 `__) +Use consistent labels for monthly and annual energy variables. (`SSC 1236 `__) -Improve display of parametric results that include "NaN" or "Inf" values. (`WEX 180 `__) +Improve display of parametric results that include "NaN" or "Inf" values. (`WEX 180 `__) -Fix time series data viewer issue with leap days that caused time series to end on a day other than December 31. (`WEX 179 `__) +Fix time series data viewer issue with leap days that caused time series to end on a day other than December 31. (`WEX 179 `__) Update Default Costs and System Designs (SAM 2024.12.12) -------------------------------------------------------- -Update defaults to better align with current state of U.S. market and incentives. (`SAM 1930 `__) +Update defaults to better align with current state of U.S. market and incentives. (`SAM 1930 `__) For Detailed PV and PVWatts configurations, update default system designs based on `DOE Solar Photovoltaic System Cost Benchmarks `__: - Behind-the-meter residential is 7.9 kWdc fixed roof-mount with 400 Wdc monofacial modules and 7.6 kWac string inverters with DC optimizers. - Behind-the-meter commercial and third party ownership is 560 kWdc fixed or rack-mounted with 530 Wdc bifacial modules and 227 kWac central inverters. It is based on both the 3 MW agrivoltaic (APV) system from the `DOE Solar Photovoltaic System Cost Benchmarks `__ and the 200 kW fixed roof-mount system from the `2024 Annual Technology Baseline (ATB) `__. - Front-of-meter is 100 MWdc ground-mounted, single-axis tracking with 530 Wdc bifacial modules and 2.5 MWac central inverters. -- PVWatts default system designs assume monofacial modules because bifacial option is hidden in collapsed "Advanced Parameters" panel. See `SAM Issue 1959 `__. +- PVWatts default system designs assume monofacial modules because bifacial option is hidden in collapsed "Advanced Parameters" panel. See `SAM Issue 1959 `__. -For IPH configurations, update default incentives (no investment tax credit, ITC) and O&M cost. For Physical Trough, change default design to an oil field HTF with molten salt TES. For Fresnel, change default design to 5 MWt heat sink. (`SAM 1946 `__) +For IPH configurations, update default incentives (no investment tax credit, ITC) and O&M cost. For Physical Trough, change default design to an oil field HTF with molten salt TES. For Fresnel, change default design to 5 MWt heat sink. (`SAM 1946 `__) -Update default utility rate for behind-the-meter (BTM) configurations. (`SAM 1958 `__) +Update default utility rate for behind-the-meter (BTM) configurations. (`SAM 1958 `__) Financial Models (SAM 2024.12.12) --------------------------------- -Update investment-tax credit (ITC) and depreciation basis calculations to remove financing fees and reserve account funding from basis. (`SAM 1860 `__, `SSC 1193 `__) +Update investment-tax credit (ITC) and depreciation basis calculations to remove financing fees and reserve account funding from basis. (`SAM 1860 `__, `SSC 1193 `__) -Add option for DSCR debt sizing option (debt-service coverage ration as input, or sculpted debt, sizing based on cash available for debt service) that was available only for Single Owner financial model to other front-of-meter financial models. (`SAM 1854 `__, `SSC 1208 `__) +Add option for DSCR debt sizing option (debt-service coverage ration as input, or sculpted debt, sizing based on cash available for debt service) that was available only for Single Owner financial model to other front-of-meter financial models. (`SAM 1854 `__, `SSC 1208 `__) -Add internal rate of return (IRR) metric to Residential and Commercial financial models. Note that the value of these projects is based on electricitiy bill savings rather than revenue. (`SSC 1223 `__) +Add internal rate of return (IRR) metric to Residential and Commercial financial models. Note that the value of these projects is based on electricitiy bill savings rather than revenue. (`SSC 1223 `__) -Add nominal discount rate output variable to financial models to help with analyses involving net present value (NPV). (`SSC 1223 `__) +Add nominal discount rate output variable to financial models to help with analyses involving net present value (NPV). (`SSC 1223 `__) Electricity Bill Calculator (SAM 2024.12.12) -------------------------------------------- -Fix downloads from Utility Rate Database (URDB) for utility companies with more than 500 rates (PG&E and others) or with no rates. (`SAM 1875 `__) +Fix downloads from Utility Rate Database (URDB) for utility companies with more than 500 rates (PG&E and others) or with no rates. (`SAM 1875 `__) -Add option for net billing with carryover for credits that expire at end of true-up period instead of carrying over to following year, and credits apply to energy charge portion of monthly electricity bill. (`SAM 1835 `__, `SSC 1200 `__) +Add option for net billing with carryover for credits that expire at end of true-up period instead of carrying over to following year, and credits apply to energy charge portion of monthly electricity bill. (`SAM 1835 `__, `SSC 1200 `__) -Improve error checking of time-of-use (TOU) rates by requiring that tiers are the same within a month across TOU periods. (`SSC 1207 `__) +Improve error checking of time-of-use (TOU) rates by requiring that tiers are the same within a month across TOU periods. (`SSC 1207 `__) -Fix an issue with front-of-meter (FOM) electricity purchases with hourly buy rates of zero. (`SSC 1264 `__) +Fix an issue with front-of-meter (FOM) electricity purchases with hourly buy rates of zero. (`SSC 1264 `__) Detailed PV (SAM 2024.12.12) ---------------------------- -Improve solar position algorithm to speed up PVWatts and Detailed PV simulation run times. (`SSC 1212 `__) +Improve solar position algorithm to speed up PVWatts and Detailed PV simulation run times. (`SSC 1212 `__) -Update module and inverter libraries. (`SAM 1913 `__, `SAM 1917 `__) +Update module and inverter libraries. (`SAM 1913 `__, `SAM 1917 `__) -Rename temperature coefficient of power variable from 'gamma_r' to 'gamma_pmp' to be more consistent with industry standard. (`SSC 1231 `__, `SAM 1898 `__) +Rename temperature coefficient of power variable from 'gamma_r' to 'gamma_pmp' to be more consistent with industry standard. (`SSC 1231 `__, `SAM 1898 `__) -Add PV output distribution clipping correction method ("Walker method") with a new option on the Losses input page to choose between the matrix lookup (Allen) or PV output distribution (Walker) methods for hourly simulations. (`SAM 1861 `__) +Add PV output distribution clipping correction method ("Walker method") with a new option on the Losses input page to choose between the matrix lookup (Allen) or PV output distribution (Walker) methods for hourly simulations. (`SAM 1861 `__) -Fix six-parameter module coefficient generator sanity check that caused a crash. This should result in more modules from the CEC list to be inlcuded in the SAM module library. (`SSC 1245 `__) +Fix six-parameter module coefficient generator sanity check that caused a crash. This should result in more modules from the CEC list to be inlcuded in the SAM module library. (`SSC 1245 `__) -Fix implementation of NOCT cell temperature model. (`SSC 1233 `__) +Fix implementation of NOCT cell temperature model. (`SSC 1233 `__) -Improve error messages for weather files with invalid data for SAM and PySAM. (`SSC 1219 `__) +Improve error messages for weather files with invalid data for SAM and PySAM. (`SSC 1219 `__) -Fix snow model for bifacial modules so that rear-side irradiance is not affected by snow cover. (`SSC 1214 `__) +Fix snow model for bifacial modules so that rear-side irradiance is not affected by snow cover. (`SSC 1214 `__) PVWatts (SAM 2024.12.12) ------------------------ -Change variable group name for 'losses' input variable from "Other DC losses" to "DC system losses". (`SSC 1229 `__) +Change variable group name for 'losses' input variable from "Other DC losses" to "DC system losses". (`SSC 1229 `__) -Improve solar position algorithm to speed up PVWatts and Detailed PV simulation run times. (`SSC 1212 `__) +Improve solar position algorithm to speed up PVWatts and Detailed PV simulation run times. (`SSC 1212 `__) Electric Battery Storage (SAM 2024.12.12) ----------------------------------------- -Modify battery dispatch to consider grid limits. (`SAM 1883 `__, `SSC 1224 `__) +Modify battery dispatch to consider grid limits. (`SAM 1883 `__, `SSC 1224 `__) -Add battery-specific availability loss inputs. (`SAM 1902 `__, `SSC 1241 `__, `SSC 1234 `__) +Add battery-specific availability loss inputs. (`SAM 1902 `__, `SSC 1241 `__, `SSC 1234 `__) -Add new Standalone Battery input to define simulation time step rather than basing it on other inputs. (`SAM 1887 `__, `SSC 1227 `__) +Add new Standalone Battery input to define simulation time step rather than basing it on other inputs. (`SAM 1887 `__, `SSC 1227 `__) -For behind-the-meter (BTM) batteries, Add metrics and graphs to Summary tab on Results page, and default graph showing battery performance metrics on Time Series tab. (`SAM 1884 `__, `SAM 1865 `__, `SSC 1215 `__) +For behind-the-meter (BTM) batteries, Add metrics and graphs to Summary tab on Results page, and default graph showing battery performance metrics on Time Series tab. (`SAM 1884 `__, `SAM 1865 `__, `SSC 1215 `__) -Change battery life model to base degraded battery capacity on sum of calendar and cycle degradation rather than the minimum of the two. (`SSC 1239 `__) +Change battery life model to base degraded battery capacity on sum of calendar and cycle degradation rather than the minimum of the two. (`SSC 1239 `__) -Update and fix REopt API calls for battery size and dispatch optimization. (`SAM 1904 `__, `SSC 1242 `__, `SSC 1203 `__) +Update and fix REopt API calls for battery size and dispatch optimization. (`SAM 1904 `__, `SSC 1242 `__, `SSC 1203 `__) -Improve efficiency of internal handling of battery parameter variables to decrease simulation run time, particularly for PV smoothing dispatch option. (`SSC 1251 `__) +Improve efficiency of internal handling of battery parameter variables to decrease simulation run time, particularly for PV smoothing dispatch option. (`SSC 1251 `__) -Improve determination of price signal forecast for Merchant Plant configurations with automated dispatch: Calculate price signal in each time step as capacity-weighted sum of enabled energy and ancillary service prices instead of simple sum. (`SSC 1235 `__) +Improve determination of price signal forecast for Merchant Plant configurations with automated dispatch: Calculate price signal in each time step as capacity-weighted sum of enabled energy and ancillary service prices instead of simple sum. (`SSC 1235 `__) Hybrid Systems (SAM 2024.12.12) ------------------------------- -Add input pages for thermal loads and thermal rates to hybrid configurations that include fuel cells. (`SAM 1903 `__, `SSC 1244 `__) +Add input pages for thermal loads and thermal rates to hybrid configurations that include fuel cells. (`SAM 1903 `__, `SSC 1244 `__) -Include battery discharge power in power profile used to calculate project costs and benefits. (`SSC 1256 `__) +Include battery discharge power in power profile used to calculate project costs and benefits. (`SSC 1256 `__) -Fix issue with PV-based O&M costs that scaled costs specified in $/kWac by PV DC capacity instead of PV AC capacity. (`)SSC 1260 `__) +Fix issue with PV-based O&M costs that scaled costs specified in $/kWac by PV DC capacity instead of PV AC capacity. (`)SSC 1260 `__) -Use consistent default time-of-delivery (TOD) PPA price factors for all for front-of-meter (FOM) hybrid configurations. (`SAM 1971 `__) +Use consistent default time-of-delivery (TOD) PPA price factors for all for front-of-meter (FOM) hybrid configurations. (`SAM 1971 `__) -Remove "Hybrid" from performance model names in configuration window when creating or adding new cases. (`SAM 1875 `__) +Remove "Hybrid" from performance model names in configuration window when creating or adding new cases. (`SAM 1875 `__) Concentrating Solar Power (CSP) (SAM 2024.12.12) ------------------------------------------------ -For parabolic trough and linear Fresnel configurations, move input variables for receiver startup dely time and energy fraction from Solar Field page to System Control page. These inputs are for the dispatch optimization algorithm, not the performance simulation. (They are inputs to the performance model for power tower configurations.) (`SAM 1961 <%3C%22https://github.com/NREL/SAM/pull/1961%22>`__, `SSC 1261 `__) +For parabolic trough and linear Fresnel configurations, move input variables for receiver startup dely time and energy fraction from Solar Field page to System Control page. These inputs are for the dispatch optimization algorithm, not the performance simulation. (They are inputs to the performance model for power tower configurations.) (`SAM 1961 `__, `SSC 1261 `__) -New options for user-defined power cycle (UDPC) interpolation at maximum cycle output. (`SAM 1935 `__, `SSC 1253 `__) +New options for user-defined power cycle (UDPC) interpolation at maximum cycle output. (`SAM 1935 `__, `SSC 1253 `__) -Fix parabolic trough and linear Fresnel dispatch issue that resulted in infeasible results. (`SSC 1213 `__) +Fix parabolic trough and linear Fresnel dispatch issue that resulted in infeasible results. (`SSC 1213 `__) -New packed bed thermocline and pressurized water cylinder with piston separator TES options for the Physical Trough CSP and IPH performance models. (`SAM 1900 `__, `SSC 1238 `__) +New packed bed thermocline and pressurized water cylinder with piston separator TES options for the Physical Trough CSP and IPH performance models. (`SAM 1900 `__, `SSC 1238 `__) -Change default constant availability loss for molten salt power tower configurations from 0 to 5%. (`SAM 1899 `__) +Change default constant availability loss for molten salt power tower configurations from 0 to 5%. (`SAM 1899 `__) Industrial Process Heat (IPH) (SAM 2024.12.12) ---------------------------------------------- -Add Single Owner and Commercial financial model option for IPH performance models. For older versions of SAM, only the LCOH Calculator (fixed-charge rate method of calculating levelized cost of heat) financial model was available. This major new feature involves adding new cash flow cost and benefit streams based on heat generated by the system. (`SAM 1900 `__, `SSC 1238 `__) +Add Single Owner and Commercial financial model option for IPH performance models. For older versions of SAM, only the LCOH Calculator (fixed-charge rate method of calculating levelized cost of heat) financial model was available. This major new feature involves adding new cash flow cost and benefit streams based on heat generated by the system. (`SAM 1900 `__, `SSC 1238 `__) -Add the Solar Dynamics SunBeam collector to the Physical Trough collector library. (`SAM 1900 `__) +Add the Solar Dynamics SunBeam collector to the Physical Trough collector library. (`SAM 1900 `__) -Disable Send-to-Excel with Equations (Windows only) for IPH configurations with Single Owner or Commercial financial model until workbooks are updated. (`SAM 1954 `__) +Disable Send-to-Excel with Equations (Windows only) for IPH configurations with Single Owner or Commercial financial model until workbooks are updated. (`SAM 1954 `__) -Fix IPH molten salt linear Fresnel (MSLF) calculation of 'aux_design' and 'bop_design' to be consistent with CSP MSLF model. (`SSC 1254 `__) +Fix IPH molten salt linear Fresnel (MSLF) calculation of 'aux_design' and 'bop_design' to be consistent with CSP MSLF model. (`SSC 1254 `__) Marine Energy (SAM 2024.12.12) ------------------------------ -Update PDF report template to support Wave and Tidal configurations with Single Owner and LCOE Calculator financial models, and new energy converter and resource options. (`SAM 1947 `__) +Update PDF report template to support Wave and Tidal configurations with Single Owner and LCOE Calculator financial models, and new energy converter and resource options. (`SAM 1947 `__) -Add time series availability losses to Wave Energy and Tidal Energy models. (`SAM 1885 `__, `SSC 1225 `__) +Add time series availability losses to Wave Energy and Tidal Energy models. (`SAM 1885 `__, `SSC 1225 `__) -Add capacity factor input to tidal energy turbine design page. (`SAM 1872 `__, `SSC 1218 `__, `SSC 1181 `__) +Add capacity factor input to tidal energy turbine design page. (`SAM 1872 `__, `SSC 1218 `__, `SSC 1181 `__) -Update marine energy device cost curves. (`SSC 1249 `__) +Update marine energy device cost curves. (`SSC 1249 `__) -Update equations to improve use of marine energy models with PySAM. (`SSC 1217 `__) +Update equations to improve use of marine energy models with PySAM. (`SSC 1217 `__) Geothermal Power (SAM 2024.12.12) --------------------------------- -Update cost scenario data. (`SAM 1931 `__) +Update cost scenario data. (`SAM 1931 `__) -Add new option to turn off reservoir replacements. (`SAM 1881 `__, `SSC 1222 `__) +Add new option to turn off reservoir replacements. (`SAM 1881 `__, `SSC 1222 `__) -Add a button that updates O&M costs. (`SAM 1858 `__, `SSC 1210 `__) +Add a button that updates O&M costs. (`SAM 1858 `__, `SSC 1210 `__) -Remove unused features EGS custom plant temperature, check for production pumping cost in flash plants, and user-interface text revisions. (`SAM 1857 `__) +Remove unused features EGS custom plant temperature, check for production pumping cost in flash plants, and user-interface text revisions. (`SAM 1857 `__) -Improve production well calculations for brine efficiency and specific heat. (`SSC 1209 `__) +Improve production well calculations for brine efficiency and specific heat. (`SSC 1209 `__) Wind Power (SAM 2024.12.12) --------------------------- -Fix LandBOSSE call to run Python from SAM user interface. (`SAM 1939 `__) +Fix LandBOSSE call to run Python from SAM user interface. (`SAM 1939 `__) -Add wind weather file reader check for missing data to improve error message for invalid wind resource files. (`SSC 1221 `__) +Add wind weather file reader check for missing data to improve error message for invalid wind resource files. (`SSC 1221 `__) -New inputs to SSC (accessible only via `SAM Software Development Kit (SDK) `__ for wake model, access to internal Park wake model inputs, and new "icing persistence" input. These features are not available in the SAM desktop application. (`SSC 1186 `__) +New inputs to SSC (accessible only via `SAM Software Development Kit (SDK) `__ for wake model, access to internal Park wake model inputs, and new "icing persistence" input. These features are not available in the SAM desktop application. (`SSC 1186 `__) Custom Generation Profile (SAM 2024.12.12) ------------------------------------------ -Rename "Generic System" model to "Custom Generation Profile" to be clearer that model can use a time series generation profile from measured data or from a different model as input. (`SAM 1890 `__, `SSC 1228 `__) +Rename "Generic System" model to "Custom Generation Profile" to be clearer that model can use a time series generation profile from measured data or from a different model as input. (`SAM 1890 `__, `SSC 1228 `__) .. _2023-12-17-r2: SAM 2023.12.17 r2, SSC 292: August 23, 2024 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is the second maintenance update to `SAM 2023.12.17 <#2023-12-17>`__. +This is the second maintenance update to :ref:`SAM 2023.12.17 <2023-12-17>`. - Detailed PV and PVWatts - - 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. (`SAM 1812 `__, `SAM 1753 `__) - - Add checkboxes to PV uncertainty page to allow for enabling and disabling uncertainty categories. (`SAM 1753 `__) - - Fix problems with PV PDF report. (`SAM 1789 `__) - - 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. (`SAM 1791 `__, `SSC 1153 `__) - - Improve documentation of IEC 61858 temperature, optical, and spectral models for PV. (`SAM 1795 `__, `SSC 1175 `__) - - Fix internal issue with initializing ground clearance height for IEC 61853 module model. (`SSC 1194 `__) + - 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. (`SAM 1812 `__, `SAM 1753 `__) + - Add checkboxes to PV uncertainty page to allow for enabling and disabling uncertainty categories. (`SAM 1753 `__) + - Fix problems with PV PDF report. (`SAM 1789 `__) + - 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. (`SAM 1791 `__, `SSC 1153 `__) + - Improve documentation of IEC 61858 temperature, optical, and spectral models for PV. (`SAM 1795 `__, `SSC 1175 `__) + - Fix internal issue with initializing ground clearance height for IEC 61853 module model. (`SSC 1194 `__) - Battery Storage - - Fix default battery properties for Li-NMC batteries for some configurations with batteires. (`SAM 1818 `__) - - Improve battery lifetime model to allow for reversible thermal degradation. (`SSC 1164 `__) - - Fix issues with REopt API call for battery size and dispatch optimization. (`SSC 1187 `__) - - Display a message on input page when battery is allowed to charge from grid an a production tax credit (PTC) is enabled. (`SAM 1792 `__) - - Improve results of battery storage self-consumption dispatch option to more accurately determine when 100% of load is met by the system. (`SSC 1182 `__) - - Fix PDF report for the self-consumption battery dispatch option. (`SAM 1750 `__) - - Fix year index in TOU demand charge calculation for electricity bill calculations. (`SSC 1152 `__) + - Fix default battery properties for Li-NMC batteries for some configurations with batteires. (`SAM 1818 `__) + - Improve battery lifetime model to allow for reversible thermal degradation. (`SSC 1164 `__) + - Fix issues with REopt API call for battery size and dispatch optimization. (`SSC 1187 `__) + - Display a message on input page when battery is allowed to charge from grid an a production tax credit (PTC) is enabled. (`SAM 1792 `__) + - Improve results of battery storage self-consumption dispatch option to more accurately determine when 100% of load is met by the system. (`SSC 1182 `__) + - Fix PDF report for the self-consumption battery dispatch option. (`SAM 1750 `__) + - Fix year index in TOU demand charge calculation for electricity bill calculations. (`SSC 1152 `__) - Financial Models - - Fix tax and depreciation formulas in Send-to-Excel workbooks. (`SAM 1841 `__) - - Fix electricity bill calculation for net billing with tiered energy rates. (`SSC 1168 `__) - - Report basis for investment tax credit (ITC) and depreciation in outputs to improve transparency of incentive calculations. (`SAM 1808 `__, `SSC 1178 `__) - - Fix formula in Excel Workbook for Third Party Host / Developer financial model that calculates federal depreciation. (`SAM 1793 `__) - - Fix formulas in Excel Workbook for Community Solar financial model that calculates subscriber share of generation. (`SAM 1744 `__) - - Revise description of Indifference Point macro for Third Party Host / Developer model. (`SAM 1788 `__) - -- 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. (`SAM 1746 `__) -- Fix stochastic and PV uncertainty simulations on macOS. (`SAM 1758 `__, `SAM 1782 `__) -- Revise Marine Energy Help topics mentioning DOE Reference Model project. (`SAM 1790 `__) -- Revise description of Wind environmental loss on input page and in Help. (`SAM 1770 `__) -- Fix custom HTF for Molten Salt Power Tower configurations. (`SAM 1817 `__) -- 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. (`SAM 1749 `__) -- Fix application of time series losses ('adjust' variables) for non-annual simulations from SAM SDK / PySAM. (`SSC 1113 `__, `SAM 1826 `__) -- Make geothermal cost curves available in SSC (`SSC 1191 `__) -- Fix issues with geothermal cost inputs. (`SAM 1823 `__, `SSC 1189 `__) -- Modify marine energy tidal energy converter "Design tidal converter" power curve calculation method. (`SAM 1807 `__) + - Fix tax and depreciation formulas in Send-to-Excel workbooks. (`SAM 1841 `__) + - Fix electricity bill calculation for net billing with tiered energy rates. (`SSC 1168 `__) + - Report basis for investment tax credit (ITC) and depreciation in outputs to improve transparency of incentive calculations. (`SAM 1808 `__, `SSC 1178 `__) + - Fix formula in Excel Workbook for Third Party Host / Developer financial model that calculates federal depreciation. (`SAM 1793 `__) + - Fix formulas in Excel Workbook for Community Solar financial model that calculates subscriber share of generation. (`SAM 1744 `__) + - Revise description of Indifference Point macro for Third Party Host / Developer model. (`SAM 1788 `__) + +- 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. (`SAM 1746 `__) +- Fix stochastic and PV uncertainty simulations on macOS. (`SAM 1758 `__, `SAM 1782 `__) +- Revise Marine Energy Help topics mentioning DOE Reference Model project. (`SAM 1790 `__) +- Revise description of Wind environmental loss on input page and in Help. (`SAM 1770 `__) +- Fix custom HTF for Molten Salt Power Tower configurations. (`SAM 1817 `__) +- 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. (`SAM 1749 `__) +- Fix application of time series losses ('adjust' variables) for non-annual simulations from SAM SDK / PySAM. (`SSC 1113 `__, `SAM 1826 `__) +- Make geothermal cost curves available in SSC (`SSC 1191 `__) +- Fix issues with geothermal cost inputs. (`SAM 1823 `__, `SSC 1189 `__) +- Modify marine energy tidal energy converter "Design tidal converter" power curve calculation method. (`SAM 1807 `__) .. _2023-12-17-r1: SAM 2023.12.17 r1, SSC 290: March 4, 2024 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is the first maintenance update to `SAM 2023.12.17 <#2023-12-17>`__. +This is the first maintenance update to :ref:`SAM 2023.12.17 <2023-12-17>`. - Solar Resource - - Support NSRDB weather file downloads from the Solar Resource page for locations outside the United States. (`SAM 1720 `__, `SSC 1140 `__)  `Additional work is planned `__ for the Advanced NSRDB Download window for the second update to SAM 2023.12.17. - - Fix problem using latitude and longitude to download weather files from the Solar Resource page. (`SAM 1692 `__) + - Support NSRDB weather file downloads from the Solar Resource page for locations outside the United States. (`SAM 1720 `__, `SSC 1140 `__). `Additional work is planned `__ for the Advanced NSRDB Download window for the second update to :ref:`SAM 2023.12.17 <2023-12-17>`. + - Fix problem using latitude and longitude to download weather files from the Solar Resource page. (`SAM 1692 `__) - Detailed PV and PVWatts - - Fix PV land area calculations. (`SAM 1721 `__, `SAM 1697 `__) - - Fix PV time series shading data import from 3D shade calculator and overlapping inputs in Edit Shading window for PVWatts. (`SAM 1712 `__) - - Fix Detailed PV non-linear self shading for vertical arrays to avoid negative POA irradiance values. (`SSC 1127 `__) - - Fix issue with Detailed PV subhourly clipping loss when weather file has no DNI data. (`SSC 1126 `__) - - Fix reporting of ground-reflected rear irradiance gains in loss diagram for Detailed PV model with bifacial modules. (`SSC 1125 `__) - - Add snow slide coefficient to outputs for Detailed PV with snow model enabled. (`SSC 1128 `__) - - Clean up PV subhourly clipping loss correction in user interface. (`SAM 1689 `__) - - Fix diagrams on Detailed PV Shading and Layout page to show both portrait and landscape instead of duplicating portrait. (`SAM 1696 `__) + - Fix PV land area calculations. (`SAM 1721 `__, `SAM 1697 `__) + - Fix PV time series shading data import from 3D shade calculator and overlapping inputs in Edit Shading window for PVWatts. (`SAM 1712 `__) + - Fix Detailed PV non-linear self shading for vertical arrays to avoid negative POA irradiance values. (`SSC 1127 `__) + - Fix issue with Detailed PV subhourly clipping loss when weather file has no DNI data. (`SSC 1126 `__) + - Fix reporting of ground-reflected rear irradiance gains in loss diagram for Detailed PV model with bifacial modules. (`SSC 1125 `__) + - Add snow slide coefficient to outputs for Detailed PV with snow model enabled. (`SSC 1128 `__) + - Clean up PV subhourly clipping loss correction in user interface. (`SAM 1689 `__) + - Fix diagrams on Detailed PV Shading and Layout page to show both portrait and landscape instead of duplicating portrait. (`SAM 1696 `__) - Concentrating Solar Power (CSP) - - Fix parabolic trough loop configuration on SCA (Collectors) page. (`SAM 1709 `__) - - Fix problems with parabolic trough dispatch optimization and loop configuration that caused a simulation error. (`SAM 1674 `__, `SSC 1121 `__) + - Fix parabolic trough loop configuration on SCA (Collectors) page. (`SAM 1709 `__) + - Fix problems with parabolic trough dispatch optimization and loop configuration that caused a simulation error. (`SAM 1674 `__, `SSC 1121 `__) - Battery Storage - - Improve REopt API calls for battery size and dispatch optimization to better report status and errors from API. (`SAM 1714 `__) - - Fix simulation error caused by battery environment temperature input as time series array. (`SAM 1694 `__, `SSC 1138 `__) - - Fix issue with behind-the-meter battery with retail rate dispatch that caused a simulation error. (`SSC 1135 `__) - - Fix default battery life inputs so correct table is shown for the default Li-ion LFP/Graphite battery type. (`SAM 1715 `__) - - Fix problem with battery discharging to grid for manual dispatch option. (`SSC 1115 `__) - - Fix problem with battery self consumption dispatch option with grid outage. (`SSC 1114 `__) - -- Fix problem with losses specifed as "time series losses with custom time periods" that caused a simulation error. (`SAM 1698 `__) -- Improve reporting of time series data for subhourly Detailed PV and PV Battery simulations so that "hourly" and "hourly lifetime" values are consistent. (`SAM 1684 `__) -- Fix problem with loading weather files with time series wave resource data for marine energy wave model. (`SAM 1701 `__, `SSC 1130 `__) -- Improve debt sizing calculation for front-of-meter financial models with sculpted debt (DSCR as input) and when debt size limit is enabled. (`SSC 1136 `__) -- Fix state of Fuel Cell dispatch page when opening .sam files from older versions of SAM. (`SAM 1707 `__) -- Fix Save and Load buttons throughout user interface. (`SAM 1695 `__) -- Improve reporting of DC loss factors in PDF report for Detailed PV and PV Battery configurations. (`SAM 1690 `__) -- Fix broken link to SAM Forum from Help window. (`SAM 1716 `__) + - Improve REopt API calls for battery size and dispatch optimization to better report status and errors from API. (`SAM 1714 `__) + - Fix simulation error caused by battery environment temperature input as time series array. (`SAM 1694 `__, `SSC 1138 `__) + - Fix issue with behind-the-meter battery with retail rate dispatch that caused a simulation error. (`SSC 1135 `__) + - Fix default battery life inputs so correct table is shown for the default Li-ion LFP/Graphite battery type. (`SAM 1715 `__) + - Fix problem with battery discharging to grid for manual dispatch option. (`SSC 1115 `__) + - Fix problem with battery self consumption dispatch option with grid outage. (`SSC 1114 `__) + +- Fix problem with losses specifed as "time series losses with custom time periods" that caused a simulation error. (`SAM 1698 `__) +- Improve reporting of time series data for subhourly Detailed PV and PV Battery simulations so that "hourly" and "hourly lifetime" values are consistent. (`SAM 1684 `__) +- Fix problem with loading weather files with time series wave resource data for marine energy wave model. (`SAM 1701 `__, `SSC 1130 `__) +- Improve debt sizing calculation for front-of-meter financial models with sculpted debt (DSCR as input) and when debt size limit is enabled. (`SSC 1136 `__) +- Fix state of Fuel Cell dispatch page when opening .sam files from older versions of SAM. (`SAM 1707 `__) +- Fix Save and Load buttons throughout user interface. (`SAM 1695 `__) +- Improve reporting of DC loss factors in PDF report for Detailed PV and PV Battery configurations. (`SAM 1690 `__) +- Fix broken link to SAM Forum from Help window. (`SAM 1716 `__) .. _2023-12-17: @@ -644,7 +644,7 @@ SAM 2023.12.17, SSC 288: December 17, 2023 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. -For a complete list of code revisions associated with this version, see the `SAM `__ and `SSC `__ GitHub repositories. Highlights include: +For a complete list of code revisions associated with this version, see the `SAM `__ and `SSC `__ GitHub repositories. Highlights include: - New SAM logo and icon. - 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. @@ -658,12 +658,12 @@ For a complete list of code revisions associated with this version, see the `SAM - Update photovoltaic module and inverter libraries. - Revise and update Help. -We are working to fix known `SAM issues `__ and `SSC issues `__ for an update to this version in early 2024. Please `let us know `__ if you find any other problems. +We are working to fix known `SAM issues `__ and `SSC issues `__ for an update to this version in early 2024. Please `let us know `__ if you find any other problems. Hybrid Power Systems -------------------- -This major new feature adds configurations for hybrid power systems. (`SAM 1448 `__ and `multiple subsequent pull requests `__, `SSC 1051 `__) +This major new feature adds configurations for hybrid power systems. (`SAM 1448 `__ and `multiple subsequent pull requests `__, `SSC 1051 `__) 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: @@ -675,62 +675,62 @@ Hybrid power systems combine photovoltaic (PVWatts or Detailed PV), Wind Power, General (2023.12.17) -------------------- -- New System Advisor Model logo and icon. Icon is implemented for Windows and Mac, not Linux. (`SAM 1514 `__) -- 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. (`SAM 1559 `__, `SAM 1499 `__) -- Update defaults to align with `2023 NREL Annual Technology Baseline (ATB) `__ and to result in positive net present value (NPV) where possible. (`SAM 1581 `__) -- Fix layout issues for Mac and Linux versions. (`SAM 1580 `__) -- 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. (`SAM 1468 `__) -- Fix issue with time series availability losses. (`SSC 1093 `__) +- New System Advisor Model logo and icon. Icon is implemented for Windows and Mac, not Linux. (`SAM 1514 `__) +- 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. (`SAM 1559 `__, `SAM 1499 `__) +- Update defaults to align with `2023 NREL Annual Technology Baseline (ATB) `__ and to result in positive net present value (NPV) where possible. (`SAM 1581 `__) +- Fix layout issues for Mac and Linux versions. (`SAM 1580 `__) +- 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. (`SAM 1468 `__) +- Fix issue with time series availability losses. (`SSC 1093 `__) Financial Models (2023.12.17) ----------------------------- -- Fix investment-based incentive (IBI) and capacity-based incentive (CBI) double-counting in cash flow (`SAM 1445 `__, `SSC 1048 `__) -- 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. (`SAM 1545 `__) -- 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. (`SAM 1501 `__, `SSC 1066 `__) -- 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. (`SAM 1542 `__) -- Fix electricity to/from grid output for battery configurations with grid outages. (`SSC 1097 `__) -- Report battery capacity-based O&M expense in cash flow for all financial models. (`SSC 1076 `__) -- Remove total production tax credit (PTC) from cash flow results. State and federal PTC are applied separately. (`SSC 1072 `__) -- Fix monthly energy values for grid curtailment. (`SSC 1068 `__) -- Rename internal cash flow variables from "net" to "sales" to make it clear these are for energy to grid outputs. (`SSC 1060 `__) +- Fix investment-based incentive (IBI) and capacity-based incentive (CBI) double-counting in cash flow (`SAM 1445 `__, `SSC 1048 `__) +- 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. (`SAM 1545 `__) +- 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. (`SAM 1501 `__, `SSC 1066 `__) +- 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. (`SAM 1542 `__) +- Fix electricity to/from grid output for battery configurations with grid outages. (`SSC 1097 `__) +- Report battery capacity-based O&M expense in cash flow for all financial models. (`SSC 1076 `__) +- Remove total production tax credit (PTC) from cash flow results. State and federal PTC are applied separately. (`SSC 1072 `__) +- Fix monthly energy values for grid curtailment. (`SSC 1068 `__) +- Rename internal cash flow variables from "net" to "sales" to make it clear these are for energy to grid outputs. (`SSC 1060 `__) Detailed Photovoltaic (2023.12.17) ---------------------------------- -- New subhourly clipping correction for AC loss calculation. (`SAM 1447 `__, `SSC 1077 `__, `SSC 1050 `__) -- Update module and inverter libraries from 11/17/2023 CEC workbooks. (`SAM 1607 `__, `SAM 1606 `__) -- Change default inverters based on market share. (`SAM 1607 `__) -- Make scripts and data used to generate module and inverter libraries public. (`SAM 1440 `__) -- Fix issue with availability and shading losses shown on PDF report. (`SAM 1579 `__) -- Add checks and warnings for bifacial ground clearance height input values that result in modules being too close to the ground. (`SAM 1544 `__, `SSC 1095 `__) -- Move module dimension inputs from Shading and Layout page to Module page. (`SAM 1519 `__) -- Change default inverter temperature derating curve maximum voltage to 1500 VDC so it works with full range of inverters in the library. (`SAM 1460 `__) -- Improve PVsyst conversion macro to better handle PVsyst meteo files. (`SAM 1430 `__) -- Prevent number of strings in parallel value of zero to avoid simulation crash. (`SSC 1087 `__) -- Improve error messages when cell temperature heat transfer method is missing data. (`SSC 1086 `__) -- 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. (`SSC 1071 `__) +- New subhourly clipping correction for AC loss calculation. (`SAM 1447 `__, `SSC 1077 `__, `SSC 1050 `__) +- Update module and inverter libraries from 11/17/2023 CEC workbooks. (`SAM 1607 `__, `SAM 1606 `__) +- Change default inverters based on market share. (`SAM 1607 `__) +- Make scripts and data used to generate module and inverter libraries public. (`SAM 1440 `__) +- Fix issue with availability and shading losses shown on PDF report. (`SAM 1579 `__) +- Add checks and warnings for bifacial ground clearance height input values that result in modules being too close to the ground. (`SAM 1544 `__, `SSC 1095 `__) +- Move module dimension inputs from Shading and Layout page to Module page. (`SAM 1519 `__) +- Change default inverter temperature derating curve maximum voltage to 1500 VDC so it works with full range of inverters in the library. (`SAM 1460 `__) +- Improve PVsyst conversion macro to better handle PVsyst meteo files. (`SAM 1430 `__) +- Prevent number of strings in parallel value of zero to avoid simulation crash. (`SSC 1087 `__) +- Improve error messages when cell temperature heat transfer method is missing data. (`SSC 1086 `__) +- 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. (`SSC 1071 `__) PVWatts (2023.12.17) -------------------- -- Fix issue with Edit Shading Data window for advanced "Shading by Nearby Objects". (`SAM 1593 `__) +- Fix issue with Edit Shading Data window for advanced "Shading by Nearby Objects". (`SAM 1593 `__) Battery Storage (2023.12.17) ---------------------------- -- Change default battery type from Li-ion LFP to Li-ion NMC. (`SAM 1581 `__) -- New behind-the-meter self-consumption battery dispatch option that minimizes use of grid power (`SAM 1446 `__, `SSC 1057 `__, `SSC 1049 `__) -- Update REopt API call to Version 3, pass grid outage data to API, and fix conversion efficiency values. (`SAM 1527 `__, `SSC 1078 `__) -- Rename "price signals dispatch" to "retail rate dispatch" for behind-the-meter battery dispatch options. (`SAM 1495 `__, `SSC 1064 `__) -- Fix problem with automatic battery sizing when desired size is specified in AC units. (`SAM 1469 `__) -- 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. (`SAM 1493 `__, `SSC 1016 `__) -- Remove "Calculate Load Data" option from Electric Load page for Standalone Battery / Residential configurations because it requires solar resource data that is not available. (`SAM 1467 `__) -- Set default values of all availability loss inputs to zero for battery configurations. (`SAM 1463 `__) -- Show rear irradiance values in loss diagram for PV-battery configurations. (`SAM 1422 `__) -- Fix issue for PV-smoothing dispatch that caused discrepancy between PV-smoothing and battery state of charge values. (`SSC 1085 `__) -- Fix battery not discharging for peak shaving dispatch for small batteries. (`SSC 1208 `__) -- Fix battery discharging in excess of critical load when AC losses are present. (`SSC 1061 `__) +- Change default battery type from Li-ion LFP to Li-ion NMC. (`SAM 1581 `__) +- New behind-the-meter self-consumption battery dispatch option that minimizes use of grid power (`SAM 1446 `__, `SSC 1057 `__, `SSC 1049 `__) +- Update REopt API call to Version 3, pass grid outage data to API, and fix conversion efficiency values. (`SAM 1527 `__, `SSC 1078 `__) +- Rename "price signals dispatch" to "retail rate dispatch" for behind-the-meter battery dispatch options. (`SAM 1495 `__, `SSC 1064 `__) +- Fix problem with automatic battery sizing when desired size is specified in AC units. (`SAM 1469 `__) +- 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. (`SAM 1493 `__, `SSC 1016 `__) +- Remove "Calculate Load Data" option from Electric Load page for Standalone Battery / Residential configurations because it requires solar resource data that is not available. (`SAM 1467 `__) +- Set default values of all availability loss inputs to zero for battery configurations. (`SAM 1463 `__) +- Show rear irradiance values in loss diagram for PV-battery configurations. (`SAM 1422 `__) +- Fix issue for PV-smoothing dispatch that caused discrepancy between PV-smoothing and battery state of charge values. (`SSC 1085 `__) +- Fix battery not discharging for peak shaving dispatch for small batteries. (`SSC 1208 `__) +- Fix battery discharging in excess of critical load when AC losses are present. (`SSC 1061 `__) Concentrating Solar Power (2023.12.17) -------------------------------------- @@ -740,150 +740,150 @@ Concentrating Solar Power (2023.12.17) - 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%. - 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%. - Improved levelized cost of heat (LCOH) model includes component cost breakdowns -- Fix molten salt power tower cavity receiver estimated net output at design calculation. (`SSC 1067 `__) +- Fix molten salt power tower cavity receiver estimated net output at design calculation. (`SSC 1067 `__) Wind Power (2023.12.17) ----------------------- -- Add system availability loss to wind power model. `SAM 1612 `__ -- Fix WIND Toolkit downloads to correctly download data at different measurement heights. (`SAM 1483 `__) +- Add system availability loss to wind power model. `SAM 1612 `__ +- Fix WIND Toolkit downloads to correctly download data at different measurement heights. (`SAM 1483 `__) Marine Energy (2023.12.17) -------------------------- -- New array cable voltage and array cost scaling calculations. (`SAM 1423 `__, `SAM 1350 `__, `SSC 1038 `__, `SSC 990 `__) -- New option for custom tidal turbine design. (`SAM 1423 `__) -- New option for Tidal resource time series data with new example resource files. (`SAM 1510 `__, `SSC 1069 `__) -- Fix user interface layout issues for Mac, and issues with showing and hiding inputs on cost pages cost based on selection of options. (`SAM 1591 `__) -- Update Wave resource libraries and example files. (`SAM 1591 `__, `SSC 1095 `__) -- Fix issue with tidal resource data shown on PDF report. (`SAM 1579 `__) +- New array cable voltage and array cost scaling calculations. (`SAM 1423 `__, `SAM 1350 `__, `SSC 1038 `__, `SSC 990 `__) +- New option for custom tidal turbine design. (`SAM 1423 `__) +- New option for Tidal resource time series data with new example resource files. (`SAM 1510 `__, `SSC 1069 `__) +- Fix user interface layout issues for Mac, and issues with showing and hiding inputs on cost pages cost based on selection of options. (`SAM 1591 `__) +- Update Wave resource libraries and example files. (`SAM 1591 `__, `SSC 1095 `__) +- Fix issue with tidal resource data shown on PDF report. (`SAM 1579 `__) Solar Water Heating ------------------- -- Limit tank cold node temperature to realistic range of values. (`SSC 1011 `__) +- Limit tank cold node temperature to realistic range of values. (`SSC 1011 `__) Geothermal Power (2023.12.17) ----------------------------- -- Fix reservoir pressure change units. (`SAM 1591 `__, `SSC 1095 `__) -- Add inputs for more precise well count calculations, new tooltips for input variable descriptions, and option to read wet bulb temperature from weather file. (`SAM 1524 `__, `SSC 1075 `__) -- 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. (`SAM 1517 `__, `SAM 1488 `__) +- Fix reservoir pressure change units. (`SAM 1591 `__, `SSC 1095 `__) +- Add inputs for more precise well count calculations, new tooltips for input variable descriptions, and option to read wet bulb temperature from weather file. (`SAM 1524 `__, `SSC 1075 `__) +- 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. (`SAM 1517 `__, `SAM 1488 `__) Fuel Cell (2023.12.17) ---------------------- -- Create new input page for fuel cell dispatch options that is separate from battery dispatch, and remove options not appropriate for fuel cell. (`SAM 1492 `__) -- Add monthly energy output. (`SSC 1094 `__) +- Create new input page for fuel cell dispatch options that is separate from battery dispatch, and remove options not appropriate for fuel cell. (`SAM 1492 `__) +- Add monthly energy output. (`SSC 1094 `__) .. _2022-11-21-r3: SAM 2022.11.21 r3, SSC 280: June 3, 2023 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is the third maintenance update to `SAM 2022.11.21 <2022-11-21>`__. +This is the third maintenance update to :ref:`SAM 2022.11.21 <2022-11-21>`. -- Fix Electric Load page callback error. (`SAM 1412 `__) -- Help revisions. (`SAM 1413 `__) +- Fix Electric Load page callback error. (`SAM 1412 `__) +- Help revisions. (`SAM 1413 `__) .. _2022-11-21-r2: SAM 2022.11.21 r2, SSC 280: May 27, 2023 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is the second maintenance update to `SAM 2022.11.21 <2022-11-21>`__. - -- 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. (`SAM 1408 `__, `SSC 1024 `__, `SSC 1028) `__ -- Fix marine energy PDF report rounding of numbers and add LCOE and FCR table. (`SAM 1399 `__) -- Fix photovoltaic PDF report so monthly energy graphs display correctly for large systems. (`SAM 1394 `__) -- Fix critical load array length problems. (`SAM 1397 `__, `SSC 1021 `__, `SAM 1390 `__) -- Update WIND Toolkit download sample scripts. (`SAM 1396 `__) -- Fix photovoltaic loss diagram to avoid overlapping text. (`SAM 1393 `__) -- Fix photovoltaic CAPEX graphs on Installation Costs page. (`SAM 1386 `__) -- Fix direct steam linear Fresnel callback error on System Design page. (`SAM 1382 `__) -- Fix high-concentration photovoltaic callback error on Inverter page. (`SAM 1381 `__) -- Fix geothermal cost calculations for automatic plant cost estimate. (`SAM 1379 `__) -- Revise multiple weather file download instructions in page note. (`SAM 1377 `__) -- Improve photovoltaic sizing message logic and text. (`SAM 1376 `__) -- Update WIND Toolkit downloads to use wtk-download endpoint instead of wtk-srw-download to provide access to subhourly data. (`SAM 1374 `__) -- Update hourly price downloads to Cambium 2022 and add an optional escalation rate. (`SAM 1365 `__) -- Update battery price signals dispatch to use same approach as peak shaving so battery dispatch can respond to system power and load. (`SSC 1031 `__) -- Update REopt battery sizing for standalone battery, includes updating PySAM tools for Utility Rate Database (URDB) to URDB Version 8. (`SSC 1022 `__) -- Add check on battery voltage table for duplicate voltage values to prevent battery charge power exceeding available power from system. (`SSC 1020 `__) -- Update weather file reader to avoid error about different number of columns in header rows for SAM CSV solar resource file format. (`SSC 1017 `__) +This is the second maintenance update to :ref:`SAM 2022.11.21 <2022-11-21>`. + +- 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. (`SAM 1408 `__, `SSC 1024 `__, `SSC 1028) `__ +- Fix marine energy PDF report rounding of numbers and add LCOE and FCR table. (`SAM 1399 `__) +- Fix photovoltaic PDF report so monthly energy graphs display correctly for large systems. (`SAM 1394 `__) +- Fix critical load array length problems. (`SAM 1397 `__, `SSC 1021 `__, `SAM 1390 `__) +- Update WIND Toolkit download sample scripts. (`SAM 1396 `__) +- Fix photovoltaic loss diagram to avoid overlapping text. (`SAM 1393 `__) +- Fix photovoltaic CAPEX graphs on Installation Costs page. (`SAM 1386 `__) +- Fix direct steam linear Fresnel callback error on System Design page. (`SAM 1382 `__) +- Fix high-concentration photovoltaic callback error on Inverter page. (`SAM 1381 `__) +- Fix geothermal cost calculations for automatic plant cost estimate. (`SAM 1379 `__) +- Revise multiple weather file download instructions in page note. (`SAM 1377 `__) +- Improve photovoltaic sizing message logic and text. (`SAM 1376 `__) +- Update WIND Toolkit downloads to use wtk-download endpoint instead of wtk-srw-download to provide access to subhourly data. (`SAM 1374 `__) +- Update hourly price downloads to Cambium 2022 and add an optional escalation rate. (`SAM 1365 `__) +- Update battery price signals dispatch to use same approach as peak shaving so battery dispatch can respond to system power and load. (`SSC 1031 `__) +- Update REopt battery sizing for standalone battery, includes updating PySAM tools for Utility Rate Database (URDB) to URDB Version 8. (`SSC 1022 `__) +- Add check on battery voltage table for duplicate voltage values to prevent battery charge power exceeding available power from system. (`SSC 1020 `__) +- Update weather file reader to avoid error about different number of columns in header rows for SAM CSV solar resource file format. (`SSC 1017 `__) .. _2022-11-21-r1: SAM 2022.11.21 r1, SSC 279: February 23, 2023 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is the first maintenance update to `SAM 2022.11.21 <#2022-11-21>`__. - -- 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 `SAM CSV format for WIND `__ is now SAM's default format for wind resource files. (`SSC 985 `__) -- Add Artic XCPC collector to Solar Water Heating collector library. (`SAM 1337 `__) -- Fix Geothermal resource temperature input constraint on maximum value. (`SAM 1341 `__, `SSC 986 `__) -- Fix issue for Geothermal resource temperature less than 150°C causing capacity factor greater than 1. (`SSC 989 `__) -- New Python sample script to download data from the OpenEI End Use Load Profiles database. (`SAM 1331 `__) -- Convert UI forms to JSON. (`SAM 1338 `__, `WEX 155 `__) -- Fix descriptive text in Loss Adjustment widget. (`SAM 1355 `__) -- Fix 'irrad_mode' input variable documentation. (`SSC 955 `__) -- Revise and update Help. (`SAM 1359 `__) +This is the first maintenance update to :ref:`SAM 2022.11.21 <2022-11-21>`. + +- 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 `SAM CSV format for WIND `__ is now SAM's default format for wind resource files. (`SSC 985 `__) +- Add Artic XCPC collector to Solar Water Heating collector library. (`SAM 1337 `__) +- Fix Geothermal resource temperature input constraint on maximum value. (`SAM 1341 `__, `SSC 986 `__) +- Fix issue for Geothermal resource temperature less than 150°C causing capacity factor greater than 1. (`SSC 989 `__) +- New Python sample script to download data from the OpenEI End Use Load Profiles database. (`SAM 1331 `__) +- Convert UI forms to JSON. (`SAM 1338 `__, `WEX 155 `__) +- Fix descriptive text in Loss Adjustment widget. (`SAM 1355 `__) +- Fix 'irrad_mode' input variable documentation. (`SSC 955 `__) +- Revise and update Help. (`SAM 1359 `__) - Battery Storage - - Fix issue with Generic Battery price signal dispatch causing simulation crash. (`SSC 991 `__) - - Fix missing Help topic for Stanadalone Battery installation cost page. (`SAM 1347 `__) - - Fix issue with PV - Battery configurations caused by specifying negative time series losses. (`SSC 980 `__) + - Fix issue with Generic Battery price signal dispatch causing simulation crash. (`SSC 991 `__) + - Fix missing Help topic for Stanadalone Battery installation cost page. (`SAM 1347 `__) + - Fix issue with PV - Battery configurations caused by specifying negative time series losses. (`SSC 980 `__) - CSP, IPH and TES - - New Pumped Thermal Energy Storage (PTES) design-point parameter calculator. (`SAM 1318 `__, `SSC 965 `__) - - Add methanol as cold TES option for Pumped Thermal Energy Storage (PTES). (`SAM 1307 `__, `SSC 967 `__) - - Fix Electric Thermal Energy Storage (ETES) issue loading input pages. (`SAM 1312 `__, `SSC 961 `__) - - Fix Physical Trough labeling of SCA and HCE in loop configuration widget and SCA and HCE input pages. (`SAM 1329 `__) - - Fix issue with Physical Trough at 600 MWt heat capacity simulation failing. (`SSC 982 `__) - - Fix Molten Salt Power Tower optimization failure and erroneous calculated design point values of -789. (`SSC 976 `__) - - Add ternery salt properties to HTF options for Molten Salt Power Tower. (`SAM 1321 `__) - - Fix Industrial Process Heat (IPH) Trough and Physical Trough models to allow use of 'solar_resource_data' input. (`SSC 975 `__) - - Fix issue with name of system capacity variable in internal code. (`SSC 958 `__) + - New Pumped Thermal Energy Storage (PTES) design-point parameter calculator. (`SAM 1318 `__, `SSC 965 `__) + - Add methanol as cold TES option for Pumped Thermal Energy Storage (PTES). (`SAM 1307 `__, `SSC 967 `__) + - Fix Electric Thermal Energy Storage (ETES) issue loading input pages. (`SAM 1312 `__, `SSC 961 `__) + - Fix Physical Trough labeling of SCA and HCE in loop configuration widget and SCA and HCE input pages. (`SAM 1329 `__) + - Fix issue with Physical Trough at 600 MWt heat capacity simulation failing. (`SSC 982 `__) + - Fix Molten Salt Power Tower optimization failure and erroneous calculated design point values of -789. (`SSC 976 `__) + - Add ternery salt properties to HTF options for Molten Salt Power Tower. (`SAM 1321 `__) + - Fix Industrial Process Heat (IPH) Trough and Physical Trough models to allow use of 'solar_resource_data' input. (`SSC 975 `__) + - Fix issue with name of system capacity variable in internal code. (`SSC 958 `__) - Financial Models - - Fix issue with NaN in financial model results for performance models that run single year simulations. (`SSC 993 `__) - - Fix issue with display of lifetime electricity load output for performance models with singe-year simulations. (`SSC 963 `__) - - Fix ITC for PPA Sale Leaseback to apply to all years. (`SSC 988 `__) - - Update cash flow Excel Send-to-Excel with Equations to support multi-year ITC. (`SAM 1343 `__) - - Electricity rate energy charge supports up to 36 TOU periods. (`SAM 1357 `__) - - Add button to Electric Load page to run "Download Load Data" macro. (`SAM 1349 `__) - - Fix issue with grid outage code that cause simulation to stop without finishing. (`SSC 979 `__) - - Improve output variable labels to make effect of grid interconnection clearer. (`SSC 983 `__) + - Fix issue with NaN in financial model results for performance models that run single year simulations. (`SSC 993 `__) + - Fix issue with display of lifetime electricity load output for performance models with singe-year simulations. (`SSC 963 `__) + - Fix ITC for PPA Sale Leaseback to apply to all years. (`SSC 988 `__) + - Update cash flow Excel Send-to-Excel with Equations to support multi-year ITC. (`SAM 1343 `__) + - Electricity rate energy charge supports up to 36 TOU periods. (`SAM 1357 `__) + - Add button to Electric Load page to run "Download Load Data" macro. (`SAM 1349 `__) + - Fix issue with grid outage code that cause simulation to stop without finishing. (`SSC 979 `__) + - Improve output variable labels to make effect of grid interconnection clearer. (`SSC 983 `__) - Detailed PV - - Fix issue with reporting of rear-side soiling losses for bifacial modules when rack shading loss set to zero. (`SSC 978 `__) - - Fix issue with reporting of bifacial gain output. (`SSC 951 `__) - - Condense albedo out-of-range simulation warnings. (`SSC 996 `__) - - Make inverter voltage ratings editable and improve system sizing messages. (`SAM 1352 `__) - - Fix ground clearance height issue for Sandia module model that cause simulation to stop without finishing. (`SSC 960 `__) - - Update default module parameters for Sandia, CEC with User Specifications, Simple Efficiency, and IEC 61853 module models to be consistent with CEC Database model. (`SAM 1335 `__ + - Fix issue with reporting of rear-side soiling losses for bifacial modules when rack shading loss set to zero. (`SSC 978 `__) + - Fix issue with reporting of bifacial gain output. (`SSC 951 `__) + - Condense albedo out-of-range simulation warnings. (`SSC 996 `__) + - Make inverter voltage ratings editable and improve system sizing messages. (`SAM 1352 `__) + - Fix ground clearance height issue for Sandia module model that cause simulation to stop without finishing. (`SSC 960 `__) + - Update default module parameters for Sandia, CEC with User Specifications, Simple Efficiency, and IEC 61853 module models to be consistent with CEC Database model. (`SAM 1335 `__ - PVWatts - - Fix REopt API call for PVWatts-Battery configurations. (`SSC 952 `__, `SAM 1301 `__) - - New PVWatts warning when bifacial module enabled with fixed roof mount. (`SSC 953 `__) - - Change default O&M cost for PVWatts-Battery configurations to better account for battery cost. (`SAM 1326 `__)> - - Fix callback error with PVWatts Advanced Inputs for PVWatts with no financial model configurations. (`SAM 1309 `__) + - Fix REopt API call for PVWatts-Battery configurations. (`SSC 952 `__, `SAM 1301 `__) + - New PVWatts warning when bifacial module enabled with fixed roof mount. (`SSC 953 `__) + - Change default O&M cost for PVWatts-Battery configurations to better account for battery cost. (`SAM 1326 `__)> + - Fix callback error with PVWatts Advanced Inputs for PVWatts with no financial model configurations. (`SAM 1309 `__) - Marine Energy - - Fix Marine Energy callback error when choosing resource options. (`SAM 1304 `__) - - Fix Marine Energy issue copying and pasting tidal resource data on Mac. (`WEX 148 `__) + - Fix Marine Energy callback error when choosing resource options. (`SAM 1304 `__) + - Fix Marine Energy issue copying and pasting tidal resource data on Mac. (`WEX 148 `__) .. _2022-11-21: SAM 2022.11.21, SSC 278: November 21, 2022 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -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 `SAM `__ and `SSC `__ GitHub repositories. Highlights include: +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 `SAM `__ and `SSC `__ GitHub repositories. Highlights include: - New Pumped Thermal Energy Storage (PTES) model with dispatch optimization. - CSP Power Tower option to charge TES (via dispatch optimization) from grid via electric heater. @@ -893,7 +893,7 @@ This new version introduces a new Pumped Thermal Energy Storage (PTES) model and - Spatial albedo and ground irradiance calculations for Detailed Photovoltaic model. - Investment tax credit (ITC) as either Year 1 credit or spread over multiple years. -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 `SAM `__ and `SSC `__ repositories: +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 `SAM `__ and `SSC `__ repositories: - Add support for ITC as array to cash flow send-to-Excel with equations. - Generic System model Generate profile from open cases causes SAM to crash. @@ -908,224 +908,224 @@ General (2022.11.21) - Update defaults for current version of `NREL Annual Technology Baseline (ATB) `__ - Fix user interface layout issues for Linux and Mac versions. (This is an ongoing effort.) -- Fix sample script for downloading weather files from NSRDB to include time zone. (`SAM 1213 `__) -- Fix issue with solar resource library folder with Advanced Download option. (`SAM 1182 `__) -- Improve Edit Losses window to support specifying time periods with minutes. (`SAM 1164 `__, `SSC 878 `__) -- 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. (`SSC 907 `__) +- Fix sample script for downloading weather files from NSRDB to include time zone. (`SAM 1213 `__) +- Fix issue with solar resource library folder with Advanced Download option. (`SAM 1182 `__) +- Improve Edit Losses window to support specifying time periods with minutes. (`SAM 1164 `__, `SSC 878 `__) +- 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. (`SSC 907 `__) Financial Models (2022.11.21) ----------------------------- -- Fix bug in Community Solar subscriber NPV calculation. (`SAM 1242 `__, `SSC 929 `__) -- 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. (`SSC 913 `__) +- Fix bug in Community Solar subscriber NPV calculation. (`SAM 1242 `__, `SSC 929 `__) +- 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. (`SSC 913 `__) Electricity Rates (2022.11.21) ------------------------------ -- For Utility Rate Database (URDB) downloads, apply look back months to billing demand inputs instead of listing as unused. (`SAM 1237 `__) -- Fix rollover calculation for bill without system. (`SSC 941 `__) +- For Utility Rate Database (URDB) downloads, apply look back months to billing demand inputs instead of listing as unused. (`SAM 1237 `__) +- Fix rollover calculation for bill without system. (`SSC 941 `__) Detailed Photovoltaic (2022.11.21) ---------------------------------- -- Update module and inverter libraries. (`SAM 1269 `__) -- Enhance bifacial model with electrical mismatch loss estimate and spatial albedo, and new Spatial tab on Results page. (`SAM 1152 `__, `SSC 871 `__, `SAM 1199 `__) -- Update P50/P90 simulations to PV Uncertainty with more sophisticated modeling of uncertainty factors. (`SAM 1076 `__) -- Add option to input land area in acres/MWac and fix land area calculatoins. (`SAM 1195 `__, `SAM 1166 `__) -- Fix problem with terrain slope input enabling. (`SAM 1191 `__) -- Improve error handling for different albedo input options. (`SAM 1180 `__) -- Add warning in user interface for negative tilt angles. (`SAM 1171 `__) -- Report latitude, longitude, elevation, and time zone from weather file header in simulation results. (`SSC 908 `__) -- New time series module temperature input to bypass internal calculations (SSC and LK script only, not available in SAM input pages). (`SSC 897 `__) -- Improve input checks in variable table for Software Development Kit and PySAM users. (`SSC 885 `__) -- Fix issue with AC wiring loss for subhourly simulations. (`SSC 879 `__) +- Update module and inverter libraries. (`SAM 1269 `__) +- Enhance bifacial model with electrical mismatch loss estimate and spatial albedo, and new Spatial tab on Results page. (`SAM 1152 `__, `SSC 871 `__, `SAM 1199 `__) +- Update P50/P90 simulations to PV Uncertainty with more sophisticated modeling of uncertainty factors. (`SAM 1076 `__) +- Add option to input land area in acres/MWac and fix land area calculatoins. (`SAM 1195 `__, `SAM 1166 `__) +- Fix problem with terrain slope input enabling. (`SAM 1191 `__) +- Improve error handling for different albedo input options. (`SAM 1180 `__) +- Add warning in user interface for negative tilt angles. (`SAM 1171 `__) +- Report latitude, longitude, elevation, and time zone from weather file header in simulation results. (`SSC 908 `__) +- New time series module temperature input to bypass internal calculations (SSC and LK script only, not available in SAM input pages). (`SSC 897 `__) +- Improve input checks in variable table for Software Development Kit and PySAM users. (`SSC 885 `__) +- Fix issue with AC wiring loss for subhourly simulations. (`SSC 879 `__) PVWatts (2022.11.21) -------------------- -- Improve handling and error reporting for albedo. (`SAM 1136 `__, `SSC 864 `__) -- Add option to input land area in acres/MWac and fix land area calculatoins. (`SAM 1195 `__, `SAM 1166 `__) -- Report latitude, longitude, elevation, and time zone from weather file header in simulation results. (`SSC 908 `__) -- Fix issue with snow loss model that resulted in DC snow loss of zero for time steps with snow. (`SSC 874 `__) -- Fix issue with inverter efficiency at lower power. (`SSC 872 `__) +- Improve handling and error reporting for albedo. (`SAM 1136 `__, `SSC 864 `__) +- Add option to input land area in acres/MWac and fix land area calculatoins. (`SAM 1195 `__, `SAM 1166 `__) +- Report latitude, longitude, elevation, and time zone from weather file header in simulation results. (`SSC 908 `__) +- Fix issue with snow loss model that resulted in DC snow loss of zero for time steps with snow. (`SSC 874 `__) +- Fix issue with inverter efficiency at lower power. (`SSC 872 `__) Battery Storage (2022.11.21) ---------------------------- -- Improve reporting of AC and DC in kW and kWh inputs and outputs. (`SAM 1183 `__, `SSC 899 `__, `SSC 889 `__) -- Improve passing of SAM inputs to REopt. (`SAM 1165 `__) -- Improve transformer loss calculations so losses are better accounted for in battery dispatch. (` `__) -- For PV smoothing, change battery state of charge (SOC) to end of time step to be consistent with other dispatch options. (`SSC 904 `__) -- Restore PV priority option for manual dispatch option. (`SSC 900 `__) -- Various Levelized Cost of Storage (LCOS) fixes. (`SSC 883 `__, `SSC 853 `__) -- Fix price signals dispatch option for rates with different periods in a month. (`SSC 882 `__) -- Make front-of-meter (FOM) automated dispatch aware of retail electricity prices. (`SSC 824 `__) -- Improvements to front-of-meter (FOM) automated dispatch. (`SSC 877 `__) -- New 'utilityrateforecast' compute module for Software Development Kit (SDK) and PySAM coders. (`SSC 868 `__) +- Improve reporting of AC and DC in kW and kWh inputs and outputs. (`SAM 1183 `__, `SSC 899 `__, `SSC 889 `__) +- Improve passing of SAM inputs to REopt. (`SAM 1165 `__) +- Improve transformer loss calculations so losses are better accounted for in battery dispatch. (` `__) +- For PV smoothing, change battery state of charge (SOC) to end of time step to be consistent with other dispatch options. (`SSC 904 `__) +- Restore PV priority option for manual dispatch option. (`SSC 900 `__) +- Various Levelized Cost of Storage (LCOS) fixes. (`SSC 883 `__, `SSC 853 `__) +- Fix price signals dispatch option for rates with different periods in a month. (`SSC 882 `__) +- Make front-of-meter (FOM) automated dispatch aware of retail electricity prices. (`SSC 824 `__) +- Improvements to front-of-meter (FOM) automated dispatch. (`SSC 877 `__) +- New 'utilityrateforecast' compute module for Software Development Kit (SDK) and PySAM coders. (`SSC 868 `__) Concentrating Solar Power (2022.11.21) -------------------------------------- -- Remove boiler pressure input from Rankine cycle model. (`SAM 1192 `__) -- 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. (`SSC 861 `__) +- Remove boiler pressure input from Rankine cycle model. (`SAM 1192 `__) +- 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. (`SSC 861 `__) Marine Energy ------------- -- Add battery storage option to Marine Wave model. (`SSC 890 `__) +- Add battery storage option to Marine Wave model. (`SSC 890 `__) Geothermal Power (2022.11.21) ----------------------------- -- Update to latest version of GETEM. (`SAM 1174 `__, `SSC 886 `__) -- Fix number of wells calculation. (`SSC 875 `__) +- update to latest version of GETEM. (`SAM 1174 `__, `SSC 886 `__) +- Fix number of wells calculation. (`SSC 875 `__) Wind Power (2022.11.21) ----------------------- -- Remove BOS model options from Residential and Commercial configurations. (`SAM 1169 `__) +- Remove BOS model options from Residential and Commercial configurations. (`SAM 1169 `__) Fuel Cell --------- -- Fix issue with fuel cell capex table interpolation. (`SAM 1272 `__) -- Allow AC-connected battery to charge from fuel cell during grid outage. (`SSC 880 `__) +- Fix issue with fuel cell capex table interpolation. (`SAM 1272 `__) +- Allow AC-connected battery to charge from fuel cell during grid outage. (`SSC 880 `__) .. _2021-12-02-r2: SAM 2021.12.02 r2, SSC 274: June 6 , 2022 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is a maintenance update to `SAM 2021.12.02 Revision 1 <#2021-12-02>`__. +This is a maintenance update to :ref:`SAM 2021.12.02 Revision 1 <2021-12-02>`. -- Improve feedback for parametric simulation graphs when they cannot be displayed. (`1051 `__) -- Change labels on Results page Metrics table and graphs to be more consistent with output variable labels. (`1045 `__) -- Fix PVWatts land area value shown on cost input pages for PVWatts Battery configurations. (`1037 `__) -- Fix issue with Data Tables tab on Results page to correctly group variables by number of rows. (`1001 `__) -- For Wind resource data download from WIND Toolkit, add 2014 to list of available years. (`963 `__) -- Revise Help system for latest updates. (`1062 `__) -- Add PVWatts output for AC power before AC adjustment factors are applied. (`SSC 830 `__) -- Fix utilityrate module descriptions to clarify dependence on different OpenEI URDB versions. (`SSC 829 `__) +- Improve feedback for parametric simulation graphs when they cannot be displayed. (`1051 `__) +- Change labels on Results page Metrics table and graphs to be more consistent with output variable labels. (`1045 `__) +- Fix PVWatts land area value shown on cost input pages for PVWatts Battery configurations. (`1037 `__) +- Fix issue with Data Tables tab on Results page to correctly group variables by number of rows. (`1001 `__) +- For Wind resource data download from WIND Toolkit, add 2014 to list of available years. (`963 `__) +- Revise Help system for latest updates. (`1062 `__) +- Add PVWatts output for AC power before AC adjustment factors are applied. (`SSC 830 `__) +- Fix utilityrate module descriptions to clarify dependence on different OpenEI URDB versions. (`SSC 829 `__) - Detailed PV - - Update CEC module and inverter libraries to May 2022 CEC database versions. (`1057 `__, `1067 `__) - - Fix problem with DC degradation inputs that caused a simulation error "Degradation calculated to be greater than 100%, capped at 100%". `958 `__, `SSC 772 `__) - - Add button to Inverter page Inverter Datasheet option to import library parameters to datasheet inputs. (`1053 `__) - - Fix inverter temperature derate table issue to provide feedback instead of generating an error when table has wrong number of columns. (`1027 `__) - - Fix PVsyst shade data import for Version 7. (`1054 `__) - - Fix PVsyst PAN to SAM macro to bettery handle module technology parameter. (`1047 `__) - - Fix Solmetric Suneye shading import. (`1052 `__) - - Add transmission losses to loss diagram. (`1000 `__, `SSC 790 `__) - - Make 6parsolve module coefficient calculator error messages more descriptive. (`SSC 827 `__, `802 `__) - - Improve handling of albedo data errors. (`SSC 799 `__) - - Report time series outputs over lifetime to facilitate comparison with other outputs in results. (`SSC 791 `__) + - Update CEC module and inverter libraries to May 2022 CEC database versions. (`1057 `__, `1067 `__) + - Fix problem with DC degradation inputs that caused a simulation error "Degradation calculated to be greater than 100%, capped at 100%". `958 `__, `SSC 772 `__) + - Add button to Inverter page Inverter Datasheet option to import library parameters to datasheet inputs. (`1053 `__) + - Fix inverter temperature derate table issue to provide feedback instead of generating an error when table has wrong number of columns. (`1027 `__) + - Fix PVsyst shade data import for Version 7. (`1054 `__) + - Fix PVsyst PAN to SAM macro to bettery handle module technology parameter. (`1047 `__) + - Fix Solmetric Suneye shading import. (`1052 `__) + - Add transmission losses to loss diagram. (`1000 `__, `SSC 790 `__) + - Make 6parsolve module coefficient calculator error messages more descriptive. (`SSC 827 `__, `802 `__) + - Improve handling of albedo data errors. (`SSC 799 `__) + - Report time series outputs over lifetime to facilitate comparison with other outputs in results. (`SSC 791 `__) - Battery Storage - - Fix REopt battery sizing and dispatch API calls. (`999 `__) - - 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. (`992 `__) - - Fix problem with inputs for battery dispatch to grid power targets option. (`988 `__) - - Fix issue with voltage table outside of battery state-of-charge limits. (`SSC 883 `__) - - Add metric for capacity factor based on AC power to Standalone Battery configurations. (`1050 `__, `SSC 820 `__) - - Fix Standalone Battery nameplate capacity value used for capacity-based incentive and capacity revenue calculations. (`1040 `__) - - Add a new LK sample script to replicate battery computed properties calculations from SAM's user interface.(`1002 `__) - - Fix PV Battery / Single Owner default value of batt_Vcut to match other battery configurations. (`1032 `__) - - Make Detailed PV macros available for PV Battery configurations, including for PV system sizing, PVsyst file import, subarray layout, etc. (`967 `__) - - Apply battery state-of-charge limits to PV smoothing battery dispatch option. (`SSC 816 `__) - - Improve behind-the-meter price signal dispatch option to respond to demand ratchets in electricty rate structure. (`SSC 800 `__) - - Improve front-of-meter battery dispatch to price forecast to consider battery capacity in addition to price forecast. (`SSC 792 `__) - - Improve front-of-meter battery dispatch to price forecast to use lifetime price data. (`SSC 787 `__) - - Improve the way daily losses are applied to battery power. (`SSC 780 `__) - - Account for battery operating costs in behind-the-meter (BTM) and front-of-meter (FOM) dispatch. (`SSC 856 `__) + - Fix REopt battery sizing and dispatch API calls. (`999 `__) + - 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. (`992 `__) + - Fix problem with inputs for battery dispatch to grid power targets option. (`988 `__) + - Fix issue with voltage table outside of battery state-of-charge limits. (`SSC 883 `__) + - Add metric for capacity factor based on AC power to Standalone Battery configurations. (`1050 `__, `SSC 820 `__) + - Fix Standalone Battery nameplate capacity value used for capacity-based incentive and capacity revenue calculations. (`1040 `__) + - Add a new LK sample script to replicate battery computed properties calculations from SAM's user interface.(`1002 `__) + - Fix PV Battery / Single Owner default value of batt_Vcut to match other battery configurations. (`1032 `__) + - Make Detailed PV macros available for PV Battery configurations, including for PV system sizing, PVsyst file import, subarray layout, etc. (`967 `__) + - Apply battery state-of-charge limits to PV smoothing battery dispatch option. (`SSC 816 `__) + - Improve behind-the-meter price signal dispatch option to respond to demand ratchets in electricty rate structure. (`SSC 800 `__) + - Improve front-of-meter battery dispatch to price forecast to consider battery capacity in addition to price forecast. (`SSC 792 `__) + - Improve front-of-meter battery dispatch to price forecast to use lifetime price data. (`SSC 787 `__) + - Improve the way daily losses are applied to battery power. (`SSC 780 `__) + - Account for battery operating costs in behind-the-meter (BTM) and front-of-meter (FOM) dispatch. (`SSC 856 `__) - Concentrating Solar Power (CSP) - - Fix physical trough bug when number of SCAs in loop is changed. (`1014 `__) - - Fix issues with custom HTF. (`1007 `__, `1006 `__) - - Add sub-cooled outlet option to Industrial Process Heat (IPH) Direct Steam Linear Fresnel model. (`973 `__, `SSC 776 `__) - - Fix issue with Molten Salt Linear Fresnel (MSLF) partial sequential defocus. (`SSC 759 `__) + - Fix physical trough bug when number of SCAs in loop is changed. (`1014 `__) + - Fix issues with custom HTF. (`1007 `__, `1006 `__) + - Add sub-cooled outlet option to Industrial Process Heat (IPH) Direct Steam Linear Fresnel model. (`973 `__, `SSC 776 `__) + - Fix issue with Molten Salt Linear Fresnel (MSLF) partial sequential defocus. (`SSC 759 `__) - Marine Energy - - Add new feature to convert a set of one-year time series wave resource data files into a single joint probability distribution (JPD) file. (`993 `__) - - For Wave Energy model, improve layout and text on Wave Resource input page. (`1025 `__) + - Add new feature to convert a set of one-year time series wave resource data files into a single joint probability distribution (JPD) file. (`993 `__) + - For Wave Energy model, improve layout and text on Wave Resource input page. (`1025 `__) - Financial Models - - Fix Send to Excel with Equations for all financial models so that Excel results more closely match SAM results. (`1044 `__, `SSC 818 `__) - - Fix issue with Value of RE macro tax rate calculation that prevented macro from running. (`982 `__) - - Edit variable labels to include abbreviations LCOE, NPV, and IRR to facilitate searching for variable names. (`954 `__, `SSC 770 `__) - - Fix merchant plant price data download from Cambium API. (`1063 `__) - - Fix merchant plant cleared capacity calculations when capacity is negative for battery charging or for system self-consumption. (`1059 `__, `SSC 826 `__) - - Fix interaction between analysis period and merchant plant price data input window. (`1041 `__) - - Fix LCOE Calculator issue with undefined analysis period and no financial model. (`SSC 797 `__) + - Fix Send to Excel with Equations for all financial models so that Excel results more closely match SAM results. (`1044 `__, `SSC 818 `__) + - Fix issue with Value of RE macro tax rate calculation that prevented macro from running. (`982 `__) + - Edit variable labels to include abbreviations LCOE, NPV, and IRR to facilitate searching for variable names. (`954 `__, `SSC 770 `__) + - Fix merchant plant price data download from Cambium API. (`1063 `__) + - Fix merchant plant cleared capacity calculations when capacity is negative for battery charging or for system self-consumption. (`1059 `__, `SSC 826 `__) + - Fix interaction between analysis period and merchant plant price data input window. (`1041 `__) + - Fix LCOE Calculator issue with undefined analysis period and no financial model. (`SSC 797 `__) - Solar Resource Data - - Update Solar Resource File Converter macro for SolarAnywhere data to better handle subhourly data and missing data at end of row. (`1019 `__, `951 `__) - - Fix NSRDB weather data queries from Advanced NSRDB window to return correct time zone. (`1023 `__, `950 `__) - - Improve messages when NSRDB API returns an error message instead of weather data. (`1018 `__) - - Improve wfcheck error time stamp reporting. (`SSC 773 `__) + - Update Solar Resource File Converter macro for SolarAnywhere data to better handle subhourly data and missing data at end of row. (`1019 `__, `951 `__) + - Fix NSRDB weather data queries from Advanced NSRDB window to return correct time zone. (`1023 `__, `950 `__) + - Improve messages when NSRDB API returns an error message instead of weather data. (`1018 `__) + - Improve wfcheck error time stamp reporting. (`SSC 773 `__) .. _2021-12-02-r1: SAM 2021.12.02 r1, SSC 274: February 21, 2022 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is a maintenance update to `SAM 2021.12.02 <#2021-12-02>`__. - -- Update CEC module and inverter libraries to December 2021 and February 2022 CEC database versions, respectively. (`946 `__) -- Change default sales tax value to same value for all configurations. (`844 `__) -- Fix issues with Solar Resource location name parsing of latitude/longitude pairs, addresses, and location names. (`929 `__) -- Allow PVLIB labels as solar resource data columns in SAM CSV weather file format. (`SSC 754 `__) -- Fix land area calculations for PVWatts and Detailed Photovoltaic models. (`928 `__, `SSC 761 `__) -- Revise Help topics and fix issues with context-sensitive ETES Help topics not displaying properly. (`938 `__) -- Fix marine energy labels in user interface. (`916 `__) -- New marine wave energy option to convert time series wave resource data file to joint probability distribution data file. (`892 `__) -- Update geothermal drilling cost curves. (`910 `__) -- Fix geothermal issue with time stamps for hourly simulation option. (`SSC 690 `__ -- Update electric thermal energy storage (ETES) default tax incentives and debt mode. (`900 `__) -- Fix issue with wind turbine characteristics equations. (`894 `__, `SSC 730 `__) -- Allow wind resource files with "srw" and "csv" extension. (`929 `__) -- Update SAM sample files to work with SAM 2021.12.01. (`895 `__) +This is a maintenance update to :ref:`SAM 2021.12.02 <2021-12-02>`. + +- Update CEC module and inverter libraries to December 2021 and February 2022 CEC database versions, respectively. (`946 `__) +- Change default sales tax value to same value for all configurations. (`844 `__) +- Fix issues with Solar Resource location name parsing of latitude/longitude pairs, addresses, and location names. (`929 `__) +- Allow PVLIB labels as solar resource data columns in SAM CSV weather file format. (`SSC 754 `__) +- Fix land area calculations for PVWatts and Detailed Photovoltaic models. (`928 `__, `SSC 761 `__) +- Revise Help topics and fix issues with context-sensitive ETES Help topics not displaying properly. (`938 `__) +- Fix marine energy labels in user interface. (`916 `__) +- New marine wave energy option to convert time series wave resource data file to joint probability distribution data file. (`892 `__) +- Update geothermal drilling cost curves. (`910 `__) +- Fix geothermal issue with time stamps for hourly simulation option. (`SSC 690 `__ +- Update electric thermal energy storage (ETES) default tax incentives and debt mode. (`900 `__) +- Fix issue with wind turbine characteristics equations. (`894 `__, `SSC 730 `__) +- Allow wind resource files with "srw" and "csv" extension. (`929 `__) +- Update SAM sample files to work with SAM 2021.12.01. (`895 `__) - Cash Flow - - 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. (`936 `__) - - Add operation and maintenance costs for battery, fuel cell, and fuel as appropriate to cash flow operating costs line itames. (`927 `__, `909 `__, `SSC 762 `__, `SSC 753 `__) - - Fix annual electricity values for cash flow output. (`919 `__, `SSC 756 `__, `SSC 750 `__) + - 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. (`936 `__) + - Add operation and maintenance costs for battery, fuel cell, and fuel as appropriate to cash flow operating costs line itames. (`927 `__, `909 `__, `SSC 762 `__, `SSC 753 `__) + - Fix annual electricity values for cash flow output. (`919 `__, `SSC 756 `__, `SSC 750 `__) - Battery - - Fix issue with battery environment temperature input. (`920 `__, `SSC 751 `__) - - Fix issues with battery dispatch inputs including enabling/disabling options, and grid power target array length. (`860 `__, `855 `__, `858 `__) - - Fix battery life model for Li-ion NMC/Graphite battery type. (`SSC 763 `__, `748 `__) - - Fix battery dispatch PV smoothing algorithm to make battery state of charge value for dispatch consistent with value for simulation. (`SSC 758 `__) - - Fix issue with battery merchant plant dispatch to power price and check that generation exceeds cleared capacity. (`SSC 729 `__) - - Change "Market sell rate" label to "Power price for battery dispatch" to make it clear variable is for battery dispatch calculations. (`SSC 706 `__) - - Fix battery degradation issue that caused SAM to crash. (`SSC 796 `__) + - Fix issue with battery environment temperature input. (`920 `__, `SSC 751 `__) + - Fix issues with battery dispatch inputs including enabling/disabling options, and grid power target array length. (`860 `__, `855 `__, `858 `__) + - Fix battery life model for Li-ion NMC/Graphite battery type. (`SSC 763 `__, `748 `__) + - Fix battery dispatch PV smoothing algorithm to make battery state of charge value for dispatch consistent with value for simulation. (`SSC 758 `__) + - Fix issue with battery merchant plant dispatch to power price and check that generation exceeds cleared capacity. (`SSC 729 `__) + - Change "Market sell rate" label to "Power price for battery dispatch" to make it clear variable is for battery dispatch calculations. (`SSC 706 `__) + - Fix battery degradation issue that caused SAM to crash. (`SSC 796 `__) - Grid Outage and Critical Load - - Consolidate inputs for behind-the-meter grid outage inputs on new Grid Outage page. (`902 `__, `842 `__) - - Remove grid outage feature from PVWatts - battery configuration. (`884 `__, `945 `__, `SSC 767 `__) - - Add grid outage inputs to standalone battery behind-the-meter configurations. (`873 `__) - - Fix grid outage issue to prevent load during outage being used for electricity bill calculation. (`SSC 741 `__) - - Improve behavior of DC-connected battery during outage to allow charging during outage. (`SSC 738 `__, `SSC 728 `__, `SSC 725 `__) - - Fix problem with scaling of critical load. (`842 `__) + - Consolidate inputs for behind-the-meter grid outage inputs on new Grid Outage page. (`902 `__, `842 `__) + - Remove grid outage feature from PVWatts - battery configuration. (`884 `__, `945 `__, `SSC 767 `__) + - Add grid outage inputs to standalone battery behind-the-meter configurations. (`873 `__) + - Fix grid outage issue to prevent load during outage being used for electricity bill calculation. (`SSC 741 `__) + - Improve behavior of DC-connected battery during outage to allow charging during outage. (`SSC 738 `__, `SSC 728 `__, `SSC 725 `__) + - Fix problem with scaling of critical load. (`842 `__) - Concentraing Solar Power (CSP) - - Fix CSP molten salt linear Fresnel thermal efficiency calculation in user interface. (`939 `__) - - Fix CSP molten salt linear Fresnel sequential defocus bug. (`SSC 760 `__) - - 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. (`SSC 695 `__) - - Update default financial assumptions for concentrating solar power (CSP) configurations. (`904 `__) + - Fix CSP molten salt linear Fresnel thermal efficiency calculation in user interface. (`939 `__) + - Fix CSP molten salt linear Fresnel sequential defocus bug. (`SSC 760 `__) + - 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. (`SSC 695 `__) + - Update default financial assumptions for concentrating solar power (CSP) configurations. (`904 `__) - Electricity Bill and Purchases - - Fix issue with front-of-meter electricity purchases when non-zero sell rate input value was hidden. (`908 `__) - - Fix issues with billing demand periods table. (`889 `__) - - Fix issues with billing demand calculations with only kWh/kW energy charge units. (`SSC 723 `__) - - Fix issue with reporting of time series demand charge and electricity peak values. (`SSC 733 `__) + - Fix issue with front-of-meter electricity purchases when non-zero sell rate input value was hidden. (`908 `__) + - Fix issues with billing demand periods table. (`889 `__) + - Fix issues with billing demand calculations with only kWh/kW energy charge units. (`SSC 723 `__) + - Fix issue with reporting of time series demand charge and electricity peak values. (`SSC 733 `__) .. _2021-12-02: @@ -1146,15 +1146,15 @@ This new version consists of several improvements and updates. Highlights includ General (2021.12.02) -------------------- -- Fix issues with PDF report templates for battery storage configurations, PPA financial models, and marine energy configurations. (`822 `__) -- Update default assumptions to match `NREL Annual Technology Baseline `__. (`833 `__, `827 `__, `823 `__, `812 `__, `793 `__, `786 `__, `783 `__) -- Fix issue with yellow page notes disappearing when opening files created with older versions of SAM. (`809 `__) -- Replace Combine Cases macro with option on Generic System model Power Plant input age. (`706 `__, `765 `__) +- Fix issues with PDF report templates for battery storage configurations, PPA financial models, and marine energy configurations. (`822 `__) +- Update default assumptions to match `NREL Annual Technology Baseline `__. (`833 `__, `827 `__, `823 `__, `812 `__, `793 `__, `786 `__, `783 `__) +- Fix issue with yellow page notes disappearing when opening files created with older versions of SAM. (`809 `__) +- Replace Combine Cases macro with option on Generic System model Power Plant input age. (`706 `__, `765 `__) PVWatts (2021.12.02) -------------------- -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. (`729 `__) +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. (`729 `__) - Reorganize user interface to group advanced inputs into a collapsible panel. - Add snow loss model when weather file includes snow depth data in cm. @@ -1166,166 +1166,166 @@ With this release, we have updated SAM's implementation to PVWatts V8 (pvwattsv8 Detailed Photovoltaic (2021.12.02) ---------------------------------- -- Modify default inverter temperature derate curve to work over the full range of inverter sizes in the CEC inverter library. (`804 `__) -- Fix Shade Calculator crashing on MacOS. (`775 `__) -- Add terrain slope inputs for one-axis trackers to improve backtracking and linear self-shading calculations for large arrays on sloped land. (`742 `__) -- Model PV degradation as linear instead of compounded annually to better reflect recent research on module degradation. (`756 `__) -- 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. (`658 `__) -- Update the CEC module model to assume anti-reflective coatings for all PV modules (`662 `__) +- Modify default inverter temperature derate curve to work over the full range of inverter sizes in the CEC inverter library. (`804 `__) +- Fix Shade Calculator crashing on MacOS. (`775 `__) +- Add terrain slope inputs for one-axis trackers to improve backtracking and linear self-shading calculations for large arrays on sloped land. (`742 `__) +- Model PV degradation as linear instead of compounded annually to better reflect recent research on module degradation. (`756 `__) +- 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. (`658 `__) +- Update the CEC module model to assume anti-reflective coatings for all PV modules (`662 `__) Battery Storage (2021.12.02) ---------------------------- -- Redesigned user interface for battery dispatch choices for PV Battery, Generic Battery, Fuel Cell, and new Standalone Battery configurations. (`819 `__, `834 `__, `830 `__, `821 `__, `819 `__, `806 `__, `805 `__, `712 `__, `690 `__, `656 `__, `644 `__) -- Add option to specify surface area of single battery to improve battery temperature calculations for large batteries.(`789 `__) -- New levelized cost of storage (LCOS) metric. (`679 `__, `529 `__) -- 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. (`677 `__, `707 `__) -- New Standalone Battery configuration based on Generic Battery configuration. (`766 `__, `659 `__) -- 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. (`692 `__) -- Add dispatch options for behind-the-meter batteries to forecast to custom time series data for weather and load. (`688 `__, `681 `__) -- Allow behind-the-meter batteries to be charged from clipped photovoltaic power, and to discharge to the grid. (`754 `__, `653 `__) -- 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. (`679 `__) -- Add grid outage dispatch capability for behind-the-meter batteries. (`722 `__, `721 `__, `707 `__) -- Ensure correct battery capacity values are read into new variables when opening a file or case created by an older version of SAM. (`781 `__) -- Ensure correct values passed to model when switching between kWh and h option for specifying battery capacity. (`720 `__) -- Disable option for charging from photovoltaic clipped power for Generic Battery configurations. (`677 `__) -- New cutoff voltage input for battery voltage model. (`502 `__) -- Fix issue with cycle degradation penalty value of zero or NaN ("not a number") calculation for price signal and automated economic dispatch options. (`627 `__) +- Redesigned user interface for battery dispatch choices for PV Battery, Generic Battery, Fuel Cell, and new Standalone Battery configurations. (`819 `__, `834 `__, `830 `__, `821 `__, `819 `__, `806 `__, `805 `__, `712 `__, `690 `__, `656 `__, `644 `__) +- Add option to specify surface area of single battery to improve battery temperature calculations for large batteries.(`789 `__) +- New levelized cost of storage (LCOS) metric. (`679 `__, `529 `__) +- 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. (`677 `__, `707 `__) +- New Standalone Battery configuration based on Generic Battery configuration. (`766 `__, `659 `__) +- 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. (`692 `__) +- Add dispatch options for behind-the-meter batteries to forecast to custom time series data for weather and load. (`688 `__, `681 `__) +- Allow behind-the-meter batteries to be charged from clipped photovoltaic power, and to discharge to the grid. (`754 `__, `653 `__) +- 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. (`679 `__) +- Add grid outage dispatch capability for behind-the-meter batteries. (`722 `__, `721 `__, `707 `__) +- Ensure correct battery capacity values are read into new variables when opening a file or case created by an older version of SAM. (`781 `__) +- Ensure correct values passed to model when switching between kWh and h option for specifying battery capacity. (`720 `__) +- Disable option for charging from photovoltaic clipped power for Generic Battery configurations. (`677 `__) +- New cutoff voltage input for battery voltage model. (`502 `__) +- Fix issue with cycle degradation penalty value of zero or NaN ("not a number") calculation for price signal and automated economic dispatch options. (`627 `__) Financial Models (2021.12.02) ----------------------------- -- 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. (`653 `__) -- 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. (`785 `__) -- Add option to front-of-meter financial models to model land lease payments as an operating cost in project cash flow. (`779 `__) -- Update electricity rate data download from NREL Utility Rate Database (URDB) to URDB Version 8 and correctly handle unsupported inputs and units. (`758 `__) -- Calculate billing demand in kW for electricity bill energy charges with kWh/kW units. (`627 `__) -- Ratcheting demand charges for electricity bill calculations. (`637 `__, `728 `__) -- 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. (`749 `__) -- Fix units in variable labels for operation and maintenance (O&M) costs from $/kWh to $/MWh. (`667 `__) -- 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. (`673 `__) -- Add Cambium forecast hourly price data download option to Merchant Plant model. (`0669 `__) +- 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. (`653 `__) +- 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. (`785 `__) +- Add option to front-of-meter financial models to model land lease payments as an operating cost in project cash flow. (`779 `__) +- Update electricity rate data download from NREL Utility Rate Database (URDB) to URDB Version 8 and correctly handle unsupported inputs and units. (`758 `__) +- Calculate billing demand in kW for electricity bill energy charges with kWh/kW units. (`627 `__) +- Ratcheting demand charges for electricity bill calculations. (`637 `__, `728 `__) +- 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. (`749 `__) +- Fix units in variable labels for operation and maintenance (O&M) costs from $/kWh to $/MWh. (`667 `__) +- 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. (`673 `__) +- Add Cambium forecast hourly price data download option to Merchant Plant model. (`0669 `__) Concentrating Solar Power (2021.12.02) -------------------------------------- -- New cavity receiver option for the Molten Salt Power Tower model. (`625 `__). -- Fix issue with tower Heliostat Availability inputs to make clearer distinction between the design parameter and heliostat availability loss applied during simulation. (`822 `__) -- For the Molten Salt Power Tower model, change units of piping heat loss coefficient to W/m2-K from W/m. (`746 `__) +- New cavity receiver option for the Molten Salt Power Tower model. (`625 `__). +- Fix issue with tower Heliostat Availability inputs to make clearer distinction between the design parameter and heliostat availability loss applied during simulation. (`822 `__) +- For the Molten Salt Power Tower model, change units of piping heat loss coefficient to W/m2-K from W/m. (`746 `__) - 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. ((Fix Trough Dispatch)). Marine Energy (2021.12.02) -------------------------- -- For Wave model, add wave resource data download from NREL Wave Hindcast Data with library to store wave resource files. (`725 `__) -- New macros for Wave model to generate a report and compare cases. (`704 `__) -- For Wave model, add support for time series wave resource data. (`645 `__, `643 `__) -- Add option to import device power curve data from CSV or clipboard. (`740 `__) -- Fix issues with PDF report template, metrics table outputs, and update cost structure options. (`682 `__) +- For Wave model, add wave resource data download from NREL Wave Hindcast Data with library to store wave resource files. (`725 `__) +- New macros for Wave model to generate a report and compare cases. (`704 `__) +- For Wave model, add support for time series wave resource data. (`645 `__, `643 `__) +- Add option to import device power curve data from CSV or clipboard. (`740 `__) +- Fix issues with PDF report template, metrics table outputs, and update cost structure options. (`682 `__) Wind (2021.12.02) ----------------- -- Fix issue with integration of Python LandBOSSE wind cost model that caused SAM to crash. (`787 `__) +- Fix issue with integration of Python LandBOSSE wind cost model that caused SAM to crash. (`787 `__) Geothermal (2021.12.02) ----------------------- -- Update model to be more consistent with latest version of GETEM. (`772 `__) +- Update model to be more consistent with latest version of GETEM. (`772 `__) .. _2020-11-29-r2: SAM 2020.11.29 r2, SSC 256: May 12, 2021 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is a maintenance update to `SAM 2020.11.29 Revision 1 <#2020-11-29-r1>`__. +This is a maintenance update to :ref:`SAM 2020.11.29 Revision 1 <2020-11-29-r1>`. -Show heat map of system power generated on Summary page of Results page. (`571 `__) +Show heat map of system power generated on Summary page of Results page. (`571 `__) -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. (`609 `__) +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. (`609 `__) -Add minute value to error messages about weather files to facilitate troubleshooting problems. (`563 `__) +Add minute value to error messages about weather files to facilitate troubleshooting problems. (`563 `__) -Change Detailed PV short circuit current output variable labels to make it clear current is string current rather than array current. (`572 `__) +Change Detailed PV short circuit current output variable labels to make it clear current is string current rather than array current. (`572 `__) -Show system power generated by default on Results page time series tables and graphs instead of blank tables and graphs. (`559 `__) +Show system power generated by default on Results page time series tables and graphs instead of blank tables and graphs. (`559 `__) -Fix issue with Electricity Bill calculations that caused SAM to crash when time-of-use periods have different numbers of tiers. (`560 `__) +Fix issue with Electricity Bill calculations that caused SAM to crash when time-of-use periods have different numbers of tiers. (`560 `__) -Improve Stochastic simulations so that input samples and results are consistent and add description of distributions to Help. (`565 `__) +Improve Stochastic simulations so that input samples and results are consistent and add description of distributions to Help. (`565 `__) -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. (`581 `__) +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. (`581 `__) -Updated Solar Resource File Converter macro for SolarAnywhere files to work with latest SolarAnywhere version and fix issues with time stamp conversions. (`601 `__) +Updated Solar Resource File Converter macro for SolarAnywhere files to work with latest SolarAnywhere version and fix issues with time stamp conversions. (`601 `__) Battery model: -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. (`569 `__, `560 `__) +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. (`569 `__, `560 `__) -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. (`606 `__) +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. (`606 `__) -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.) (`561 `__, `568 `__) +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.) (`561 `__, `568 `__) -Fix behind-the-meter battery dispatch algorithm issue that allowed discharging of battery to grid. (`513 `__) +Fix behind-the-meter battery dispatch algorithm issue that allowed discharging of battery to grid. (`513 `__) -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. (`611 `__) +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. (`611 `__) -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. (`603 `__) +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. (`603 `__) -Remove fuel cell and battery variables from results when system does not include a fuel cell or battery. (`570 `__) +Remove fuel cell and battery variables from results when system does not include a fuel cell or battery. (`570 `__) -Shorten some battery output variable labels to make graphs and tables easier to work with. (`576 `__) +Shorten some battery output variable labels to make graphs and tables easier to work with. (`576 `__) -Fix issues with Lithium-ion NMC lifetime model's calculation of length of day for simulations with one-minute timesteps. (`549 `__, `545 `__) +Fix issues with Lithium-ion NMC lifetime model's calculation of length of day for simulations with one-minute timesteps. (`549 `__, `545 `__) -Fix LK scripting issue when adding folders to the solar resource library. (`611 `__) +Fix LK scripting issue when adding folders to the solar resource library. (`611 `__) -Revise Help to improve battery, electricity bill calculation, and other topics. (`617 `__, `602 `__) +Revise Help to improve battery, electricity bill calculation, and other topics. (`617 `__, `602 `__) .. _2020-11-29-r1: SAM 2020.11.29 r1, SSC 252: February 25, 2021 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is a maintenance update to `SAM 2020.11.29 <#2020-11-29>`__. +This is a maintenance update to :ref:`SAM 2020.11.29 <2020-11-29>`. -- Revert default Federal Investment Tax Credit (ITC) to 26%. (`493 `__) -- Fix power tower to correctly update tower height cost value. (`475 `__) -- Fix photovoltaic model simulation warnings for bifacial and one-axis tracking. (`364 `__) +- Revert default Federal Investment Tax Credit (ITC) to 26%. (`493 `__) +- Fix power tower to correctly update tower height cost value. (`475 `__) +- Fix photovoltaic model simulation warnings for bifacial and one-axis tracking. (`364 `__) - Battery model: - - Fix generic battery display of power units on System Costs page. (`469 `__) - - Fix PV-fuel-cell-battery battery O&M cost calculation. (`521 `__) - - Make sure user interface panels on battery input pages are collapsed in a consistent way for all battery configurations. (`515 `__) - - Fix an issue with voltage model enabling in the user interface for flow batteries. (`505 `__) - - Fix issues with battery voltage model. (`520 `__, `517 `__) - - Fix message about Specify IRR target for battery not being available for configurations with PPA financial models (it is). (`516 `__) - - Fix PDF report generator for PV-Battery with PPA financial model configurations. (`528 `__) - - Integrate new NREL NMC lifetime model (available in SSC only). (`521 `__) - - Remove REopt optimization option from Generic Battery configurations. (`479 `__) + - Fix generic battery display of power units on System Costs page. (`469 `__) + - Fix PV-fuel-cell-battery battery O&M cost calculation. (`521 `__) + - Make sure user interface panels on battery input pages are collapsed in a consistent way for all battery configurations. (`515 `__) + - Fix an issue with voltage model enabling in the user interface for flow batteries. (`505 `__) + - Fix issues with battery voltage model. (`520 `__, `517 `__) + - Fix message about Specify IRR target for battery not being available for configurations with PPA financial models (it is). (`516 `__) + - Fix PDF report generator for PV-Battery with PPA financial model configurations. (`528 `__) + - Integrate new NREL NMC lifetime model (available in SSC only). (`521 `__) + - Remove REopt optimization option from Generic Battery configurations. (`479 `__) - Electricity bill calculation: - - Fix electricity bill calculations to correctly apply time series buy/sell rates to bill without system. (`494 `__) - - Fix handling of nested tiers. (`275 `__) - - Improve reporting of monthly results. (`492 `__) + - Fix electricity bill calculations to correctly apply time series buy/sell rates to bill without system. (`494 `__) + - Fix handling of nested tiers. (`275 `__) + - Improve reporting of monthly results. (`492 `__) - Macros: - - Modify Value of RE macro to support Third Party Ownership financial models. (`492 `__) - - Fix Indifference vs PPA Price macro for Third Party Ownership finanical model. (`490 `__) - - Fix Value of RE macro rate switching option. (`499 `__, `487 `__) - - Update Solar Resource File converter to work with SolarAnywhere V3.4 files and older. (`491 `__) - - Fix marine energy Compare Cases macro when comparing cases with the same LCOE. (`497 `__) - - Remove Puerto Rico solar resource download macro now that data is available from Location and Resource page, move code to LK script samples. (`473 `__) - -- Fix upgrade script issue that caused SAM to crash when opening some files created in older versions of SAM. (`518 `__) -- For Third Party Ownership model, make PPA price and lease term available for parametric simulations. (`536 `__) -- Improve handling of API errors for weather file downloads from NSRDB. (`541 `__) -- Improve Data Table categories on Results page. (`485 `__) -- Clean up Marine Energy System Costs pages. (`489 `__) -- Fix REopt inputs to remove unused value of lost load, and only set battery capacity to zero when REopt finds an optimal solution. (`482 `__, `495 `__) -- Fix P50/P90 simulations to work with weather files files in EPW format. (`480 `__) + - Modify Value of RE macro to support Third Party Ownership financial models. (`492 `__) + - Fix Indifference vs PPA Price macro for Third Party Ownership finanical model. (`490 `__) + - Fix Value of RE macro rate switching option. (`499 `__, `487 `__) + - Update Solar Resource File converter to work with SolarAnywhere V3.4 files and older. (`491 `__) + - Fix marine energy Compare Cases macro when comparing cases with the same LCOE. (`497 `__) + - Remove Puerto Rico solar resource download macro now that data is available from Location and Resource page, move code to LK script samples. (`473 `__) + +- Fix upgrade script issue that caused SAM to crash when opening some files created in older versions of SAM. (`518 `__) +- For Third Party Ownership model, make PPA price and lease term available for parametric simulations. (`536 `__) +- Improve handling of API errors for weather file downloads from NSRDB. (`541 `__) +- Improve Data Table categories on Results page. (`485 `__) +- Clean up Marine Energy System Costs pages. (`489 `__) +- Fix REopt inputs to remove unused value of lost load, and only set battery capacity to zero when REopt finds an optimal solution. (`482 `__, `495 `__) +- Fix P50/P90 simulations to work with weather files files in EPW format. (`480 `__) .. _2020-11-29: @@ -1348,23 +1348,23 @@ In the following list of changes, numbers in parentheses are links to detailed d General ------- -- Fix issue with scroll bars disappearing when long pages are loaded in the user interface. (`405 `__) -- Fix problem opening files with parametric simulations that caused SAM to crash with "Could not inflate stream" error. (`393 `__) -- Fix problem with Welcome page when SAM starts without an internet connection. (`376 `__) -- Update default ITC and PTC tax credits to reflect current market conditions. (`450 `__) -- Update sun angle calculations for all solar models to use NREL Solar Position Algorithm (SPA). (`279 `__) -- 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. (`462 `__) +- Fix issue with scroll bars disappearing when long pages are loaded in the user interface. (`405 `__) +- Fix problem opening files with parametric simulations that caused SAM to crash with "Could not inflate stream" error. (`393 `__) +- Fix problem with Welcome page when SAM starts without an internet connection. (`376 `__) +- Update default ITC and PTC tax credits to reflect current market conditions. (`450 `__) +- Update sun angle calculations for all solar models to use NREL Solar Position Algorithm (SPA). (`279 `__) +- 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. (`462 `__) Detailed Photovoltaic --------------------- -- 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. (`457 `__). -- 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. (`380 `__) -- Rename Array DC power variable to Inverter DC input power to avoid confusion about whether value includes DC losses. (`383 `__) -- Improve inverter temperature derate curve inputs, and normalize efficiency table to Pmax instead of efficiency. (`412 `__) -- Fix module coefficient generator for CEC Module Model with User Entered Specifications option to work with newer high-current modules. (`129 `__) -- Improve warning messages for bifacial modules with one-axis trackers and non-zero tilt. (`364 `__) -- Update default system size for PPA financial models to 50 MW and Commercial to 500 kW. (`392 `__) +- 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. (`457 `__). +- 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. (`380 `__) +- Rename Array DC power variable to Inverter DC input power to avoid confusion about whether value includes DC losses. (`383 `__) +- Improve inverter temperature derate curve inputs, and normalize efficiency table to Pmax instead of efficiency. (`412 `__) +- Fix module coefficient generator for CEC Module Model with User Entered Specifications option to work with newer high-current modules. (`129 `__) +- Improve warning messages for bifacial modules with one-axis trackers and non-zero tilt. (`364 `__) +- Update default system size for PPA financial models to 50 MW and Commercial to 500 kW. (`392 `__) Battery Storage --------------- @@ -1372,70 +1372,70 @@ Battery Storage - Add new behind-the-meter (BTM) dispatch option that reponds to electricity rates and cycle degradation penalty. - Add option so battery cost can be specified in $/kWh, $/kW, or both - Simplify battery replacement cost option so annual replacement can be specified with a single input array instead of two. -- Rename Array DC power variable to Inverter DC input power to avoid confusion about whether value includes power from battery for DC-connected batteries. (`383 `__) -- Fix issue with REopt for PVWatts for rates with no max usage units that caused a user interface error. (`388 `__) -- Fix bug with battery sizing when using AC power values. (`375 `__) -- Update default parameters for battery chemistries. (`323 `__) -- Add a PDF report template for battery configurations. (`302 `__) -- Fix an issue that allowed battery capacity percent to exceed 100% when the calendar degradation model option was set to None. (`478 `__) -- Fix issue with battery thermal model for subhourly simulations. (`472 `__) -- Fix an issue that prevented battery ancillary losses from being correctly applied. (`379 `__) -- Fix issue with battery current and state of charge calculation. (`445 `__) +- Rename Array DC power variable to Inverter DC input power to avoid confusion about whether value includes power from battery for DC-connected batteries. (`383 `__) +- Fix issue with REopt for PVWatts for rates with no max usage units that caused a user interface error. (`388 `__) +- Fix bug with battery sizing when using AC power values. (`375 `__) +- Update default parameters for battery chemistries. (`323 `__) +- Add a PDF report template for battery configurations. (`302 `__) +- Fix an issue that allowed battery capacity percent to exceed 100% when the calendar degradation model option was set to None. (`478 `__) +- Fix issue with battery thermal model for subhourly simulations. (`472 `__) +- Fix an issue that prevented battery ancillary losses from being correctly applied. (`379 `__) +- Fix issue with battery current and state of charge calculation. (`445 `__) Retail Electricity Rates and Bill Calculations ---------------------------------------------- -- Fix issues with display of electricity bill data for demand charges, net billing credits, and net metering credits. (`442 `__, `372 `__) -- Update electricity rate downloads from Utility Rate Database to use latest API versions, and fix broken downloads due to using http instead of https. (`361 `__, `379 `__) -- Remove 500 rate limit for that caused some rates to be missing for utilties with more than 500 rates. (`361 `__) -- Fix display of net billing dollar amounts in monthly results table. Bill calculations were correct, but table was not displaying correct values. (`372 `__) -- Add option to choose month for end of net metering true-up period. (`16 `__) -- Apply net excess generation credit at end of true-up period to January when true-up period ends in December. (`16 `__) +- Fix issues with display of electricity bill data for demand charges, net billing credits, and net metering credits. (`442 `__, `372 `__) +- Update electricity rate downloads from Utility Rate Database to use latest API versions, and fix broken downloads due to using http instead of https. (`361 `__, `379 `__) +- Remove 500 rate limit for that caused some rates to be missing for utilties with more than 500 rates. (`361 `__) +- Fix display of net billing dollar amounts in monthly results table. Bill calculations were correct, but table was not displaying correct values. (`372 `__) +- Add option to choose month for end of net metering true-up period. (`16 `__) +- Apply net excess generation credit at end of true-up period to January when true-up period ends in December. (`16 `__) - Improve metering option variable labels. Financial Models ---------------- -- 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. (`370 `__) -- 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. (`403 `__) +- 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. (`370 `__) +- 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. (`403 `__) .. _marine-energy-1: Marine Energy ------------- -- Add graphs to Summary tab on Results page. (`390 `__) -- Add detailed cost break down option for specifying Wave and Tidal energy capital and O&M costs. (`389 `__) +- Add graphs to Summary tab on Results page. (`390 `__) +- Add detailed cost break down option for specifying Wave and Tidal energy capital and O&M costs. (`389 `__) Wind Power ---------- -- 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. (`270 `__) -- Fix issue with wind resource data downloads from WIND Toolkit API. (`353 `__, `216 `__) +- 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. (`270 `__) +- Fix issue with wind resource data downloads from WIND Toolkit API. (`353 `__, `216 `__) Concentrating Solar Power (CSP) ------------------------------- -- 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. (`454 `__) -- 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 `SAM website `__. (`363 `__) -- For molten salt power tower and physical trough models, display better information about air-cooled condenser model paramters. (`366 `__) -- Remove custom HTF option from Empirical Trough model to avoid errors. (`316 `__) -- 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. (`201 `__) -- 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. (`477 `__) -- Fix a bug with the Generic CSP model that ignored solar field area at design, and affected the calculation of system power generated. (`476 `__) +- 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. (`454 `__) +- 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 `SAM website `__. (`363 `__) +- For molten salt power tower and physical trough models, display better information about air-cooled condenser model paramters. (`366 `__) +- Remove custom HTF option from Empirical Trough model to avoid errors. (`316 `__) +- 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. (`201 `__) +- 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. (`477 `__) +- Fix a bug with the Generic CSP model that ignored solar field area at design, and affected the calculation of system power generated. (`476 `__) Solar Resource Data ------------------- -- 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. (`271 `__) -- 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. (`365 `__) +- 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. (`271 `__) +- 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. (`365 `__) .. _2020-2-29-r3: SAM 2020.2.29 r3, SSC 242: July 31, 2020 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -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 `GitHub Issues for SAM 2020.2.29 Patch 3 `__ and for `SSC 2020 Patch 3 `__. +This is an update to :ref:`SAM 2020.2.29 Revision 2 <2020-2-29>` that fixes the issues listed beow. For detailed descriptions of issues fixed for this update, see `GitHub Issues for SAM 2020.2.29 Patch 3 `__ and for `SSC 2020 Patch 3 `__. - Update wind turbine library. - New marine energy report templates. @@ -1454,14 +1454,14 @@ This is an update to SAM 2020.2.29 Revision 2 that fixes the issues listed beow. - Correct Detailed Photovoltaic model units reported for transformer no load loss, change from kWh to kW. - Speed up PVWatts V7 self-shading calculations refactoring code. - Fix PVWatts V5 single time step model. -- 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. +- Add support for custom time series length to pvsamv1 and pvwattsv7 (in SSC only, not available in SAM user interface). See https://github.com/NatLabRockies/ssc/pull/418. .. _2020-2-29-r2: SAM 2020.2.29 r2, SSC 240: May 28, 2020 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -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 `GitHub Issues for SAM 2020.2.29 Patch 2 `__. +This is an update to :ref:`SAM 2020.2.29 Revision 1 <2020-2-29-r1>` that fixes the issues listed beow. For detailed descriptions of issues fixed for this update, see `GitHub Issues for SAM 2020.2.29 Patch 2 `__. - General @@ -1483,7 +1483,7 @@ This is an update to SAM 2020.2.29 Revision 1 that fixes the issues listed beow. - Concentrating Solar Power (CSP) - Revert default inputs to SAM 2018.11.11 values. - - Empirical trough model: Remove custom HTF from user interface per `Issue 316 `__. + - Empirical trough model: Remove custom HTF from user interface per `Issue 316 `__. - Battery Storage @@ -1522,7 +1522,7 @@ This is an update to SAM 2020.2.29 Revision 1 that fixes the issues listed beow. SAM 2020.2.29 r1, SSC 238: March 30, 2020 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is an update to SAM 2020.2.29 that fixes the issues listed below. For detailed descriptions of issues fixed for this update, see `GitHub Issues for SAM 2020.2.29 Patch 1 `__. +This is an update to :ref:`SAM 2020.2.29 <2020-2-29>` that fixes the issues listed below. For detailed descriptions of issues fixed for this update, see `GitHub Issues for SAM 2020.2.29 Patch 1 `__. - General @@ -1570,7 +1570,7 @@ This version introduces several new models and features in addition to enhanceme - New models for grid interconnection limits and curtailment. - New battery storage category to separate battery model configurations from Detailed PV and Generic System configurations. -For details about work done for this release, see `GitHub Issues for SAM 2020.2.29 release `__. +For details about work done for this release, see `GitHub Issues for SAM 2020.2.29 release `__. .. _general-1: @@ -1887,9 +1887,9 @@ Display bandgap voltage assumptions for single-diode models. Update CEC module and inverter libraries with CEC data as of November 4, 2018. Remove inverters with bad data from library. -Fixed issue with voltage calculation for subarray mismatch algorithm. `GitHub Issue SSC 191 `__. +Fixed issue with voltage calculation for subarray mismatch algorithm. `GitHub Issue SSC 191 `__. -Add implementation of Mermoud/Lejeune module model to SSC. This model option is not available in the SAM user interface, but can be accessed via the SSC API using the `SAM Software Development Kit (SDK) `__. `GitHub Issue SSC 26 `__. +Add implementation of Mermoud/Lejeune module model to SSC. This model option is not available in the SAM user interface, but can be accessed via the SSC API using the `SAM Software Development Kit (SDK) `__. `GitHub Issue SSC 26 `__. PVWatts ------- @@ -1915,7 +1915,7 @@ Electricity Rates Change labels for excess generation options to standard names for net energy metering, net billing, etc. -Fix issue with calculation of credits for excess generation. `GitHub Issue SSC 154 `__ +Fix issue with calculation of credits for excess generation. `GitHub Issue SSC 154 `__ .. _battery-storage-2: @@ -1928,9 +1928,9 @@ For systems with batteries using the PPA Single Owner financial models, enable E Fix issue with initial state of charge (SOC) not being applied correctly. -Include PV DC and AC losses in power values used for front-of-meter and behind-the-meter battery configurations. `GitHub Issue SSC 137 `__ +Include PV DC and AC losses in power values used for front-of-meter and behind-the-meter battery configurations. `GitHub Issue SSC 137 `__ -Fix issue with battery replacements. `GitHub Issue SSC 55 `__. +Fix issue with battery replacements. `GitHub Issue SSC 55 `__. Fix several issues with dispatch, lifetime, power flow calculations. @@ -2740,7 +2740,7 @@ Utility Rates - For electricity rates that combine net metering with time-of-use periods and tiers pro-rate rollover credits to next month's time-of-use periods - For electricity rates with net metering and time-of-use periods, apply method for rolling over credits to appropriate periods when the next month has a different time-of-use schedule (assume periods at 12 am, 6 am, 12 pm and 6 pm determine periods to roll over to) - Flat rates now modeled as energy charges under a single tier and time of use period -- Update to new OpenEI Utility Rate Database +- update to new OpenEI Utility Rate Database .. _general-5: