{ "cells": [ { "cell_type": "markdown", "metadata": { "colab_type": "text", "id": "f4rXez8ioy3l" }, "source": [ "\n", "*This notebook contains course material from [CBE40455](https://jckantor.github.io/CBE40455) by\n", "Jeffrey Kantor (jeff at nd.edu); the content is available [on Github](https://github.com/jckantor/CBE40455.git).\n", "The text is released under the [CC-BY-NC-ND-4.0 license](https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode),\n", "and code is released under the [MIT license](https://opensource.org/licenses/MIT).*" ] }, { "cell_type": "markdown", "metadata": { "colab_type": "text", "id": "XpVq9yGPoy3m" }, "source": [ "\n", "< [Jesuit Volunteer Corps](http://nbviewer.jupyter.org/github/jckantor/CBE40455/blob/master/notebooks/04.04-Jesuit-Volunteer-Corps.ipynb) | [Contents](toc.ipynb) | [Scheduling Multipurpose Batch Processes using State-Task Networks](http://nbviewer.jupyter.org/github/jckantor/CBE40455/blob/master/notebooks/04.06-Scheduling-Multipurpose-Batch-Processes-using-State-Task-Networks.ipynb) >
" ] }, { "cell_type": "markdown", "metadata": { "colab_type": "text", "id": "eh0-fke71Hno" }, "source": [ "# Unit Commitment\n", "\n", "The production of electrical power to meet the demands of a regional power grid is among the most complex and important applications of mathematical optimization. A full treatment of the problem would consider the dispatch of mulitiple generating units and storage systems and the allocation of transportation resources to meet the projected demands of users.\n", "\n", "The scope of this notebook is an elementary introduction to the models used for unit commitment and closely follows [Unit Commitment](https://yalmip.github.io/example/unitcommitment/). A more comprehensive discussion and implemenation can be found in the open source [Dispa-Set](http://www.dispaset.eu/en/latest/) package." ] }, { "cell_type": "markdown", "metadata": { "colab_type": "text", "id": "SULnfFaYpXIQ" }, "source": [ "## Install Pyomo and Solvers for Google Colaboratory" ] }, { "cell_type": "markdown", "metadata": { "colab_type": "text", "id": "4AAkdrrjrfdC" }, "source": [ "### Install and Import Pyomo" ] }, { "cell_type": "code", "execution_count": 0, "metadata": { "colab": {}, "colab_type": "code", "id": "owz_lt6S-uAH" }, "outputs": [], "source": [ "!pip install -q pyomo\n", "import pyomo.environ as pyo" ] }, { "cell_type": "markdown", "metadata": { "colab_type": "text", "id": "j7ABANpRpktv" }, "source": [ "### Install COIN-OR BONMIN and Create Solver" ] }, { "cell_type": "code", "execution_count": 0, "metadata": { "colab": {}, "colab_type": "code", "id": "Vs8V6FbgdyK2" }, "outputs": [], "source": [ "!wget -N -q \"https://ampl.com/dl/open/bonmin/bonmin-linux64.zip\"\n", "!unzip -o -q bonmin-linux64\n", "bonmin = pyo.SolverFactory('bonmin', executable='/content/bonmin')" ] }, { "cell_type": "markdown", "metadata": { "colab_type": "text", "id": "axFsSMlQp1qS" }, "source": [ "## Unit Specifications" ] }, { "cell_type": "code", "execution_count": 0, "metadata": { "colab": { "base_uri": "https://localhost:8080/", "height": 295 }, "colab_type": "code", "executionInfo": { "elapsed": 6631, "status": "ok", "timestamp": 1557426367466, "user": { "displayName": "Jeffrey Kantor", "photoUrl": "https://lh5.googleusercontent.com/-8zK5aAW5RMQ/AAAAAAAAAAI/AAAAAAAAKB0/kssUQyz8DTQ/s64/photo.jpg", "userId": "09038942003589296665" }, "user_tz": 240 }, "id": "b6Ur0rQC0_1q", "outputId": "51854313-74eb-490f-d7cf-932c9d90e6cd" }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "