Help for release candidate 2023

deploy/runtime/help/html/battery_dispatch_btm.html

@@ -547,8 +547,10 @@ <h4 class="p_Heading4"><span class="f_Heading4">Dispatch Options</span></h4>
 <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>
 <p class="p_VariableDescription"><span class="f_VariableDescription">Dispatch the battery based on month-by-hour weekday and weekend schedules you provide. Use this option to dispatch the battery in response to time-of-use electricity rates.</span></p>
-<p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Price signal forecast</span></p>
+<p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Retail rate dispatch</span></p>
 <p class="p_VariableDescription"><span class="f_VariableDescription">Dispatch the battery to minimize the energy and demand charge portions of the monthly electricity bill.</span></p>
+<p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Self-consumption</span></p>
+<p class="p_VariableDescription"><span class="f_VariableDescription">Dispatch the battery to minimize power to and from the grid.</span></p>
 <h4 class="p_Heading4"><span class="f_Heading4">Charge Options</span></h4>
 <p class="p_Text"><span class="f_Text">The battery charge options are limits on the dispatch options. Not all charge options are available for all dispatch options. SAM automatically disables (greys out) charge options that do not apply to the dispatch option you choose.</span></p>
 <p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Battery can charge from grid</span></p>
@@ -564,7 +566,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">Discharge battery only when load exceeds system output</span></p>
 <p class="p_VariableDescription"><span class="f_VariableDescription">Allow the battery to discharge only when the load is greater than the photovoltaic or other power system AC output.</span></p>
 <p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Battery can charge from fuel cell</span></p>
-<p class="p_VariableDescription"><span class="f_VariableDescription">For Fuel Cell PV Battery systems, allow the battery to charge from the fuel cell.</span></p>
+<p class="p_VariableDescription"><span class="f_VariableDescription">For system with fuel cells, allow the battery to charge from the fuel cell.</span></p>
 <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">
@@ -660,16 +662,16 @@ <h4 class="p_Heading4"><span class="f_Heading4">Load Forecast Horizon</span></h4
 </tr>
 </table>
 </div>
-<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="toggle0186a5_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="toggle0186a5_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="toggle0186a5_ICON" data-src0="./images/ico-plus-16x16.png" data-src1="./images/ico-minus-16x16.png">Price signal forecast</a></span></td></tr></table></div>
-<div id="toggle0186a5" 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" >
+<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 alt="ico-plus-16x16" 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_">Retail rate dispatch</span></td></tr></table></div>
+<div style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 0 0 0.3750rem 0;"><table class="ToggleContentTable" >
 <tr class="ToggleContentTable">
-<td class="ToggleContentTable"><p class="p_Text"><span style="font-family: Verdana,Geneva,Arial,sans-serif;">The price signal forecast option operates the battery to minimize the electricity bill based on an electricity price estimate that represents the cost to the system owner of purchasing electricity from the grid in each time step. For this option, battery dispatch depends on:</span></p>
+<td class="ToggleContentTable"><p class="p_Text"><span style="font-family: Verdana,Geneva,Arial,sans-serif;">The retail rate dispatch option operates the battery to minimize the electricity bill based on an estimate of retial electricity price that represents the cost to the system owner of purchasing electricity from the grid in each time step. For this option, battery dispatch depends on:</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_List">A rolling 24-hour forecast of system power generation and load as defined under </span><span class="f_CHInterfaceElement">Generation Forecast Horizon</span><span class="f_List">..</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_List">Energy and demand rates (flat, time-of-use, and/or tiered)</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_List">Battery state of charge and available capacity</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_List">Battery degradation</span></p>
 <p class="p_ListLast" style="text-indent: 0; page-break-inside: avoid; 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_ListLast">Cost of future battery replacements</span></p>
-<p class="p_Text"><span class="f_Text">The price signal forecast dispatch option is described in Mirletz, B.; Guittet, D. (2021). Heurestic Dispatch Based on Price Signals for Behind-the-Meter PV-Battery Systems in the System Advisor Model. NREL/CP-7A40-79575. (<a href="https://www.nrel.gov/docs/fy21osti/79575.pdf" target="_blank" class="weblink">PDF 2.2 MB</a>)</span></p>
+<p class="p_Text"><span class="f_Text">The retail rate dispach option is described (as &quot;price signal forecast&quot;) in Mirletz, B.; Guittet, D. (2021). Heurestic Dispatch Based on Price Signals for Behind-the-Meter PV-Battery Systems in the System Advisor Model. NREL/CP-7A40-79575. (<a href="https://www.nrel.gov/docs/fy21osti/79575.pdf" target="_blank" class="weblink">PDF 2.2 MB</a>)</span></p>
 <h4 class="p_Heading4"><span class="f_Heading4">Generation Forecast Horizon</span></h4>
 <p class="p_Text"><span class="f_Text">The generation forecast horizon determines whether the battery dispatch responds to a perfect forecast of the system's output, or to a forecast that is different from the system's output over the forecast period.</span></p>
 <p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Perfect look ahead</span></p>
@@ -678,7 +680,7 @@ <h4 class="p_Heading4"><span class="f_Heading4">Generation Forecast Horizon</spa
 <p class="p_VariableDescription"><span class="f_VariableDescription">Similar to perfect look ahead, but based on the system's output over the previous 24 hours. This adds some uncertainty to the dispatch because yesterday's generation profile is likely to be different from today's.</span></p>
 <p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Look ahead to custom weather file</span></p>
 <p class="p_VariableDescription"><span class="f_VariableDescription">For the PV Battery configuration, use a different weather file for the generation forecast than for simulating the system's power output. Use this option when you want the battery dispatch to be more realistic by not responding exactly to the system's output.</span></p>
-<p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Weather file for price signal forecast</span></p>
+<p class="p_VariableName" style="page-break-inside: avoid; page-break-after: avoid;"><span class="f_VariableName">Weather file for retail rate dispatch</span></p>
 <p class="p_VariableDescription"><span class="f_VariableDescription">The weather file to use for the Look Ahead to Custom Weather File 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>
 <h4 class="p_Heading4"><span class="f_Heading4">Load Forecast Horizon</span></h4>
 <p class="p_Text"><span class="f_Text">The generation forecast horizon determines whether the battery dispatch responds to a perfect forecast of the building or facility's electric load, or to a forecast that is different from the load over the forecast period.</span></p>
@@ -711,6 +713,16 @@ <h4 class="p_Heading4"><span class="f_Heading4">Cycle Degradation Penalty</span>
 </tr>
 </table>
 </div>
+<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="toggle0186a5_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="toggle0186a5_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="toggle0186a5_ICON" data-src0="./images/ico-plus-16x16.png" data-src1="./images/ico-minus-16x16.png">Self-consumption</a></span></td></tr></table></div>
+<div id="toggle0186a5" 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 self-consumption dispatch option dispatches the battery to minimize power to and from the grid.</span></p>
+<p class="p_Text"><span class="f_Text">This dispatch option is equivalent to the input grid power targets dispatch option with the grid power target set to zero for all time steps.</span></p>
+</td>
+</tr>
+</table>
+</div>
+<p class="p_Text"><span class="f_Text">&nbsp;</span></p>
 
 	<footer class="topicfooter">
 <p class="topicfooter">System Advisor Model (SAM) Help &copy; National Renewable Energy Laboratory</p>