From 0a4d4433d8f7f9c5c5fefc8ebe3591a292f15e1c Mon Sep 17 00:00:00 2001 From: FRICKO Oliver Date: Thu, 18 Mar 2021 13:31:18 +0100 Subject: [PATCH 01/15] initial addition of tutorial to demonstrate building a scenario using xlsx files --- tutorial/westeros/westeroes_baseline.xlsx | Bin 0 -> 39212 bytes .../westeros/westeroes_baseline_demand.xlsx | Bin 0 -> 9550 bytes .../westeroes_baseline_technology_basic.xlsx | Bin 0 -> 16519 bytes ...teroes_baseline_technology_constraint.xlsx | Bin 0 -> 9559 bytes ...esteroes_baseline_technology_economic.xlsx | Bin 0 -> 12119 bytes ...esteroes_baseline_technology_historic.xlsx | Bin 0 -> 10271 bytes .../westeros_baseline_using_xlsx_import.ipynb | 704 ++++++++++++++++++ 7 files changed, 704 insertions(+) create mode 100644 tutorial/westeros/westeroes_baseline.xlsx create mode 100644 tutorial/westeros/westeroes_baseline_demand.xlsx create mode 100644 tutorial/westeros/westeroes_baseline_technology_basic.xlsx create mode 100644 tutorial/westeros/westeroes_baseline_technology_constraint.xlsx create mode 100644 tutorial/westeros/westeroes_baseline_technology_economic.xlsx create mode 100644 tutorial/westeros/westeroes_baseline_technology_historic.xlsx create mode 100644 tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb diff --git a/tutorial/westeros/westeroes_baseline.xlsx b/tutorial/westeros/westeroes_baseline.xlsx new file mode 100644 index 0000000000000000000000000000000000000000..1abb4de0fbbb9db11207643464454c3266be94da GIT binary patch literal 39212 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 U$>Ue9NC1Bx1KD?2$ob#?Ki9LwZvX%Q literal 0 HcmV?d00001 diff --git a/tutorial/westeros/westeroes_baseline_demand.xlsx b/tutorial/westeros/westeroes_baseline_demand.xlsx new file mode 100644 index 0000000000000000000000000000000000000000..b182b55c2a4671232f9fe3e25ca89b42b174870c GIT binary patch literal 9550 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 literal 0 HcmV?d00001 diff --git a/tutorial/westeros/westeroes_baseline_technology_basic.xlsx b/tutorial/westeros/westeroes_baseline_technology_basic.xlsx new file mode 100644 index 0000000000000000000000000000000000000000..d54f6ee49e727542faf61aec3b4d25b28ec12afa GIT binary patch literal 16519 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 Xq6{R^0)MrI01z@@msyVY*U|q2Gdo>s literal 0 HcmV?d00001 diff --git a/tutorial/westeros/westeroes_baseline_technology_constraint.xlsx b/tutorial/westeros/westeroes_baseline_technology_constraint.xlsx new file mode 100644 index 0000000000000000000000000000000000000000..10e3dee68dc5b232d1ea7067df319093e2554550 GIT binary patch literal 9559 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 literal 0 HcmV?d00001 diff --git a/tutorial/westeros/westeroes_baseline_technology_historic.xlsx b/tutorial/westeros/westeroes_baseline_technology_historic.xlsx new file mode 100644 index 0000000000000000000000000000000000000000..3fd434053f8790017bed7f22c808311ecb837438 GIT binary patch literal 10271 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

