{ "cells": [ { "cell_type": "markdown", "id": "e739facc", "metadata": {}, "source": [ "(pump)=\n", "# pump\n", "A hydropower pumping unit which consumes electricity to pump water between reservoirs\n", "\n", "| | |\n", "|---|---|\n", "|Input connections|{ref}`plant`, {ref}`reserve_group`, {ref}`commit_group`, {ref}`busbar`, {ref}`pump_reserve_capability`|\n", "|Output connections|{ref}`plant`, {ref}`reserve_group`, {ref}`commit_group`, {ref}`busbar`, {ref}`pump_reserve_capability`|\n", "|License|SHOP_OPEN|\n", "|Release version|13.0.0.a|\n", "\n", "```{contents}\n", ":local:\n", ":depth: 1\n", "```\n", "\n", "## Introduction\n", "The pump object is in many ways analogous to the [](generator) object, but in reverse. Please consult the generator documentation for general topics not covered here (like unit commitment), as they are very similar for pumps. Instead of producing power from falling water, the pump consumes power to lift water. The power consumed by a pump is calculated by the following equation:\n", "\n", "```{math}\n", "p = \\frac{\\rho \\cdot g \\cdot h \\cdot q}{\\eta_{gen}(p) \\cdot \\eta_{turb}(q, h)},\n", "```\n", "\n", "where $p$ is the power, $\\rho$ is the density of water, $g$ is the acceleration due to gravity, $h$ is the effective head of the generator, $q$ is the flow of water through the turbine, $\\eta_{gen}$ is the efficiency of the generator and $\\eta_{turb}$ is the efficiency of the turbine. Unlike the generator, the power consumed by the pump increases with lower efficiency. \n", "\n", "## Required input\n", "Similar to the generator object, a pump must be connected to a [](plant) object. The plant is in turn connected to the rest of the system which decides the overall system topology of how water flows. A pump must have a specified the [penstock number](pump:penstock), [minimum consumption](pump:p_min), [maximum consumption](pump:p_max), [nominal consumption](pump:p_nom), and [turbine efficiency curves](pump:turb_eff_curves). A [generator efficiency curve](pump:gen_eff_curve) is also common input.\n", "\n", "## Binary pumps\n", "A binary pump can only operate with a constant rotational speed, which means that it has a single operating point for a given head in SHOP. Binary pumps can be defined in SHOP by only inputting a single point on each turbine efficiency curve for the pump. This is shown in the [binary pump example](binary-pump-example).\n", "\n", "## Reversible turbines\n", "Reversible turbines can operate as both generators and pumps. How these are modelled SHOP is covered in the [generator documentation](generator) and the [reversible turbine example](reversible-turbine-example).\n", "\n", "## Reserve capacity\n", "Some pumps are able to deliver ancillary services, and reserve capacity can therefore be allocated on pumps in SHOP. Please see the [](generator) and [](reserve_group) objects for further information. Note that a upward reserve capacity on pumps is capacity for *decreasing* the consumption of the pump, which is the mirrored opposite of delivering upward reserves on generators (increasing production). The same is true for downward reserve capacity. \n", "\n", "## Examples\n", " - [](binary-pump-example)\n", " - [](reversible-turbine-example)\n", " \n", "\n", "## References\n", " - Short-term hydro scheduling of a variable speed pumped storage hydropower plant considering head loss in a shared penstock {cite}`Kong2019a`\n", " - Calculation of power compensation for a pumped storage hydropower plant with hydraulic short-circuit operation {cite}`Skjelbred2017b`\n", " \n", "\n", "## Attributes" ] }, { "cell_type": "code", "execution_count": 1, "id": "e311325d", "metadata": { "tags": [ "remove-input", "full-width" ] }, "outputs": [ { "data": { "text/html": [ "
\n", "\n" ], "text/plain": [ "" ] }, "execution_count": 1, "metadata": {}, "output_type": "execute_result" } ], "source": [ "from IPython.core.display import HTML\n", "HTML(\"\"\"
\n", "\n", "\"\"\")" ] }, { "cell_type": "markdown", "id": "c9e4aa56", "metadata": {}, "source": [ "(pump:initial_state)=\n", "### initial_state\n", "The initial operation state of the pump before the optimization period: -1 = not set; 0 = not running; 1 = running (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:penstock)=\n", "### penstock\n", "The penstock number the pump is connected to (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:separate_droop)=\n", "### separate_droop\n", "A flag to turn on (1) or off (0, default) the building of separate droop variables for FCR-N, FCR-D up, and FCR-D down for the pump. (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:p_min)=\n", "### p_min\n", "Static minimum consumption for the pump (xUnit: MW, yUnit: MW)\n", "\n", "\n", "(pump:p_max)=\n", "### p_max\n", "Static maximum consumption for the pump (xUnit: MW, yUnit: MW)\n", "\n", "\n", "(pump:p_nom)=\n", "### p_nom\n", "The nominal consumption that is the rated capacity of the pump (xUnit: MW, yUnit: MW)\n", "\n", "\n", "(pump:gen_eff_curve)=\n", "### gen_eff_curve\n", "The efficiency curve for the machine powering the pump (xUnit: MW, yUnit: %)\n", "\n", "\n", "(pump:turb_eff_curves)=\n", "### turb_eff_curves\n", "The turbine efficiency curve(s) as a function of upflow through the pump. Several curves can be specified for different head levels (reference value in the XY) to make the efficiency head-dependent. (xUnit: M3/S, yUnit: %)\n", "\n", "\n", "(pump:maintenance_flag)=\n", "### maintenance_flag\n", "Flag determining whether the pump is out for maintenance for a given time step (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:startcost)=\n", "### startcost\n", "Pump startup cost for turning on the pump (xUnit: NO_UNIT, yUnit: NOK)\n", "\n", "\n", "(pump:stopcost)=\n", "### stopcost\n", "Pump shutdown cost for turning off the pump (xUnit: NO_UNIT, yUnit: NOK)\n", "\n", "\n", "(pump:committed_in)=\n", "### committed_in\n", "Committed status given by the user used to define the operating status of the pump in the optimization: 0 - committed not to run; 1 - committed to run (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:committed_flag)=\n", "### committed_flag\n", "Flag determining whether to use the input commit status should be used for a given time step or not (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:upstream_max)=\n", "### upstream_max\n", "Maximum water level of upstream reservoir allowed when operating the pump (xUnit: NO_UNIT, yUnit: METER)\n", "\n", "\n", "(pump:upstream_max_flag)=\n", "### upstream_max_flag\n", "Flag determining whether the maximum water level of upstream reservoir allowed when operating the pump should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:downstream_min)=\n", "### downstream_min\n", "Minimum water level of downstream reservoir required for operating the pump (xUnit: NO_UNIT, yUnit: METER)\n", "\n", "\n", "(pump:downstream_min_flag)=\n", "### downstream_min_flag\n", "Flag determining whether the minimum water level of downstream reservoir required for operating the pump should be included in the optimization model (xUnit: NO_UNIT, yUnit: METER)\n", "\n", "\n", "(pump:consumption_schedule)=\n", "### consumption_schedule\n", "Consumption schedule (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:consumption_schedule_flag)=\n", "### consumption_schedule_flag\n", "Flag determining whether the pump consumption schedule should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:upflow_schedule)=\n", "### upflow_schedule\n", "Pump upflow schedule (xUnit: NO_UNIT, yUnit: M3/S)\n", "\n", "\n", "(pump:upflow_schedule_flag)=\n", "### upflow_schedule_flag\n", "Flag determining whether the pump upflow schedule should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_mip_flag)=\n", "### fcr_mip_flag\n", "Flag determining whether binary variables should be used to enforce minimum available capacity requirement when delivering FCR (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:p_fcr_min)=\n", "### p_fcr_min\n", "Temporary minimum consumption for the pump when delivering FCR (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:p_fcr_max)=\n", "### p_fcr_max\n", "Temporary maximum consumption for the pump when delivering FCR (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:p_rr_min)=\n", "### p_rr_min\n", "Temporary minimum consumption for the pump when delivering RR (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:frr_up_min)=\n", "### frr_up_min\n", "Minimum FRR_UP delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:frr_up_max)=\n", "### frr_up_max\n", "Maximum FRR_UP delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:frr_down_min)=\n", "### frr_down_min\n", "Minimum FRR_DOWN delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:frr_down_max)=\n", "### frr_down_max\n", "Maximum FRR_DOWN delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_up_min)=\n", "### fcr_n_up_min\n", "Minimum FCR_N_UP delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_up_max)=\n", "### fcr_n_up_max\n", "Maximum FCR_N_UP delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_down_min)=\n", "### fcr_n_down_min\n", "Minimum FCR_N_DOWN delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_down_max)=\n", "### fcr_n_down_max\n", "Maximum FCR_N_DOWN delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_d_up_min)=\n", "### fcr_d_up_min\n", "Minimum FCR_D_UP delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_d_up_max)=\n", "### fcr_d_up_max\n", "Maximum FCR_D_UP delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_d_down_min)=\n", "### fcr_d_down_min\n", "Minimum FCR_D_DOWN delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_d_down_max)=\n", "### fcr_d_down_max\n", "Maximum FCR_D_DOWN delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:rr_up_min)=\n", "### rr_up_min\n", "Minimum RR_UP delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:rr_up_max)=\n", "### rr_up_max\n", "Maximum RR_UP delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:rr_down_min)=\n", "### rr_down_min\n", "Minimum RR_DOWN delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:rr_down_max)=\n", "### rr_down_max\n", "Maximum RR_DOWN delivery for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_up_schedule)=\n", "### fcr_n_up_schedule\n", "Pump FCR_N_UP delivery schedule (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_up_schedule_flag)=\n", "### fcr_n_up_schedule_flag\n", "Flag determining whether the pump FCR_N_UP delivery schedule should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_n_down_schedule)=\n", "### fcr_n_down_schedule\n", "Pump FCR_N_DOWN delivery schedule (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_down_schedule_flag)=\n", "### fcr_n_down_schedule_flag\n", "Flag determining whether the pump FCR_N_DOWN delivery schedule should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_d_up_schedule)=\n", "### fcr_d_up_schedule\n", "Pump FCR_D_UP delivery schedule (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_d_up_schedule_flag)=\n", "### fcr_d_up_schedule_flag\n", "Flag determining whether the pump FCR_D_UP delivery schedule should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_d_down_schedule)=\n", "### fcr_d_down_schedule\n", "Pump FCR_D_DOWN delivery schedule (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_d_down_schedule_flag)=\n", "### fcr_d_down_schedule_flag\n", "Flag determining whether the pump FCR_D_DOWN delivery schedule should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:frr_up_schedule)=\n", "### frr_up_schedule\n", "Pump FRR_UP delivery schedule (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:frr_up_schedule_flag)=\n", "### frr_up_schedule_flag\n", "Flag determining whether the pump FRR_UP delivery schedule should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:frr_down_schedule)=\n", "### frr_down_schedule\n", "Pump FRR_DOWN delivery schedule (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:frr_down_schedule_flag)=\n", "### frr_down_schedule_flag\n", "Flag determining whether the pump FRR_DOWN delivery schedule should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:rr_up_schedule)=\n", "### rr_up_schedule\n", "Pump RR_UP delivery schedule (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:rr_up_schedule_flag)=\n", "### rr_up_schedule_flag\n", "Flag determining whether the pump RR_UP delivery schedule should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:rr_down_schedule)=\n", "### rr_down_schedule\n", "Pump RR_DOWN delivery schedule (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:rr_down_schedule_flag)=\n", "### rr_down_schedule_flag\n", "Flag determining whether the pump RR_DOWN delivery schedule should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:droop_cost)=\n", "### droop_cost\n", "The cost for the inverse unit droop when it is modelled as a variable in the optimization model, which makes SHOP prefer high droop settings. The default droop_cost on global_settings is used if this attribute is not specified (xUnit: NO_UNIT, yUnit: NOK)\n", "\n", "\n", "(pump:fixed_droop)=\n", "### fixed_droop\n", "Fixed unit droop given as input data (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fixed_droop_flag)=\n", "### fixed_droop_flag\n", "Flag determining whether the fixed droop setting should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:droop_min)=\n", "### droop_min\n", "The lower bound of the unit droop when it is modelled as a variable in the optimization model. This bound is applied together with other FCR constraints, where the most restrictive will limit the FCR delivery (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:droop_max)=\n", "### droop_max\n", "The upper bound of the unit droop when it is modelled as a variable in the optimization model. This bound is applied together with other FCR constraints, where the most restrictive will limit the FCR delivery (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:reserve_ramping_cost_up)=\n", "### reserve_ramping_cost_up\n", "Upward reserve ramping cost for changing reserve delivery of the pump (xUnit: NO_UNIT, yUnit: NOK/MW)\n", "\n", "\n", "(pump:reserve_ramping_cost_down)=\n", "### reserve_ramping_cost_down\n", "Downward reserve ramping cost for changing reserve delivery of the pump (xUnit: NO_UNIT, yUnit: NOK/MW)\n", "\n", "\n", "(pump:discrete_droop_values)=\n", "### discrete_droop_values\n", "A list of all legal droop values for the pump. If the functionality for fixing the unit droop is activated by the 'set droop_discretization_limit' command, this list of discrete values will be used when fixing the pump droop (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_n_discrete_droop_values)=\n", "### fcr_n_discrete_droop_values\n", "A list of all legal droop values for FCR-N reserves when the pump is built with separate droop. If the functionality for fixing the unit droop is activated by the 'set droop_discretization_limit' command, this list of discrete values will be used when fixing the generator droop (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_d_up_discrete_droop_values)=\n", "### fcr_d_up_discrete_droop_values\n", "A list of all legal droop values for FCR-D up reserves when the pump is built with separate droop. If the functionality for fixing the unit droop is activated by the 'set droop_discretization_limit' command, this list of discrete values will be used when fixing the generator droop (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_d_down_discrete_droop_values)=\n", "### fcr_d_down_discrete_droop_values\n", "A list of all legal droop values for FCR-D down reserves when the pump is built with separate droop. If the functionality for fixing the unit droop is activated by the 'set droop_discretization_limit' command, this list of discrete values will be used when fixing the generator droop (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_n_up_cost)=\n", "### fcr_n_up_cost\n", "The cost of allocating FCR-N up reserves on this pump (xUnit: NO_UNIT, yUnit: NOK/MW)\n", "\n", "\n", "(pump:fcr_n_down_cost)=\n", "### fcr_n_down_cost\n", "The cost of allocating FCR-N down reserves on this pump (xUnit: NO_UNIT, yUnit: NOK/MW)\n", "\n", "\n", "(pump:fcr_d_up_cost)=\n", "### fcr_d_up_cost\n", "The cost of allocating FCR-D up reserves on this pump (xUnit: NO_UNIT, yUnit: NOK/MW)\n", "\n", "\n", "(pump:fcr_d_down_cost)=\n", "### fcr_d_down_cost\n", "The cost of allocating FCR-D down reserves on this pump (xUnit: NO_UNIT, yUnit: NOK/MW)\n", "\n", "\n", "(pump:frr_up_cost)=\n", "### frr_up_cost\n", "The cost of allocating FRR up reserves on this pump (xUnit: NO_UNIT, yUnit: NOK/MW)\n", "\n", "\n", "(pump:frr_down_cost)=\n", "### frr_down_cost\n", "The cost of allocating FRR down reserves on this pump (xUnit: NO_UNIT, yUnit: NOK/MW)\n", "\n", "\n", "(pump:rr_up_cost)=\n", "### rr_up_cost\n", "The cost of allocating RR up reserves on this pump (xUnit: NO_UNIT, yUnit: NOK/MW)\n", "\n", "\n", "(pump:rr_down_cost)=\n", "### rr_down_cost\n", "The cost of allocating RR down reserves on this pump (xUnit: NO_UNIT, yUnit: NOK/MW)\n", "\n", "\n", "(pump:spinning_reserve_up_max)=\n", "### spinning_reserve_up_max\n", "Sets a maximum limit for the sum of spinning reserves delivered in the upward direction on the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:spinning_reserve_down_max)=\n", "### spinning_reserve_down_max\n", "Sets a maximum limit for the sum of spinning reserves delivered in the downward direction on the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_droop_cost)=\n", "### fcr_n_droop_cost\n", "The cost for the inverse unit droop for FCR-N reserves when it is modelled as a variable in the optimization model and droop is built separately for FCR-N and FCR-D. The droop_cost attribute on the pump or global_settings is used if this attribut is not specified. (xUnit: NO_UNIT, yUnit: NOK)\n", "\n", "\n", "(pump:fcr_d_up_droop_cost)=\n", "### fcr_d_up_droop_cost\n", "The cost for the inverse unit droop for FCR-D up reserves when it is modelled as a variable in the optimization model and droop is built separately for FCR-N and FCR-D. The droop_cost attribute on the pump or global_settings is used if this attribut is not specified. (xUnit: NO_UNIT, yUnit: NOK)\n", "\n", "\n", "(pump:fcr_d_down_droop_cost)=\n", "### fcr_d_down_droop_cost\n", "The cost for the inverse unit droop for FCR-D down reserves when it is modelled as a variable in the optimization model and droop is built separately for FCR-N and FCR-D. The droop_cost attribute on the pump or global_settings is used if this attribut is not specified. (xUnit: NO_UNIT, yUnit: NOK)\n", "\n", "\n", "(pump:fcr_n_fixed_droop)=\n", "### fcr_n_fixed_droop\n", "Fixed unit droop schedule for FCR-N reserves when droop is built separately for FCR-N and FCR-D (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_d_up_fixed_droop)=\n", "### fcr_d_up_fixed_droop\n", "Fixed unit droop schedule for FCR-D up reserves when droop is built separately for FCR-N and FCR-D (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_d_down_fixed_droop)=\n", "### fcr_d_down_fixed_droop\n", "Fixed unit droop schedule for FCR-D down reserves when droop is built separately for FCR-N and FCR-D (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_n_droop_min)=\n", "### fcr_n_droop_min\n", "The lower bound of the unit droop for FCR-N reserves when it is modelled as a variable in the optimization model and droop is built separately for FCR-N and FCR-D. This bound is applied together with other FCR-N constraints, where the most restrictive will limit the FCR delivery (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_d_up_droop_min)=\n", "### fcr_d_up_droop_min\n", "The lower bound of the unit droop for FCR-D up reserves when it is modelled as a variable in the optimization model and droop is built separately for FCR-N and FCR-D. This bound is applied together with other FCR-D up constraints, where the most restrictive will limit the FCR delivery (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_d_down_droop_min)=\n", "### fcr_d_down_droop_min\n", "The lower bound of the unit droop for FCR-D down reserves when it is modelled as a variable in the optimization model and droop is built separately for FCR-N and FCR-D. This bound is applied together with other FCR-D down constraints, where the most restrictive will limit the FCR delivery (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_n_droop_max)=\n", "### fcr_n_droop_max\n", "The upper bound of the unit droop for FCR-N reserves when it is modelled as a variable in the optimization model and droop is built separately for FCR-N and FCR-D. This bound is applied together with other FCR-N constraints, where the most restrictive will limit the FCR delivery (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_d_up_droop_max)=\n", "### fcr_d_up_droop_max\n", "The upper bound of the unit droop for FCR-D up reserves when it is modelled as a variable in the optimization model and droop is built separately for FCR-N and FCR-D. This bound is applied together with other FCR-D up constraints, where the most restrictive will limit the FCR delivery (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_d_down_droop_max)=\n", "### fcr_d_down_droop_max\n", "The upper bound of the unit droop for FCR-D down reserves when it is modelled as a variable in the optimization model and droop is built separately for FCR-N and FCR-D. This bound is applied together with other FCR-D down constraints, where the most restrictive will limit the FCR delivery (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:historical_consumption)=\n", "### historical_consumption\n", "The pump consumption for times before the optimization start. (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:min_uptime)=\n", "### min_uptime\n", "Minimum pump up-time, given in whole minutes. (xUnit: MINUTE, yUnit: MINUTE)\n", "\n", "\n", "(pump:min_downtime)=\n", "### min_downtime\n", "Minimum pump down-time, given in whole minutes. (xUnit: MINUTE, yUnit: MINUTE)\n", "\n", "\n", "(pump:min_uptime_flag)=\n", "### min_uptime_flag\n", "Flag for turning on/off the minimum pump up-time constraints (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:min_downtime_flag)=\n", "### min_downtime_flag\n", "Flag for turning on/off the minimum pump down-time constraints (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:rr_up_stop_mip_flag)=\n", "### rr_up_stop_mip_flag\n", "Setting this flag to 1 will turn on the use of binary variables in full iterations to enable this pump to deliver valid RR-UP reserves up to full stop. This forces RR-UP to either be alocated as spinning reserve (up to p_min) or up to a full stop, and no other spinning reservers can be allocated on the unit if RR-UP is delivered to stop. RR-UP allocation in forbidden consumption regions (between 0 and p_min) is also prohibited. If the flag is not specified, the attribute 'rr_up_stop_mip' on global_settings is used (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:max_p_constr)=\n", "### max_p_constr\n", "Time-dependent maximum consumption limit for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:max_p_constr_flag)=\n", "### max_p_constr_flag\n", "Flag determining whether the time-dependent maximum consumption limit for the pump should be included in the building of the original PQ curve (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:min_p_constr)=\n", "### min_p_constr\n", "Time-dependent minimum consumption limit for the pump (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:min_p_constr_flag)=\n", "### min_p_constr_flag\n", "Flag determining whether the time-dependent minimum consumption limit for the pump should be included in the building of the original PQ curve (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:min_q_constr)=\n", "### min_q_constr\n", "Time-dependent minimum upflow limit for the pump (xUnit: NO_UNIT, yUnit: M3/S)\n", "\n", "\n", "(pump:min_q_constr_flag)=\n", "### min_q_constr_flag\n", "Flag determining whether the time-dependent minimum upflow limit for the pump should be included in the building of the original PQ curve (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:max_q_constr)=\n", "### max_q_constr\n", "Time-dependent maximum upflow limit for the pump (xUnit: NO_UNIT, yUnit: M3/S)\n", "\n", "\n", "(pump:max_q_constr_flag)=\n", "### max_q_constr_flag\n", "Flag determining whether the time-dependent maximum upflow limit for the pump should be included in the building of the original PQ curve (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:eff_head)=\n", "### eff_head\n", "Resulting effective head of the pump (xUnit: NO_UNIT, yUnit: METER)\n", "\n", "\n", "(pump:sim_eff_head)=\n", "### sim_eff_head\n", "Resulting effective head of the pump during simulation (xUnit: NO_UNIT, yUnit: METER)\n", "\n", "\n", "(pump:head_loss)=\n", "### head_loss\n", "Resulting head loss of the pump, i.e. the effective head of the pump (eff_head) minus the plant gross head (gross_head) (xUnit: NO_UNIT, yUnit: METER)\n", "\n", "\n", "(pump:sim_head_loss)=\n", "### sim_head_loss\n", "Resulting head loss of the pump in the simulation, i.e. the effective head of the pump (eff_head) minus the plant gross head (gross_head) (xUnit: NO_UNIT, yUnit: METER)\n", "\n", "\n", "(pump:consumption)=\n", "### consumption\n", "Resulting pump consumption, calculated based on upflow (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:sim_consumption)=\n", "### sim_consumption\n", "Simulated pump consumption, calculated based on upflow (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:solver_consumption)=\n", "### solver_consumption\n", "Preliminary result for pump consumption that is returned by the linearized optimization problem (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:upflow)=\n", "### upflow\n", "Resulting pump upflow. If solver_upflow >= pump_turn_off_limit, upflow = solver_upflow. Otherwise, upflow = 0. (xUnit: NO_UNIT, yUnit: M3/S)\n", "\n", "\n", "(pump:sim_upflow)=\n", "### sim_upflow\n", "Simulated pump upflow. (xUnit: NO_UNIT, yUnit: M3/S)\n", "\n", "\n", "(pump:solver_upflow)=\n", "### solver_upflow\n", "Preliminary result for pump upflow that is returned by the linearized optimization problem (xUnit: NO_UNIT, yUnit: M3/S)\n", "\n", "\n", "(pump:committed_out)=\n", "### committed_out\n", "Committed status of the pump as a result of the optimization: 0 - not running; 1 - committed to run (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:consumption_schedule_penalty)=\n", "### consumption_schedule_penalty\n", "Resulting penalty when the pump consumption schedule is violated (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:upflow_schedule_penalty)=\n", "### upflow_schedule_penalty\n", "Resulting penalty when the pump upflow schedule is violated (xUnit: NO_UNIT, yUnit: MM3)\n", "\n", "\n", "(pump:fcr_n_up_delivery)=\n", "### fcr_n_up_delivery\n", "Resulting pump FCR_N_UP delivery (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_down_delivery)=\n", "### fcr_n_down_delivery\n", "Resulting pump FCR_N_DOWN delivery (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_d_up_delivery)=\n", "### fcr_d_up_delivery\n", "Resulting pump FCR_D_UP delivery (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_d_down_delivery)=\n", "### fcr_d_down_delivery\n", "Resulting pump FCR_D_DOWN delivery (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:frr_up_delivery)=\n", "### frr_up_delivery\n", "Resulting pump FRR_UP delivery (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:frr_down_delivery)=\n", "### frr_down_delivery\n", "Resulting pump FRR_DOWN delivery (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:rr_up_delivery)=\n", "### rr_up_delivery\n", "Resulting pump RR_UP delivery (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:rr_down_delivery)=\n", "### rr_down_delivery\n", "Resulting pump RR_DOWN delivery (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_up_delivery_physical)=\n", "### fcr_n_up_delivery_physical\n", "Resulting physical pump FCR_N delivery in the upward direction (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_down_delivery_physical)=\n", "### fcr_n_down_delivery_physical\n", "Resulting physical pump FCR_N delivery in the downward direction (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_d_up_delivery_physical)=\n", "### fcr_d_up_delivery_physical\n", "Resulting physical pump FCR_D delivery in the upward direction (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_d_down_delivery_physical)=\n", "### fcr_d_down_delivery_physical\n", "Resulting physical pump FCR_D delivery in the downward direction (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_up_schedule_penalty)=\n", "### fcr_n_up_schedule_penalty\n", "Resulting penalty when the pump FCR_N_UP schedule is violated (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_down_schedule_penalty)=\n", "### fcr_n_down_schedule_penalty\n", "Resulting penalty when the pump FCR_N_DOWN schedule is violated (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_d_up_schedule_penalty)=\n", "### fcr_d_up_schedule_penalty\n", "Resulting penalty when the pump FCR_D_UP schedule is violated (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_d_down_schedule_penalty)=\n", "### fcr_d_down_schedule_penalty\n", "Resulting penalty when the pump FCR_D_DOWN schedule is violated (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:frr_up_schedule_penalty)=\n", "### frr_up_schedule_penalty\n", "Resulting penalty when the pump FRR_UP schedule is violated (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:frr_down_schedule_penalty)=\n", "### frr_down_schedule_penalty\n", "Resulting penalty when the pump FRR_DOWN schedule is violated (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:rr_up_schedule_penalty)=\n", "### rr_up_schedule_penalty\n", "Resulting penalty when the pump RR_UP schedule is violated (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:rr_down_schedule_penalty)=\n", "### rr_down_schedule_penalty\n", "Resulting penalty when the pump RR_DOWN schedule is violated (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:droop_result)=\n", "### droop_result\n", "Resulting unit droop when it is modelled as a variable in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:original_pq_curves)=\n", "### original_pq_curves\n", "Original PQ-curve for the pump that includes non-convex regions (xUnit: M3/S, yUnit: MW)\n", "\n", "\n", "(pump:convex_pq_curves)=\n", "### convex_pq_curves\n", "Convexified PQ-curve for the pump that removes all the nonconcave points of the original PQ curve. The slope of each segment is non-decreasing. (xUnit: M3/S, yUnit: MW)\n", "\n", "\n", "(pump:final_pq_curves)=\n", "### final_pq_curves\n", "Final PQ curve for the pump that is the final form included into the optimization problem. The first point of the convex PQ curve is extended to Q=0. (xUnit: M3/S, yUnit: MW)\n", "\n", "\n", "(pump:max_cons)=\n", "### max_cons\n", "The head dependent maximal consumption of the pump, most accurate in incremental iterations (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:min_cons)=\n", "### min_cons\n", "The head dependent minimal consumption of the pump, most accurate in incremental iterations (xUnit: NO_UNIT, yUnit: MW)\n", "\n", "\n", "(pump:fcr_n_droop_result)=\n", "### fcr_n_droop_result\n", "The optimized unit droop for FCR-N reserves when the droop is built separately for FCR-N and FCR-D. If all FCR reserves share a common droop setting, this txy is identical to the 'droop_result' attribute (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_d_up_droop_result)=\n", "### fcr_d_up_droop_result\n", "The optimized unit droop for FCR-D up reserves when the droop is built separately for FCR-N and FCR-D. If all FCR reserves share a common droop setting, this txy is identical to the 'droop_result' attribute (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(pump:fcr_d_down_droop_result)=\n", "### fcr_d_down_droop_result\n", "The optimized unit droop for FCR-D down reserves when the droop is built separately for FCR-N and FCR-D. If all FCR reserves share a common droop setting, this txy is identical to the 'droop_result' attribute (xUnit: NO_UNIT, yUnit: NO_UNIT)" ] } ], "metadata": { "jupytext": { "text_representation": { "extension": ".md", "format_name": "myst", "format_version": 0.13, "jupytext_version": "1.13.8" } }, "kernelspec": { "display_name": "Python 3", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.12.9" }, "source_map": [ 11, 61, 73 ] }, "nbformat": 4, "nbformat_minor": 5 }