Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Help revisions for SAM 2024.12.12 #1960

Merged
merged 4 commits into from
Dec 10, 2024
Merged

Help revisions for SAM 2024.12.12 #1960

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
789ba5c
Help revisions for SAM 2024.12.12
cpaulgilman Dec 7, 2024
f12f191
Merge branch 'develop' into help-2024-12-12
sjanzou Dec 8, 2024
6151a19
Merge branch 'develop' into help-2024-12-12
cpaulgilman Dec 9, 2024
76ffc4f
Help revisions
cpaulgilman Dec 9, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion deploy/runtime/help/html/battery_dispatch_btm.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -567,7 +567,7 @@ <h4 class="p_Heading4"><span class="f_Heading4">Charge Options</span></h4>
<div style="text-align: left; text-indent: 0; border-color: #0072c6; border-style: solid; border-width: thin; background: #ebebeb; padding: 0.1250rem 0.1250rem 0.1250rem 0.1250rem; margin: 0.1875rem 0 0.1875rem 0;"><table style="border:none;border-spacing:0;padding:0;line-height: normal;"><tr style="vertical-align:baseline"><td style="border:none;padding:0;width:1.1875rem"><img id="toggle0186a1_ICON" class="dropdown-toggle-icon" alt="Click to expand or collapse" title="Click to expand or collapse" style="margin:0;width:1.0000rem;height:1.0000rem;border:none" src="./images/ico-plus-16x16.png"/></td><td style="border:none;padding:0"><span class="f_Heading2_atoc_"><a id="toggle0186a1_LINK" class="dropdown-toggle" style="font-style: normal; font-weight: bold; color: #0072c6; background-color: transparent; text-decoration: none;" title="Click to expand or collapse" href="javascript:void(0)" data-type="dropdown" data-state="0" data-icon="toggle0186a1_ICON" data-src0="./images/ico-plus-16x16.png" data-src1="./images/ico-minus-16x16.png">Peak Shaving</a></span></td></tr></table></div>
<div id="toggle0186a1" class="dropdown-toggle-body" style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 0 0 0.3750rem 0;display:none"><table class="ToggleContentTable" >
<tr class="ToggleContentTable">
<td class="ToggleContentTable"><p class="p_Text"><span class="f_Text">The peak shaving dispatch options attempt to discharge the battery during times of peak demand over a forecast period. Peak shaving dispatch considers the load, and either the available solar resource for PV systems, or the AC output for generic battery systems over the forecast period and calculates a grid power target for each time step in that period. It then charges or discharges the battery as possible given the battery's capacity and state of charge to meet the target. Use this option to reduce monthly demand charges when the rates on the <a href="electricity_rates.html" class="topiclink">Electricity Rates</a> page include demand rates.</span></p>
<td class="ToggleContentTable"><p class="p_Text"><span class="f_Text">The peak shaving dispatch options attempt to discharge the battery during times of peak demand over a forecast period. Peak shaving dispatch considers the load, and either the available solar resource for PV systems, or the AC output for other systems over the forecast period and calculates a grid power target for each time step in that period. It then charges or discharges the battery as possible given the battery's capacity and state of charge to meet the target. Use this option to reduce monthly demand charges when the rates on the <a href="electricity_rates.html" class="topiclink">Electricity Rates</a> page include demand rates.</span></p>
<p class="p_Text"><span class="f_Text">Peak shaving discharges the battery each day to reduce that day's peak load. This results in more battery cycling than would result from a dispatch strategy that discharges the battery once a month to reduce the peak load.</span></p>
<p class="p_Text"><span class="f_Text">For a detailed description of the behind-the-meter peak shaving dispatch algorithm, see DiOrio, N. (2017). An Overview of the Automated Dispatch Controller Algorithms in SAM. NREL/TP-6A20-68614. (<a href="https://www.nrel.gov/docs/fy18osti/68614.pdf" class="weblink">PDF 770 KB</a>)</span></p>
<h4 class="p_Heading4"><span class="f_Heading4">Peak Shaving Option</span></h4>
Expand Down
10 changes: 5 additions & 5 deletions deploy/runtime/help/html/battery_dispatch_fom.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -533,7 +533,7 @@ <h4 class="p_Heading4"><span class="f_Heading4">Dispatch Options</span></h4>
<p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Automated dispatch</span></p>
<p class="p_VariableDescription"><span class="f_VariableDescription">Automated dispatch dispatches the battery in response to changes in the power price to maximize revenue from power sales. Use this option for PPA projects that involve time-of-delivery price multipliers or Merchant Plant projects.</span></p>
<p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">PV smoothing</span></p>
<p class="p_VariableDescription"><span class="f_VariableDescription">PV smoothing dispatches the battery for photovoltaic-battery systems to limit power ramp rates at the grid interconnection point. Use this option for projects required to meet ramp rate limits. This option is available for PV battery and Generic battery systems. It is not available for standalone batteries.</span></p>
<p class="p_VariableDescription"><span class="f_VariableDescription">PV smoothing dispatches the battery for photovoltaic-battery systems to limit power ramp rates at the grid interconnection point. Use this option for projects required to meet ramp rate limits. This option is available for PV battery and Custom Generation Profile - Battery systems. It is not available for standalone batteries.</span></p>
<p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Dispatch to custom time series</span></p>
<p class="p_VariableDescription"><span class="f_VariableDescription">Dispatch the battery according to time series charge and discharge power values you provide. Use this option when you know exactly how you want the battery to charge and discharge.</span></p>
<p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Manual dispatch</span></p>
Expand All @@ -552,8 +552,8 @@ <h4 class="p_Heading4"><span class="f_Heading4">Charge Options</span></h4>
<div id="toggle0186a1" class="dropdown-toggle-body" style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 0 0 0.3750rem 0;display:none"><table class="ToggleContentTable" >
<tr class="ToggleContentTable">
<td class="ToggleContentTable"><p class="p_Text"><span class="f_Text">SAM's front-of-meter automated dispatch algorithm attempts to charge and discharge the battery to maximize revenue from power sales to the grid. It calculates a battery power target for each time step, and charges or discharges the battery to attempt to meet the target, given any constraints on battery capacity and battery state of charge, and accounting for power conversion losses. Note that in some time steps, depending on the battery's state of charge and other constraints, the battery discharge power may be less than the target.</span></p>
<p class="p_Text"><span class="f_Text">You can explore the results of the automated dispatch by comparing the output variables </span><span class="f_CHInterfaceElement">Electricity battery power target for automated dispatch</span><span class="f_Text"> to </span><span class="f_CHInterfaceElement">Electricity to/from battery</span><span class="f_Text">. Other useful output variables include </span><span class="f_CHInterfaceElement">Market sell rate (year 1)</span><span class="f_Text"> representing the power prices used for battery dispatch calculations, </span><span class="f_CHInterfaceElement">Battery state of charge</span><span class="f_Text">, </span><span class="f_CHInterfaceElement">Electricity to grid from battery</span><span class="f_Text">,and </span><span class="f_CHInterfaceElement">Electricity to grid from system</span><span class="f_Text"> (for PV Battery and Generic Battery configurations). </span></p>
<p class="p_Text"><span class="f_Text">Automated battery dispatch responds to power prices that vary over time, which can be defined as a PPA price with time-of-delivery multipliers for PPA projects, or market prices for Merchant Plant projects. For batteries connected to a power system (PV Battery and Generic Battery configurations), battery dispatch also responds to the availability of power from the system. Battery dispatch also accounts for the cost of cycling the battery based on a prediction of how battery cycling will affect battery degradation and replacements.</span></p>
<p class="p_Text"><span class="f_Text">You can explore the results of the automated dispatch by comparing the output variables </span><span class="f_CHInterfaceElement">Electricity battery power target for automated dispatch</span><span class="f_Text"> to </span><span class="f_CHInterfaceElement">Electricity to/from battery</span><span class="f_Text">. Other useful output variables include </span><span class="f_CHInterfaceElement">Market sell rate (year 1)</span><span class="f_Text"> representing the power prices used for battery dispatch calculations, </span><span class="f_CHInterfaceElement">Battery state of charge</span><span class="f_Text">, </span><span class="f_CHInterfaceElement">Electricity to grid from battery</span><span class="f_Text">,and </span><span class="f_CHInterfaceElement">Electricity to grid from system</span><span class="f_Text"> (for PV Battery and Custom Generation Profile - Battery configurations). </span></p>
<p class="p_Text"><span class="f_Text">Automated battery dispatch responds to power prices that vary over time, which can be defined as a PPA price with time-of-delivery multipliers for PPA projects, or market prices for Merchant Plant projects. For batteries connected to a power system (PV Battery and Custom Generation Profile - Battery configurations), battery dispatch also responds to the availability of power from the system. Battery dispatch also accounts for the cost of cycling the battery based on a prediction of how battery cycling will affect battery degradation and replacements.</span></p>
<p class="p_Text"><span class="f_Text">The automated dispatch options determine the time horizon over which the algorithm maximizes revenue</span></p>
<p class="p_Text"><span class="f_Text">The automated dispatch algorithms are described in DiOrio, N.; Denholm, P.; Hobbs, W. (2020). <a href="https://doi.org/10.1016/j.apenergy.2019.114465" target="_blank" class="weblink">A Model for Evaluating the Configuration and Dispatch of PV Plus Battery Power Plants</a>. Applied Energy Vol 262 March 2020, also listed on the SAM website at <a href="https://sam.nrel.gov/battery-storage/battery-publications.html" target="_blank" class="weblink" title="https://sam.nrel.gov/battery-storage/battery-publications.html">https://sam.nrel.gov/battery-storage/battery-publications.html</a>.</span></p>
<p class="p_Note"><span class="f_CHNote">Notes.</span><br />
Expand All @@ -572,7 +572,7 @@ <h4 class="p_Heading4"><span class="f_Heading4">Charge Options</span></h4>
<p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Custom forecast</span></p>
<p class="p_VariableDescription"><span class="f_VariableDescription">Similar to the look ahead automated dispatch option, except use different time series data for the forecast of power available to charge the battery than that used to model the system's power output:</span></p>
<p class="p_VariableDescription" style="text-indent: 0; padding-left: 0.8125rem; margin-left: 1.5000rem;"><span class="f_VariableDescription" style="font-family: Arial,'Lucida Sans Unicode','Lucida Grande','Lucida Sans';display:inline-block;width:0.8125rem;margin-left:-0.8125rem">&#8226;</span><span class="f_VariableDescription">For the PV Battery configuration, use a different weather file than the one on the Location and Resource page.</span></p>
<p class="p_VariableDescription" style="text-indent: 0; padding-left: 0.8125rem; margin-left: 1.5000rem;"><span class="f_VariableDescription" style="font-family: Arial,'Lucida Sans Unicode','Lucida Grande','Lucida Sans';display:inline-block;width:0.8125rem;margin-left:-0.8125rem">&#8226;</span><span class="f_VariableDescription">For the Generic Battery configuration, use a different generation profile for the forecast than the generation profile on the Power Plant page.</span></p>
<p class="p_VariableDescription" style="text-indent: 0; padding-left: 0.8125rem; margin-left: 1.5000rem;"><span class="f_VariableDescription" style="font-family: Arial,'Lucida Sans Unicode','Lucida Grande','Lucida Sans';display:inline-block;width:0.8125rem;margin-left:-0.8125rem">&#8226;</span><span class="f_VariableDescription">For the </span><span class="f_Text">Custom Generation Profile - Battery</span><span class="f_VariableDescription"> configuration, use a different generation profile for the forecast than the generation profile on the Power Plant page.</span></p>
<p class="p_Note"><span class="f_CHNote">Note.</span><span class="f_Note"> The custom forecast option is not available for standalone batteries, which do not dispatch in response to a generation profile of a photovoltaic array or other power generating equipment.</span></p>
<p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Frequency to update dispatch</span></p>
<p class="p_VariableDescription"><span class="f_VariableDescription">For any of the three automated dispatch options, determines how often a new dispatch decision is made.</span></p>
Expand All @@ -581,7 +581,7 @@ <h4 class="p_Heading4"><span class="f_Heading4">Charge Options</span></h4>
<p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Weather file for automated dispatch</span></p>
<p class="p_VariableDescription"><span class="f_VariableDescription">For the PV Battery configuration, the weather file to use for the custom forecast option. Click </span><span class="f_CHInterfaceElement">Browse</span><span class="f_VariableDescription"> to choose a weather file in the <a href="weather_format_sam_csv_solar.html" class="topiclink">SAM CSV format</a>.</span></p>
<p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Generation profile for automated dispatch</span></p>
<p class="p_VariableDescription"><span class="f_VariableDescription">For the Generic Battery configuration, a time series generation profile (hourly or subhourly) to use for the custom forecast option. Click </span><span class="f_CHInterfaceElement">Edit array</span><span class="f_VariableDescription"> to import or paste a generation profile.</span></p>
<p class="p_VariableDescription"><span class="f_VariableDescription">For the </span><span class="f_Text">Custom Generation Profile - Battery</span><span class="f_VariableDescription"> configuration, a time series generation profile (hourly or subhourly) to use for the custom forecast option. Click </span><span class="f_CHInterfaceElement">Edit array</span><span class="f_VariableDescription"> to import or paste a generation profile.</span></p>
<h4 class="p_Heading4"><span class="f_Heading4">Cycle Degradation Penalty</span></h4>
<p class="p_Text"><span class="f_VariableDescription">The cycle degradation penalty represents the future cost of replacing the battery. It allows SAM to account for the battery replacement cost in the battery dispatch decision. </span><span class="f_Text">For any of the automated dispatch options, choose a method for estimating the cost of cycling the battery:</span></p>
<p class="p_List" style="text-indent: 0; padding-left: 1.5000rem; margin-left: 1.5000rem;"><span class="f_List" style="font-family: Arial,'Lucida Sans Unicode','Lucida Grande','Lucida Sans';display:inline-block;width:1.5000rem;margin-left:-1.5000rem">&#8226;</span><span class="f_CHInterfaceElement">Calculate automatically</span><span class="f_List"> if you want SAM to calculate the cost.</span></p>
Expand Down
Loading
Loading