Help revisions for SAM 2024.12.12 (#1960)

* Help revisions for SAM 2024.12.12

Grid limits do not affect electricity imports from the grid.

Revise IPH molten salt linear Fresnel topics

Power tower heliostast pivot point height definition.

New Financial Parameters topic for LCOH Calculator.

Wind wake loss inputs NREL/ssc#1186

Annual energy and monthly energy label updates: NREL/ssc#1236

Replace parentheses with commas for installation cost units

Battery availability loss. NREL/ssc#1241

Tidal Energy Converter page revisions for new options, see #1807.

New net billing with carryover options. NREL/ssc#1200

IPH MSLF revisions: #1444

Fix fuel cell model link https://www.nrel.gov/hydrogen/fuel-cell-power-model.html, replace with https://www.nrel.gov/docs/fy13osti/57457.pdf.

PV GCR affects output for bifacial modules.

Revise report generator topic to explain template not available for some configurations.

Add topics for IPH financial models

Generic system to custom generatio profile

Standalone battery time step

New autographs and default graphs for battery configurations: #1884

System Availability three hour option for marine, "hourly" to "time series"

## October 24, 2024

Update Cambium note about years for Cambium 2023

Battery dispatch (BTM and FOM) battery can charge from grid-limited system power

Grid limits battery can charge from grid-limited system power

Project with 100% debt results in IRR = NaN

Revise real discount rate description

Geothermal system availability losses

Revise metrics topics to facilitate navigation.

Revise weather file format to include CSV for wind

Revise PV subhourly clipping "Allen method"

Revise Cost of Acquiring Financing.

* Help revisions

Revise "receiver startup delay time" and "receiver startup delay energy fraction" descriptions for trough and Fresnel models.

Fix remaining references to "generic system" model.

---------

Co-authored-by: Steven Janzou <steven@janzouconsulting.com>

deploy/runtime/help/html/battery_dispatch_btm.html

@@ -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>

deploy/runtime/help/html/battery_dispatch_fom.html

@@ -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>
@@ -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 />
@@ -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>
@@ -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>