{ "cells": [ { "cell_type": "markdown", "id": "08a21331", "metadata": {}, "source": [ "(reserve_group)=\n", "# reserve_group\n", "Represents a group of generators, pumps, and batteries that collectively serve to fulfill a reserve capacity obligation. SHOP distinguishes between eight different types of reserve capacity products: FCR-N, FCR-D, FRR, and RR in both upward and downward directions.\n", "\n", "| | |\n", "|---|---|\n", "|Input connections|{ref}`generator`, {ref}`pump`, {ref}`market`, {ref}`battery`|\n", "|Output connections|{ref}`generator`, {ref}`pump`, {ref}`battery`, {ref}`market`|\n", "|License|SHOP_RESERVE_GROUP|\n", "|Release version|13.0.0.a|\n", "\n", "```{contents}\n", ":local:\n", ":depth: 1\n", "```\n", "\n", "## Introduction\n", "The reserve_group object is used to optimally distribute reserve capacity among all [generators](generator), [pumps](pump), and [batteries](battery) that are connected to the reserve_group. The [reserve capacity tutorial](reserves) describes how different types of reserve capacity is modelled in SHOP. The reserve_group is used for mainly two purposes: to specify a fixed reserve capacity obligation to be optimally distributed, and to connect units to a reserve [](market) where reserve capacity can be traded.\n", "\n", "## Distributing a reserve obligation\n", "The simplest use for a reserve_group is for optimal distribution of a reserve obligation among a set of eligible generators, pumps, and batteries. The reserve obligation is specified on the reserve_group, and is specific to a type of reserve capacity such as the [fcr_n_up_obligation](reserve_group:fcr_n_up_obligation). Several different types of reserve capacity obligations can be specified on the same reserve_group, but it is recommended to create separate reserve_groups for different reserve types. The units that are connected to the reserve_group will be able to deliver reserve capacity of the types that are specified in the obligation(s), and the sum of the reserve capacity allocated on the different units must meet the obligation to avoid taking a penalty. The [reserve allocation example](reserve-example) shows how several generators cooperate to cover the reserve obligations specified in the reserve_groups.\n", "\n", "## Reserve capacity markets\n", "It is possible to create a reserve capacity market by connecting a reserve_group to a market object and setting the [market_type](market:market_type) of the market to be a reserve type, such as FRR_UP. The units connected to the reserve_group can now participate in the reserve market by selling reserve capacity to earn the [sale_price](market:sale_price), as long as the market depth [max_sale](market:max_sale) is set larger than zero. Note that reserve capacity also can be bought in the market if [max_buy](market:max_buy) is larger than zero. Any reserve obligation on the reserve_group will be handled as a load in the market, which means that the obligation must be covered before additional capacity can be sold.\n", "\n", "## Examples\n", " - [](reserves)\n", " - [](reserve-example)\n", " - [](reserve-market-example)\n", " - [](battery_reserves)\n", " - [](plant-reserve-strategy)\n", " \n", "\n", "## References\n", " - Opportunity-cost-pricing of reserves for a simple hydropower system {cite}`Aasgard2016a`\n", " - Operational hydropower scheduling with post-spot distribution of reserve obligations {cite}`Kong2017`\n", " - Accounting for reserve capacity activation when scheduling a hydropower dominated system {cite}`Naversen2020b`\n", " - Operational use of marginal cost curves for hydropower plants as decision support in real-time balancing markets {cite}`Skjelbred2017a`\n", " - Coordinated hydropower bidding in the day-ahead and balancing market {cite}`Aasgard2019a`\n", " - Hydropower bidding in a multi-market setting {cite}`Aasgard2019b`\n", " - The value of coordinated hydropower bidding in the Nordic day-ahead and balancing market {cite}`Aasgard2022`\n", " \n", "\n", "## Attributes" ] }, { "cell_type": "code", "execution_count": 1, "id": "22d55143", "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": "7bbd2917", "metadata": {}, "source": [ "(reserve_group:fcr_n_up_obligation)=\n", "### fcr_n_up_obligation\n", "The obligation of FCR_N_UP that should be fulfilled by the reserve group. Unit (y): MW.\n", "\n", "\n", "(reserve_group:fcr_n_down_obligation)=\n", "### fcr_n_down_obligation\n", "The obligation of FCR_N_DOWN that should be fulfilled by the reserve group. Unit (y): MW.\n", "\n", "\n", "(reserve_group:fcr_d_up_obligation)=\n", "### fcr_d_up_obligation\n", "The obligation of FCR_D_UP that should be fulfilled by the reserve group. Unit (y): MW.\n", "\n", "\n", "(reserve_group:fcr_d_down_obligation)=\n", "### fcr_d_down_obligation\n", "The obligation of FCR_D_DOWN that should be fulfilled by the reserve group. Unit (y): MW.\n", "\n", "\n", "(reserve_group:frr_up_obligation)=\n", "### frr_up_obligation\n", "The obligation of FRR_UP that should be fulfilled by the reserve group. Unit (y): MW.\n", "\n", "\n", "(reserve_group:frr_down_obligation)=\n", "### frr_down_obligation\n", "The obligation of FRR_DOWN that should be fulfilled by the reserve group. Unit (y): MW.\n", "\n", "\n", "(reserve_group:rr_up_obligation)=\n", "### rr_up_obligation\n", "The obligation of RR_UP that should be fulfilled by the reserve group. Unit (y): MW.\n", "\n", "\n", "(reserve_group:rr_down_obligation)=\n", "### rr_down_obligation\n", "The obligation of RR_DOWN that should be fulfilled by the reserve group. Unit (y): MW.\n", "\n", "\n", "(reserve_group:fcr_n_penalty_cost)=\n", "### fcr_n_penalty_cost\n", "Given penalty cost for deviating below the FCR_N_UP or FCR_N_DOWN obligation for the reserve group. Unit (y): NOK/MWH.\n", "\n", "\n", "(reserve_group:fcr_d_penalty_cost)=\n", "### fcr_d_penalty_cost\n", "Given penalty cost for deviating below the FCR_D_UP obligation for the reserve group. Unit (y): NOK/MWH.\n", "\n", "\n", "(reserve_group:frr_penalty_cost)=\n", "### frr_penalty_cost\n", "Given penalty cost for deviating below the FRR_UP or FRR_DOWN obligation for the reserve group. Unit (y): NOK/MWH.\n", "\n", "\n", "(reserve_group:rr_penalty_cost)=\n", "### rr_penalty_cost\n", "Given penalty cost for deviating below the RR_UP or RR_DOWN obligation for the reserve group. Unit (y): NOK/MWH.\n", "\n", "\n", "(reserve_group:fcr_n_up_slack)=\n", "### fcr_n_up_slack\n", "Resulting slack when deviating above the FCR_N_UP obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:fcr_n_down_slack)=\n", "### fcr_n_down_slack\n", "Resulting slack when deviating above the FCR_N_DOWN obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:fcr_d_up_slack)=\n", "### fcr_d_up_slack\n", "Resulting slack when deviating above the FCR_D_UP obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:fcr_d_down_slack)=\n", "### fcr_d_down_slack\n", "Resulting slack when deviating above the FCR_D_DOWN obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:frr_up_slack)=\n", "### frr_up_slack\n", "Resulting slack when deviating above the FRR_UP obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:frr_down_slack)=\n", "### frr_down_slack\n", "Resulting slack when deviating above the FRR_DOWN obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:rr_up_slack)=\n", "### rr_up_slack\n", "Resulting slack when deviating above the RR_UP obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:rr_down_slack)=\n", "### rr_down_slack\n", "Resulting slack when deviating above the RR_DOWN obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:fcr_n_up_violation)=\n", "### fcr_n_up_violation\n", "Resulting penalty when deviating below the FCR_N_UP obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:fcr_n_down_violation)=\n", "### fcr_n_down_violation\n", "Resulting penalty when deviating below the FCR_N_DOWN obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:fcr_d_up_violation)=\n", "### fcr_d_up_violation\n", "Resulting penalty when deviating below the FCR_D_UP obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:fcr_d_down_violation)=\n", "### fcr_d_down_violation\n", "Resulting penalty when deviating below the FCR_D_DOWN obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:frr_up_violation)=\n", "### frr_up_violation\n", "Resulting penalty when deviating below the FRR_UP obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:frr_down_violation)=\n", "### frr_down_violation\n", "Resulting penalty when deviating below the FRR_DOWN obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:rr_up_violation)=\n", "### rr_up_violation\n", "Resulting penalty when deviating below the RR_UP obligation. Unit (y): MW.\n", "\n", "\n", "(reserve_group:rr_down_violation)=\n", "### rr_down_violation\n", "Resulting penalty when deviating belown the RR_DOWN obligation. Unit (y): MW." ] } ], "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.13.9" }, "source_map": [ 11, 57, 69 ] }, "nbformat": 4, "nbformat_minor": 5 }