{ "cells": [ { "cell_type": "markdown", "id": "b76a238e", "metadata": {}, "source": [ "(gate)=\n", "# gate\n", "A general water rout that is used to move water from an upstream reservoir to the downstream reservoir\n", "\n", "| | |\n", "|---|---|\n", "|Input connections|{ref}`reservoir`, {ref}`creek_intake`, {ref}`discharge_group`|\n", "|Output connections|{ref}`reservoir`, {ref}`junction`, {ref}`discharge_group`|\n", "|License|SHOP_OPEN|\n", "|Release version|13.0.0.a|\n", "\n", "```{contents}\n", ":local:\n", ":depth: 1\n", "```\n", "\n", "```{warning}\n", "The gate object is old and will be deprecated in the future. A gate can be replaced with either the newer [](river) or [](tunnel) objects.\n", "```\n", "\n", "## Examples\n", " - [](ramping)\n", " \n", "\n", "\n", "\n", "## Attributes" ] }, { "cell_type": "code", "execution_count": 1, "id": "4f7fede3", "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": "44477891", "metadata": {}, "source": [ "(gate:time_delay)=\n", "### time_delay\n", "Future deprecation: All time delay should be modelled by using the river object (does not require additional license). The delay between water leaving the gate and until it ends up in the downstream reservoir (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:add_slack)=\n", "### add_slack\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Include slack variables for the corresponding delta meter gate (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:max_discharge)=\n", "### max_discharge\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Maximum discharge capacity for the gate (xUnit: M3/S, yUnit: M3/S)\n", "\n", "\n", "(gate:lin_rel_a)=\n", "### lin_rel_a\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Linear approximation to model gate discharge (in Mm3) as a function of upstream reservoir volume: gate_flow = lin_rel_a*up_rsv_volume + lin_rel_b (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:lin_rel_b)=\n", "### lin_rel_b\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Linear approximation to model gate discharge (in Mm3) as a function of upstream reservoir volume: gate_flow = lin_rel_a*up_rsv_volume + lin_rel_b (xUnit: MM3, yUnit: MM3)\n", "\n", "\n", "(gate:shape_discharge)=\n", "### shape_discharge\n", "Future deprecation: All time delay should be modelled by using the river object (does not require additional license). Describes the wave shape of the delayed discharge for a gate by ratios as a function of time delays (xUnit: HOUR, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:spill_cost_curve)=\n", "### spill_cost_curve\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Describes a piece-wise constant cost curve for the flow in the gate. This is only available for spill gates, and overrides the default overflow penalty in SHOP. (xUnit: M3/S, yUnit: NOK/M3/S)\n", "\n", "\n", "(gate:peak_flow_cost_curve)=\n", "### peak_flow_cost_curve\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Describes the piece-wise constant cost curve for the highest achieved flow rate in the gate over the optimization horizon (xUnit: M3/S, yUnit: NOK/M3/S)\n", "\n", "\n", "(gate:peak_flow_penalty)=\n", "### peak_flow_penalty\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). The penalty incurred based on the peak_flow_cost_curve and the highest achieved flow rate in the gate over the optimization horizon (xUnit: NO_UNIT, yUnit: NOK)\n", "\n", "\n", "(gate:functions_meter_m3s)=\n", "### functions_meter_m3s\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). The relation between the head and opening of the gate or weir to define the discharge function of the gate (xUnit: METER, yUnit: M3/S)\n", "\n", "\n", "(gate:functions_deltameter_m3s)=\n", "### functions_deltameter_m3s\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Relationship between flow through the gate and water level in upper reservoir and difference in water level between upper and lower reservoir (xUnit: DELTA_METER, yUnit: M3/S)\n", "\n", "\n", "(gate:min_flow)=\n", "### min_flow\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Minimum flow constraint on the gate (xUnit: NO_UNIT, yUnit: M3/S)\n", "\n", "\n", "(gate:min_flow_flag)=\n", "### min_flow_flag\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Flag determining whether the min_flow should be used (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:max_flow)=\n", "### max_flow\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Maximum flow constraint on the gate (xUnit: NO_UNIT, yUnit: M3/S)\n", "\n", "\n", "(gate:max_flow_flag)=\n", "### max_flow_flag\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Flag determining whether the max_flow should be used (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:schedule_m3s)=\n", "### schedule_m3s\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Gate discharge schedule (xUnit: NO_UNIT, yUnit: M3/S)\n", "\n", "\n", "(gate:schedule_percent)=\n", "### schedule_percent\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Gate schedule in percent opening of the gate (xUnit: NO_UNIT, yUnit: %)\n", "\n", "\n", "(gate:schedule_flag)=\n", "### schedule_flag\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Flag determining how the gate schedule should be used: 0 = no discharge schedule; 1 = discharge schedule; 2 = flow is calculated from reservoir water level and flow function for the gate (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:setting)=\n", "### setting\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Predefined position of the gate to be used for determining gate flow together with functions and upstream water level (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:setting_flag)=\n", "### setting_flag\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Flag determining whether the gate setting should be used to determine the flow through the gate (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:discharge_fee)=\n", "### discharge_fee\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Cost of discharging water through the gate referred to the time of discharge (xUnit: NO_UNIT, yUnit: NOK/MM3)\n", "\n", "\n", "(gate:discharge_fee_flag)=\n", "### discharge_fee_flag\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Flag determining whether discharge_fee should be used in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:block_merge_tolerance)=\n", "### block_merge_tolerance\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Maximum deviation in discharge between two time steps that forces these hours to have the same discharge in later iterations (xUnit: NO_UNIT, yUnit: M3/S)\n", "\n", "\n", "(gate:min_q_penalty_flag)=\n", "### min_q_penalty_flag\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). A flag enabling the penalty cost for the minimum discharge constraint on the gate (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:max_q_penalty_flag)=\n", "### max_q_penalty_flag\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). A flag enabling the penalty cost for the maximum discharge constraint on the gate (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:ramping_up)=\n", "### ramping_up\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Maximum limit for increase in gate discharge per hour (xUnit: NO_UNIT, yUnit: M3SEC_HOUR)\n", "\n", "\n", "(gate:ramping_up_flag)=\n", "### ramping_up_flag\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). A flag for toggling the upper ramping limit constraint on and off for this gate (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:ramping_down)=\n", "### ramping_down\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Maximum limit for decrease in gate discharge per hour (xUnit: NO_UNIT, yUnit: M3SEC_HOUR)\n", "\n", "\n", "(gate:ramping_down_flag)=\n", "### ramping_down_flag\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). A flag for toggling the lower ramping limit constraint on and off for this gate (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:ramp_penalty_cost)=\n", "### ramp_penalty_cost\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). The penalty cost for breaking the upper or lower discharge ramping limits for the gate (xUnit: NO_UNIT, yUnit: NOK/M3/S)\n", "\n", "\n", "(gate:ramp_penalty_cost_flag)=\n", "### ramp_penalty_cost_flag\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). A flag for toggling the use of the specified ramping penalty cost for this gate on or off (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:max_q_penalty_cost)=\n", "### max_q_penalty_cost\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). The penalty cost for the gate maximum discharge constraint (xUnit: NO_UNIT, yUnit: NOK/MM3)\n", "\n", "\n", "(gate:min_q_penalty_cost)=\n", "### min_q_penalty_cost\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). The penalty cost for the gate minimum discharge constraint (xUnit: NO_UNIT, yUnit: NOK/MM3)\n", "\n", "\n", "(gate:max_q_penalty_cost_flag)=\n", "### max_q_penalty_cost_flag\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Flag determining whether max_q_penalty_cost should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:min_q_penalty_cost_flag)=\n", "### min_q_penalty_cost_flag\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Flag determining whether min_q_penalty_cost should be included in the optimization model (xUnit: NO_UNIT, yUnit: NO_UNIT)\n", "\n", "\n", "(gate:min_q_penalty)=\n", "### min_q_penalty\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Resulting penalty when the gate minimum discharge is violated (xUnit: NO_UNIT, yUnit: NOK)\n", "\n", "\n", "(gate:max_q_penalty)=\n", "### max_q_penalty\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Resulting penalty when the gate maximum discharge is violated (xUnit: NO_UNIT, yUnit: NOK)\n", "\n", "\n", "(gate:discharge)=\n", "### discharge\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Resulting gate discharge (xUnit: NO_UNIT, yUnit: M3/S)\n", "\n", "\n", "(gate:sim_discharge)=\n", "### sim_discharge\n", "Future deprecation: All gates should be modelled by using the river or tunnel objects (does not require additional license). Simulated gate discharge (xUnit: NO_UNIT, yUnit: M3/S)" ] } ], "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, 40, 52 ] }, "nbformat": 4, "nbformat_minor": 5 }