m+ZjYfT$cv&f1TD7HO7=q!aQt~i{>Ag;1WPX9 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 literal 0 HcmV?d00001 diff --git a/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb b/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb new file mode 100644 index 000000000..f9dfb7fe6 --- /dev/null +++ b/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb @@ -0,0 +1,704 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "# Westeros Tutorial Part 1.X - Building the Westeros Baseline using xlsx input data" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "## Scope of this tutorial: Building a Simple Energy Model using xlsx data\n", + "\n", + "This tutorial explains how the Westeros Baseline scenario can be built using data retrieved from xlsx files.\n", + "\n", + "The tutorial is split into two parts.\n", + "\n", + "The first part will create a scenario and basic parameters will be added including the modeling time-horizon, the discount rate. This code is a repetition of that used in the tutorial XXXXX\n", + "\n", + "The sceond part will then import various xlsx files to add technologies, demands and constraints to the model." + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "## Online documentation\n", + "\n", + "The full framework documentation is available at [https://docs.messageix.org](https://docs.messageix.org)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Step 1. Setting up the scenario" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "## Ready, steady, go!\n", + "\n", + "First, we import all the packages we need. We import a utility function called *make_df*, which can be used to wrap the input data into dataframes that can be saved in model parameters." + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [ + { + "data": { + "application/javascript": [ + "IPython.OutputArea.prototype._should_scroll = function(lines) { return false; }" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + }, + { + "name": "stderr", + "output_type": "stream", + "text": [ + "pyam - INFO: Running in a notebook, setting `pyam` logging level to `logging.INFO` and adding stderr handler\n" + ] + } + ], + "source": [ + "import pandas as pd\n", + "import ixmp\n", + "import message_ix\n", + "\n", + "from message_ix.utils import make_df\n", + "\n", + "%matplotlib inline" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "mp = ixmp.Platform()" + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "scenario = message_ix.Scenario(mp, model='Westeros Electrified', \n", + " scenario='baseline_xlsx', version='new')" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "## Model Structure\n", + "\n", + "We start by defining basic characteristics of the model, including time, space, and the energy system structure." + ] + }, + { + "cell_type": "code", + "execution_count": 17, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "history = [690]\n", + "model_horizon = [700, 710, 720]\n", + "scenario.add_horizon(\n", + " year=history + model_horizon,\n", + " firstmodelyear=model_horizon[0]\n", + ")" + ] + }, + { + "cell_type": "code", + "execution_count": 18, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "country = 'Westeros'\n", + "scenario.add_spatial_sets({'country': country})" + ] + }, + { + "cell_type": "code", + "execution_count": 19, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "scenario.add_set(\"commodity\", [\"electricity\", \"light\"])\n", + "scenario.add_set(\"level\", [\"secondary\", \"final\", \"useful\"])\n", + "#scenario.add_set(\"technology\", ['coal_ppl', 'wind_ppl', 'grid', 'bulb'])\n", + "#scenario.add_set(\"mode\", \"standard\")" + ] + }, + { + "cell_type": "code", + "execution_count": 20, + "metadata": {}, + "outputs": [], + "source": [ + "scenario.add_par(\"interestrate\", model_horizon, value=0.05, unit='-')" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Important: Note that the data has not yet been commited. This is because at a minimum, the set technology needs to be defined otherwise an error message will be raised when commiting the scenario. Hence, we will continue in this tutorial adding data, step-by-step, making a single commit priior to solving." + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "## Supply and Demand (or Balancing Commodities)" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "source": [ + "Instead of using the add_par for adding data to a MESSAGEix parameter, we will import data from a xlsx file. Because the scenario has not been commited, data is also imported without commiting individual steps." + ] + }, + { + "cell_type": "code", + "execution_count": 21, + "metadata": {}, + "outputs": [], + "source": [ + "scenario.read_excel(\"westeroes_baseline_demand.xlsx\", add_units=True, commit_steps=False)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Open the above indicated xlsx file and browse its contents. You will find that it includes two sheets. A sheet `demand` which contains the based on the index structure of the parameters `demand`" + ] + }, + { + "cell_type": "code", + "execution_count": 22, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "['node', 'commodity', 'level', 'year', 'time']\n" + ] + } + ], + "source": [ + "print(scenario.idx_names('demand'))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In addition, numerical values have been added under the index-name `value` and the units have been specified under the index-name 'unit'" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Adding technologies\n", + "The following sheets are distinguished in the data input file. The naming convention is analogue to the set or parameter to which the data contained within refers to. The exception is the last sheet, which is used by the importer data is used to populate sets or parameters. This is important as first sets will need to be populated, to allow the import of parameters.\n", + "a. `mode`\n", + "b. `technology`\n", + "c. `capacity_factor`\n", + "d. `input`\n", + "e. `output`\n", + "f. `technical_lifetime`\n", + "g. `ix_type_mapping`" + ] + }, + { + "cell_type": "code", + "execution_count": 23, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "scenario.read_excel(\"westeroes_baseline_technology_basic.xlsx\", add_units=True, commit_steps=False)" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "## Technological Diffusion and Contraction" + ] + }, + { + "cell_type": "code", + "execution_count": 24, + "metadata": {}, + "outputs": [], + "source": [ + "scenario.read_excel(\"westeroes_baseline_technology_constraint.xlsx\", add_units=True, commit_steps=False)" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "## Defining an Energy Mix (Model Calibration)" + ] + }, + { + "cell_type": "code", + "execution_count": 25, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "scenario.read_excel(\"westeroes_baseline_technology_historic.xlsx\", add_units=True, commit_steps=False)" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "### Investment, Fixed O&M and Varaible O&M Costs" + ] + }, + { + "cell_type": "code", + "execution_count": 26, + "metadata": {}, + "outputs": [], + "source": [ + "scenario.read_excel(\"westeroes_baseline_technology_economic.xlsx\", add_units=True, commit_steps=False)" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "## Time to Solve the Model\n", + "\n", + "First, we *commit* the model structure and input data (sets and parameters).\n", + "In the `ixmp` backend, this creates a new model version in the database, which is assigned a version number automatically:" + ] + }, + { + "cell_type": "code", + "execution_count": 28, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "scenario.set_as_default()" + ] + }, + { + "cell_type": "code", + "execution_count": 29, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "scenario.solve()" + ] + }, + { + "cell_type": "code", + "execution_count": 30, + "metadata": { + "jupyter": { + "name": "solve-objective-value" + }, + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [ + { + "data": { + "text/plain": [ + "369297.75" + ] + }, + "execution_count": 30, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "scenario.var('OBJ')['lvl']" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "## Plotting Results\n", + "\n", + "Analyzing the results of a scenario after it is solved is called **reporting**.\n", + "MESSAGE*ix* includes flexible and customizable message_ix/tutorial for reporting, but here we wish to focus on the results of our example scenario.\n", + "We use some custom code to set up some simple plots:" + ] + }, + { + "cell_type": "code", + "execution_count": 31, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "# Create a Reporter object to describe and carry out reporting\n", + "# calculations and operations (like plotting) based on `scenario`\n", + "from message_ix.reporting import Reporter\n", + "\n", + "rep = Reporter.from_scenario(scenario)\n", + "\n", + "# Add keys like \"plot activity\" to describe reporting operations.\n", + "# See tutorial/utils/plotting.py\n", + "from message_ix.util.tutorial import prepare_plots\n", + "\n", + "prepare_plots(rep)" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "Now the object `rep` is ready to generate several plots.\n", + "\n", + "(For a detailed introduction to how the `Reporter` works, see `westeros_report.ipynb`.)\n", + "\n", + "### Activity\n", + "\n", + "How much energy is generated in each time period from the different potential sources?" + ] + }, + { + "cell_type": "code", + "execution_count": 32, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [ + { + "data": { + "text/plain": [ + "" + ] + }, + "execution_count": 32, + "metadata": {}, + "output_type": "execute_result" + }, + { + "data": { + "image/png": "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HDxo0KDBp5566r6vv/56p89//vMDBw4cOPjzn//8wMWLF3cCmD59eo/PfOYznz7wwAMHjxw5cuDy5cubtYd27NixJWecccbew4cPH1RSUjJkxowZPSAZCR9zzDH7jx49ekBJScmQiRMn9mmt19TsXceSdicZae5c25aeWVyviBhfT/NtDfSdCcxsbi1mZrbjKSsr2/naa6/t8+yzz77Wp0+f6tWrV3cYP378vmecccbaiy++eO3111+/54UXXtj/scceW3rcccdtGDdu3GtFRUVMnjy551VXXdX7lltuWdGc7SxfvrzznDlzyhctWtT52GOPHTRmzJhXAObPn9/1lVdeWditW7eaYcOGDR4zZsx7RxxxxAdNra8pzQpaSecCl5J8HWcecBjJaPXo7S3AzMwM4JFHHtn1lFNOWdenT59qgF69em196aWXuj788MNLAS688MJ3r7zyyn4Ab775ZqdTTz21X1VV1U5btmwp6t+//+bmbmfs2LHvdujQgYMPPnhz//79N8+bN29ngFGjRr3fu3fvrQAnn3zyuscff7xbawRtc3cdXwp8DngrIo4ChgH+bo2ZmbWaiEBSs75idNFFF+397W9/e83rr7++aMqUKW9t3ry52YdCJdU73VD79mpuYZsiYlO64c4R8RowqFUqMDMzA0444YT3H3zwwT1WrVrVAWD16tUdhg0btvHWW2/dHeA3v/nNHqWlpRsA1q9f32Hvvff+O8DUqVP33Jbt3Hfffbtv3bqVhQsXdl6+fHnnQw45ZBPAU089tevq1as7bNiwQbNmzdrtyCOP3NAar6u5x2hXSNoN+D3JiUzrgJWtUYCZmbU9+fo6Tq7S0tJNEydOrBw9evSni4qKYsiQIR/cdNNNyyZMmFDyy1/+sveee+5ZPW3atAqAK664YuX48eP379Wr15bS0tKNy5Yt69zc7RxwwAGbR4wYMWjt2rU7XX/99W916dIl0u1vOP300/etqKjYeezYsWtbY7cxNBG0koYCL0fEl9OmSZL+CvQA/tgaBZiZmdW6+OKL11588cVrc9uee+651+v2O/PMM/925pln/q1u+yWXXLIWWFu3PdeoUaM23Hbbbcvrtvfs2bO6vu/fbs93aKHpEe2tJJdGfBF4GniG5M4672/PRs3MzD4pGg3aiCiV1AUYAYwELgHulLQKeDoivp2HGs3MzLbJ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\n", + "text/plain": [ + "

" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "# Only show a subset of technologies in the follow plots;\n", + "# e.g. exclude \"bulb\" and \"grid\"\n", + "rep.set_filters(t=[\"coal_ppl\", \"wind_ppl\"])\n", + "\n", + "# Trigger the calculation and plotting\n", + "rep.get(\"plot activity\")" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "### Capacity\n", + "\n", + "How much capacity of each plant is installed in each period?" + ] + }, + { + "cell_type": "code", + "execution_count": 33, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [ + { + "data": { + "text/plain": [ + "" + ] + }, + "execution_count": 33, + "metadata": {}, + "output_type": "execute_result" + }, + { + "data": { + "image/png": "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lTQNmAkMkLRC0gUkZyF3Ax6RNEfST9LZPwbMlfQX4BfARRHxRoMrNjOzXdakSZP279+//8ABAwYMPPPMMw9+6aWXOn70ox/t379//4Ef/ehH+y9evLgjwNSpU/f+4Ac/ePgRRxwxcPjw4f2XL1++XXtoR40aVXHOOeccNHTo0AEVFRWDpk2btjckPeGTTjrp0GOPPbZfRUXFoPHjx/dqreeU267jiBjTQPPtjcw7HZieVy1mZtb2VVVV7fH973+/18yZM1/s1atX7Zo1a9qNGTPm4HPOOWfdpZdeuu6GG27Y/+KLL+776KOPLj3llFM2jh49+sWysjImTpzY/Zprrul56623rtie7SxfvrzTrFmzFi1YsKDTySefPGDkyJEvAMydO7fLCy+8ML9r167bhgwZMnDkyJFvfexjH9vc3PqaU/BjtGZmZg156KGH9jrjjDPW9+rVqxagR48eW59//vkuDz744FKAiy+++I1vfetbfQBeeeWVjmeeeWafmpqaDu+9915Z3759t2zvdkaNGvVGu3btOOqoo7b07dt3y5w5c/YAGDFixNs9e/bcCnD66aevf+yxx7q2RtD66h9mZtYmRASStusnRpdccslBX/rSl9a+9NJLCyZNmvTqli1btjvPJDU43lj7zmqyMEmD1VpbMjMza8Kpp5769v3337/f6tWr2wGsWbOm3ZAhQzbddttt+wL89Kc/3a+ysnIjwIYNG9oddNBBfwWYPHny/juynV/+8pf7bt26lfnz53davnx5p6OPPvpdgCeffHKvNWvWtNu4caMeeOCBfY477riNrfG8mtt1fBvJhSSeA54Cnia5DvHbrbFxMzNrmwr1c5ysysrKd8ePH7/q2GOPPbysrCwGDRq0+eabb142duzYih/96Ec9999//9opU6ZUA1x99dUrx4wZc2iPHj3eq6ys3LRs2bJO27udww47bMuwYcMGrFu3rsMNN9zwaufOnSPd/sazzz774Orq6j1GjRq1rjV2G0MzQRsRlZI6A8OA4cBlwM8krQaeiogvtUYRZmZmAJdeeum6Sy+9dF227Zlnnnmp/nznnnvum+eee+6b9dsvu+yydcC6+u1ZI0aM2Hj77bcvr9/evXv32oZ+f7szv6GF7TgZKv2962OS/gw8CxwDfA44dWc2bGZmtjtoMmglnUPSkx1McuWmurAdERGrc6/O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\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "# Create a different plot. The same filters are still active.\n", + "rep.get(\"plot capacity\")" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "### Electricity Price\n", + "\n", + "And how much does the electricity cost? These prices are in fact **shadow prices** taken from the **dual variables** of the model solution.\n", + "They reflect the marginal cost of electricity generation (i.e., the additional cost of the system for supplying one more unit of\n", + "electricity), which is in fact the marginal cost of the most expensive operating generator. \n", + "\n", + "Note the price drop when the most expensive technology is no longer in the system." + ] + }, + { + "cell_type": "code", + "execution_count": 34, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [ + { + "data": { + "text/plain": [ + "" + ] + }, + "execution_count": 34, + "metadata": {}, + "output_type": "execute_result" + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "# Replace the technology filters with a commodity filter;\n", + "# show only \"light\" and not e.g. \"electricity\".\n", + "rep.set_filters(c=[\"light\"])\n", + "\n", + "# Create a price plot\n", + "rep.get(\"plot prices\")" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Close the connection to the database\n", + "\n", + "When working with local HSQLDB database instances, you cannot connect to one database from multipe Jupyter notebooks (or processes) at the same time.\n", + "\n", + "If you want to easily switch between notebooks with connections to the same `ixmp` database, you need to close the connection in one notebook before initializing the platform using `ixmp.Platform()` in another notebook.\n", + "\n", + "After having closed the database connection, you can reopen it using\n", + "```\n", + "mp.open_db()\n", + "```" + ] + }, + { + "cell_type": "code", + "execution_count": 35, + "metadata": { + "slideshow": { + "slide_type": "skip" + } + }, + "outputs": [], + "source": [ + "mp.close_db()" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "## Congratulations! \n", + "\n", + "You have built and run your very first *MESSAGEix* model. Welcome to the community!\n", + "\n", + "The next tutorials will introduce you to other features of the framework, including energy system constraints, emissions taxes, and other policy options.\n", + "\n", + "Check us out on Github https://github.com/iiasa/message_ix \n", + "and get in touch with us online https://groups.google.com/forum/message-ix ..." + ] + } + ], + "metadata": { + "anaconda-cloud": {}, + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "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.7.9" + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} From 745e3d21b11c79d3b72664cf9a6b61d15c380590 Mon Sep 17 00:00:00 2001 From: FRICKO Oliver Date: Thu, 18 Mar 2021 13:32:13 +0100 Subject: [PATCH 02/15] removed source xlsx containing entire scenario data --- tutorial/westeros/westeroes_baseline.xlsx | Bin 39212 -> 0 bytes 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 tutorial/westeros/westeroes_baseline.xlsx diff --git a/tutorial/westeros/westeroes_baseline.xlsx b/tutorial/westeros/westeroes_baseline.xlsx deleted file mode 100644 index 1abb4de0fbbb9db11207643464454c3266be94da..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 39212 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 U$>Ue9NC1Bx1KD?2$ob#?Ki9LwZvX%Q From 392c9490c27b08e93777d9ee160eee784fdf0e5a Mon Sep 17 00:00:00 2001 From: FRICKO Oliver Date: Thu, 18 Mar 2021 14:46:48 +0100 Subject: [PATCH 03/15] updated description of steps carried out in tutorial --- .../westeros_baseline_using_xlsx_import.ipynb | 214 +++++------------- 1 file changed, 56 insertions(+), 158 deletions(-) diff --git a/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb b/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb index f9dfb7fe6..685b693da 100644 --- a/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb +++ b/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb @@ -25,7 +25,7 @@ "\n", "The tutorial is split into two parts.\n", "\n", - "The first part will create a scenario and basic parameters will be added including the modeling time-horizon, the discount rate. This code is a repetition of that used in the tutorial XXXXX\n", + "The first part will create a scenario and basic parameters will be added including the modeling time-horizon, the discount rate. This code is a repetition of that used in the tutorial `westeros_baseline.ipynb`\n", "\n", "The sceond part will then import various xlsx files to add technologies, demands and constraints to the model." ] @@ -65,33 +65,13 @@ }, { "cell_type": "code", - "execution_count": 1, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" } }, - "outputs": [ - { - "data": { - "application/javascript": [ - "IPython.OutputArea.prototype._should_scroll = function(lines) { return false; }" - ], - "text/plain": [ - "" - ] - }, - "metadata": {}, - "output_type": "display_data" - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "pyam - INFO: Running in a notebook, setting `pyam` logging level to `logging.INFO` and adding stderr handler\n" - ] - } - ], + "outputs": [], "source": [ "import pandas as pd\n", "import ixmp\n", @@ -104,7 +84,7 @@ }, { "cell_type": "code", - "execution_count": 2, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" @@ -117,7 +97,7 @@ }, { "cell_type": "code", - "execution_count": 16, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" @@ -139,12 +119,12 @@ "source": [ "## Model Structure\n", "\n", - "We start by defining basic characteristics of the model, including time, space, and the energy system structure." + "We start by defining basic characteristics of the model, including time, space, and the energy system structure. We will also be defining the interest rate earlier in on in the process of creating the baseline scenario, so as to allow us to focus on importing data in the second part of the tutorial." ] }, { "cell_type": "code", - "execution_count": 17, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" @@ -162,7 +142,7 @@ }, { "cell_type": "code", - "execution_count": 18, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" @@ -174,9 +154,16 @@ "scenario.add_spatial_sets({'country': country})" ] }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Contrary to the original tutorial for building the Westros tutorial, we will only define the commodities and levels in the next step. Note that we originally also populated the set `technology` and `mode`, which we will address in the second half of the tutorial." + ] + }, { "cell_type": "code", - "execution_count": 19, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" @@ -185,14 +172,12 @@ "outputs": [], "source": [ "scenario.add_set(\"commodity\", [\"electricity\", \"light\"])\n", - "scenario.add_set(\"level\", [\"secondary\", \"final\", \"useful\"])\n", - "#scenario.add_set(\"technology\", ['coal_ppl', 'wind_ppl', 'grid', 'bulb'])\n", - "#scenario.add_set(\"mode\", \"standard\")" + "scenario.add_set(\"level\", [\"secondary\", \"final\", \"useful\"])" ] }, { "cell_type": "code", - "execution_count": 20, + "execution_count": null, "metadata": {}, "outputs": [], "source": [ @@ -203,7 +188,7 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "### Important: Note that the data has not yet been commited. This is because at a minimum, the set technology needs to be defined otherwise an error message will be raised when commiting the scenario. Hence, we will continue in this tutorial adding data, step-by-step, making a single commit priior to solving." + "Note that the data has not yet been commited. This is because at a minimum, the set technology needs to be defined otherwise an error message will be raised when commiting the scenario. Hence, we will continue in this tutorial by adding data, step-by-step, in the process of which commits are automatically made." ] }, { @@ -225,12 +210,12 @@ } }, "source": [ - "Instead of using the add_par for adding data to a MESSAGEix parameter, we will import data from a xlsx file. Because the scenario has not been commited, data is also imported without commiting individual steps." + "Instead of using the add_par for adding data to a MESSAGEix parameter, we will import data from a xlsx file. The arguments `add_units` has been set to `True`, so that any units which have not yet been defined will be defined automatically." ] }, { "cell_type": "code", - "execution_count": 21, + "execution_count": null, "metadata": {}, "outputs": [], "source": [ @@ -241,22 +226,14 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "Open the above indicated xlsx file and browse its contents. You will find that it includes two sheets. A sheet `demand` which contains the based on the index structure of the parameters `demand`" + "Open the above indicated xlsx (\"westeroes_baseline_demand.xlsx\") file and browse its contents. You will find that it includes two sheets. A sheet `demand` which contains the based on the index structure of the parameters `demand`." ] }, { "cell_type": "code", - "execution_count": 22, + "execution_count": null, "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "['node', 'commodity', 'level', 'year', 'time']\n" - ] - } - ], + "outputs": [], "source": [ "print(scenario.idx_names('demand'))" ] @@ -265,27 +242,30 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "In addition, numerical values have been added under the index-name `value` and the units have been specified under the index-name 'unit'" + "In addition, numerical values have been added under the index-name `value` and the units have been specified under the index-name `unit`. These two index names are used for adding numerical values and units across all parameters." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ - "### Adding technologies\n", - "The following sheets are distinguished in the data input file. The naming convention is analogue to the set or parameter to which the data contained within refers to. The exception is the last sheet, which is used by the importer data is used to populate sets or parameters. This is important as first sets will need to be populated, to allow the import of parameters.\n", - "a. `mode`\n", - "b. `technology`\n", - "c. `capacity_factor`\n", - "d. `input`\n", - "e. `output`\n", - "f. `technical_lifetime`\n", - "g. `ix_type_mapping`" + "## Adding technologies\n", + "The following sheets are distinguished in the data input file for the next step (\"westeroes_baseline_technology_basic.xlsx\"), which adds a basic configuration for technologies.\n", + "```\n", + "a. mode\n", + "b. technology\n", + "c. capacity_factor\n", + "d. input\n", + "e. output\n", + "f. technical_lifetime\n", + "g. ix_type_mapping\n", + "```\n", + "The naming convention of the sheets is analogue to the set or parameter to which the data contained within refers to. The exception is the last sheet (\"ix_type_mapping\"), which is used by the importer to distinguish which sheets are populate sets or parameters. This is important as first sets will need to be populated, to allow the import of parameters. The sets must include all unique entries in the parameters, otherwise if data in the sheet `capacity_factor` is defined for a technology which is not listed in the sheet `technology`, an error will be raised." ] }, { "cell_type": "code", - "execution_count": 23, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" @@ -304,12 +284,13 @@ } }, "source": [ - "## Technological Diffusion and Contraction" + "## Technological Diffusion and Contraction\n", + "As we have already undertaken an initial definition of technologies, and will now proceed to add additional parameters for already defined technologies, the input data file (\"westeroes_baseline_technology_constraint.xlsx\") does not contain and sheets relating to sets." ] }, { "cell_type": "code", - "execution_count": 24, + "execution_count": null, "metadata": {}, "outputs": [], "source": [ @@ -329,7 +310,7 @@ }, { "cell_type": "code", - "execution_count": 25, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" @@ -353,7 +334,7 @@ }, { "cell_type": "code", - "execution_count": 26, + "execution_count": null, "metadata": {}, "outputs": [], "source": [ @@ -368,15 +349,12 @@ } }, "source": [ - "## Time to Solve the Model\n", - "\n", - "First, we *commit* the model structure and input data (sets and parameters).\n", - "In the `ixmp` backend, this creates a new model version in the database, which is assigned a version number automatically:" + "## Time to Solve the Model" ] }, { "cell_type": "code", - "execution_count": 28, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" @@ -389,7 +367,7 @@ }, { "cell_type": "code", - "execution_count": 29, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" @@ -402,7 +380,7 @@ }, { "cell_type": "code", - "execution_count": 30, + "execution_count": null, "metadata": { "jupyter": { "name": "solve-objective-value" @@ -411,18 +389,7 @@ "slide_type": "fragment" } }, - "outputs": [ - { - "data": { - "text/plain": [ - "369297.75" - ] - }, - "execution_count": 30, - "metadata": {}, - "output_type": "execute_result" - } - ], + "outputs": [], "source": [ "scenario.var('OBJ')['lvl']" ] @@ -444,7 +411,7 @@ }, { "cell_type": "code", - "execution_count": 31, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" @@ -484,36 +451,13 @@ }, { "cell_type": "code", - "execution_count": 32, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" } }, - "outputs": [ - { - "data": { - "text/plain": [ - "" - ] - }, - "execution_count": 32, - "metadata": {}, - "output_type": "execute_result" - }, - { - "data": { - "image/png": "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HDxo0KDBp5566r6vv/56p89//vMDBw4cOPjzn//8wMWLF3cCmD59eo/PfOYznz7wwAMHjxw5cuDy5cubtYd27NixJWecccbew4cPH1RSUjJkxowZPSAZCR9zzDH7jx49ekBJScmQiRMn9mmt19TsXceSdicZae5c25aeWVyviBhfT/NtDfSdCcxsbi1mZrbjKSsr2/naa6/t8+yzz77Wp0+f6tWrV3cYP378vmecccbaiy++eO3111+/54UXXtj/scceW3rcccdtGDdu3GtFRUVMnjy551VXXdX7lltuWdGc7SxfvrzznDlzyhctWtT52GOPHTRmzJhXAObPn9/1lVdeWditW7eaYcOGDR4zZsx7RxxxxAdNra8pzQpaSecCl5J8HWcecBjJaPXo7S3AzMwM4JFHHtn1lFNOWdenT59qgF69em196aWXuj788MNLAS688MJ3r7zyyn4Ab775ZqdTTz21X1VV1U5btmwp6t+//+bmbmfs2LHvdujQgYMPPnhz//79N8+bN29ngFGjRr3fu3fvrQAnn3zyuscff7xbawRtc3cdXwp8DngrIo4ChgH+bo2ZmbWaiEBSs75idNFFF+397W9/e83rr7++aMqUKW9t3ry52YdCJdU73VD79mpuYZsiYlO64c4R8RowqFUqMDMzA0444YT3H3zwwT1WrVrVAWD16tUdhg0btvHWW2/dHeA3v/nNHqWlpRsA1q9f32Hvvff+O8DUqVP33Jbt3Hfffbtv3bqVhQsXdl6+fHnnQw45ZBPAU089tevq1as7bNiwQbNmzdrtyCOP3NAar6u5x2hXSNoN+D3JiUzrgJWtUYCZmbU9+fo6Tq7S0tJNEydOrBw9evSni4qKYsiQIR/cdNNNyyZMmFDyy1/+sveee+5ZPW3atAqAK664YuX48eP379Wr15bS0tKNy5Yt69zc7RxwwAGbR4wYMWjt2rU7XX/99W916dIl0u1vOP300/etqKjYeezYsWtbY7cxNBG0koYCL0fEl9OmSZL+CvQA/tgaBZiZmdW6+OKL11588cVrc9uee+651+v2O/PMM/925pln/q1u+yWXXLIWWFu3PdeoUaM23Hbbbcvrtvfs2bO6vu/fbs93aKHpEe2tJJdGfBF4GniG5M4672/PRs3MzD4pGg3aiCiV1AUYAYwELgHulLQKeDoivp2HGs3MzLbJ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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "needs_background": "light" - }, - "output_type": "display_data" - } - ], + "outputs": [], "source": [ "# Only show a subset of technologies in the follow plots;\n", "# e.g. exclude \"bulb\" and \"grid\"\n", @@ -538,36 +482,13 @@ }, { "cell_type": "code", - "execution_count": 33, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" } }, - "outputs": [ - { - "data": { - "text/plain": [ - "" - ] - }, - "execution_count": 33, - "metadata": {}, - "output_type": "execute_result" - }, - { - "data": { - "image/png": "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lTQNmAkMkLRC0gUkZyF3Ax6RNEfST9LZPwbMlfQX4BfARRHxRoMrNjOzXdakSZP279+//8ABAwYMPPPMMw9+6aWXOn70ox/t379//4Ef/ehH+y9evLgjwNSpU/f+4Ac/ePgRRxwxcPjw4f2XL1++XXtoR40aVXHOOeccNHTo0AEVFRWDpk2btjckPeGTTjrp0GOPPbZfRUXFoPHjx/dqreeU267jiBjTQPPtjcw7HZieVy1mZtb2VVVV7fH973+/18yZM1/s1atX7Zo1a9qNGTPm4HPOOWfdpZdeuu6GG27Y/+KLL+776KOPLj3llFM2jh49+sWysjImTpzY/Zprrul56623rtie7SxfvrzTrFmzFi1YsKDTySefPGDkyJEvAMydO7fLCy+8ML9r167bhgwZMnDkyJFvfexjH9vc3PqaU/BjtGZmZg156KGH9jrjjDPW9+rVqxagR48eW59//vkuDz744FKAiy+++I1vfetbfQBeeeWVjmeeeWafmpqaDu+9915Z3759t2zvdkaNGvVGu3btOOqoo7b07dt3y5w5c/YAGDFixNs9e/bcCnD66aevf+yxx7q2RtD66h9mZtYmRASStusnRpdccslBX/rSl9a+9NJLCyZNmvTqli1btjvPJDU43lj7zmqyMEmD1VpbMjMza8Kpp5769v3337/f6tWr2wGsWbOm3ZAhQzbddttt+wL89Kc/3a+ysnIjwIYNG9oddNBBfwWYPHny/juynV/+8pf7bt26lfnz53davnx5p6OPPvpdgCeffHKvNWvWtNu4caMeeOCBfY477riNrfG8mtt1fBvJhSSeA54Cnia5DvHbrbFxMzNrmwr1c5ysysrKd8ePH7/q2GOPPbysrCwGDRq0+eabb142duzYih/96Ec9999//9opU6ZUA1x99dUrx4wZc2iPHj3eq6ys3LRs2bJO27udww47bMuwYcMGrFu3rsMNN9zwaufOnSPd/sazzz774Orq6j1GjRq1rjV2G0MzQRsRlZI6A8OA4cBlwM8krQaeiogvtUYRZmZmAJdeeum6Sy+9dF227Zlnnnmp/nznnnvum+eee+6b9dsvu+yydcC6+u1ZI0aM2Hj77bcvr9/evXv32oZ+f7szv6GF7TgZKv2962OS/gw8CxwDfA44dWc2bGZmtjtoMmglnUPSkx1McuWmurAdERGrc6/O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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "needs_background": "light" - }, - "output_type": "display_data" - } - ], + "outputs": [], "source": [ "# Create a different plot. The same filters are still active.\n", "rep.get(\"plot capacity\")" @@ -592,36 +513,13 @@ }, { "cell_type": "code", - "execution_count": 34, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "fragment" } }, - "outputs": [ - { - "data": { - "text/plain": [ - "" - ] - }, - "execution_count": 34, - "metadata": {}, - "output_type": "execute_result" - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "needs_background": "light" - }, - "output_type": "display_data" - } - ], + "outputs": [], "source": [ "# Replace the technology filters with a commodity filter;\n", "# show only \"light\" and not e.g. \"electricity\".\n", @@ -649,7 +547,7 @@ }, { "cell_type": "code", - "execution_count": 35, + "execution_count": null, "metadata": { "slideshow": { "slide_type": "skip" From 5a2103c7b0989ff91a21bc8cdf5a69c98d2cc8b7 Mon Sep 17 00:00:00 2001 From: FRICKO Oliver Date: Thu, 18 Mar 2021 14:50:28 +0100 Subject: [PATCH 04/15] new tutorial added to documentation --- tutorial/README.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/tutorial/README.rst b/tutorial/README.rst index c295cf620..c57e2299c 100644 --- a/tutorial/README.rst +++ b/tutorial/README.rst @@ -104,6 +104,8 @@ uses it to illustrate a range of framework features. a certain share of total electricity generation (`westeros_share_constraint.ipynb`_). #. Add a fossil-resource supply curve for the coal power plant, (`westeros_fossil_resource.ipynb`_). + #. Build the baseline scenario using data stored in xlsx files to populate sets and + parameters (`westeros_baseline_using_xlsx_import.ipynb`_). #. After the MESSAGE model has solved, use the :mod:`.message_ix.reporting` module to ‘report’ results, e.g. do post-processing, plotting, and other calculations (`westeros_report.ipynb`_). @@ -116,6 +118,7 @@ uses it to illustrate a range of framework features. .. _westeros_seasonality.ipynb: https://github.com/iiasa/message_ix/blob/master/tutorial/westeros/westeros_seasonality.ipynb .. _westeros_share_constraint.ipynb: https://github.com/iiasa/message_ix/blob/master/tutorial/westeros/westeros_share_constraint.ipynb .. _westeros_fossil_resource.ipynb: https://github.com/iiasa/message_ix/blob/master/tutorial/westeros/westeros_fossil_resource.ipynb +.. _westeros_baseline_using_xlsx_import.ipynb: https://github.com/iiasa/message_ix/blob/master/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb .. _westeros_report.ipynb: https://github.com/iiasa/message_ix/blob/master/tutorial/westeros/westeros_report.ipynb From 2cd3a4068bdb108c124099f19b425c3ee25c5d85 Mon Sep 17 00:00:00 2001 From: FRICKO Oliver Date: Thu, 18 Mar 2021 14:52:10 +0100 Subject: [PATCH 05/15] new tutorial added to tests --- message_ix/tests/test_tutorials.py | 1 + 1 file changed, 1 insertion(+) diff --git a/message_ix/tests/test_tutorials.py b/message_ix/tests/test_tutorials.py index a219326d2..af950bf0e 100644 --- a/message_ix/tests/test_tutorials.py +++ b/message_ix/tests/test_tutorials.py @@ -23,6 +23,7 @@ [("solve-objective-value", 369297.75)], {}, ), + (("westeros", "westeros_baseline_using_xlsx_import"), [], {}), (("westeros", "westeros_emissions_bounds"), [], {}), (("westeros", "westeros_emissions_taxes"), [], {}), (("westeros", "westeros_firm_capacity"), [], {}), From c923bc1019ba74285bc9a2c4f64693ba991db8ea Mon Sep 17 00:00:00 2001 From: FRICKO Oliver Date: Thu, 18 Mar 2021 16:06:16 +0100 Subject: [PATCH 06/15] tutorial tests extended to copy necessary data files to temporary path where tutorials are run --- message_ix/tests/test_tutorials.py | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/message_ix/tests/test_tutorials.py b/message_ix/tests/test_tutorials.py index af950bf0e..6dce7e263 100644 --- a/message_ix/tests/test_tutorials.py +++ b/message_ix/tests/test_tutorials.py @@ -1,4 +1,5 @@ import sys +from shutil import copyfile import numpy as np import pytest @@ -49,6 +50,13 @@ # Short, readable IDs for the tests ids = [arg[0][-1] for arg in tutorials] +# List of data files required to run tutorials +data_files = ["westeroes_baseline_demand.xlsx", + "westeroes_baseline_technology_basic.xlsx", + "westeroes_baseline_technology_constraint.xlsx", + "westeroes_baseline_technology_economic.xlsx", + "westeroes_baseline_technology_historic.xlsx"] + @pytest.fixture def nb_path(request, tutorial_path): @@ -76,6 +84,10 @@ def test_tutorial(nb_path, cell_values, run_args, tmp_path, tmp_env): [str(nb_path.parent), tmp_env.get("PYTHONPATH", "")] ) + # Copy necessary data files to tmp_path + for fil in data_files: + copyfile(f"{str(nb_path.parent)}\\{fil}", f"{tmp_path}\\{fil}") + # The notebook can be run without errors nb, errors = run_notebook(nb_path, tmp_path, tmp_env, **run_args) assert errors == [] From c92ff0144c0524a66ea0a7ef3473b669d2f1caa3 Mon Sep 17 00:00:00 2001 From: FRICKO Oliver Date: Thu, 18 Mar 2021 16:12:54 +0100 Subject: [PATCH 07/15] run black on script --- message_ix/tests/test_tutorials.py | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/message_ix/tests/test_tutorials.py b/message_ix/tests/test_tutorials.py index 6dce7e263..f9fc386aa 100644 --- a/message_ix/tests/test_tutorials.py +++ b/message_ix/tests/test_tutorials.py @@ -51,11 +51,13 @@ ids = [arg[0][-1] for arg in tutorials] # List of data files required to run tutorials -data_files = ["westeroes_baseline_demand.xlsx", - "westeroes_baseline_technology_basic.xlsx", - "westeroes_baseline_technology_constraint.xlsx", - "westeroes_baseline_technology_economic.xlsx", - "westeroes_baseline_technology_historic.xlsx"] +data_files = [ + "westeroes_baseline_demand.xlsx", + "westeroes_baseline_technology_basic.xlsx", + "westeroes_baseline_technology_constraint.xlsx", + "westeroes_baseline_technology_economic.xlsx", + "westeroes_baseline_technology_historic.xlsx", +] @pytest.fixture From 6f2c3da18b340fe7b12e836df9c72e619f789afb Mon Sep 17 00:00:00 2001 From: FRICKO Oliver Date: Thu, 18 Mar 2021 16:48:49 +0100 Subject: [PATCH 08/15] files copied only for relevant tutorial --- message_ix/tests/test_tutorials.py | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/message_ix/tests/test_tutorials.py b/message_ix/tests/test_tutorials.py index f9fc386aa..2d603d8d0 100644 --- a/message_ix/tests/test_tutorials.py +++ b/message_ix/tests/test_tutorials.py @@ -87,8 +87,10 @@ def test_tutorial(nb_path, cell_values, run_args, tmp_path, tmp_env): ) # Copy necessary data files to tmp_path - for fil in data_files: - copyfile(f"{str(nb_path.parent)}\\{fil}", f"{tmp_path}\\{fil}") + print(nb_path) + if "westeros_baseline_using_xlsx_import" in nb_path.parts[-1]: + for fil in data_files: + copyfile(f"{str(nb_path.parent)}\\{fil}", f"{tmp_path}\\{fil}") # The notebook can be run without errors nb, errors = run_notebook(nb_path, tmp_path, tmp_env, **run_args) From e929b23fe79bd9cac48735cbaf355b2339252689 Mon Sep 17 00:00:00 2001 From: FRICKO Oliver Date: Fri, 19 Mar 2021 08:59:54 +0100 Subject: [PATCH 09/15] syntax corrected for different OS --- message_ix/tests/test_tutorials.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/message_ix/tests/test_tutorials.py b/message_ix/tests/test_tutorials.py index 2d603d8d0..4a2fed0b6 100644 --- a/message_ix/tests/test_tutorials.py +++ b/message_ix/tests/test_tutorials.py @@ -90,7 +90,7 @@ def test_tutorial(nb_path, cell_values, run_args, tmp_path, tmp_env): print(nb_path) if "westeros_baseline_using_xlsx_import" in nb_path.parts[-1]: for fil in data_files: - copyfile(f"{str(nb_path.parent)}\\{fil}", f"{tmp_path}\\{fil}") + copyfile(nb_path.parent / fil, tmp_path / fil) # The notebook can be run without errors nb, errors = run_notebook(nb_path, tmp_path, tmp_env, **run_args) From 48ca77012f554dbf49a2f99f3fd90a62c2c875d2 Mon Sep 17 00:00:00 2001 From: FRICKO Oliver Date: Fri, 19 Mar 2021 09:06:42 +0100 Subject: [PATCH 10/15] added viewing of set/par after uploading xlsx --- .../westeros_baseline_using_xlsx_import.ipynb | 32 +++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb b/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb index 685b693da..06c42c4eb 100644 --- a/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb +++ b/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb @@ -276,6 +276,38 @@ "scenario.read_excel(\"westeroes_baseline_technology_basic.xlsx\", add_units=True, commit_steps=False)" ] }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In order to view which technologies we have added, we can do the following:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "scenario.set('technology')" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We can also look at the specific parameters by:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "scenario.par('capacity_factor')" + ] + }, { "cell_type": "markdown", "metadata": { From 808b73fb55c38c33addfeecb2a7f5eb522b16186 Mon Sep 17 00:00:00 2001 From: Ben Date: Fri, 19 Mar 2021 17:31:30 +0100 Subject: [PATCH 11/15] editing for clarity and improving the text --- .../westeros_baseline_using_xlsx_import.ipynb | 60 ++++++++++--------- 1 file changed, 31 insertions(+), 29 deletions(-) diff --git a/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb b/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb index 06c42c4eb..d40deedbb 100644 --- a/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb +++ b/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb @@ -8,7 +8,7 @@ } }, "source": [ - "# Westeros Tutorial Part 1.X - Building the Westeros Baseline using xlsx input data" + "# Westeros Tutorial Part 1.X - Building a scenario by importing data from Excel" ] }, { @@ -19,28 +19,17 @@ } }, "source": [ - "## Scope of this tutorial: Building a Simple Energy Model using xlsx data\n", + "## Scope of this tutorial\n", "\n", - "This tutorial explains how the Westeros Baseline scenario can be built using data retrieved from xlsx files.\n", + "This tutorial explains how the Westeros Baseline scenario can be built using data imported from Excel (.xlsx) files. The tutorial is split into two parts:\n", "\n", - "The tutorial is split into two parts.\n", + "The first part will create a scenario and basic parameters will be added including the modeling time-horizon and the discount rate. This code is a repetition of that used in the tutorial `westeros_baseline.ipynb`\n", "\n", - "The first part will create a scenario and basic parameters will be added including the modeling time-horizon, the discount rate. This code is a repetition of that used in the tutorial `westeros_baseline.ipynb`\n", + "The sceond part will then import various parameters from Excel files to add technologies, demand and constraints to the model.\n", "\n", - "The sceond part will then import various xlsx files to add technologies, demands and constraints to the model." - ] - }, - { - "cell_type": "markdown", - "metadata": { - "slideshow": { - "slide_type": "slide" - } - }, - "source": [ - "## Online documentation\n", + "### Online documentation\n", "\n", - "The full framework documentation is available at [https://docs.messageix.org](https://docs.messageix.org)" + "The documentation of the MESSAGEix framework is available at [https://docs.messageix.org](https://docs.messageix.org)" ] }, { @@ -92,6 +81,7 @@ }, "outputs": [], "source": [ + "# Loading Modeling platform\n", "mp = ixmp.Platform()" ] }, @@ -105,6 +95,7 @@ }, "outputs": [], "source": [ + "# Creating a new, empty scenario\n", "scenario = message_ix.Scenario(mp, model='Westeros Electrified', \n", " scenario='baseline_xlsx', version='new')" ] @@ -119,7 +110,7 @@ "source": [ "## Model Structure\n", "\n", - "We start by defining basic characteristics of the model, including time, space, and the energy system structure. We will also be defining the interest rate earlier in on in the process of creating the baseline scenario, so as to allow us to focus on importing data in the second part of the tutorial." + "We start by defining basic characteristics of the model, including model years, location, and the energy system structure. We also definie the interest rate." ] }, { @@ -132,6 +123,7 @@ }, "outputs": [], "source": [ + "# Defining historical and model (optimization) years\n", "history = [690]\n", "model_horizon = [700, 710, 720]\n", "scenario.add_horizon(\n", @@ -150,15 +142,16 @@ }, "outputs": [], "source": [ - "country = 'Westeros'\n", - "scenario.add_spatial_sets({'country': country})" + "# Defining a spatial level and adding a node to it\n", + "node = 'Westeros'\n", + "scenario.add_spatial_sets({'country': node})" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ - "Contrary to the original tutorial for building the Westros tutorial, we will only define the commodities and levels in the next step. Note that we originally also populated the set `technology` and `mode`, which we will address in the second half of the tutorial." + "Contrary to the original tutorial for building the Westros model, we only define commodities and levels here. Note that we populated the set `technology` and `mode` in the original tutorial, which we will address in the second half of this tutorial." ] }, { @@ -171,6 +164,7 @@ }, "outputs": [], "source": [ + "# Adding elements to MESSAGEix sets\n", "scenario.add_set(\"commodity\", [\"electricity\", \"light\"])\n", "scenario.add_set(\"level\", [\"secondary\", \"final\", \"useful\"])" ] @@ -181,6 +175,7 @@ "metadata": {}, "outputs": [], "source": [ + "# Adding interest rate of 5% per model year\n", "scenario.add_par(\"interestrate\", model_horizon, value=0.05, unit='-')" ] }, @@ -199,7 +194,12 @@ } }, "source": [ - "## Supply and Demand (or Balancing Commodities)" + "## Step 2: Importing data from Excel\n", + "The required model data and structure of a MESSAGEix scenario can be entirely saved in one Excel file. It is also possible to import the entire data from Excel using [`ixmp.Scenario.read_excel()`](https://docs.messageix.org/projects/ixmp/en/latest/api.html#ixmp.Scenario.read_excel).\n", + "\n", + "In this tutorial, we import data from different Excel files because ...\n", + "\n", + "### 2.1 Supply and Demand (or Balancing Commodities)" ] }, { @@ -210,7 +210,7 @@ } }, "source": [ - "Instead of using the add_par for adding data to a MESSAGEix parameter, we will import data from a xlsx file. The arguments `add_units` has been set to `True`, so that any units which have not yet been defined will be defined automatically." + "Instead of using the `message_ix.Scenario.add_par()` for adding data to a MESSAGEix parameter, we import data from a xlsx file. The arguments `add_units` has been set to `True`, so that any units which have not yet been specified in the modeling platform will be defined automatically." ] }, { @@ -249,7 +249,7 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "## Adding technologies\n", + "### 2.2 Adding technologies\n", "The following sheets are distinguished in the data input file for the next step (\"westeroes_baseline_technology_basic.xlsx\"), which adds a basic configuration for technologies.\n", "```\n", "a. mode\n", @@ -316,7 +316,7 @@ } }, "source": [ - "## Technological Diffusion and Contraction\n", + "### 2.3 Technological Diffusion and Contraction\n", "As we have already undertaken an initial definition of technologies, and will now proceed to add additional parameters for already defined technologies, the input data file (\"westeroes_baseline_technology_constraint.xlsx\") does not contain and sheets relating to sets." ] }, @@ -337,7 +337,8 @@ } }, "source": [ - "## Defining an Energy Mix (Model Calibration)" + "### 2.4 Defining an Energy Mix (Model Calibration)\n", + "In this part, we import data of the historical years." ] }, { @@ -361,7 +362,8 @@ } }, "source": [ - "### Investment, Fixed O&M and Varaible O&M Costs" + "### 2.5 Investment, Fixed O&M and Varaible O&M Costs\n", + "Here, we import the cost data from a separate file." ] }, { @@ -626,7 +628,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.7.9" + "version": "3.7.6" } }, "nbformat": 4, From be16bbd204a5a19675365f1249bca05070289dbb Mon Sep 17 00:00:00 2001 From: FRICKO Oliver Date: Mon, 22 Mar 2021 09:44:13 +0100 Subject: [PATCH 12/15] added figure and further explanation to explain xlsx workflow --- .../westeroes_baseline_xlsx_workflow.jpg | Bin 0 -> 154138 bytes .../westeroes_baseline_xlsx_workflow.pptx | Bin 0 -> 246160 bytes .../westeros_baseline_using_xlsx_import.ipynb | 39 +++++++++++------- 3 files changed, 23 insertions(+), 16 deletions(-) create mode 100644 tutorial/westeros/_static/westeroes_baseline_xlsx_workflow.jpg create mode 100644 tutorial/westeros/_static/westeroes_baseline_xlsx_workflow.pptx diff --git a/tutorial/westeros/_static/westeroes_baseline_xlsx_workflow.jpg b/tutorial/westeros/_static/westeroes_baseline_xlsx_workflow.jpg new file mode 100644 index 0000000000000000000000000000000000000000..b960d0d1e1a1d7d314b148e5644fa9f69bd33ffa GIT binary patch literal 154138 zcmeFZ2T+sU-zFRcq>CU`kf;=qDjfldih#%i2+{*YDbj=}y#%5ty$J{?h$vNRq$H7+ z(2IabmxLCo^n@B9gw3};%TY#isf z&vTsPI>*L#p6@)@1s+~rUUp7?0X`l9ZXRBqzdwYIp7u8kj4X_dEIb@+96bNwXnD&Pzk9X%J_X*&Q20MIegdi!^W|Jy-#hStZkOw25-Y_t=Q=K*Kv=;_Ze z(Er_Q+Sy^W_W=xCjNDfg?wq|~`h@A~3m(N+DPNdH?^d<&nhg@glpK8`SXlY^1q3gO zOI(w@E~TuZs-}KZL+75Zp8kD<2an7xEUm0_joULPr#Iqf)f%3}2m&5o zczYWpU~=pa^UHGeC(Yk3_YqCL{|$#}^JAbo4<7sdwH-b>eaq6ZRki9K(>Lk>N*x$` zjf7xAjQNxopZ)f3S;NCD)d+>CJCyUvb`nu6xMJF=;3bxWx;0J}%A7}^@Cd?*rp55> zTR`F@_7e8b=iXC5M55*?AZ4xfD*|$?#CQtOb~+I4q7HY#2Ufz?41I(Q1;=q2H)aqL*Kd{K`Uk8cJ(_`5uKlAw6-J*fZ`fk*ttbC$s6!g^-%w5h_8-{s z-yq{ZS>m58@ekDhhsXRw(*6~K{ZF?1|4+6&PTPM@(@tKKGqyTyU86B#$WQr2t4iY4 zo)245L-_k$9<_0wMXxy0HJjC4yC#76RZ3xR2uK=pHM2-(Vb_RYI*Wy^?NCLVf3=Jj zOL3u9c2^3qeJ5;Dq*2nlQoY8yk6s9SC{=$!ZG)!KTzf)dqSjl(SL(+arJBa~7f%6c z-^euBWiJETo$_?xg?x6&-86@{Vnuf*hfj{s?<|9sa;=P6)!018o|ol)OKG1bnFJ_Sq{QU!smgSx!C#eI=H zrnedYFKp*$;9comC%(`H&x0ZCnJw)6k9lexdRygq1(HK@?a-%ApKuNa84@Z^0p8T& zfAz*XWx(r9X+WHkoY)VVDTBvSpXl;f6$QW2<#|Z=@3gbjs#&AJHYzXiAQrj~OXP0{ zx>5V;ck-d2?zj4CKLn~b9GUvghB{kD6%w;MLO^X^(p}>rR_O#;v&HiDJgt?!LV~?R2YWxyUsv7e{unT3*En=23)|P$8>FyQ zl3%xCu8?FSlXLUP@byywF3`cxb0K(JfN*Gd)~k>C@J<(uwHZ+>kKzBLElduDGx zzOFd%5M>j>rAU28ce}(#juyAeEiDzIr%QV-Fzz_XvYi5e8ODSTw|bLSlVk@r(gr#T z1DuAbk>sOlZ&D1rLeC*pOE^X>=MTO;sNtPx2=S6)8MxWHp7tO(HB)&KoOl2h+jzRU zxkYlz$s6rkb*a?)X7<2xViVUiR9%g3E3--s&~~oOq0svS+tgtmM@b(u9(io#>lW88 zI5ftx{)XOA8Pxt*jQ-InVDJ8hr1h`9@{6}C&y;+)E5{*`x9EvMVOx<<^Ne2qC&Rt2;>tK5 z)22*A{9K55J~XhVj&$$_CR!e})1C#7rhtn3OFj9w4=wk<(beGv#nM{80;(KuKV%UD z7=<9>u`XecS`IWu8>cmia$jELyQAyVDYoI?wwurs1yQ2V%L-@Gdc;;!@|}F8*&_hj ziN{yS4Xu3G3sf=kkMZV*6TO5P&gr0Jo!ZwH-=&>|x!xC`WfmL9(ys}ow6L0|-xgr( zws+D&o_q*b2uju^Zc#)0Qt@p^4*6w&j=I`dD4v803EykDa&H$GK4S9qo)7PqSq)u-9yM0(|H*K9Af06j zLzwT@?2es4ORd1dq+Y3>?M{Opw=uLsJ-AnI{Xkng50gzquWx-pueZ&~`kF>>fG%wL zjgjP1ijaLN2CjMd$$M$`%Fa?$lI>Ib#n+#8`1?e@17oHceo=*C0z@%2l(uU-=LK&P zPo{(4>-CUFB}rqKzGPk3nyXMHL>n~-_(*#Mty)MB*wFpG2h!-3p_APkC9leiS$(VR z8fQYQ9h$uGkGj7i{K))7eCu<{EfS=|Bqqbx10yi#Vy|ZW>vJRc>6nTjzqaXH^%P4L z=eHYzmotRkcqa~%u?A#=InIep2st_r25KZ`AhqkDgeKJql@bIY!rY=R)yG*19?WJS z$e_+BD#erG@u=&r%B`&Ukgrp=<6&x;oM+fetWjruiZ_IZ27mlKs9r-NR|3f%upZqo z7g9U{-UfZG%~e0B0t9&0({zh_K7Sy*%KZjKs8RWX1Ve!vuNQQ=u3F#(7q;KtV7E4a zNR0iqGk@`LIl?^{52?e}O;nZ$%zdkF9Z2<3TMX0Q#q9YVsq$EjLCz~fB0x3E34R02 zWJGgK5Z*qbv-MWEk(zl!ZA2^Ns%rY&|-I3_2NBuI&U;O&2ZC@4e!9%K5%u>0Ngj*~K7-3O-bDnZlJ z`z7v(05s|V{|J37Rg;$BoNYXWJed+2H}2U8vq1kM;{7DvB=u%QQ?2EY(qUM)293~yDL z&2f>TfMyYlc#jZjRfT)T%u3W?Bl?q#Pgg&Ds)d#J?vFyB$_u=xs}&DSa@}N)_g1zI z0^i=K&aQnra9rvtTIg9;e zQ{cA6=6gFO6RdhvUjkP_K zjj1&kPe>tkXhL(w@YA(Z0JB5`?FC4Y$bE7Oi1R!)IR-dBETbh^{WabYqaWTxLt+Ld5!>Lu|dVS5}3^VzHJ!yP@eE(81 z9$QsAfsEgp(FdlvpPNxM$%$I`hNSy+Y0=YqoptRM=XC zeiGcno|%a;N^D*5_Ky<}kiOn~>2s2SJ)DiKL+ENlybR|djVJqYk{=+U=RE@Zi`@1D zGgT4(P|i%c3qOmUuL~UxywOX+8NxL3ejxKZzoIwMr3T^^lfe~O=)Ht7mLBZAPGAkh_oBrCBXLIMD77dM|==v%j?EeCMGHmTTqre?|qnb!6 z-I4;U_bL~C84xg-u*cyb_dYcoK{i#BtV{<|AH_9PH|?P+Dpal3ppA!_Iz*1Kx>*QM zP>ISVjiKJ#89xQRDwnUn@E7mB&vn_pK$DIqsrl{QFQV$|D~$@o3+5z!%4I4f26nUf z6wqqp^>w;s|9Cupoo_!Jnk_rCIq)uV!LTZ77KZ8(GS)Z+aGwG?WRH1*)C?O=7Q5ma z?L!e0%31{h`@h(3@|iu?`M@m2b3?l4GRf{-A*rF`V)TAzFSZKq=Kk%E;l8^#&}k^Y zQ<)ri6HkX1*}&(ZU_W6!uzrgNd+&0j#rwvmimB;=+vpEz#dqW5O0!`lC)5LKn#&G0 zrFkrJIeO1X(_k2B*rd8W{?|z3K$U|LeSw+-*emUa&y8d2mw1B~b>*P&?Jnc-T71(Z zW9szr1!%xcdzAaTJpcQ~qD98Qb9z3~Yd~D69kH_tP8fI{BHvn4ix9N7Ua1fG zm=A&0tXKu=U0*;aU50&_X#ADzvuN`>jS-3^1w~D6G*tcl9Yhk zSiVM5fJcw?E%1cfrxnfMLm<#H>NVlyQHMtDMThvJX^*3i$Bkv0%p$=BxWa4?Nio8m zYxFN!5TU1lNF#!Ya5x@Ld`X5pp#CJj(^&q!G`v+QewbJL*Ywx7nmxyD49DkY!~GXQ z(ZwepVE(fRW;Zw=ENF)Pse)UIp=@QLXXSl4nX641nxXdESMNJN6RZi!ZL~P2@r@(W z4lXO_@!Z=o9u+?q5EpW=4%MgYx5_9ON?bscku4U+avE|a1|fIIfvs>3WDc++mv3*2 z!$Vty$eX^0%KSpsF&fDtAUX7VxD6OGz1d^=M&#Blj3urJ`8~1iifPm&_Re9OvHaxW zmhkh9@RBmHNKJ2b)4-~VJNcL8P}9;&zU0)@0ey7hq0Z+pVT?+12=M1FFAG{4E8MB z8a4E$EjXby!HdssbX~T>z@Gn&fL|%v1xYN^@NXKK#L07vLi6I zHT}Z30e3m4c{&#bWjZ;e5>@yA%L=DNjrq^Apl6f!xx9zxW--IS9Fp^29 zfEU;kCH#0R@_!=fSp%nlDJQCAt`Q9lZ<*2HZE~brUfj{6rMq#GpU?c;*0e(vFr3dk zVF4amR-FRo_qxOTrdeoHB9^q%j1$szeF2pyzSQ5xzg90;G26GJ*IOGkC2aiVev26W zOM^=Me(W&yVo-xMDLTmynvfQh-+nQ1#~$qVh#aylu|55m;p)<(S{YMe_LmChA2I=g z)f0@Y=S1(Op)#QvW>XW-Mo}TCkl!$s>rWOPN--$IEQJaC&71>UG1#GQ7(a1fwm4E- z1;!b53NQo_6Umva^&b=G`W^c<*fXkFv}HZ&qTRQ)>)T!%Qw2LPtQfsmxz3NF8xUznOP~Jho#z~W+WM-Y;^clF z;X~J_*4I6SD+`M9H$)Lq;MIl7)S+XrUxmN#T!{3lJWG(t?09mc8i})&3M7u@2bKg` zwW8~%u*ug(3Zv}xJe>r^tlv7tU2~P9>pgtz%FW#-`k%r;o+n=})rp4|q^C~}dsb%2 zq0nGKxNC2C5Uw8`=<+mer4muNHMIOQeVFnWkz>5|6mZFd%8MEC+b}yYe5Z5kXWGrI znLZrbWyjLME8+s@nO&aXFj>TbmKk=>Q-A>66)OnSL}s^TS;fm2VAJl56uXag8Y!BG zrU)NC^?xC>KB@GUMGE*VScIOeUr2dAf{}%}jA()8KwLo{c)P4H={8%%&yAzr5_LPU z4*~o^gWT4QtuJ$`l|(NHGBJI)qa9daHtN6RvuL+iAqq|bZk&7x7ZsBTZqC`HCHo}uC{eEjnfA#418|O=D-wQxXw?`3rv zvys3Pw_co3Y!;8Gw!#cR^@a~sUzoRy6x%D zu1-&iz$#0H6&^JLGBQ^!oa)`52Q0fc13n4Nd(_CIV6sEu%&;KRL$Z553^YoSE?MOp z?kFI)+Itu_q{%3J-~-2-S@KS&-1NVDTNW9xpaCIU%>(I!==T*yRqU+@%M`I(e7Jag zTm1+K?~6OZ_UJdEv!yuG7dKgufGPBgYwDFUdfFc6cvg^_9X5D(2qbRmQu@Jk_h#GT z?&Qd-xp7XxW*s`QmJA)W$9q){e1HWLfaE(ci?A=J055luE64IQ%h?6lvuhiwzTSzD z1E0s$8NSiC|8YmqOz#eZ z>uZPsO#0*l<%)dQDL@2~{7hnyLRUb3ReMR)xISa5qX-q;v@wA62u5|2Sp%(^d2;HmTOc8 z_Ht^^yx52fEo^<8serfbs#O$~=AE9+kZJf4=~I{#tr@9ahr~_WgAGd${~%l))mgT$ zkETY1Z7mN<9D#J7ZurALNEeg6W`z*37=;?*#;5#Zcg0EF7fKM1o%ddklLW-F^ix_< zqbx$c2_dt-5M9Ljz$_vfdmf|GHrIdGbBiHJs5!~4U5!{PF4Kwf#wr64Kb*_E9j1&SQ*(Hi%3js47DEpmNnbTKJc#YbFT zCOorxinklBQ4bX~FUU!C*w3)*0mIEVpx{g9K6S@#k4i`J;hSh!MKLPpV$+En4C2t> zd8|Z^4d?5cukf@bF27lqt0-<9_S=9zR2@GmFufc$_G?}9V3UsSGHOvBx7r80Jq+U@ zA{>UauGWJn;yBdnl4z1~>46fiEBLCqP3@Wm!?Rba)q)f3Nrx`KU!FaRpSw#AZJ$8_ z+u%{*K;jz>>fYflw%J&-?{y@vj9AyR`@QbcKW!%Ez89BQ;?kN^+%~-ej$gql(n7n8n#}B zGtdyl2U2be=3*#tL)vi47>KexoVGl^2UVP3nk;bSc}po!1InvcHW2vVXkDM5iJw*- z&HJT2MN_leaNbpOcRo8f7Q$Pwzgen8CB8Kd%%N{l`#Sfxy=YtD1`VvmgY%ez-@nu8#Qi@g&k~tQ0Hr59_c1ixhVyM5piE@^L=NYxJaB2r(6&EYKIezt#eyrxn zIqYkl<}`1aElsWjD&CAx|BOzb>9@{(dg$U**Vp&eiL1-Hu~WF@s{uA-&9KtSHOve9 zbnDlIOU;t|&+DP6kcl1XGWRfaz2zz_OgFT+W8h5)s1@{P1se85Wgu>o;#xZ4j@z!Y z-t=n_2KUrok!GH#WVy^M`v#gV6bPv&@<%svmc!Tw5ilms_`T%wD{Q3@{GEycxB41L zzm)Y|yV={nUJ1&4XE$Ja^?kK!WRX{0Vz>$QC+ENu*%XK>@0j(_Grr)i;<>e-h3YxL zJ47US&4^>Mcd`KK3ghX0KMqG(6HYv*ZovtKds7i3h+4mACFoq`GXkb9nTA90KAL#j3K5DWQHlqBwD_h0v(iJQ~ya3dFf zL9v7s%q6lOjuY+aphfEFEH2PxD=qr%2&NY8wvuwT}4~$CEv` zxKSU6Y}NMRMgHckgYQ0;$Oon)%L2zU^|6ItWdwK=ue+AX$em?!#I zqoG8!E1^lv@{hY(B$ay&MM&@ z*dB_>unJQ_A9%ycbp2@TKn`{-c)r46zIiMwF*;KGoq>~Q8L!&;l7}`dme0P1wfOV} zL{1v?R5~`r7-mUXB9A{Q&-Y#vnx2Y?lPnXH%!>p3+ZJ_9)v5%oWy3`wm~=9K7>zer z0r&c`DTtW|l&yGeDbW7GpYZrr2nX~ya1V3^>kT>7G|>z0ksmT;y_u#-cN{DuudXe&lU zatP{|=m39hi;b#)DR~w!%O+BDd21nmwu|4}X?7|7{NZp{KdaI}p>+I5ty#v|1j0q1 zro3|G?)bRTNobP5>d3NG3UXm{cW-#uzDW~kMA0U4#$Y(Yf6fSMSp&p&Pc=uZeG!c{lOy9PjV!f|M+`)O+_wQS5oUlg$nDWYB(L zDil}WJ2#LJl^_RhRVXo6OvufAF}*C)1=2QsaMPcWiNn^t z%c?rG5KldGeMx0Tj^HWje^9SRLO)Fz#ErcI7HL$o|9f400zyNlT+r6Tstm~V7!Y&*r*jbmu4I8!XOv^L2+=3P!z!qpN;wq$wX%fjn7Q3sgK zagT9_@Gy}v%4Nl_w3LuhJWr#!!%`zP@_^!E{b z=LPUP#Ub3ib``TXQj8QRR^Z4bFC07_+Kr1M0BV?`xNhJHEdsP;2rHcuR z+__q74RzIfUU0Gkv8qHNXJ&OeG}6Clluaep+Pa5MgkKwRkRua_H!(L>ffu}XO)dt- zcZ}6z@iObhBl*eq>)ZW}pXawN<7z&dFuQ|swdIMf&wx$3p^wS_5He(e#6 z-ou?4)NA81#yQtwv~&Z#c(R^}JoBELx@;y`z-r#W>-Ho63X@6;%$EErpWL8B4$Th= zkk#vbK-`L+tNvco07mcg0BUO5eVFC=jy z*SPJ=(Yg{ci)QW&kNGcOQ`Z$_T0t;(5#V%dGrZyQ?lYWP_Mg`tuGB|;tH-vN1(k19 zY%Tc=f^Aw0Z755DckyUR^90qWHz_NXx$QGNS}yaR%LgP|ut&(dafR}i z=Y^%K=w3b*T#M31w#4>^A@iBs_NF(~0>{B?M>9^p+Mb5fWDA6>EHdpuZ&AkZE^65* zpJF^j0Uc|Rqgw*_4&DZ3wqIOqJj$7F_jKR=Eh@`?Q|3YaB=@1YpfI24;#X~1*zG}z z{TIru!A4EKe3!zYz&4VNoy~Ne0!^B2tTqhR(&>X|==^R{rFfFc2!U-gQ8V1Io5Y(>{mo5<#bvbKn<3i2@clOL0(X&sTQ&8sx5*`!G{dc4! zE04_Q^|Vs(kd7(pHAdU&3b|lt@oYKvOlPj|rJNIF``Fu=4xTbm+$29&-{%O^IK^*f z>Y6sjoD3qKe?W=3B3evyxyhe|$t461&2}G;=NhshQ{Z z7>2amb)wTjy&P{ks-*y*<3vr`{#@QLDGok7e@5)k`ZmL3Cc5Xe=NPE`spsF2&YOb4 z$RFmgytvf^>P1pz_E$IKF*XLPeU#a{HS3oXyoN6Oi;rlZ_BsJ*j%4YlbMNNz#$tVr zWI;V)tx<}#;(ebgc0!s0k7uUC`2SPGw2xdfhkir3Kf|OfTC{qt8N*$LPPQ7FvT*)h zmkL)i3$io#UjA8bvffMdW%|6ic^CZy`K*nG>5a8eA1XMYp~|ewB6YDES>fsKxf33G zP+d1pu^DN+R1Uj6>P?|9ba4B`o%Z9HH}W_mOXgmLQG3sorQ7S;zAcwD&fSfZMsY2~ zMQ(W?VLx=-3^llk8{fz~q}hfoZ=34!0RFvZH3g}LQ{KyWB_AiA0#-gvV|WquSm#r~ z;SESK@IdGkFnp^CHU_7z0ZI3cyn&~HkW8{OOq%A%9m-YwU-_&PE2ypqKVskM;!A7nH+~n;LCI6HFUxAK$R{ z?zW)OyJhOnFMUOopAJj{D>0azLy#DaX1R?oJ`eEpRH+^|G4T(Zes&aZc2YIR3MzIsv+JLblmn}k3hP+Q-bzwqK|t%@MIniFiA9)#(kf4>pYj$l!c;t zQDxU=N=k(=Ktw&`hrJlCwONf#Ibbli@XF1ELls8b5+n5KS z7zALA`_5}t{k33hOTS`04`XR!qPXHzXdGWO_o>&SuyTPK=;_dX&~$A-Z)l!e5jw9w zD6b4zhcaVc&1MT3nC%>2Bs}K2{d4=-&RghrvF>W%^s6Ww^A{p;|J4xX!t5>mW~w-b z6cCx$TaxH8V@bTUYP$+@+kPXYeoSI~)SX%@hoiu6gwlcYI{+FcH5458eFB zm;K(;;xK%PzSJl<>6f9q5Wms!BYSlrc$v|^T&4dosY7w%DY8a+l8}s>c16I6%`c= zq9KZT^&%qN`RgK8$VTc;j^nk9(^Kx!GhW*BDKs(%3VA(MRS&qIJ)$ z3k{fx2Iae1#+Cl1llzXrQ|q3ka@`*hgrm)!*pRpVAFA`4?adYIdGC}ToD zj=b=HPE6N;8Ys{7I!$RShYycK&WEeGVHAGVe)UTPwpsNC=dCEwFV;pZOls}q-GHdN z8?UgQzt761V82|6ArBL;f?^CwdIPN@%DJ60-pMvzXT$DJ%U*`?S*5(0RbIT8T?mvD ze96drZg6{pH+nzpoOP?3fwUX0el_=SYsu^63nc4Ndbamb!TOO36&x(mfPm4~us68` z`PkhPvn{Iz@~b&0cT0)KQJF!!XD_qY)DyJJIlzQchB;Rx-6N)j+r_V_Ds9A>*$!$f zp(VIDXpT11QMNfh3m3X%YbI>vv%N%wQJ3Vf!L95`f-#4l-Crv(C5D-)ID1XMp|L}0 zX?am#rRCBx2IX<$-$eD^-0IIYH6R#5a1Hwj#DloTYqZ>9pWK?&vG;-WzyM$3x#CXYs-7U_)d zbOS`B&(t}+8tsHmnl2iG@fG+j=O#Y1#$xi|1GX8TC8!~!Fm)r~#3AEW4MDyG!GNd8 zj%f?Q9t`e#J4Otc^1VhY=oj*u9{JU0yxtJ_ z5AF@U@rd{QRAz>a;e%N9Lud1crIkN;zZv>!baffpg9)HyzZQ3u%!EehT;b?mS$xo| z>Wq%SzcSXECQ>pMCp!7XgXBW25={*ryZid0@byzOu6|7yMv9Zldb?8}47hlWX773G z4AQ(O|1pMgfMta}9;Ql!|AL?Qmt||!mKqWClxHBJG1Cz^i?vT!w5WH+T9_fxCloO3PrY#oVY%vUOnpGf2A`}Z=zwQ<@w`^|p zJ9Mfyl0K}R`MCz~D^*_^F6o!8%toiW!^-z5$=|dUZ2y3m;m&Lo7uqmfBQS|+84^Rl zPmF>>Wy4q8?L6P-q$?t3T^i*NzDsevo>e|h?w;l(-5QU8+2;ktb*j5G4atATMrcM# zsHR@$(`Bb)D3MZ%IHwt>Wi-zb+Br^|35o}g_^>%1z`eO$u)%;pM0UQgyXjGtDo#m z<}mr?o?M2K#GfUV?S5>Y9}HYr&qupeEIbkOto6RpDF86OnHzlys4WLEP^1Y>{LTC5 z?1hmHB!Xv^U;0wT&%D9=<;rAxwRcF?0zOBZzG~Rl@@^`V?q5EuT*d2I-fB(R!$**@ z?vkhKvF7_Fh0?Ywo+qHSfH3nJVePY?+5)7m2!AL?Q2lVrQD&@uY^}RriaYPYyXjcF1-7->$a}L}Q6QcoED;*zA4cD5RWFPY!e-t23xkmH(KgP% z@KK**jE|42(uw`e8MU(z`n-2Os|pEuc=uf|Jo3cvxYZ`n{ehx^1j=1{D>TIOKxBe6 zKj#_&^ZL9p_DN)fDjJmeC~Dz{KPPatii(MONi@uO!8-cgw`8+&1?Z+tr`tH z&1JSTS5h>g!A=BOd83-aT|>5A-K?=8ftTCA%Wgua1+A4d71$L+ITiEJg^|Vj>17x& zj!G+d$PYB!D2p!vf6$ckbeOiHJuRxYng+U~gG7kB%B%K%wW?>6z{mHOf6hg^=h!ySXaC)p_g zbqa73QOnKiR^YQGmW6 zb1df!oxWH2GU4#?+q%aFSIo(;j`iKBH%=;Q2V$3cO|is|$h|k;+;JH&@|8%@Y0-Px z9^c*>NXeZi{CjWj&3&{_zgQ~sn|rU$v%jA-bPX_=YqHw6|62kF;)7^g z11s_!f43d-}jW6D3oR7T7r1lU9r}ICI?;mb8qUMUD7~`medLoeTT^9U(af9 zJ!;Rw6y{AlJC@51gv+3QJ-ZuQt?F2YG%$U6gM~iM|JzVHWAy8TfWT2amGzhT3)95F zn6FJ6qqSCB+aWmt$s|of8X8#NnFBKZ22bCagPixw*jWt><*FziewIh z>$zuZY}XI5q-6o$T+yH!ZhG~+&5DjS*g%}%DIio`wOC-_XK_wQT z2a(KYbG}Y>HOR|UXQXq#*zW%N#lrrb^y7@bX_$?_!0^67Z4;~lYSPvBCpgjFe7{2C zL~9EUY3tsbvYO+6sbx>Q23>*FE5xaJitV_6kBX+OZGX-)S;q|Pg4A14@S{U|$>n88 zc0%&iytvIm15+d22GFg>OqYe{qor%g3+dx7*z8S8Yn)_7!rgys`lbEM4E-N>zP<{a zAuYZ*1=!&aFP`ioe$qq%TGbR99{s0LoJi9f(eOvxLjUuAW{0(7pHo23Z`d80CXxX> z@PQts9$mc~+V?j(r1Cr|7qTgFKV&Bx#DURy+OBMQ8KEcc5CI(jHUXa?<8 zIs*KNZ#S7j7f;KS`PB2AG)D9bT>zhDhfs`yW^jgwpbPWxv1cI4G5poeS-1W$5KVbt zqSZ0}fQLZDv+`7lWb$n-`BT8%>6BBzO9ePd8SXB>K+!pQN=v>2Xfp7|(}eM1+PHfe z1ffPYiJk%gj;DY*nxg%NzLmB!TXqFVrst=L6#DzARFihlKmY5WYxvLD_-B6olQ;g! zhySc8|Jqu~$U7bWE6X995ZtJabI5itKBS4|Hrl;sI3d0%y$0v_qg#NqRDEt4s+vtDi zMEXDa-hX<-ng`n!ne?3oD!nMBArUm!miOPTEvcjHFqy;eu=~e+agvAx5YvCY^A!UO zLE1ZA7|H5iwTF+RHn+mN>YiG6j=0{GV);{ywlzzQ^U3JOC0=|VSCwzzVCF79)x>?{ z5900^hGn%L8oh-~1X=&0&K7`IX~ugyvJIXH#9?FRlNz2xVpTnJjRjawRb zb3>ow(Sm<`H|+ZVaxTExgJ_iWQC^Wqp}?b$qwhw?vzA_9XZVmCxE5V^GPEruGk&kk zOVj{$?C|A9!;k2YqK#7P?RL7>w4M!{cbf?BBJYnQy!!k<@CLhHwyP(jqsR7vw5#{w z{l8aZ`xkysH=B!8n;{~O$3e#r8mGrk?uJPZfjnr=M94uUd_O(7332r1$f_Z8ePBWn zddTyT#v`!1MdAmPU_1D@Dpd~~CQX$4A1!&?A8kmcf1joEU)XySc&OiYe_W}wkdTm= zvS%$z3eBXlC5c3csgyN@Ft(Y>zK0OPSGEw6ond0^lI*)NW8Y`2!z}&p&htF~*Ll8u z&pF@ood5a#UjK8RUafcY`F!ScFV}tD@9TZNuT3O7*$y>=$=PA~gCmA3tr9i01U>zO zVL+Rerf4$YZ!|dlS7oJ17v1dz903L1jB`Ha!Jl}Ke>2Yb-*xRj8o#^^M>U84)GnI7 z)60b;P5$M;X4IvPx9Y$WGzLrb)Vv>(FaD!n+b9d!fmt&_D}$3CY*$ChBl$Uw1#JTY zaNA9Z?m^Jztse|UJE?PY$9RnQ(^M~;CPk}kTPz!wl3bX(4PB!shHw_|B6&fexa5pJ zOKq#xg^dA+<}4c||95XzBCe@ckk}jy!%L;usixn=SX{`nIlhuM_1t~jnc-l2(-QH^ zg<;IW4c>OtfsWkT(1}4Q(dzRB`IC>v?~~zi7rA~LHoV$FRVxBqnQs>zK|<)UDI&{C zhRA1nf473RmSkbcOa;R5G04e@PiKD3yYI!<19DMbSPZ*-g}0*Bdqg^xjr_j-mIv>x z#*H|~r$Wk^`WBFjl6!cjTw3?-X;f0se}j}LEr>6z)z%ax&x!y5cQplc+3^PhO*F{yd z+s82@`R~w0Qb*)`Yh?&c3Y7bTL6T@9HYBGap-=D_0 zlE7d2e!;M5c>89eWwWdP~Ow@##$jq!78I{@SHKWDX8LrKngiC@xen1adyt@ zd&fER@i&V``tQy>AT6=tdoax`T`zRkUQkOE%{--+7XK58G~BqoyuE|eHuURY$SB*ndZb~B0xmh zk5w#~C8DDoOXH47opzzt<$|ltvdX1bRx#)fQt4$n>wK=n|YDu4Wphw)!>>Cwl zCgFqu$qaFS^S#lt$%Fh>W*6_>VvA1oxhz?&*gxAzIw5)}r0_--XV#9C$eWMT9Wpav zrrRE_gUI}HL)~c zTv78kwO7e&fAMd^k-J6{X8(FmoWA%s^lgFqPxS4N(YN1z`qsQZee1UD4>Fj^rhgIf zD|{bc-Jvwv_@|GQAif6kWwQqTUwSZ$KPA;HHFV;{ac+iTPfk(FI- zNReD;jUnim8PPGBFp2_*aQQ_x!8ha|A@nU|rTtLl za|froQ-GHW9}=Cwgw#sdnhS?EtdYYSpB!h|Q&nAE#+&f&)Uo!I#4~9Li zZ@M<);%^f#PgSOjdUrma{n*8-yDExIPr>Ax9Ieboq^lSAl_XWTvRqgbP8?qt^A!s6 zJZ6V4&LxNO&8-<<&Pbvc`1EVXO_SRVZ%E}6CLs&W%{XGyIaH@T7)d5~4AnD|Y{3ni zEd%fETaBY%hFjb7zp>|!CH-J91(A%-R-Yvb>(aYw`b%KRUuaMx8&e}vn8+_DP@((+ z-#0wa`tt3U^d77|u1>h{Hmbt;mWRdYz`F%5__2~yndRN`prz{xgASP$K^K%J-Q;?W zmIIq2!^TgMc_ykOkC6ks#oA1U)HRabr7wmvtzTxC8klly!h|Ewke4U5Hfc!k|Hgw& zx-nKK5Z56cRYg-?xO_ao$S@Le%ehY@PD!u>g%>2n)0lTL z^aCKK(Fjgge?QRqBn{5ZRQ)XPR0Y`1Hl&gh_8(tx+~>wympg!8|7R8k?zrBj_`?oe zx=-_pn(ptW70|-{yOomXt=9^;;ongm{sZtpR5tLG<9=Sf&sb9(Y-T}c-?;=4_^s$$ zZ$xL?A!|?&7y8{j*Q}PW5iv~|X1Z{52ExsegXK~Qxd7I+BE7=pCFi?-!U3t*WVgj? zy;0y!V2Uh(1VA}zNsyq`^q!4s`O!5+$z`foXy4lu20rV0OV0T|opPAOr^cxSpBp;j zw*yVrnyHc4(0Qof{IlRfR~ZiDtESe`_!YtXDML@0iMD~iACxWJu^mv?K$2vxx3PS0cme!%3mz@NF`KVfzW5n{Ws=l)OJT<{YywH_CdqSW=Mk9ygW zkZf@?DnWmtdpY^Y**Xa76|05$4&@@f9m0-Q^C^f7GDHf0dc}>uV7abW5$M8BA$?X& z*}J(}s6b1C*<5zn@*r6a+n3w&pF+EyjEnB@kM;BjPC0Q!iJ!*G2QxuJ$P`s_GF}8r%ztrHD%Z zVED}%HNgfdjI9Y029^d$Kwva9-vnWLgY;w|a58FtM*ntnOIVhID04SE^3j-GtBO6| zF*KDWt0b^d5i0OKv&zug0*!XH(tDxFyB?NOx;snJM0V{mEv@4PJv;z%2Cp_WQ`9oV z-o%n|l%kvk+>05EF!YS~wE^T=#AiwaQn1#Jc5C_bSA=G-&tMnI|M)Wox`)DcrA)t5 zk$%qc-%4uBQIX@FufBasa5!*Fp73tGtmG+%wenQtpO}la#R~?V(f?iZ+M0vhY{cW$N+_$ZLm8#}=Bg~q5M*Ll?no#u8 zHJ`sr0Y36~h`l%Dgtq}|dG$Mu(XaL-ZfkV`c?~&=S#yINLoH?o(v$M->hs1>zvKvS zU9zIYLWqSe)~Xkn`Fgt=sKx!z8cBBcF6y_}MxC9j`;FAaz zJSCN>hA8#N_dI3W&#m0nSt|&d_`!fzrJe`14xR8aR5p;PM5==Q(y}U6n7lhKN=It1 zTGedYLRxC4o}q}p(Yb#xbX_FI(+@7A$YYS-H@Lsi+eGV9sqy33gcPs<-YthZ}p zm2BYblU+ajNHm~Rah$IQZ*ZM&wlw_8;R&C)FMF@ZLQ$ArJ(I4l=jF39zu{u+v#eBv zdDPp^dStlmLW`adSfmH^dmJp#MU|>Tat+P}*#H|*F*FJXB-x1$=vko_ADte_WP1RkP(k^YN;dE){*XV=aA_x9*Em z9KN~pLS*__SsJuFzmsn@NIJ%%mESw*UU8HogNh&1zL@r?N{qkJ{A}XwaEKkB>3lyO zY3}3cS{`#s*w|pp-n28jy>pF9a-{RjLlxgHm|yOePvu-#b3Q@ukhWinFS)QNkesVr z#&~JES{$&2{F#W&^x$Sc3{k`G2Sd{$8l+6zTe>+lwE(M0AB;HRcej#j^iTD^0nL#E zkPn5oKiB48+u<6GV5J|2U?IDr{On-=;R8-OZ~8AS1#2PD@?hYeMpFiTOaj+rDk0Ly zLEItg5j^WqbK`Jr@C1g{=45hC@wxGPHn&yfJ4IKjTL()R}NP;o27TxhS91pQ+?h}8(;(KUi2hJl7+W- zJA-hWoj2+3uG@o>YF1e8oJ-Z~`3|c!as<*nPwk*{^J=EC8*2%hg;X(E0BqxyiZFPh zGMuic@%sj|X-*>S|2=o;=G~^NZ43JT(!+DVw17U3%qO5`r)sw#hH2E$6%8hU05uuG!A+gD53; zZw5B`vqfqZPWtdJ&Y!B6O~z`3>i0ac@(n!QwXbTJ)O7@w-EgQnhM5$;s; zEL@|PZsNMV^$6jxx?Pp3xJ(Hl@vA~kIUbf#5$qSgJAZ3_k)H1%k~2YuirjRC@Xwz( z`8k!m{(UtqVqrj6cl#cvMqi7KNdPsa5&(r69&qy{!pXwMQ zPFg~cy5z&uN~ub9n5;cTQu*`3!2I;=K#vQHuZ~Nn9iK+wKu-{p`=fB#&aXpQ{dQPnW)_5<5l81=8`0*&BRdabibT6?ncC+9m zN`>pfu0n~kn!rd)+gzRO$AkOWS_Eq9D`1hBwW~kv>0o&dYF;w7&#&8ivZT{)Ns)eo5>!uOdPGh4#ntO-P{=u-%4MTOPwFmPUpdqaiBnT}K{H5E@mZDU1lfr3c>Dv8a zpk^!usT+{Kd06q)$mff&-(UXA{i@p}>i%Z4i~qm1*)^GDC~JTVi^dldwSee!I!s=f z+oH6zmxI=~NB`lsq4S+%j`90F7bI>VmUJ$ibtzvMxvqWa>W$H0PYJnvA|^y0=u}#h zY)zhiBo>L0S~7(L)Gi{XuC-OA98QUink?i))yqxU3_l0N{)kPjk|HU;yQk!P&QYSy z3X0}jyt_Y$vk7ifRS=n{RX{e^wpK8Hqv3AjdCvqV#(hWR`;8Xgm5P0@FT4xmOjZ4k z`i$&xb#)$&EAp%d8^K-dSL|<$WWn2-2B*X}h2PRnt=o!6mIOBJx*?J9)VQ*>N#73( z&e|Z!XL@!A=}jA`!yP6ESk{s({WHkT_usBm^eKcZ@l09JdXMH$Hz`TlK4Z!e4uk!= z`x$+0=M9dj{y^XIY(JtZ;Ve_}XD5H=U-!-Ce|+3_T(+9Xx)bn&$Zt^Tz75^|WG~I$ zWu1h8HSCR7htfNy4v(1K{)_H`U=7mErd%C}*kN>G4uv}k@KZjLn2oA&jEp>lylz5k zevxO8^D3uPgtlFau@s%8+T2K1xp_$-zN&09Dib7zE(Fe`{Tp>!_9^}yIrdBS-(mN& z-hYc(ZEwQS&b z2G&y9Q7w}kbP<%+6l6^T3pP8DA`HLag$D!11R*gJ2K;NeN3Hv-Xw>-+c6YQ6BxTKS zah>#Ep48xpzQ$LIcD~UTB>R=icG_7TpUO;Tq8J!2n6r_S2#&nuDi#g3QgS>BU&u0g zZ$t`fX3D`dn4fP^8dlSDE-K+hUbXbS=v>Vn^2-d{)T2Kbp6c)t@@K;HZ0SdPRk%d` zGE=d;&v#=x{D;SR8=}1sY?*6j$A61f@P;z_F@N+%eTnflB?5)Ypy7x>ydyip(8p`i zzGFPMS<|$}uvxVNp|V(gZ|~Q5=7Wc-getBwho!w*h2Ki%Rzfw(LS57?4)e8+@J5-| zqe=sP6*>cv2T3BiiDls*5V^-Mm>iy~^6yw$_lcFZJn=mfljO>5O&x9I2_mgK??-UG zs6B-kXc*334hp zt7#n8g=D99o|F!^nUpz9e$;u(4AN8;mx|{NE)9py;BG`Nku>a_Y$Q}z&u8;G&l)@$7tw|%1g z{Dq+hDTnSp2DY|MGxwRnB=e#9ycx$qje0uZ76c%H4_vRCVOOQIl}6$+>=gj;VaV`B zhn0s>Qd{4~HILO2cx4Ve61spb=iKOc*8eJ7uSt4tE?ZPAt3E{RqxMfakqXxqhyldh zB{g@q1I_9D#d_F8JZ=#xh#I&ow=*_SO&^1=+16g%HAc<5)*v*f>=c?+gX8XO7D~B_ z#>Du8L8w-OYPX){Z74&(aY~U4pO#xaDfS)%h4%iGqmoD<`;sKEsYjmQQ-E{W!XA`X zq62kHBQ6S6R8&>QmNo7>c0FIH`}{X{1&bHW-1-_ia20yjI9LBuq=NS`kZhL$w@cwC z+Rx9ov?{r5Uci(Dt&f=`RNR-x$o=c+gF~w*;J>!n^#5 zxUCPxXmSzdx-GvD>G?6BQ*&SGRKJYt(@%UV9d>7`f(P0;c)}K^-#$K|_L{psV8?Dy z1x8x0OA+ba^pXBHYZz$KU9!6D70!G6yTTDE)n!H5o$tdPdv%^wzs_EXqCd*pPEg%( zw!cOIvI>R6i_JJzG)KYEVpVB&pb&9jt0}r=JF3yPt5crsQbV+mTE;z7S&26hntn-X z1xXY1K!Wn>NXTrX5o5CnF2EGuW3x3bObQ6(Pn!9vAn&qQ$grPsKJbi4xbQ{yJ@3yK zt>&mF-7+F;$$;PTaO?xW9gMB7r$ z=#vX=V(-yCAOB@y`I3QdtB@!GMho?fr$@J%O+Q0HP*Z+CZE2CCKJdnjB?_77>$+6! z^-Cn!m(+A>WD;s30k(GI=SLn6!8Q_yYrhqS{XyFu=nsadWYnEb5JMOh+Xd#=e9sd2 z{mLoDM%J*CiuIjK%G!B$%Z?37n-fJ{RONK_XxsujGtWr{_v`lvS3zYNK0!5z++G97 zUa}sk*#I5^FImaYH72*;?)HYU2AZ_jOITeVTh8cways#d-F3<8lqWNqk#DHlGu$L$ zPe}7>K&@bJt(dnEz%G-O>FnBtd&l9K1A&4m%66e6cH|S|#t-5Q?@?Q>upgWf6XFeg z>&G$<%LDRe(>b<~Qkh`1LI$u7tOPi(iM1$J7G-CO{ubB2%-3N4i2ZcMc@BQW_1GT_ z?sDS6i{0rb?aMeCebH^3t?jn@n-Sr{Zjc!4JLB7igLRANzUbmByZ~BEoONQB`U8ux7iJKmB!X~!c8|f zxD>RV9I%XpGvgSj+uuv@|LC?dT+##AlOdbs|}6Mu&@9IB_I$BiGlx{hr> zmORYYhPL{?IO8~Ehlhkv8A*AQR>2AwR=BkiS1_gsqCxK+_*UdDplUDMQhal*RrGD< zciCduv%(f0f@&@s9ZrT}7RuM`VZx|}@gxVu*MPwH60jwY@0q}q8&MMrBcO5cT{A~` zd?G8=BOjUeca|7wZVe;Nlv2vU7_GR%ewHVEn;PMSp?rnaV=kRE&{IQ}ARqh-?eY(5 zE&jVWAkw`tl@mho+JLFyWdh1+)w`*$algm_Zo^07>9?>1R@(DVK!C(GA92?w!k9j- zL6um8DuUwzGM_HG+Iw&|3sk(Mriaxwu+pnWCoN{qtrsT;bxhru4Vy#}ExXi(+o04h;6 zgVX8P09NyX{ylvtaEs2klREn69uc{G`0`uSKOgY#jKV*==s%pO|LmfFcF{j=5!Lp8 z{W@@O0AS)qI0x3VEd4-su1bGg%zc3tVytA)J;tEACXIYVWBA&*My1{R2$5tf>y$E9 zE^WR;2EVPug_ZuAw@WsxU7*DPkf9E#f*N)F!EkeHlQ0WBgd(6Bs#}Z)yI>9~K%*Wo z=Y7tupZNm-h-prg%27zy#07zz^v6j*7__7$7Cd(>=!XD=F67vN+L8q|eKO)=H!q{k zl0>Ny=V1h^jTF@%3<79?aO$af=tiKd!)5AIq=6t@I>MqM^_apk-z1r#|9{0GE;oH^oYt20Q`N;n9gT)nOJO1Dk`IFbl zfhNMMlb(cfWOnE0i^c~9tWbBx@4Gqd{XCkEekx>^8F6Jvn6n<3shwCZ2O(m?DN%Z88t})Z9NV79EWaq9#`$z z=WM`%cLXxPsUbL)mD)4L;0)H~&0>{pwxDRTQe<`9>AF<1U(vyCqd3EZ0XkiR%`fht z67x@%t7o{w2R7b{M|sH&TNg5;$*T`1J73a8NPMdSRM&}4Rx^b9qFHHQ+KEtig{ZRi zlcvTGDq>Gp7)0@$aN%WlPV;kqs-j4_fOHY2<|nvbj>wZStIeJh-b90_G*c!OM#O~b)K?}lhO-UH!`m2Gc~j%I9u>cSUnkQYgA#dzKhK|^9-*z*q- z)$v&R>3b(;?6eq$+!<9Ri*$~zSxE7gHR~4~kNsMuAW-nVmoOG{`6$3QLjPN_jY1Xj zOH#2m5f)nFcyMU`WO*pnA{Q$>Y7Qapei=A7tbUYIIqdN$gxmckw+)|r_5Ldj7tUpY ziERZ?nj2UhVtL4>BNrl~Yx5wLKhfF5w(LaLim@nKJLgQqxI&coZ>y)-mG`i{b}`Al zVDUM8BQ2hA zU-g%x(>Ejn^>w_qDuB3x-v*plr+|E?(Nj0bThQicwh!Le-hR3_yJzY#yxi2|4q9#` z&5~U+I#r_W8RZtE(WgA>`>oe2Udf!ZDe~lbd@9p@Z`i8~sSPgVS-k+PdZg-kGx;tR zOZA#2QdR%OEi@3h&s}ixz3+oremODHVW+O`BWIRcUo{XkP@iZOE?Dkg61uDwTh_dX z!(&bTu}09XPj9u;y(y};vFaJI-MsG%!&7E~{lLP91+~eAgjKdV(3#D_Lb^v6%WENh zrKX|Q0-wt&${`44odm;cv3l&)g>6qXW4qpxwJFzaP$#996m%G|{6g@RIv1vNCw!%B|HYbwgTzwT4$X{K2~lBdzmhfZ9N6|x?ay&J6mew;sBQQXX) zJhCoq5MD5}^4ur^VK+GwUf_MDjOdn`Zdc0=4$SJk@-VVyzW$Ix^>fj$c270G3aJgQ zI?6UG359eV!`g2QH|aTbYj$aAKPX_GT&2EF1r~ctY5~5hE$kj!M+HoeXbuvD-dF>| zRa%b=-a#lGFp|tyEC=<_F05szoPG#w6hei-qVs{jXyxZEEs&f4pm9@fb%$qQQ-zvJ ztB(ZdQx70A79L+E(|DN|pY5jtV+y9)d1Y%Am|go|E0t|*vuk@PNLPr!V>~o7aMXhxbo?uJBqalVG5&3j|P z5)osW(-BS=cIq?i*yWCmWE`91{JM}@)^H+~l`4}zj1brbl5C3ON`d&TQoMg{h;q1$ z!5Qk@WI|w!Q_1@!`?&}q{Z1Zct|x&Xw%{T3T1#aAk(`YV&UI86#*W1czlmw!gP4+i z7!d#@sbWVIuyE-P`1PA)g$dnTkxoZ@JwIO}`ipaD{T65x#Ikpk-4IGj{#agB% zv{W{@%Gi}8PJ-w}ezTKGyjRY}rMMHV0udJpN5>7WVve*3#DB`k0{bTbS!5PfDVp1t zUxn->>Cj4Gr5OBCl5n;!8W+GXLwb&6?NYf$%L%1arhW}~pw~aFH%-7tK|SKk@-S^v zXP2PNRPTXWS#oug;R)nnU+wSSqJ(e_tkG~||7V_TyJveZqmLYt{Hi$~EpHn#r#GYA zck0uoKvMKb&+g9NoC8Y<%koA6$ZwdEfJ};-by@A%ZnT62)2me(>5qg;Uo+G28?6MZ zLC1V%vDc1j>LaImF0SKuZpdk-JRve|1rle$iQKBt*F+Z!ifs)IW5Np+cpZWVRP^>hJDuCSUkMsXXWB`9pa+*j z^lW_xwulLjYP@V=M0Agxj11(8GaT*=5bRSNY2}+D~$&ae-OBmf~No>m6rTm5a|X1rJD-#eKWA)9}Lux z;X;}pn0wc;=E>$Fg5=MeFxGD{+`=wB2tcQ^Di8kQJdrA1c%ZpNZE3*F2=-)0Bf3Q> z!n$O~m`}6i$(d)Wr>2Z9>u2&j?O3>-rzWa@RB?Dd?!V2WXAl%*}B(9~L2P)xSy2Rs9 zVNm(H|Fe*uX*=qWbsyWHmcUN5{KHu1s|TLkobZWJbKFcA?l;3Qac+y!-Q~8ZWs zFeI#{lt9qwY?AL2dJsE!C|g%!cuav(PSgp%{;wj2hER zMuYXWUjT{7pfo;yBAWWNfWJu*vq`h{&Zek%GXXay5SvNTz}ma9av}t}?Juk7JcJ$eQ`^zHpv^O}Bytz=)v5bqug-s)l!9eHM(St)e(B_PVkcit8E|z15 zDw;5Ia{COARMuqEISYa7g0H~fAE2yIjo=oC7b!<58l91J7^(ztkR;m2W>9%M<@O^Z zmk2fALJ}TXNr7gzT)l{&HvMeT-`jL^HgKc{%vNI(FTHX;_1j7f?%$7b&RvA;2$SHG z@MJkc5o+x=9s@L`&ZZ)|)HruYTiGwYuMk;7yd@~Q);Ml?mc6KxHtS?_-Gd7z(y304 z_FmQ)8%3wFCI{h&vu`Ta5@qMwEAKf@8y)?*dV1&=5!#ckoiCv{pAQH%szd=o5kw_2 ztGnf#2b^^I8fFeUcpNz%#B<@qXt*rUxRN)zQP5o)*T2K#rGWbir~*8JgyTpyq8YWy zfVI#T!)sqFVwZTiX6j}YUxt6!>x7{<_vNpMOrE5E{mOPvdS=t{xHnrb+KOUsOF!NJ z9A4(F)K|;Zfma@hEEV@CZvVg)jkB$YbveRObA?gmoWh0zr+(utlU=%i!K28?9}Je5 z7cjPs)nMeQ3UVq}!h3JAZfWn!6V)C4SjwGmiT5JXK9B2sCp1aiQwc7gb)yC{+sREh zE@i{8KCpWFL6Yu^QrrnGybN2owg$4#s)Y!7;9$Yi= zj|&B8*>_!a^gFNhNN@6~udu*$i~U!m9ab{#5nc)De_L6)a`*Njp?3_2auK=Fj-6%6 z6i!(nMo_g+g$;k%6pwl#6sRBHq;x!Stft@hgIU#wS7sN+ggn^7 zl5TBL9zyXXENEUz)tiTK$R&KaJ=cBNO)C!MV+hifGYA;$=l$G^Z z1)nfp*_U!9`d;7k`Mgh8IK7)6U7;j~3@pZ8s$42W4J3}o@9ab^2|Adk5~X(dc|hfn z!XTD@_+B`h($F`Wz<# zcMQr#P8^wR3MaYLv1BYLbzAEr;09ePs;*L*CH*26E~h@}9+xd~k*rf?;mu1wrc!pl zyrj$gl*q(Nq=}yX=+2CzFWCK-kiukb!l)wjcz^Bb>_9j;9CnRsCoA8G8_KeK<8|rP zeeF|G9i>`Pr*0&id3cc%xC2-|aw6;?SrTP$qX-4x$3Nem1Z$K@c=(w;x`{B}=%yTd zTklTC>9T&y$1QhvheO65*-8a%=~;!^rtV#J?HtZpCGfwmx|KGu*vSC%b9i3;Ter4K zp|{mDk}UV|iLls9Pop(QBJBKW?@&)*9Ny>1K~?493Ueyj@5vgslCBV$?LDMMx7=jM zbObw`g@X;13x!5T0?Wl~^|^@#Qa&1Ly8WVUlimHSR=lG-x)bF~z*jl^Xa#$Q%TM=PC9#`}Z{tV38(7NA6!w*nbXR5I1ky^1D>66@Cu5X+V+ z4>N2p4EwDec^g&_xo~Npbf(bSphOM}Z$JxWZ%857`b2MIur&<-f`=NwoZSrdT>JiNX!z11IoGx zm7}F0kC0c|W}2h~>rf-`;bWtk1OmLwMCiPS__4f)Z{kMVU-n#<7!=Dv1Y?>>hSb-z zH>g5U)K}n&&nWzYQLU{5EHzT05R{_Mqw5$oL$qaR(&dHi9ZYnUevBK~;A!8o$vAop z2kD#Q4+f7wveB&I4WJLyANh6f9|&LmZ2LbdeknH!vjU|lI7{J_LyGj^fEp!q^A?z* zQKol)Fno$Z&Aqkj$!lmpoiNYF?=(|raCjFuBHW)1`?rGC|53ZorCdDh-5YQDEH(Kw6K>pysoG6gxZp{5~t5= zQ&-2VZkHBGfcTZb!rW_xx>g=*OF1-lj(}3P(%~NGcBTh+)(?M@tUG#MLVSu@G4vMa zS;}bD&~V$B=jz(d9I`OH@qtr^-d2A|o=$t>4Xpz8!u=~l<_oqz7}`doZw;j=kae<5 z$jW*H8`=<#x%o`=)df~glaC^IEQTkUC5*-LvOwlVP-X)AwH%IG#laHJKrZ~oY!igi^rzWu|*c*x{Mv+!0AfCkq$8UOO@2BZ3F^yf{56Sj5?*F=D*F zQnG2gOWjbB9H1zs#9%Yh_13GEE7Wg5XFr}ynZHnJ7G1P_k|_Yni*P5nMZQ6ZmX%qxiK$MLboh>Rkh#ZbvJIpmNroqqb3tFY=|f^zqW*mN%!p>k42MvLzu0Hj zgFHoF#*85K_|2Q(GMq9S#5740yGuIB-Bc~zXc2X`L%Ra8lo=py?7XU6usyB zJ0=~27{6S&`YtSXgG#r&*ZN?tyYYKnE^_0Hgv&KoG0(i6nM^9K@#GCvgZr3~ex4>dg1&X!+$43$K0Z;jccgr6ra_!kY1Wsj( z0F+iFz$iRGRHs|}#%@aOJ>U+yf=BU!6pFAI)Vy$}k1o8;TMJ~)hUtg4vaf|y1*%TyJ1gc%UulbKRH*%J3;K-ANzw0| zbo5oqZb-Ijs69@)m5@nx-K?>=LCk+w<{1~N0yNz}zSeP(NvdwII3mcsXKjz3Kzo(! zz$8Z0bl8^%E7m_4 zK9`sjHo~|OtIdg7F@?7LBE)LMjjeXX=8e=Wwf({Rh(AB2{FG{*N3BC`mV+1 z+fn4n{jh*|*imVy#LhTVD7GpxU`dJt`&xKJRYl~;9S_*s>p07x36DchAB!I;nu4gc z1uFDaJ)a-4ArB#~#P3Sw)KiVgt&?JyhoH(pYUp#Bz2s1eu4b2l1pLU@{2jAkR+E8w& zbMDpMkjM2UFX%hBEDV}s&--+(P_NV8f@3|D7Htnb2!JE)Er_6I_eS9|?vqDSZPV8B zj0gV%z*`esS>17Wy*S&ca)~%V(7`S1QZyGpox)k7&`Gq?z7tBdIr!D`A+wj+N-F)7 z6sdL9(+q5a>WWpZ9MS&b(r?nF3JT}Z`ZSat)Kz$mno4C%AeU3FB9bPV>TpBV&2+{- zE22FASrR=NkjK9Y$A)DY%=gkneCCo zQXP#SS@!AQIPUm3Jh|=cr8C+^3@u>w);L zq|NA+L+0v=daGeApLwz@?~O~!g;(EogSd20)&$-x(NRZ8m+tpJF+=D-@anAaVa3nt z-=>ehd!0G>;>zflu7XX^8~yChj{O7Q``1nlIUFiPrrseG(Wuj|&8<7WQZ<0U4sc$Yi5;1L7R3d&yXi$13Kb<_JMc2(@xB*axBh4Q!FS?=>Ttxw8w zOg0hZpvjr@urA?pY;k6ui6H`3lAj6{dQ3J%2ky+n$BM7l`vN@72iEN^a0QvTO#k$Wn%Xl9L1XY*8FfomFDH`%!(8ix@=_7N`i7#Nh&cSJ z|8v{{vWspX^7wr1xo8jh#eh(q*y(#=w@o!^Xy8pEzY>K%loC<0v29`>Iy8d$dSlstCL#Vv$*Gp1(sJpv z_1Lf8Gw12Jw3>+}31ZD<`_Q_eR^K?noVP^fje+}zS(o=kW zKXq(b+3tJt4gKnnVx);{6+Cd~T~}CNVR>OTm7}qiiE039HbxG*n~|Ff$!k8>8ba|t zZe9}B&#T3x(h`SOypw_%f)YgT9KCp!?dos!-%e_P$qud|=@PcFs6!Bb-L!en=DIP( z#^H=D6SJ5xEtGJ5M$Faj>#ZE;pX`%W@lx~;H;cQz4Ld;Zpz{!6ORG*q+j@#&5|(3r zVAsNIRENVns9@OgO(2`!DD!H`(wF)vewXPBsLv~v>GbY#p4u)2K6h23V<41km~5m= zx*Wb)INaFF^-fJlIxNPaycPPG<%H&wBLZj4?%t4fm5d%Ama1ZFmrq}-oCKqy(NM@n zy-RzElr=#_>f!Rqtc}?E^4-`lHY|V5mMO)6qxF#Cn&M9D8O?W(Gy}K=xffScS!@(d zPK4T9c;({|Aq!F?n^Ia*-Grw_g3n%wrE~8S8}{|*X>El*aiWNmkFHM`78A1w#x>2ltY5KeY&)pn{TN2S zH+oE3q@7*ypg_p^7gxhST-1B_E~dleqv+9l?vAV4RE(g>vo}vX+~7Ic01xM>_#Z|h z|GyCD{I7)-|48-i|0kiwFpwDo2_8R6gxBXI+Z&*g-#2)NR8%Ef9dj0Lk7#x!nch9h zImljV$TJ@cjok>O%HTjszaAB&^!v8M>6hT`@6-YcRYo|(>Po-v%I(StH0VVb2kIy4 z#=2^Fr~wrO43ZmYP-p-R3RWo;c^dNj2Jh9r^RV?5xXb0$kKgI8+v(`{6)-X!15&Tk z$$-nk6o;WYNB+`~`v^5VS~~+VPNOca{<$YX3;$5t&e5kdSMOUG-n;~Z)rbuJ=7pT*F&Wgq$a#U{nFxd zhXZIgO>dvu?O>gSdn&g{_yTyD0>mRiU_d;=!w$rr#eQws%@U>iw68qeOoV)^-Ee&6~PZO8h8xQ684;GdF?y*IB}7LHZ#ddNDzf=F$U8 z9`l4RCy~6qq=?ZHsTNt*;|j!;!kk-DDtXF$hKFWi?5CJV^zQ$}caJiNpyBjGos+A~ zWPV+K2sFzUn=5GJQ~)W zIJ9XNdFGG8Js2fmW#GfSc<_d}z}^020u3?G6@RjLv=K5`Ai~1)YClWW#X(nfZc!DZ z9yoCf#fX_hz^R<(U_mBst)t6%jn3sOJs0WmR5&p(;AgbY;?{sp(o&-H_0zY&INS-Rmkyo!ehO+?#^n)NDZTG&Sl zrv`5F#G3NdNjN-vrok!OMj{!-@!QeI;&+Z-3OIVJD<53!D6@V!B4n+TY*Wa9>g=xs z9%EAuKzDjkSRDi-9a-8*6;aTotAG5#P)tf)pMjIX_Y>4Dc!-%@LT-2_bK*JZqpADy zt)h9*)(;aeh>=<|a1s)XuMVDjrn-Fd*Iwzz3>gQ~7(0OgW&92g%6bAbyYc5cMVBIa z4rFM7!_b864~En9?mAQ_8T><=+UfZo&Gq{({9PwSF1^FjUjkg|MLX4(q77J?FyNoP zlv!u}gJ4MQ9PJ~_j@2Lj6DkH0rU*wYQv76GsizdO({Ag?hw`PW0QH>|VLg9!m6X9n z_>nnp<9uY#mkQ6pr;>Q{qcREA@&lUNFyTq@jl2QB94#&9{N&x*rdR-CldKvw=;JijE`&Bd{|AEuJ$p)Vx%~%&=tB|{z3LunzN#NB zUNi7(X)(A(9I6tS@x#=}@D3O*4;4(e#0ApD>{9mhtVlg?_u>t*dN-;#{K)M=Bj>Zj z6_W>*-Sbk3{||fb9Tmm4^^0Oe1;vD9S^*^qC{bc>16e?_#8wfZK|nwBO`Z`LBqn&WmK~-#ss&+Ey{$cI0IauT07L3}UhtSv)Qngaa8fe$Y(j z{B7&~)9oJW%gWKUF>!cruV4~X=qHUG6}sR8{o@ZsBkNS%G1QmFS`=a&*nkX$z;ANu z5Va|(oYR!lSkM4W90}Q$NhQEVfDm^Jf`A@I=ij!|jA|HIHu=0%iaOZv1Y@`2dc*mB z_^4gs&!}B($R$>2`2PRkWuuW+P31_ddCbm9NE5j;o64%*0IDHR^ddL=|7I!t@eSsy zGk4NkVQSFg+3(Qetx4k1@L8&rE?DoEXMWHSkHDdOE5MRb{^M{tO@QwMp9vYkZ9qo$ z9VmyC!EzS^i_t$4hol@VNhR%q*#PSL_is?)0KV?$N3Id}7}m&T)R*aCMa1_574^F@ z1hfD9H!v-Wu8saVBVaZH@CX2P1dUgb?JLOX-wz?M8Gio;1t#G0v(MJ~>P=}Bwpr=frXKy-Y-fwc`DSV?8f3J3Xq$a!W*>f^|D!(5>14u0m}qU zhGyG`%l)y8W*K{N4!Yal_NIpF1!bi-PGx3(4w8(53~z-@Sy2&r^Jhq^gz6tO?f)Y5Lp+&b~1OLFk7d^lg_y=A$<4#e4}FbObci~+eoNO)dcNg~F5F$srdQxh%nrzUpMt;e=UPT= z{+~0GEx=M8x1jQ+s@DM)0AOR#hx=Kl1rc=@Zv6rdbE0fe(7npI7&*-nRL1w|vQpCc zTNeGp3WL? zn@9q0_*W8?(OUv1QJ?*87kL#q`KD_Z6)3n9PCX7>d!FnD3?6tKWA1qi?m?k4?iXe% z)0YWOXtj598AP!W=ydYVrt!c1#d`{F)$QKK+RnJWeppP1nHh8J6*AwtPSBjGK!F!S zsSwJ3&|EfY1WyFm*4}^uO^jpR^s>w~*Ch-$wq5f|E=oMraQ__=8`7Xm=Duz)&)BnT zV-|+|j~D(3JclO&-_w468^kz|+{ldW|7~D%t%L-P8AWO9v!0(V;?iGHcYT<8Qt{uP z05!-Q#{9zvK)}xcqvcq;euW|gT&aLI+z-#eOeI53tjigp+@~)upG1Fv1h-Kc_ZY}x zwaKe6K#cqqSe0{+34T9l%mKdz`vCDAEYd3CUb}#jEPS7P_j{P8hmW+n4^q;->EG^& z#h{Td?RKD}Y>lz}dzUIg7)Ur4Dw<>g3rCi^k(2hqF{>LQ6yBgJf=!Z*1y4q88@Xo@ zC!wnQwV{EMxi7Yu`d>3k5nJi6g2emSpthO+YpBlq7{@&z4!{KAGNH;_yCbG9# zQvY@;opf}Pgw9svY)st>D9a%?TK(<*opaRVP1v@(IHo$tc@0PAC*elJ3MqH2h(lio zh{_;I4uVOMx-*lclc1kUwf;7{qUM<|Qj7x-?K&6UtDZVOEISY~KgT($I|`6({QE!5 zBNP#Oh);;KWF2e=8dbl^^eu0z>C?nT;_>f>*D1aZl+jHp82AD?Z9R~7TC$*%L~1sd_V27j?Mkvl=DbZ})h#S{2~?^(&0V3i6nq?#G6eI^$z;x6!@ev=^F!aVm8Tyxi= z!n`rMv+l(TS=3vcaV!sR1JWJPUY~a z9HSz*e$do5KSpt_-I{A{fZDln>$#Yx#;UvJ7k^%9RV9 z@p~*Jh#`?NVfuF1qwK>w%-Rj! zm(Ld)e;*q+2EF1v>@NQ7u~FJW@0*^phP-v0_F@F=G5H{Y#8992FwORfAoRkRaz%{N z@Mb#4lQ*vNQoQ=Sm2YjQo!w`6l4d2BYeUN%2()W*9QFGMTWDTqWVV@IS#@=CY|T(R z-i9w%W}@ujbj_7by#e8w!oGEG(Jn_ZJC%MHo}pI3nlr>PxM1-@7X(q4dc-0MhI4q6 z*}t>u7Hg+OT+z@@_m^)s>(V@``h|FcJWR;Ub3Z%VXz2Upp6Q6YJ!IUZG~LxQVfOHX zLDzVf3vO!x9UI=CDd3VUXkEGTEWHb}`7nP=EdgKmSE6aX--|GnteCR5&$X|d|FibG_s6cLh7KnQcO zvBuGlI&8bEXe9+B8Y*Pw5O-403V&pM@s+_&(PIK?F&F1fD_?wd;IPxN!-f|`809p0 zkCid?WVub1e@kI4O1>*4?wQrs*Eas0^7;!y`pbyU--uio(T2tn zTd4h}Fr{nRJDbh7{n|6s3)_*}aoMa&g=v@q`7R|0!Q`!kvo8ekkkbX(jFjbb<82qx z9{RanG#hR_Z+A~?)|?`T8?EE%Q~6xS8t1|DAUF4@D$fp$VIzc-D&K;;1%EDd!XV&l zPwC}%mL_@+JX2K;EJ4F__Me^F_r88Mj}&-g&$e(8cfs~W>ofaWd4A+o&z5}zkR`3A zv2ecxWGGLc0*g=1PVm_t^&A+CrFP_s$Mu}X(+^&FmO6iF@JRi;i7{M`b_@%Z&>Si= z*cc(t!h&Nw!?Fj~5kUq(0bTxwGFSFD4Fi<90U~Zk`j9wrV94f!a2%~6u*05Dk~Mrx6h**oZ;_vN zp^LpF@Gv&Oo=1(x#?1)DU|v`IU|YNH;!J;2hUb_YX&g3wcgU~p!SNTgFZT)~Iu(8T z0KjBAzz@N=9LMVRdPmmmMC*)0iTcTp7v&OfZAkMb@j?6$p6X}Y6HRV3U(6BE^L=}h z{nbyN=8I=w`qVB+iLCp}_3FzrV-b|H&{)=_ciJC8cN6?M8ilZ<%F>5s#7yOl%=0Dp zJ@abht8(KH zn*W?K2tV?h#P6mRf(^Ar?i>J^F{~NTrsrS=V3Q2hY=#bcrfx3-Y5*)lB&wv1A}Sua zr%_uNI`*i=#g<3SaPQND3P`pI?5J`kh*|ajr&1U(fc!oAF>H3 ze5-PiL!U6j1E_C|r1WK2)dYauM!4w#L(vGia|rfYa8J3nw&^ust=?*5YvbJL;ZGoDEC7$5R@8JEqmoVhFOL0B^z(j*-4RCF!vb+vm zlvW(3xi}T(q|Av9$w({cRMWFDjPjFkdqUOLDBDskJ{2U;(HQ4pYia8tpMf1U+a$@? zM~F5__W2LjKm6=|V+sDfLrF&?6WD?g#zy2I4h zXHVVaiVTwKiP6kh>d?ztznp9PybGmpirU9&7+4K;p$*;?dT!>XUIyQI^7hSCm7lU$ zQ%XSA67iLi=rM_@RF+yX82Q0K%o)o^d-FR#pcS57&@w2V>PlWT{)|x!t>H5ImDBO{n z+V^cJ|F~ZE(U~&WF{PiDdGow=T2<<4Z^+3!@+@t&~R=pd&hI?P2q;W)3K7%IFq*gCl7r8-?wHHr5M+UF;wo)5~fjU7wZ{pQ^=-8 zfI%q3@UEBtvAB=vmmkX=c}JtV#C{O$PxHC4L$_1wUoh_DMPJzK#1kr!IAuHJ^Z!ju%8OHt^pw?T!uOpvaMYnm&1Z5%zc+j%Rk4@Eb#D zm4;&<#@K1UT=BU``<|+hJ^w{PQO9_+!^h<$xvJE_V&Ftla( zI_{~Vw$L$G7_heII_msg{>yc?ig?NU(BdWZP^iGFU=MXJ*Ma9rE=2|;I7tj_{^+6QU& z>i&g3MG|!MtkOenk4|k@nqxP(lOme(A9iPej`IwnnXJ*X$2*Kv%{=nZ$Qp^Q6aPf} z*q~)6Eu@vST_elL9QSm8ElSxvzbR=7sR?&LRK2+=d7pN=7&@}Zzg4-^6uw3mWEIBR zDgHJinhTwsEv04Xe=x_u^jD0Dl)mRx9X5Dbd4*oD)e5nqiP0;ON?&-U_0B#!0KKXG z-^k37s~jgJ%pnJn78NZWYRfUgh((G+Nt1R9I%C)bO}8*WK>aQ zd#9||oR2r&iayk7TD3GJj8l)kVZe#0?P*Hv0+if+KNDscLx4@01YgJlKk7dlX{U z=1Il7-+ify*8vG$@N;cNuk50qp!#1O|NDq>0i|^O!mscJ|I>4jPY|qD*S;i#;Rnso z_$D=4-iHHr1K9Ua=-jY36f}x+!w~Q7?zkXW-XUxCe+I?6#+?8YpbQL{PRYNBLG5|f zr)~+ar0%YYP+!<${SZq;!(nVHxpp6s-H3bAk3haJ0ks3K5$?Yl!vE$lJ)>cRaN?;ol(16?~Gl3YY18{$a z)Ke*ZkyV~E3Una&DFq~AHM5Hvt!h@|?V=TCo;_<6M_NY$MPUWU+I}nLlqAHZS&t?( zCY98Y2l3(kVGfqkl*uA|}`KWN+ zl%KAX`PHIZdxu}sTjOyJ3zw4}CA}u!Z_TJI1O`=JlcvvbIwm(~sFCZfgOe=Iwuxmj zevN!Iz+qYaicRH_YKGzD!s#~(PQz{C@ueRh{YK+4@Ub(a4{R*ORlqU3J<{eZr@(Mh zKvzRGH}6iWl)QpU)|dvLY;C3L`q01!Y_2GwOJ!(X?z)3Z7Qsfnq^G3ns7WwOBwvb@ z)D`(oC8fkTEbJ-i79D-w6k(&Te)91<0c zZMj;%Z7QD1BxfWp6;Yd)S~|+cR-w?r5btv4w|6mk`-oQ|w2$r|9OicHw8Vt&=9yg> zQw!U>5F5p^u6`#}C@t9`PtI!2Mymg zi^@Ibx#v%PbZ6oM(aExUpDX*hNf$n@3eBA!y?s`L3xuPuy}r2}+i2?Dfxdl~<`B0c zjsx$zNN4bJCJ`PB5$I_PRr}HT{<7GuxAlD~nV)(dmRU;)19*WkgDCs71atKb-!`%+W** zJx1pgc#BSmHU5ju|&1|8}2>&Zp_b+d=in|ZB zb=FHOn!ZxTT~m;P)H9rJno%EjU(r#|g>g5yTy2iz!Ih8pR6ji-YC&^}O=;i@GjkA> zZPkE!v3M|l6VdX~Xv#$5lPdkQ7pejgX|MG!zl)*s7apN?>~yNrONbL2$n&tXAA^}u zmF?I`w0=2?-C6w)wN=M?uf!lVBdzrVoFcJ9L9al$-6D! zUcO+;r+U7*MV6;Nv&ny5dSX8DX+Q5gbF%7XB}C~P1S;5jdPiuKCfsxL zc^)-}%DX+SXNgORK#jUTnpoAq_Q%1~;jZ*$7sPn9H2;d*&paBZCX2=l4>&qqEh%_g-W!78Z~DvjaT5E8l~HX0kqYGQb`;I3%Q z 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℞2}JtR#orQ4dx`Jn2U=~8t4zz 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

sctVg2RtT_D<8w{0i%25MYZ|X`HSFX$2%T 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

;6!TFC)Zb6d}L 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

QUVJ?K9bYRmTw9r$hQB#GRdhv=)5I z?R8>6b@pR6kQtoXke=8xuS0!D`i@xndgbUwig6E9M&VO9uL?r1?)8y=(39XHN}1o3 zA7-mZe!!P5%AyWq4pIsi<(bZgXP5if{=_HYTH#xyR&Y#!ld5~DJ0c~Ka>@rP0sr%^ zX`FnkI;kjmb#ZA_)+Wspr(5L(g}E5|Tr2)f=V3~H7DR%HA>dKjw8&-y+A#bFx?l38 zLgSN&kLJR0*Qoos&d19;I9M8H^FRC2EP*y*wISW8z1yu(5kHeMf)@gZsSuQs;BX722Q`HB}*ZjhN7|1$JFwTmL~IltZ$=#ESH?1T)2On9Z$dK zt&rw^M!pkr4#%S z?i0n$O{I19GS*i1vqRB-&uIBNr4hki->E2{c_OY4@(X<;f=m-hgH=OzcSk#Vjq9IG zh|ySL%Y7_5KaFK5_O?f0Hgq-N#d+nIfi5`uD@>t2`)uDTW~?JrxNH>$!cFbBf8^c< zN2}U%LG0?b!WO{D3?HYWT=30U$sW2Uja>1C!oq!z<_0uM!wczT5DcEa&uIFHCuiZ` za249)-o_>~C*|1ZjCNa0tka1_KYk=(Z3x`%%jg?LcB)>YvaRxu4xuFR4up87-%0c1 z@X-m7G6?abv1?hUdNRy%9`pP5aL4=O55z_->t(J0`*P-)rnA#BzcQN&+~Bji91V%& zu&}@d5K+0z&i+n0+B3T$7*)f)Bc-tP+G$hSWCWMQj)HQ8cVc64%(c3C1uVVUS@WAF zKrZIlV#HY(MTAxcMQ{7l&k1jO`bdDY!u^Er>HlCv#_FN7h}h=5#OVH<>OK z?7cf;2GTk>d=0xW^7Q3CQcF|)JeQa3hcAu<^0-QBDr57PfHF4eWsmZ?OVq}v_dXg6 zCtIOM8%^cmU#^t%Lm#=+dv$kBu0N5+Rngfp-$ve77c35#o1IH41ul~ZM{BQTIp-7$ zER6dqG^c`-t;W6`s#W@F0L6|XA7sH|F)7@G{$%{yK#nRtq(cZ0B;nJ`N^7g9=^loTXU5D9)SR78=M5?2AgYJyKvcv$dXlkbQd;1>vI6-iM*)dbNm@CAZ{l$J99 zfCOIVh=c_J$jHJ20N{?K#YH|^z?^8y+k8~R7GlrlDo`>iD$YnEHv5+ABCX?C2rp;i z5(Hl%XCW6Q^Fb_K!4iYo5WH^}9u9$4CMqxjXvv=}{sd)PD81AhD4_=t5@TC3d6oS% zu|2_3$!?}!R9f=0^=>uSdGh7db3ezM1Y*ch1}dOO?=crK7GOdM&!PdB#r*0J5!jpe zrJ&&LMATRKN!^sJ(Exz(75Wo9i~62 zz!B`hCz=|>s=X*eeG0+%sQK_4Bmjbf&;I4D5KmhVvOi{L#lQ^%9sK390k5aPaMC$6HA=_{liD~>aXrB$)GMqi@Q?np8=YFKGUM;1gy z!lNmhG`IcQ7xA|u?x#O59z(6aU5ji#H5?C{L7pf13s9L&`t&HYyAcvF0bPBPEJnV7E&YQl5Gb-!HG}I%&1sJH9nx$!8zPbu0mSS^!L08YthYuW%9SR zu*iFS^b+;tIy^p3`am-^l~O(7Bdy2)^<9;N(+rUFNqz#c4#}>I;HS$$xW(yOr}wYp zrTQEXt3VsS&yMR|zR*jtB=#4NkIH}^5th(Y03q@Ul6(^18 z(tuFBQaFzt$MWEQClTn&N`O zioATx7YmLu`7O|*Eio~%KH+h;m7}72-2H%rH@?CG2hI1MJLUJc?|jD)_X>KKgXvkA zFvy4?5s`afYPj-I5i$V|wxTZw2VdPYf^a$DJ9c3$Am~3|cH~?-DKimseIptH+U{a01>1^JC&gTd()Q;bDT` zA%#g+O0P}>j@O9uFe$*yDR)dPr@JNJNOg06*|go-4c~VP*Mw!>9us8`XQaTDZAIvp zf*2Bj4YLRO*Cqtx99NR9Xs3$*{$|8^p;}zl_9Op1-#ZXD7Z0vV(eIJuSUi({-icd; zWI}0?J`A1Y%w5}K`9!{j32R9G0;<+V5>d-Ensg8oTREI79}uv})K5I&();pq`1W!z z0QT9!S>zH;*p5;cNKP>UojrRSq#VXY)OQf&(J%Tr4IT$tnRQWyNJXZlw{)spy>iA% zE4T?_ag6KaYe&zD2$5#>w{U?Lo_1w;;sp1u4j0}5Mc1j4A>)GKMF$%pOjPSd9W?@r zQ&AZ28gx9dl2!6zoQQ=@ZGpY@2ZpIb7!i zF*6~w*a#qQCabkCdQ~Lruihfcv$Z6`KRSp8Gol#M+aSmr9Phw*UneTK%HxpdAO#}9 zj%PCW>K|F6 zWa7X(T^kcd5Yi02yqkz=Q;WpqKPb#UX`S}7tA+?7mit5m@0889i^%;=|eLw78ZXuS{}~zK9@hGgd3gob)K*e za?fw(>V%xU8K&`S&=SJ9xkH-*x!-#GJky<@dRI6S!{sZCF69&@P73D?ijYvkE?KZ; zMzLob@cT#!{*Zk7w0A)GD!}v!BE$PJYL+){d?)#gU7wjavC?M2Qn>pnj3bR2+t^v8 zeQkNycjD|sdM4xwckkJzo1!DAth{{Z{kH(moTp|9o#djk*4_m<6Kh7RsT8gK_V)t4 z6#$dVm`pAu)g5@jSJ8Cn9d@YQ1E^lk%`5N7+51YJ>!k>{!)?V6NYY&4Zd$uO$6#&N zbpGnN*yKxS>*a_gIDY4W@gt3gl}>X^4`k}+dO)Yw<>A>IpvFrcrt&T=-QODgguI-K zXTzzGuViP(sb_Z{=r6ULq0Qi0W z2fKswzpy(*zyw+UuscHL`hx)gXcS8^F(qj+F*0zagin?>W&i+BOpKbI1rgZ9Xm>WJ zpqx;(;Rtd0DvUyflBmv+-_QnJUFEV%k>*-{dtiEdI*~R!!NcDElCStd$%pkY6T82= z*`JK&25m*CfjJqGYWW8ljZnjVkkUa^@liTId%9&??V8!C&sFwWj`wM+`5DYXYnf(B zJT}Cej4DQ4wk_wdxNt%G&%t4NxUl&e%Ea_~rE-v5ib(E_I_qM6-Udr^tDxMC2FH?5MGb*q{4^VB)7%~&8+YHnY~&zO%}d63;D%Ze%fK!nhl3h zQ?&|DMUNXBxR*eFVy&4s$dk7^Dm&OMFwS&c&8u}dGXmw>_F9Bo*?udTOwSbxJ~PsN zqUWUA-&F3GElbFic!uAyw)Jfy+E_`+jK>g${rqz+qq-R5OkB5O1+J_s_e*7CB)Q*y zFxM5s7GwA%_x^}#?_zmb;y_lfTYodB_T?o%bWcQ^PR7NM)03@g&gK5@A!o*@x2O2? zV~3~It*=uq@5wKpgR9^aM!4sq)TAJs{-AJRzJ$o_{uZeArwlq2z7@f)G>|Ew5LJhH zThF%mU{V$tm-`2)?3<&<0F}H~@%kty|7tDRa^>h4#bw6U!=ne~feBonT%QoG@&I5L zN<9J$O&UvBC!)M26ox6yd)W0iix#CpsIY90$G{CK{0^TCb17(2pH2EU-jNOBt!Jcw z{B0sp9hT|Y~wOvstXkis7;|1qqI*jdY#XM z2DQ4s7`T<2w(zstG$tMl9*&;bZt0(`zH9(@G%lK*hP21p>*T&2+h{tws}X>w5#O9o zrw>F75MMc7>}a4#_@xY|?^j>z3250fp-NPw!aQ0%sN*Zdh*w+(U57O=bW;1$ybN}Z z`;PdI`%d`w>Oscyk7jRoZ8ABKIvWh$T3r!nuY14o#A`PHm112XLr!6XL-NL{k84xe zi0zUZ8Qw%xc`+cR^62SJE_03`F{%maUdfYg7n3?f#8WNgwLC~o?c*E`lu-xg6#j{gWzI|Szxg0( zOIFw-*rD4b?m>iA=ore5AF$7$uQ0nrdgwc^V8qX5pqYKhMKCa${UZo4<=@&(x16ox zmIS~5RP5zdTtax*lbTaBJ9o1HRLK67lY=cC@a4S<8SQ6mDMU(`Jq^R&XVTO|)iXyN zhKh@@ZMb_B+lT?%RvB~Vy5P~XKz&Vw^-V6HkS1{)am{`??r#K(kP3d#F5hsc@LLNI z-!hnoQX9c#h2nd_Zl7cOy|4Nj2rrzz34IW5P=kCM;JSt56KFr>hDo zD~Ox2slp5acTkO+#NUoZEr{ZsbuPDSu&3G_i~Kl{u$cOs0M?M62#VMV&PDXwC%SnA z-IAnDRC2^EQ?X?}<|vE%*wmYESmh*bOW5aBl9k*=cX^tV2Prye|> z?sV1xFe>D7am|J?co0V-I*5hs0V|(_mN{WXJeKAT%&xIEb|wR{+%E05HF~ni%M8M` zw5U5FY%*^BbyV^Do)*#EV%~Id=KBTPi zb{*vuGHBx|lLZ!+jK@E930&Y}dBk>5$OjR-=(|I{s4}Wv{v8EKLJ1m%g;6^a4?_+P zj&<#YANx@Q!pFfF5!qj%Mm8(>hy@~-ybadjG%FmV7YGlv7=S~(R`_9wYcazRxfiL1 zI(!+Hx7w~hQt1v7#>dFs2^PCIjKA%IKmcxbmSY@84PE4J3HC@LD!GS)n32`7x@MUCcw3kg5M(yszCw(!!Q5< z2Kb%daS8_~GiR{ccW`F%u(hd3TDMyv!yY`NJ|TV!PErfHAmuFW8Jzjzno)cTktUC6 z-Bjz}kX_vQRI_a=pC~i;(XNNjVdCtGXK(Me)EXB}B~#*to>^1Wp8QE>PQF{ubNx*A zvj>vN2ZJc}8>iiugu!+_;Ijj}X;6y9t-7ZBb-8|vc;|5c$ch%fX_tLj_HnRQnaC|u zlX4r@yzgP9f%U}!qDv*IsMNCpM<;jgf<13FS7vcSNZD;R6c6QeUAEL%75*6O%6W>- zq-z#=WwunkYMjDP9$yS?#mp>4RU4rL#i!+rrjrI2oJ;j;``{JB3LPdA@%GDx3PIev zS6e)`2UB4}{^~d0s}&vV0%%fWk&u)kn2>T>$TXAAJ@}#F6eD<%uhBP9S&e;Cg6e6z zu=k=43m>)d8*4{pTRQQ0;7 zB-@x}5;_RY42dowJyH#g{&r_$GU|Prc$&Vf+6J3E^>?K5A;(UStiAdQiU;}_ti-I6 zG)PEgR0n^t9u;?#FYrpp*{U1@oC>RHG6#>U)J+KsF^s`DXC7$Iv$}550g#B&QUTT| zh%AVz?}zlwqu*hWlSe~(7$*_d+Mo1mB9HTL<+HrIunsrFxJa0Re4pd&Pth-ukq0pB z6YX!wL>D5H&}zh5Ub9wyahY7=ZZ$f^Emh2$e)SKvKiM@|1}n@6WzJQY=#N|HtEH5vS#9ZLG0 zw9ff2JxDb=z9w$B*Hz(lyYEhOKX8_vO+pe7P|YDEblH-TwBFq_dUtvDf9Iof)}|fC z`soy<@#|(zWyrf1tr|8Upn+BXe4dvW%Xlee;m1VM9%h4RdIlf7ytI=TnxU?SDG4-2 zY3XN=1MdCn@&fc|VcMqhR+r9*O&nK%eY5CFVW!ZKJfU6hpnEP^5lhxFV!6ApF|Jsp zYUsYTK98xeq1xTFK#ysKnT)rkBkl+Nx2mK%5m~@68`WLk;EFGNs>~8Q2&e*3gh_&& zgc9_Neg{`gNHbJ1wm};+ZyY{MVZnmrzBkP>JRHu{vK3%sa%OuVsWD=Mx1ptIuXBR? zVtoX=iPXT&Pb@|^WIIU6ongaqMQgtp6k{Y=x-JbB$D4nRltXl)ntF1tIQD=&Tf)@$ zY@ROcA=|TJF|tua23rhXt{=c^9hciF{rWtk2o?taK2*XXEsk%&;(`VV0Qg;O?YFpa zF*3F>Q+4sQG5bSc?5MBXFSDTgMhs&RyKAm2z@)jP&Y;458$)Lsmw$T^nKk^adT`KEySDH5zd_!-7 zVHIV}Cf3}!*E47p9!;XOCEWFBSDA+Mna_dS zuuZ$4fWqF=3u=%nS^sCuhn@J4>?n ze18`jD6Pix)G_sG5a~SJ6B#RZ7A|~{qM@GIHjBZ<`~ykg@*be)OU!N(_HN+pSW5}C zwYS1%vb`c5PV2btXc0voj=AYXi-}Kg|M;6yqmU7Yxx!fen%y$7G(C^P%TuMpjR-c0 zh*QJci}WASQ*o;zoPe@j-v!M(SGD=MR9mr5blmp6Qm-MF6^T=WmF*P$m}XZCk!p0J zPkPS>H85EGL6FqFj^26AtkG+I4wGfNA(I!@7iBit-TdSAqa(FWa=F_JDQarzi?O1v zJiH>9VpPPVvnW%(jNLr%4JyrafDLqW-#JXEUSHoHeJU%0bhq;5(t365yoT-lRh}@q|ZI~@x%xqbI>mafMN&rnB8Td>8{SiGWZ2j#$a@c0IvEAgbWgg?8TWA#m zcAE>1dA9H8#MnfY{q1I^7jC!NOCjMOr1lRp9m;c*0xg~PdSXPTG6HC)R*rWEu_gv> zDn&|-;>$kR6?*tTjn(-8C`e`>b5*| za3Ls_&whzSf3hT1(K}TWg?Gwbt?zXnOOn=NbWgB{UEQQiu}^)s!0wnDVL{Hu+%(Iw z-SBwxta+Os+^m1+wFn7ri!5-bw1LGU-oJIsAHwl})jMAj^{iJ|utU$_p3o%j>Wp<_ zD^*HN8<9eA1{d?1>s*r3v=ic!%uJ5E72UjNYnX!dBPbl#?s!Stx*kf0cHnq~HD~h} z^zxyjYn)ixVSQiS!mN|-dt!D9Ij6`>rpNcT!>oT*Q=i?uY}8 z)rH?UnE<*$orojt{pFmMd_Vc}k)&Y3_}Ep}3r-S{c)|jXnMn>y7tG9m99K6s zRU%Bp;@+_O&w@^1)sG^<;ryBdqySnh!P6(cZ%Ih`c;88}arn&p~bHJ5nu-WzRBi|WpOz|0vi52kq?<~RgzhMcR2|?68 z7Ua;)^1Ra@P=sv1RMOB@nbAedB+9mFxP)5;X#*ijuS_~~YbiD>x4#MC)-6$^DsR>X*~?p_3@#@O8j^mwjr_H= zTDrxnTR(1=E_zQ+VlT3wC=`hMs=E(^4kF?H?K=K@Lsxvw@-D%jD1u@BUqJkS)mqcf zBGy6g(L>HcKyc~pRkec_N@5}*y0S=}OhUN**OGH)azeS|Jl9PQXT!7# z2>Iqs2^Xno#Vv4Rmh}ldyot9k-`>u|I*~`AXa=f2-7CfU5EZ2!4{t6NM)Zk>d7cv7 z(>;nM-%Wd;t%!M#37%nr3`=WgMQ#lUdS>F{#DQ!@8Fg-

g;Os^o!+)+ZEel^adrIV+O0#K zT0>*`anG(yy%tzJGf{3o&(YJhdvS0wQWCC;AkE~PDD`%z2GO%`tT5s_0zcTsRKi71 zEEsc+$ogstzAzmEvou_;7zcTRUXoa&kEC|Y?ha^l((-fc29hE5KACiUe1>7ZQTy6_A#p+ zODr(L7I66~u(PuhWqnX=&psHh?DFp0(BjGE@X5ZH?@f&5`_m$U%!$wE;SgMd9(j|s ztSr&=u6Y#EWzheU2}I%yWmaY^zyifcMb zRrh;SIfoEuYMnzmoD9RY_>0D3d6;Qx&mF@Z`(QrWDGT3^ZJK)$m}j}bi!IA29~n^H z{cRlJQXK9lK}y4M)AzdX+~nqy7PBbNo;O8Ub|?>5_?=44_20W^UnuHz*W^zVEs8dn zrq6KfBL^`bk6RDQPDGR^EM&f(T#EMjPWqV3%VRHp7V8fA-b4mWILm>HNK~|&2o8%c zcc@WKK^6QNJLV+6N8W`~!M=;}@UsYnD3dpNEKp1IsR|UBBNg=mQ$3u{sfEbMkUF)h z(iK=|zQo05qfL|Bk0?NRvRz!7Vr-2ex(bOL81%?gN9Ztx5IeoUE zgbTVRhf+cSWPDe);YEa_Hhddf1p!+Lql$EAy4v2p)~^2^@+grZkmv}z&gT=pnl+a^ zgldUvL|e(=q{|TV7f0O;C$pjPk+qYSIF=Ie$Q_D%V99f46I%xt4BX+o+S?p6D?dK{TPVkU+}l*!TtLsdzCbHcAefPl3b& z5l`i!9}#Zh92Dr|h7!YESznBkq^~^L@~+!FdfZGE1kSi*h)>V)7JAPxx2{? z19!>@_Rwl8&%Svnd@}YofkV+P4)Plc5^*hpz0UW8d@Z{-zw$hy7L_=Zyu5WX(Az?2 zL&wi$Zx6XmSEMn!^OCZyQs)Fb4O<~3H}14>Mvr1~AKjqIHKi-CX%3atE?YP3L&`Lu z#qI0Tk;|mSw4|~%j0Q_H7d|Z+KgJ;!-Y1F$lI0ueRI%6u%LXgG?|T0L%V3yV%Qll7 z51S>X+3_KOzxbRgC9Y+JElD+e!;_&!GK)}S(tw_s&4XN;3Og(@v&tJm-|*rg^nsc# zUfVe)jRuE3{Ohltnwkyxo)15=X+^9W`rvY~&P|fvjZRMQIPobU24Z6@j7%`vaaUwk z7m&6pgr7HFi[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 mejxUFj~+l_R#&H\n", "\n", - "The sceond part will then import various parameters from Excel files to add technologies, demand and constraints to the model.\n", + "The approach chosen for the tutorial can be varied and depends very much on user preferences and the specific use-case. We have chosen to split this tutorial into two parts in order to demonstrate how various methods of adding data to the model can be combined.\n", + "\n", + "The first part will create a scenario and basic parameters will be added including the modeling time-horizon and the discount rate. This code is a repetition of that used in the tutorial `westeros_baseline.ipynb`, which will be referred to as the \"original\" scenario throughout the remainder of this tutorial.\n", + "\n", + "The sceond part will then import various parameters from Excel files, adding technologies, demand and constraints to the model. We have chosen to distribute the import of data across various excel files. This helps to not only outline a possible approach on how to structure the import methods if used for loading large amounts of data into scenarios, but also demonstartes the required data contents of the excel files.\n", "\n", "### Online documentation\n", "\n", @@ -47,9 +51,7 @@ } }, "source": [ - "## Ready, steady, go!\n", - "\n", - "First, we import all the packages we need. We import a utility function called *make_df*, which can be used to wrap the input data into dataframes that can be saved in model parameters." + "As in the \"original\" tutorial, we start by importing all the packages we need." ] }, { @@ -66,8 +68,6 @@ "import ixmp\n", "import message_ix\n", "\n", - "from message_ix.utils import make_df\n", - "\n", "%matplotlib inline" ] }, @@ -110,7 +110,7 @@ "source": [ "## Model Structure\n", "\n", - "We start by defining basic characteristics of the model, including model years, location, and the energy system structure. We also definie the interest rate." + "As in the original tuorial, basic characteristics of the model, including model years, location, and the energy system structure are defined. We also definie the interest rate." ] }, { @@ -151,7 +151,8 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "Contrary to the original tutorial for building the Westros model, we only define commodities and levels here. Note that we populated the set `technology` and `mode` in the original tutorial, which we will address in the second half of this tutorial." + "Contrary to the original tutorial for building the Westros model, we only define commodities and levels here. If additional `commodity` or `level` types are required later on, these can also be defined with uploading technologoy data using the excel files. Either method is fine.\n", + "Note that we populated the set `technology` and `mode` in the original tutorial. We will address these in the second half of this tutorial." ] }, { @@ -194,11 +195,17 @@ } }, "source": [ - "## Step 2: Importing data from Excel\n", - "The required model data and structure of a MESSAGEix scenario can be entirely saved in one Excel file. It is also possible to import the entire data from Excel using [`ixmp.Scenario.read_excel()`](https://docs.messageix.org/projects/ixmp/en/latest/api.html#ixmp.Scenario.read_excel).\n", - "\n", - "In this tutorial, we import data from different Excel files because ...\n", - "\n", + "## Step 2: Importing data from Excel\n" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ "### 2.1 Supply and Demand (or Balancing Commodities)" ] }, @@ -628,7 +635,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.7.6" + "version": "3.7.9" } }, "nbformat": 4, From 4ecea49f89aef2277fccbef7e5f68aa49a9b8671 Mon Sep 17 00:00:00 2001 From: FRICKO Oliver Date: Wed, 21 Apr 2021 17:04:05 +0200 Subject: [PATCH 13/15] split Westeros excel import tutorial into two parts --- message_ix/tests/test_tutorials.py | 5 +- .../westeroes_baseline_xlsx_workflow.pptx | Bin 246160 -> 251837 bytes ...westeroes_baseline_xlsx_workflow_part1.jpg | Bin 0 -> 127178 bytes ...esteroes_baseline_xlsx_workflow_part2.jpg} | Bin ...ros_baseline_using_xlsx_import_part1.ipynb | 241 ++++++++++++++++++ ...os_baseline_using_xlsx_import_part2.ipynb} | 8 +- 6 files changed, 248 insertions(+), 6 deletions(-) create mode 100644 tutorial/westeros/_static/westeroes_baseline_xlsx_workflow_part1.jpg rename tutorial/westeros/_static/{westeroes_baseline_xlsx_workflow.jpg => westeroes_baseline_xlsx_workflow_part2.jpg} (100%) create mode 100644 tutorial/westeros/westeros_baseline_using_xlsx_import_part1.ipynb rename tutorial/westeros/{westeros_baseline_using_xlsx_import.ipynb => westeros_baseline_using_xlsx_import_part2.ipynb} (91%) diff --git a/message_ix/tests/test_tutorials.py b/message_ix/tests/test_tutorials.py index eea56c911..7774273c5 100644 --- a/message_ix/tests/test_tutorials.py +++ b/message_ix/tests/test_tutorials.py @@ -24,7 +24,8 @@ [("solve-objective-value", 369297.75)], {}, ), - (("westeros", "westeros_baseline_using_xlsx_import"), [], {}), + (("westeros", "westeros_baseline_using_xlsx_import_part1"), [], {}), + (("westeros", "westeros_baseline_using_xlsx_import_part2"), [], {}), (("westeros", "westeros_emissions_bounds"), [], {}), (("westeros", "westeros_emissions_taxes"), [], {}), (("westeros", "westeros_firm_capacity"), [], {}), @@ -89,7 +90,7 @@ def test_tutorial(nb_path, cell_values, run_args, tmp_path, tmp_env): # Copy necessary data files to tmp_path print(nb_path) - if "westeros_baseline_using_xlsx_import" in nb_path.parts[-1]: + if "westeros_baseline_using_xlsx_import_part2" in nb_path.parts[-1]: for fil in data_files: copyfile(nb_path.parent / fil, tmp_path / fil) diff --git a/tutorial/westeros/_static/westeroes_baseline_xlsx_workflow.pptx b/tutorial/westeros/_static/westeroes_baseline_xlsx_workflow.pptx index 7f7827910473c64755ba9dd78caaae1a885adffe..a81ed7bac28e6a84da5cd4e6592a2d846c77c947 100644 GIT binary patch delta 36717 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

y6>DB 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 oa|`|exkrjF`WGs1tk@qi)!1E{=}KmY&$ diff --git a/tutorial/westeros/_static/westeroes_baseline_xlsx_workflow_part1.jpg b/tutorial/westeros/_static/westeroes_baseline_xlsx_workflow_part1.jpg new file mode 100644 index 0000000000000000000000000000000000000000..7311d169b8481b2b3f1c3a22acfaabb84fba6655 GIT binary patch literal 127178 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⋙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%0DGc{OBv#DAVpH62!Gydetv|`K! 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\n", + "\n", + "In order to generate the data we want to import to create a new scenario we will take the opportunity to also demonstrate how to export data to an Excel file. In the first part of this tutorial we are going to load the scenario which we created using `westeros_baseline.ipynb` and export the data to an Excel file.\n", + "\n", + "In the sceond part we will then import various the data from the Excel file, to create a new scenario.\n", + "\n", + "### Online documentation\n", + "\n", + "The documentation of the MESSAGEix framework is available at [https://docs.messageix.org](https://docs.messageix.org)" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "As in the \"original\" tutorial, we start by importing all the packages we need." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "import pandas as pd\n", + "import ixmp\n", + "import message_ix\n", + "\n", + "%matplotlib inline" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "# Loading Modeling platform\n", + "mp = ixmp.Platform()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Step 1. Loading the Westeros baseline scenario" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "base = message_ix.Scenario(mp, model='Westeros Electrified', scenario='baseline')" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Step 2. Export the data to a file called `westeros_baseline_data.xlsx`" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "data_file = 'westeros_baseline_data.xlsx'\n", + "base.to_excel(data_file)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Step 3. Create a new scenario" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "# Creating a new, empty scenario\n", + "scenario = message_ix.Scenario(mp, model='Westeros Electrified', \n", + " scenario='baseline_xlsx', version='new')" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "## Step 4: Importing data from Excel" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "source": [ + "Instead of using the `message_ix.Scenario.add_par()` for adding data to a MESSAGEix parameter, we import data from a xlsx file. The arguments `add_units` has been set to `True`, so that any units which have not yet been specified in the modeling platform will be defined automatically." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "scenario.read_excel(data_file, add_units=True)" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "## Time to Solve the Model" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "scenario.set_as_default()" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "scenario.solve()" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "jupyter": { + "name": "solve-objective-value" + }, + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [], + "source": [ + "scenario.var('OBJ')['lvl']" + ] + } + ], + "metadata": { + "anaconda-cloud": {}, + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "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.7.9" + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb b/tutorial/westeros/westeros_baseline_using_xlsx_import_part2.ipynb similarity index 91% rename from tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb rename to tutorial/westeros/westeros_baseline_using_xlsx_import_part2.ipynb index 71b052666..bf6123750 100644 --- a/tutorial/westeros/westeros_baseline_using_xlsx_import.ipynb +++ b/tutorial/westeros/westeros_baseline_using_xlsx_import_part2.ipynb @@ -8,7 +8,7 @@ } }, "source": [ - "# Westeros Tutorial Part 1.X - Building a scenario by importing data from Excel" + "# Westeros Tutorial Part 1.X Part 2 - Building a scenario by importing data from Excel continued." ] }, { @@ -21,11 +21,11 @@ "source": [ "## Scope of this tutorial\n", "\n", - "This tutorial explains how the Westeros Baseline scenario can be built using data imported from Excel (.xlsx) files. The figure below compares the workflows of the original westeroes tutorial, where data was added using the `add_par()` and `add_set()` functions. The same scenario can also be created by importing data from Excel files, using `ixmp.Scenario.read_excel()` (https://docs.messageix.org/projects/ixmp/en/latest/api.html#ixmp.Scenario.read_excel). The required model data and structure of a MESSAGEix scenario can be imported from either a single or multiple Excel files (as shown below). The advantage of using multiple files, especially for large data sets, is that this provides a more transparent structuring of the underlying workflow, i.e. the scripts related to creating the original xlsx source files and the respective imports will be limited to certain model aspects and therefore will be shorter than if they were to cover all the model data. This means that maintenance and updates can be performed more easily in the future. \n", + "This tutorial builds on `Westeros Tutorial Part 1.X Part 1`, which explained how data from the Westeros Baseline scenario can be exported to an Excel (.xlsx) file using the function [ixmp.Scenario.to_excel()](https://docs.messageix.org/projects/ixmp/en/latest/api.html#ixmp.Scenario.to_excel) and how this data can be used to build a new scenario [ixmp.Scenario.read_excel()](https://docs.messageix.org/projects/ixmp/en/latest/api.html#ixmp.Scenario.read_excel). This tutorial will look at the workflow of building a new scenario from data stored in an Excel file more carefully. \n", "\n", - "\n", + "To do this, we are again going to build the Westeros Baseline, but this time combining elements from the original baseline tutorial with the import of data from multiple Excel files (see figure below). This tutorial specifically targets users looking to build larger more complex models using the Excel import functionalities. The advantage of using multiple files, especially for large data sets, is that this provides a more transparent structuring of the underlying workflow, i.e. the scripts related to creating the original Excel source files and the respective imports will be limited to certain model aspects and therefore will be shorter than if they were to cover all the model data. This means that maintenance and updates can be performed more readily in the future. \n", "\n", - "The approach chosen for the tutorial can be varied and depends very much on user preferences and the specific use-case. We have chosen to split this tutorial into two parts in order to demonstrate how various methods of adding data to the model can be combined.\n", + "\n", "\n", "The first part will create a scenario and basic parameters will be added including the modeling time-horizon and the discount rate. This code is a repetition of that used in the tutorial `westeros_baseline.ipynb`, which will be referred to as the \"original\" scenario throughout the remainder of this tutorial.\n", "\n", From 5d6fc548e7c31f4998b0e982f67af209a8ea8c1b Mon Sep 17 00:00:00 2001 From: Behnam Date: Thu, 29 Apr 2021 09:27:58 +0200 Subject: [PATCH 14/15] Editing texts for clarity and correctness --- ...ros_baseline_using_xlsx_import_part2.ipynb | 28 +++++++++++++------ 1 file changed, 20 insertions(+), 8 deletions(-) diff --git a/tutorial/westeros/westeros_baseline_using_xlsx_import_part2.ipynb b/tutorial/westeros/westeros_baseline_using_xlsx_import_part2.ipynb index bf6123750..19b896a60 100644 --- a/tutorial/westeros/westeros_baseline_using_xlsx_import_part2.ipynb +++ b/tutorial/westeros/westeros_baseline_using_xlsx_import_part2.ipynb @@ -8,7 +8,7 @@ } }, "source": [ - "# Westeros Tutorial Part 1.X Part 2 - Building a scenario by importing data from Excel continued." + "# Westeros Tutorial Part 4a - Importing scenario data from Excel (II)" ] }, { @@ -21,15 +21,27 @@ "source": [ "## Scope of this tutorial\n", "\n", - "This tutorial builds on `Westeros Tutorial Part 1.X Part 1`, which explained how data from the Westeros Baseline scenario can be exported to an Excel (.xlsx) file using the function [ixmp.Scenario.to_excel()](https://docs.messageix.org/projects/ixmp/en/latest/api.html#ixmp.Scenario.to_excel) and how this data can be used to build a new scenario [ixmp.Scenario.read_excel()](https://docs.messageix.org/projects/ixmp/en/latest/api.html#ixmp.Scenario.read_excel). This tutorial will look at the workflow of building a new scenario from data stored in an Excel file more carefully. \n", + "In the first part of this tutorial, `Westeros Tutorial Part 4a (Part I)`, we explained how data of the Westeros Baseline scenario can be exported to an Excel (.xlsx) file using [ixmp.Scenario.to_excel()](https://docs.messageix.org/projects/ixmp/en/latest/api.html#ixmp.Scenario.to_excel); and how the data can be imported from Excel to build a new scenario using [ixmp.Scenario.read_excel()](https://docs.messageix.org/projects/ixmp/en/latest/api.html#ixmp.Scenario.read_excel). This tutorial shows a more detailed workflow for building a new scenario from data stored in one or a few Excel files. This can be useful specifically for the following applications:\n", "\n", - "To do this, we are again going to build the Westeros Baseline, but this time combining elements from the original baseline tutorial with the import of data from multiple Excel files (see figure below). This tutorial specifically targets users looking to build larger more complex models using the Excel import functionalities. The advantage of using multiple files, especially for large data sets, is that this provides a more transparent structuring of the underlying workflow, i.e. the scripts related to creating the original Excel source files and the respective imports will be limited to certain model aspects and therefore will be shorter than if they were to cover all the model data. This means that maintenance and updates can be performed more readily in the future. \n", + "- Migrating a model/scenario from another modeling tool to MESSAGEix\n", + "- Modifying the input data of a MESSAGEix scenario using Excel\n", + "\n", + "\n", + "To do this, we are again going to build the Westeros Baseline, but this time with importing data from multiple Excel files (see figure below), instead of one single file. This tutorial specifically targets users looking to build larger and more complex models using the Excel import functionalities. The advantage of using multiple Excel files, especially for large data sets, is to divide the underlying workflow into several independent subsections. This means the scripts related to creating the Excel files and importing such data to MESSAGEix can be grouped into certain model sets and parameters, e.g., one data file for cost parameters and another file for technical parameters etc. Therefore, the data import process will be shorter, and updates of data can be performed more easily in the future. \n", "\n", "\n", "\n", - "The first part will create a scenario and basic parameters will be added including the modeling time-horizon and the discount rate. This code is a repetition of that used in the tutorial `westeros_baseline.ipynb`, which will be referred to as the \"original\" scenario throughout the remainder of this tutorial.\n", + "The first part of this tutorial will create a scenario and basic parameters will be added including the modeling time-horizon and the discount rate. This code is a repetition of that used in the tutorial `westeros_baseline.ipynb`, which will be referred to as the \"original\" scenario throughout the remainder of this tutorial.\n", + "\n", + "The sceond part will then import various parameters from a few Excel files, adding technologies, demand and constraints to the model. The user can choose how to distribute the data across various excel files. We show one method of doing this distribution to outline a possible approach on how to structure the import methods if used for loading large amounts of data into scenarios, as well to demonstarte the required format of data in the excel files.\n", + "\n", + "#### Notice:\n", + "The MESSAGEix modeling framework includes powerful tools for data handling and storage. As such, we don not recommend using Excel files for storing and processing of scenario data. The methods introduced here may help some new users to import their model data and build a new model in MESSAGEix. But for most users, python and R interfaces are much more flexible for working with MESSAGEix scenario.\n", + "\n", + "### Requirements for running this tutorial\n", + "\n", + "[Please add here some notes on what they need to do before running this tutorial]\n", "\n", - "The sceond part will then import various parameters from Excel files, adding technologies, demand and constraints to the model. We have chosen to distribute the import of data across various excel files. This helps to not only outline a possible approach on how to structure the import methods if used for loading large amounts of data into scenarios, but also demonstartes the required data contents of the excel files.\n", "\n", "### Online documentation\n", "\n", @@ -51,7 +63,7 @@ } }, "source": [ - "As in the \"original\" tutorial, we start by importing all the packages we need." + "Similar to other tutorials, we start by importing all the packages we need." ] }, { @@ -151,7 +163,7 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "Contrary to the original tutorial for building the Westros model, we only define commodities and levels here. If additional `commodity` or `level` types are required later on, these can also be defined with uploading technologoy data using the excel files. Either method is fine.\n", + "Contrary to the original tutorial for building the Westeros model, we only define commodities and levels here. If additional `commodity` or `level` types are required later on, these can also be defined in the Excel files, and be uploaded with technologoy data using the excel files. Either method is fine.\n", "Note that we populated the set `technology` and `mode` in the original tutorial. We will address these in the second half of this tutorial." ] }, @@ -635,7 +647,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.7.9" + "version": "3.8.5" } }, "nbformat": 4, From ade6be2e7f902d93cc0a7ffdf0659bcc43fe6393 Mon Sep 17 00:00:00 2001 From: Behnam Date: Thu, 29 Apr 2021 09:37:58 +0200 Subject: [PATCH 15/15] Modify Part 1 and added some clarifying notes --- ...ros_baseline_using_xlsx_import_part1.ipynb | 30 ++++++++++++++----- 1 file changed, 22 insertions(+), 8 deletions(-) diff --git a/tutorial/westeros/westeros_baseline_using_xlsx_import_part1.ipynb b/tutorial/westeros/westeros_baseline_using_xlsx_import_part1.ipynb index 29a4526b0..82d80206d 100644 --- a/tutorial/westeros/westeros_baseline_using_xlsx_import_part1.ipynb +++ b/tutorial/westeros/westeros_baseline_using_xlsx_import_part1.ipynb @@ -8,7 +8,7 @@ } }, "source": [ - "# Westeros Tutorial Part 1.X - Building a scenario by importing data from Excel" + "# Westeros Tutorial Part 4a - Building a scenario by importing data from Excel (I)" ] }, { @@ -21,13 +21,19 @@ "source": [ "## Scope of this tutorial\n", "\n", - "This tutorial explains how the Westeros Baseline scenario can be built using data imported from Excel (.xlsx) files. The figure below compares the workflows of the original westeroes tutorial, where data was added using the [add_par()](https://docs.messageix.org/projects/ixmp/en/stable/api.html?highlight=add_set()#ixmp.Scenario.add_par) and [add_set()](https://docs.messageix.org/projects/ixmp/en/stable/api.html?highlight=add_set()#ixmp.Scenario.add_set) functions. The same scenario can also be created by importing data from Excel files, using [ixmp.Scenario.read_excel()](https://docs.messageix.org/projects/ixmp/en/latest/api.html#ixmp.Scenario.read_excel) as shown in the figure below.\n", + "This tutorial explains how the Westeros Baseline scenario can be built using data imported from Excel (.xlsx) files. The figure below compares the workflows of the original westeroes tutorial, where data was added using the [add_par()](https://docs.messageix.org/projects/ixmp/en/stable/api.html?highlight=add_set()#ixmp.Scenario.add_par) and [add_set()](https://docs.messageix.org/projects/ixmp/en/stable/api.html?highlight=add_set()#ixmp.Scenario.add_set) functions. The same scenario can also be created by importing data from an Excel file, using [ixmp.Scenario.read_excel()](https://docs.messageix.org/projects/ixmp/en/latest/api.html#ixmp.Scenario.read_excel) as shown in the figure below.\n", "\n", "\n", "\n", - "In order to generate the data we want to import to create a new scenario we will take the opportunity to also demonstrate how to export data to an Excel file. In the first part of this tutorial we are going to load the scenario which we created using `westeros_baseline.ipynb` and export the data to an Excel file.\n", + "We also demonstrate how to export data to an Excel file. In the first part of this tutorial we are load the scenario which we created in `westeros_baseline.ipynb`, and export the scenario data to an Excel file.\n", + "\n", + "In the sceond part, we import the data from the Excel file to create a new scenario.\n", + "\n", + "### Requirements\n", + "\n", + "Please add some notes for the requirements of running this tutorial\n", + "\n", "\n", - "In the sceond part we will then import various the data from the Excel file, to create a new scenario.\n", "\n", "### Online documentation\n", "\n", @@ -42,7 +48,7 @@ } }, "source": [ - "As in the \"original\" tutorial, we start by importing all the packages we need." + "Similar to other tutorials, we start by importing all the packages we need." ] }, { @@ -96,7 +102,8 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "## Step 2. Export the data to a file called `westeros_baseline_data.xlsx`" + "## Step 2. Export the data to an Excel file\n", + "We export all the scenario data (sets and parameters) to a single Excel file called `westeros_baseline_data.xlsx`" ] }, { @@ -109,6 +116,13 @@ "base.to_excel(data_file)" ] }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "You can open the created Excel file on your machine and navigate through the Excel sheets and make yourself familiar with the format that the data have been stored in the file." + ] + }, { "cell_type": "markdown", "metadata": {}, @@ -150,7 +164,7 @@ } }, "source": [ - "Instead of using the `message_ix.Scenario.add_par()` for adding data to a MESSAGEix parameter, we import data from a xlsx file. The arguments `add_units` has been set to `True`, so that any units which have not yet been specified in the modeling platform will be defined automatically." + "Instead of using the `message_ix.Scenario.add_set()` and `add_par()` for adding data to a MESSAGEix parameter, we import data from an xlsx file. The arguments `add_units` is set to `True`, so that any units which have not yet been specified in the modeling platform can be defined automatically." ] }, { @@ -233,7 +247,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.7.9" + "version": "3.8.5" } }, "nbformat": 4,