{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "0e26dd23",
   "metadata": {},
   "source": [
    "(unit_combination)=\n",
    "# unit_combination\n",
    "A set of spinning units in a plant. Generated by SHOP when best profit curves are calculated and used to provide marginal- and average cost curves.\n",
    "\n",
    "|   |   |\n",
    "|---|---|\n",
    "|Input connections||\n",
    "|Output connections||\n",
    "|License|SHOP_OPEN|\n",
    "|Release version|13.0.0.a|\n",
    "\n",
    "```{contents}\n",
    ":local:\n",
    ":depth: 1\n",
    "```\n",
    "\n",
    "## Introduction\n",
    "\n",
    "The unit_combination objects are automatically generated by SHOP when the [create bp_curves](create_bp_curves) command is executed to calculate [best profit curves](best-profit). Each unit_combination represents a set of [generators](generator) that are running at the same time in a specific [](plant). The unit_combinations are also automatically connected to the plant object. The purpose of this object is to hold information about the marginal and average costs of operating the specific combination of units, which is used to create the [best profit curves](plant:best_profit_mc) of the plant. See the best profit tutorial and example linked below for further details.\n",
    "\n",
    "Note that this is an output object which cannot be created (or connected to any objects) by the user.\n",
    "\n",
    "## Examples\n",
    "  - [](best-profit)\n",
    "  - [](best-profit-basic-example)\n",
    "  \n",
    "\n",
    "\n",
    "\n",
    "## Attributes"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "519a73fe",
   "metadata": {
    "tags": [
     "remove-input",
     "full-width"
    ]
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<table id=\"unit_combination-table\" class=\"display compact\"></table>\n",
       "<script>\n",
       "enableDataTable(\n",
       "  \"#unit_combination-table\",\n",
       "  \"/_static/data/unit_combination-attribute-table.json\"\n",
       ");\n",
       "</script>\n"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "execution_count": 1,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "from IPython.core.display import HTML\n",
    "HTML(\"\"\"<table id=\"unit_combination-table\" class=\"display compact\"></table>\n",
    "<script>\n",
    "enableDataTable(\n",
    "  \"#unit_combination-table\",\n",
    "  \"/_static/data/unit_combination-attribute-table.json\"\n",
    ");\n",
    "</script>\n",
    "\"\"\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "74e5c8a5",
   "metadata": {},
   "source": [
    "(unit_combination:discharge)=\n",
    "### discharge\n",
    "Discharge for a combination of generators corresponding to a certain production level of the unit combination. The result is generated by the best_profit module. (xUnit: MW, yUnit: M3/S)\n",
    "\n",
    "\n",
    "(unit_combination:marginal_cost)=\n",
    "### marginal_cost\n",
    "Marginal production cost for a combination of generators corresponding to a certain production level of the unit combination. The result is generated by the best_profit module. (xUnit: MW, yUnit: NOK/MW)\n",
    "\n",
    "\n",
    "(unit_combination:average_cost)=\n",
    "### average_cost\n",
    "Average production cost for a combination of generators corresponding to a certain production level of the unit combination. The result is generated by the best_profit module. (xUnit: MW, yUnit: NOK/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.12.9"
  },
  "source_map": [
   11,
   43,
   55
  ]
 },
 "nbformat": 4,
 "nbformat_minor": 5
}