For Honor and Profit Optimizing an NBA Franchise.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# For Honor and Profit: Optimizing an NBA Franchise \n",
    "\n",
    "Thompson Bliss, tbliss@wisc.edu\n",
    "\n",
    "Aaron Kelly, aaron.kelly@wisc.edu\n",
    "\n",
    "Elizabeth Scaria, scaria@wisc.edu"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "To view the code and data associated with this project, click <a href='https://github.com/ThompsonJamesBliss/For-Honor-and-Profit-Optimizing-an-NBA-Franchise'> here</a> to visit the Github Repository."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Table of Contents\n",
    "\n",
    "1. <a href='#Preface'>Preface</a>\n",
    "2. <a href='#Introduction'>Introduction</a>\n",
    "<br>\n",
    "3. <a href='#1'>Section 1: Player Valuation</a> <br>\n",
    "    a. <a href='#1a'>Section 1a: K-Means Clustering</a>  \n",
    "    b. <a href='#1b'>Section 1b: Random Salary Assignment</a>\n",
    "    <br>\n",
    "4. <a href='#2'>Section 2: Five Season Free Agency Plan</a> <br>\n",
    "    a. <a href='#2a'>Section 2a: Free Agency Plan Results</a>   \n",
    "    b. <a href='#2b'>Section 2b: Free Agency Plan Pareto Curves</a> <br>    \n",
    "5. <a href='#3'>Section 3: Building a Stadium</a> <br>\n",
    "    a. <a href='#3a'>Section 3a: Building a Stadium Results</a>  \n",
    "    b. <a href='#3b'>Section 3b: Building a Stadium Pareto Curve</a> <br> \n",
    "    \n",
    "7. <a href='#Conclusion'>Conclusion</a>\n",
    "8. <a href='#Limitations'>Model Limitations</a>\n",
    "9. <a href='#Footnote'>Appendix</a>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='Preface'></a>\n",
    "## Preface\n",
    "\n",
    "In order to run this notebook, the following packages must be added:\n",
    "\n",
    "* JuMP - provides a domain-specific modeling language for mathematical optimization embedded in Julia\n",
    "* NamedArrays - implements a drop-in replacement of Array with named dimensions\n",
    "* PyPlot - provides a Julia interface to the Matplotlib plotting library from Python\n",
    "* KNITRO - provides an interface for using the Artelys Knitro solver from Julia. A free academic license can be obtained <a href='https://www.artelys.com/en/optimization-tools/knitro'>here</a>.\n",
    "* Cbc - provides a Julia interface to a mixed-integer linear programming solver\n",
    "* DataFrames - provides tools for working with tabular data in Julia"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='Introduction'></a>\n",
    "## Introduction"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Dear Mr. Robert Sarver and the Phoenix Suns Operations Research team,\n",
    "\n",
    "On behalf of the employees of Bliss, Kelly, & Scaria (BK&S) we are happy to submit our firm’s proposal in response to the Phoenix Suns organization’s Request For Proposal (RFP) on how to make the Phoenix Suns a prominent team in the NBA. BK&S believes that the best way to do this is to create a winning team through the signing of free agents, and to build a new home stadium for the Suns. Building a stronger team will obviously improve the Suns’ profile, but our consultants at BK&S strongly believe that a brand new stadium designed to provide an exhilarating experience for Suns fans is nearly as important as the team itself; if you build it, they will come. \n",
    "    \n",
    "In the post-Moneyball sports world, the use of data in making decisions regarding player signings has become nearly ubiquitous. The NBA in particular has greatly invested in data gathering methods to ensure that franchise analytics teams have plenty of high quality data to work with <a href='#Footnote'>[1]</a>. Teams such as the Golden State Warriors, who languished in the middle of the standings for many seasons, can partially credit their rise to the use of analytics <a href='#Footnote'>[2]</a>. In the modern NBA, failure to keep up with the ever-changing analytics field can ruin a franchise’s hopes of a championship.\n",
    "    \n",
    " However, there is a significant difference between using analytics to make a good decision and making an optimal decision. An optimal decision accounts for the many constraints, such as player salary, positions on a team, and general franchise growth, that accompany and provide the context of any decision made in the NBA. Analytics is the pick, and optimization is the roll.\n",
    "BK&S’s consultants are uniquely equipped to answer the optimization questions posed in your RFP, questions related to:\n",
    "\n",
    "* What is the best way to determine NBA player value?\n",
    "\n",
    "* What is the optimal strategy for recruiting NBA free agents over a five year period?\n",
    "\n",
    "* What is the optimal strategy to grow the Suns franchise by investing in a new stadium?\n",
    "\n",
    "This report consists of three sections. The first section deals with player valuation. The models in this section seek to understand the relationship, if one exists, between player productivity and salary. This section then proposes an alternate method of valuing players based on their productivity. The findings in this section are used to determine player salaries that will be used in the subsequent sections’ models.\n",
    "    \n",
    "The second portion of the report provides a simple model to recruit free agents over a five season period, according to constraints such as player availability, salary, playing position, among others.\n",
    "    \n",
    "The final section of the report seeks to solve the question of building a stadium within the next five years. This section looks for the optimal time at which to build this stadium and how much will need to be invested, while still maintaining a strong playoff-worthy team and minimizing financial loss. \n",
    "    \n",
    "The analysis included in this proposal can be considered preliminary. All the models use public data from <a href='http://insider.espn.com/nba/hollinger/statistics'>ESPN</a>, <a href='http://www.spotrac.com/nba/contracts/'>Spotrac</a>, and <a href='http://www.dsg.com/jerseyreport/basketball/'>Dick's Sporting Goods</a>. If BK&S is awarded the contract with the Suns’, one of our first priorities would be to rerun our preliminary models with the Suns organization’s more accurate and expansive datasets of player metrics. BK&S also plans to, if awarded the contract, expand the work described in this proposal. A summary of potential future work is included in the conclusions section.\n",
    "\n",
    "Note: all dollar values expressed in this paper are in millions."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='1'></a>\n",
    "\n",
    "## Section 1: Player Valuation\n",
    "\n",
    "Loading data for the models:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [],
   "source": [
    "using JuMP\n",
    "using NamedArrays\n",
    "using PyPlot\n",
    "using KNITRO\n",
    "using Cbc\n",
    "using DataFrames\n",
    "\n",
    "raw = readcsv(\"data/NBA.csv\");\n",
    "(m,n) = size(raw)\n",
    "\n",
    "n_categories = 2:n     # columns containing categories\n",
    "n_playername = 2:m     # rows containing player names\n",
    "\n",
    "categories = raw[1,n_categories][:]            # the list of categories\n",
    "playernames = raw[n_playername,1][:]           # the list of player names\n",
    "positions = categories[1:5]                    # list of positions\n",
    "seasons = categories[6:10]                     # list of seasons\n",
    "\n",
    "# data[f,i] is the categories of player f listed in i\n",
    "data = NamedArray( raw[n_playername,n_categories], (playernames,categories), \n",
    "    (\"playernames\",\"categories\") );"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The first model is used to propose a new way to value free agents. <a href='http://insider.espn.com/nba/hollinger/statistics'>ESPN</a> provides advanced stats including an estimate on the number of wins an individual player adds to his team, EWA. This stat encompasses many other player statistics such as points, rebounding, assists etc. Since players should be paid based on how much they help the team win, we feel that this is a good statistic to determine a player's worth. We plot current player salaries vs EWA for all 343 players in the NBA to see if there could be a relationship. The plot is seen below:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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3FtvvSUCEFetWiWKoihWV1eLAMRNmzaJv/zyi2i1WsW33npLFEVR/Oyzz0QA4kMPPeT3fL/61a/Em2++2f33PffcI2ZmZooOhyPkthPFGkdsiDRSV1cHAGjVqlXUnmPq1KmK95WUlHj9vWvXLuzduxdjx47Fjz/+6P6G39DQgCuvvBKbN2+G0+kMeP7LL78cP/74o/u1hapjx4749NNPMXXqVPz88894+umnMXbsWHTo0AEPPPAARFF0H+uZ59LQ0ICamhr0798foij6rfTx5fnY2tpa1NTUYNCgQfj2229RW1vrdWyXLl38ppZat26N6667Di+88IK7TU1NTXjppZdw/fXXB8xXysjIwNVXX421a9d6vZ6XXnoJ/fr1Q25uLgCgTZs2AIDXX3/dr9/V6Nu3LyorK/1+xowZ4z6mf//+sFgs7tyZrVu3Ijk5GX369EF6ejp69uzpHiFy/fbNr9m9ezf27Nnjdd4xY8agpqYGGzZsCLndRLHGwIZIIxkZGQCAX375JWrP4bmixVNSUhJsNpvXbXv37gUAjB8/HmeffbbXz7PPPovGxka/i77rIuzStm1bAFKib7iysrJQWlqK6upqfP3113jiiSdw9tln4y9/+QvKysrcxx06dAgTJkxAu3btkJ6ejrPPPhuDBg0CAL92+tq6dSuGDh2KtLQ0tGnTBmeffbY7d0UusJEzbtw4d24JALz33ns4evQobrnllqCvcfTo0fjuu++wbds2AFJu0c6dOzF69GivYwYMGIBbb70VHTt2xE033YS1a9eqDnIyMzMxdOhQv5+8vDz3MW3atMEFF1zgFbxccskl7sCvf//+Xve1aNECl112mdfzrF69GmlpaejatSuqqqpQVVWF1NRUdO7cmdNRFBe4KopIIxkZGcjOzvbL01CiVGSuqalJ8TFKq3dSUlL88iRcF8xHH30UF198sezjfJdaW61W2eM8RyLCJQgCzjnnHJxzzjn4zW9+g+7du2PNmjW49dZb0dTUhMLCQvz000+YPXs2evTogbS0NBw+fBgTJkwIePHft28frrzySvTo0QNLlixBTk4OWrRogX/+85947LHH/B6r1IdFRUXo2LEjVq9ejSuuuAKrV69Gp06dMHTo0KCvbcSIEWjZsiXWrl2L/v37Y+3atbBYLBg1apTX827evBkbN27EW2+9hXfeeQcvvfQShgwZgnfffVex70M1cOBAPP300zh+/LjfarT+/fvjueeeg8PhwJYtW9CrVy+vBG5RFPHCCy+goaEB559/vt+5jx07hvr6ei7RJ0NjYEOkoWuuuQYrVqzAtm3bUFBQEPBY12iIK5nT5eDBg5q0pVu3bgCkgEvNxVktLar+du3aFW3btkV1dTUAYM+ePfjmm2/w/PPPeyULV1ZWBj3Xm2++icbGRrzxxhteI04bN24MqU1WqxVjx47FypUrsWjRIqxfvx6TJk1SFXC4Em3XrVuHJUuW4KWXXsLll1/urjHjYrFYcOWVV+LKK6/EkiVL8PDDD+P//b//h40bN2r2Hg0cOBClpaV477338Mknn2DWrFnu+/r374///e9/eOutt/Dtt9+6k8xdNm3aBLvdjvnz5+O8887zuu/nn3/G5MmTsX79+oDJ1ER641QUkYbuvvtupKWl4dZbb8XRo0f97t+3bx+WLl0KQAo4MjMzsXnzZq9jli1bpklbevXqhW7dumHx4sWyFX5/+OGHsM6blpbmF4wp+fjjj9HQ0OB3+7///W/8+OOPOPfccwE0jxR5jgyJoujuq0DkHltbW4vy8nJVbfR0yy234Oeff8aUKVNQX18f0gV89OjROHLkCJ599ll8+umnXtNQgFSs0JdrJK2xsTHktipx5cwsWbIEDofDa8Smc+fOyMrKwiOPPOJ1rItrGmrWrFn43e9+5/UzadIk9ygbkZFxxIZIQ926dUNFRQVGjx6N8847z6vy8EcffYR169Z51X259dZbsXDhQtx6663o3bs3Nm/ejG+++UaTtlgsFjz77LO4+uqrccEFF2DixIn4v//7Pxw+fBgbN25ERkYG3nzzzZDP26tXL7z33ntYsmQJsrOz0aVLF/Tt21f22FWrVmHNmjX47W9/i169eqFFixb48ssv8dxzzyE1NdWdB9OjRw9069YNd911Fw4fPoyMjAy88sorqnJ7hg0bhhYtWmDEiBHugOSZZ55Bhw4d3CNCal1yySW48MILsW7dOpx33nm49NJLVT/WVUPorrvugtVq9RsNmT9/PjZv3ozf/OY3yMvLw7Fjx7Bs2TLYbDbZAnm+Dh8+jNWrV/vdnp6e7lUFOjc3Fzk5Odi2bRs6d+7sN2rUv39/vPLKKxAEAQMGDHDf3tjYiFdeeQWFhYVe01Oerr32WixduhTHjh1Dhw4dgraZSBe6rcciMrFvvvlGnDRpkti5c2exRYsWYqtWrcQBAwaITz75pHjy5En3cSdOnBCLi4vF1q1bi61atRJvvPFG8dixY4rLveWWCo8fP15MS0tTbMsnn3wi3nDDDWL79u3FlJQUMS8vT7zxxhvF999/P+j5y8vLRQDi/v373bd99dVX4hVXXCGeddZZIoCAS793794tzpo1S7z00kvFdu3aiUlJSWJWVpY4atQo8b///a/XsV988YU4dOhQMT09XczMzBQnTZokfvrpp35L4uWWe7/xxhtiz549xdTUVLFz587iokWLxOeee86v7Xl5eeJvfvMbxfaKorRMG4D48MMPBzxOzs033ywCEIcOHep33/vvvy9ed911YnZ2ttiiRQsxOztbHDNmjPjNN98EPW+g5d55eXl+x48ZM0YEII4dO9bvviVLlogAxPPOO8/r9ldeeUUEIJaVlSm248MPPxQBiEuXLg3aZiK9CKKoQVYgEZFJLF26FDNmzMCBAwf8VokRkfExsCEiOkMURVx00UVo3759yMnHRGQMzLEhooTX0NCAN954Axs3bsSePXvw+uuv690kIgoTR2yIKOEdOHAAXbp0QZs2bTBt2jQ89NBDejeJiMLEwIaIiIhMg3VsiIiIyDQY2BAREZFpmD552Ol04siRI2jVqpUmpeCJiIgo+kRRxC+//ILs7Gy/vfACMX1gc+TIEeTk5OjdDCIiIgrDd999B5vNpvp40wc2rVq1AiB1TEZGRsTnczgcePfddzFs2DAkJydHfD4zYh+pw35Sh/0UHPtIHfaTOkbpp7q6OuTk5Liv42qZPrBxTT9lZGRoFti0bNkSGRkZ/IehgH2kDvtJHfZTcOwjddhP6hitn0JNI2HyMBEREZkGAxsiIiIyDQY2REREZBoMbIiIiMg0GNgQERGRaTCwISIiItNgYENERESmoWtgU1paip49e7przBQUFODtt9923z948GAIguD1M3XqVB1bTEREREama4E+m82GhQsXonv37hBFEc8//zyuu+46fPLJJ7jgggsAAJMmTcL8+fPdj2nZsqVezSUiIiKD0zWwGTFihNffDz30EEpLS7F9+3Z3YNOyZUt06tRJj+YRERFRnDHMlgpNTU1Yt24dGhoaUFBQ4L59zZo1WL16NTp16oQRI0bg3nvvDThq09jYiMbGRvffdXV1AKQS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",
      "text/plain": [
       "PyPlot.Figure(PyObject <matplotlib.figure.Figure object at 0x00000000388F8080>)"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plot(data[:,\"EWA\"], data[:,\"Salary\"], \"r.\")\n",
    "xlabel(\"Player EWA\")\n",
    "ylabel(\"Salary\");\n",
    "title(\"Current Salary vs EWA\")\n",
    "grid()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='1a'></a>\n",
    "\n",
    "### Section 1a: K-Means Clustering "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "From the plot above, we can see that salary is not strongly correlated with EWA and is just about random with respect to player performance.\n",
    "\n",
    "Given the randomness in player salaries, we propose a new way of determining player salaries by dividing players into paygrades.\n",
    "We use a k-means cluster approach to separate players into four separate paygrade sets. This implementation of a k-means clustering algorithm is a mixed integer non-linear program (MINLP). The program determines which players belong to each of the three paygrades by minimizing the difference between an individual player’s EWA and the paygrade’s average EWA. The average EWA for each paygrade is determined by the program. We assign the players in the first (lowest) paygrade a random salary in \\$1.4- 5 million; we assign the players in the second paygrade a random salary between \\$5-15 million; we assign the players in the third paygrade a random salary between \\$16- 27 million;we assign the players in the fourth (highest) paygrade a random salary between \\$28-35 million. \n",
    "\n",
    "EWA is a vector composed of individual player EWAs.\n",
    "\n",
    "The model components are as follow:\n",
    "\n",
    "Assumptions:\n",
    "\n",
    "* Compared to players of a similar productivity, a player’s salary is fairly random.\n",
    "\n",
    "\n",
    "Decision variables:\n",
    "* $\\omega$: a 4 row by 37 column matrix of binary values indexed by paygrades (rows) and EWAs (columns). $\\omega[Paygrade,\\: EWA] = 1$ if the player's EWA belongs to this paygrade, and zero if he does not.\n",
    "\n",
    "  $\\omega_{ij}  \\in \\{0,1\\}$\n",
    "\n",
    "\n",
    "* d: a 4 row by 37 column matrix that represents the square of the 2-norm distance from a specific player's EWA to the average EWA of the paygrade to which he belongs. $d[Paygrade,\\: EWA] =$ the 2-norm squared from a particular EWA value to the average EWA of its paygrade.\n",
    "\n",
    "Constraints:\n",
    "* All players must be included in a paygrade.\n",
    " \n",
    "  $\\sum_{j \\: \\in\\: EWA} \\omega_{ij} \\: = \\: 1$\n",
    "\n",
    "\n",
    "* d, the 2-norm squared from the player's EWA to the average EWA of their paygrade, must be greater than or equal to the 2-norm squared of a given player and paygrade mean, $\\mu _ {i}$, if the player is in the given paygrade.\n",
    "\n",
    "  $(EWA_j - \\mu_i)^2 \\omega_{ij} \\leq d_{ij}$\n",
    "\n",
    "\n",
    "Objective:\n",
    "* Minimize the sum of the 2-norm squared distance between each player’s EWA and the average EWA of his paygrade grouping.\n",
    "\n",
    "  $\\sum_{i\\:\\in\\:paygrades} \\: \\sum_{j\\:\\in\\:EWA} d_{ij}$\n",
    "  \n",
    "\n",
    "It is important to note that the KNITRO solver we have used is an academic-licensed version, which restricts the number of variables we can solve for in our model. We have solved our program for 37 randomized players to find the average EWA of each paygrade. We have then used those averages to sort the remaining players into appropriate paygrades. Our future work will involve running the k-means cluster program for the entire set of players if we are able to obtain a full license of KNITRO as the Suns organization’s consultants.\n",
    "The model is written in standard form below:\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "\\begin{equation*}\n",
    "\\begin{aligned}\n",
    "& \\underset{d,\\:\\omega}{\\text{minimize}}\n",
    "& & \\sum_{i\\:\\in\\:paygrades} \\: \\sum_{j\\:\\in\\:EWA} d_{ij} \\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\n",
    "\\\\\n",
    "\\\\\n",
    "\\\\\n",
    "& \\text{subject to} \\\\ \\\\\n",
    "\\end{aligned}\n",
    "\\end{equation*}\n",
    "\\begin{alignat}{2}\n",
    "    &(EWA_j - \\mu_i)^2 \\omega_{ij} \\leq d_{ij}  \n",
    "    && \\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\forall \\: i \\: \\in paygrades, \\: j \\: \\in \\: EWA \\\\ \\\\\n",
    "    & \\sum_{j \\: \\in\\: EWA} \\omega_{ij} \\: = \\: 1\n",
    "    && \\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\;\\forall \\: j\\: \\in \\: EWA \\\\ \\\\\n",
    "    &\\omega_{ij}  \\in \\{0,1\\}\n",
    "\\end{alignat}\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a href='#Footnote'>[3]</a> Note, parts of our model were inspired from a stackexchange answer."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [],
   "source": [
    "#Setting Random Seed\n",
    "srand(30);\n",
    "\n",
    "#Setting Random Indices\n",
    "randindices = rand(1:343,1,37);\n",
    "\n",
    "#Saving the players and their associated random indices\n",
    "randEWA = data[playernames[randindices], \"EWA\"];\n",
    "\n",
    "\n",
    "m = Model(solver=KnitroSolver(outlev = 0))\n",
    "\n",
    "\n",
    "num_clusers = 1:4\n",
    "num_dataPoints = 1:37\n",
    "\n",
    "#Binary variable, if data point j is in cluster i\n",
    "@variable(m, w[num_clusers,num_dataPoints], Bin) \n",
    "#distance of data point from mean\n",
    "@variable(m, d[num_clusers,num_dataPoints])      \n",
    "\n",
    "\n",
    "#mean of cluster\n",
    "@NLexpression(m, mean[i in num_clusers], sum(randEWA[j] * \n",
    "        w[i,j] for j in num_dataPoints)/sum(w[i,j] for j in num_dataPoints))\n",
    "\n",
    "#distance of data point from mean must be greater than or equal to norm of difference \n",
    "#between mean and point\n",
    "for i in num_clusers\n",
    "    for j in num_dataPoints\n",
    "      @NLconstraint(m, d[i,j] >= (randEWA[j] - mean[i])^2 * w[i,j])\n",
    "    end\n",
    "end\n",
    "\n",
    "#each data point must be assigned to exactly 1 cluster\n",
    "for j in num_dataPoints\n",
    "   @constraint(m, sum(w[i,j] for i in num_clusers) == 1) \n",
    "end\n",
    "\n",
    "#setting value for optimal solution\n",
    "for i in num_clusers\n",
    "    for j in num_dataPoints\n",
    "        setvalue(w[i,j], 1)\n",
    "    end\n",
    "end\n",
    "\n",
    "#minimize distance between data point and mean\n",
    "@objective(m, Min, sum(d[i,j] for i in num_clusers, j in num_dataPoints))\n",
    "\n",
    "\n",
    "solve(m);"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='1b'></a>\n",
    "\n",
    "\n",
    "### Section 1b: Random Salary Assignment"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "From our K-means function we have four ‘means’ that represent logical categories of player skill. We filter through our list of players’ EWAs and reassign their salary based on which paygrade their EWA falls into. The following function compares the player’s EWA first to the paygrade 4 and paygrade 3. If the player is closer to paygrade 4 he will be assigned a random salary from that range. If the player is closer to paygrade 3 his EWA will then be compared to paygrade 2 and so on. \n",
    "\n",
    "The paygrades can be described as follows:\n",
    "\n",
    "* Paygrade 4: True star players.\n",
    "* Paygrade 3: Good enough to play as a starter and be paid as one.\n",
    "* Paygrade 2: Likely a bench player.\n",
    "* Paygrade 1: Not a strong player. Will likely earn the league minimum.\n",
    "\n",
    "The resulting means from the K-means clustering are as follows:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[-0.553846, 2.41667, 7.15, 14.375]"
     ]
    }
   ],
   "source": [
    "means = [getvalue(mean[1]),getvalue(mean[2]),getvalue(mean[3]),getvalue(mean[4])];\n",
    "means = sort(means);\n",
    "print(means)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Break salaries into buckets and assign random salary values within range\n",
    "function randomSalaries(EWA)\n",
    "    if abs(EWA - means[4]) <= abs(EWA - means[3])\n",
    "        return rand(28:35, 1)[1]\n",
    "    elseif abs(EWA - means[3]) <= abs(EWA - means[2])\n",
    "        return rand(16:27, 1)[1]\n",
    "    elseif abs(EWA - means[2]) <= abs(EWA - means[1])\n",
    "        return rand(5:15, 1)[1]\n",
    "    else\n",
    "        return rand(1.4:5, 1)[1]\n",
    "    end\n",
    "end\n",
    "\n",
    "# Overwrite salary data with random salaries\n",
    "for i in playernames\n",
    "    data[i,\"Salary\"] = randomSalaries(data[i,\"EWA\"])\n",
    "end"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here is a graph of the newly assigned salaries and EWA:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAjYAAAHHCAYAAACskBIUAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAPYQAAD2EBqD+naQAAIABJREFUeJzs3XtcVHX+P/DXYUAUEG8ol0BDJSsV21xUQNTw7i8vq6mZKZgJldmmXS3dUmu1vrumbWZeSDDBzMpaTVMyU0QttEy3TQO31kbRpFZQVBzg/P44zTCXMzNnLnCOw+v5ePCQOedzPudzPo7y5lxeI4iiKIKIiIjIB/ipPQAiIiIib2FhQ0RERD6DhQ0RERH5DBY2RERE5DNY2BAREZHPYGFDREREPoOFDREREfkMFjZERETkM1jYEBERkc9gYUOkEkEQ8OKLL6o9DIdOnDgBQRDw7rvvqrL/iIgIPPTQQw2+37feeguCIODcuXMNvm8i8gwLG2oUsrOzIQgCmjZtijNnztisHzBgALp166bCyDxXVVWFVq1aYcCAAXbb1NbWIioqCr169Wq4gTWgiooKPP/88+jatSuCgoLQpk0b3HnnnZg9ezZ++eUXtYd3Q+jTpw8EQZD9uuOOOwAA69evhyAI2LFjh832Xbp0gSAIOHjwoM268PBwpKam2iw3GAwICwuDIAjYs2eP9w+KGiV/tQdA1JCqqqqwZMkS/OMf/1B7KF4TGBiIe+65B2+//TbOnDmDm266yabNnj17UFpaimeffVaFEdava9euITk5Gf/5z3+Qnp6Oxx57DBUVFTh27BjWrl2LiRMnol27dmoP84YQGxuLhQsX2ixv3bo1AKBv374AgP3792P48OGm9RcuXMAPP/wAf39/FBYWIjEx0bSuuLgYv/zyCzIzM236/fTTT/Hbb7+hQ4cOyM3NxV133eXtQ6JGiIUNNSp33HEH1qxZg7lz5yIqKkrt4XjN5MmTsXbtWmzcuBFPPvmkzfq8vDzodDpMnDhRhdHVr82bN+Nf//oXPvjgA4wdO9Zi3eXLl6GFz/m9cuUKgoKC1B6GU61bt8b9999vd33Hjh0RFRWF/fv3Wyw/cOAA/P39MXbsWOzfv9/iPWhsayyKzG3YsAGJiYkYPXo0Fi9ejBUrViAwMNBLR0ONFS9FUaPy3HPPoaamBkuWLFHUfsOGDejZsyeaNWuG1q1b495778XPP/9sWv/6669Dp9Ph4sWLpmV///vfIQgC5syZY1pWU1OD5s2b45lnnpHdz549eyAIArZs2WKzLi8vz+4pfqP+/fsjJiYGeXl5Nuuqqqrw4YcfYtCgQQgPDwcg/YY9e/ZsdO3aFcHBwWjRogXuvvtufPfdd07npE+fPhg2bJjN8nvvvRe33nqrxbKamhr87W9/w2233YbAwEBERERg5syZqKiosGhXW1uLF154AVFRUQgODsagQYNw8uRJp2MBgFOnTgEAkpOTbdaFhISgefPmptdff/01pkyZgtjYWDRt2hSRkZHIyMiw+Puz54MPPsDw4cMRGRmJwMBAxMXFYcmSJaitrbVo16dPH/zxj3/EoUOH0LdvXzRr1gwLFy7ExIkTERUVZdMeAPr164cePXrY3feDDz6Ili1b4vr16zbr/vSnP6F9+/amAu7gwYMYNGgQ2rRpg6CgIHTs2NGr9yklJyejqKgIBoPBtKywsBB33HEHBg0ahAMHDli0LywshE6nsziLAwCXLl3C1q1bce+992LixIkoLy/HJ5984rVxUuPFwoYaldjYWEydOhVr1qzB2bNnHbZ9+eWXMXXqVMTFxWHp0qV4/PHHsXv3bvTr18/0gzAlJQW1tbUWv8EWFBTAz88PBQUFpmXffPMNLl++jH79+snua8CAAYiJiUFubq7NutzcXHTq1MnmB4M5QRAwadIkfPPNNzhx4oTFuu3bt+PixYuYPHmyadnJkyexfft2jBkzBq+99hrmzJmDI0eOoH///l69JyU9PR3PP/88BgwYgNdffx1Tp07FunXrMGLECNTU1JjaPfPMM1i4cCESEhLw6quv4qabbsKQIUNw7do1p/vo0KEDACAnJ8dp2x07duDMmTOYPn06/vGPf2D8+PFYv349Ro0a5XTbrKwstGzZEk8++SSWLVuG7t27Y+7cuXjhhRds2p4/fx533303EhISsHz5cqSkpGDKlCkoLS3F559/btH29OnT2L9/v8MzJcYf/Dt37rRYXlFRgR07dmDChAkQBAFnzpzBsGHDcPbsWTz//PNYvnw57r33XodFsbnq6mqUlZXZfFVWVpra9O3bF1evXsWRI0dMywoLC5GUlISkpCTTZSnzdfHx8RYFJgB8+OGHuH79OiZMmIAOHTogMTFR9v1P5DKRqBFYt26dCEAsKioST506Jfr7+4uPPfaYaX3//v3Frl27ml7/9NNPok6nE19++WWLfo4fPy76+/ubltfU1IihoaHi008/LYqiKNbW1opt2rQRx48fL+p0OvHSpUuiKIri0qVLRT8/P/F///ufqS8A4gsvvGB6PXfuXDEwMFC8ePGiadkvv/wi+vv7W7Sz59tvvxUBiPPnz7dYfs8994hBQUGmsYiiKF69elWsra21aHfy5EkxICBAfPXVV03Lvv/+exGAuHHjRtOy3r17i0OHDrXZ/8SJE8UuXbqYXufn54sAxA8++MCi3UcffWSx/MyZM6JOpxPHjRtn0W7OnDkiADEzM9PhcV++fFns2LGjCECMjY0VH3jgAXHdunXihQsXbNpeuXLFZpnxvfHVV1+Zlq1cuVIEIJaWljrcNi0tTQwNDRUNBoNpWe/evUUAYnZ2tkVbg8EgtmvXTkxLS7NY/te//lX08/MT9Xq93WOsrq4W27ZtK06ePNli+fr16y3GvnHjRhGAePz4cbt92WMct9zXn//8Z1O7I0eOiADE//u//xNFURSvXbsmBgYGips2bRJra2vFli1billZWaIoiuKFCxdEQRDEWbNm2exv0KBB4sCBA02vX3/9dZv3P5E7eMaGGp2OHTtiypQpWL16NUpLS2XbfPjhh6itrcWECRMsfnONiIhAXFyc6QkOPz8/JCUlYd++fQCA77//Hr/++iueffZZiKJo+k25oKAA3bp1Q8uWLe2Oa+rUqaiqqsL7779vWrZp0yZUV1c7/G3eKD4+Ht27d8fGjRtNyy5duoRt27Zh1KhRCAkJMS1v2rQpBEEAIP2W/uuvv6J169aIjY3F119/7XRfSmzevBlt27ZFv379LOYwMTERTZo0Mc3hzp07UVNTg1mzZlls//jjjyvaT3BwMA4fPow5c+aguroab7/9NqZNm4aIiAg88cQTFpdMmjVrZvr+6tWrKCsrQ58+fQDA6XGbb3vp0iWUlZUhJSUFFRUVpsthRs2bN7f5O/P398ekSZPw4Ycf4urVq6blxptm5W76NtLpdBg3bhz++c9/WpzF2rRpE2JjY5GQkAAApvfX1q1bUV1d7fB45Nxyyy3Iz8+3+XrkkUdMbXr06IHmzZubzlIePnwYVVVVSEpKgiAISExMRGFhIQDp3htRFG3urzGeuZo0aZJp2YQJE1BdXW3x/idyBwsbapTmzZuH6upqu/faFBcXQxRFxMXFoW3bthZf33//vcXlmpSUFBw5cgRXr15FQUEBIiMjceedd6JHjx6my1H79+9HSkqKwzHdeuutSEhIsDgdn5ubiz59+qBz584ApB/G586ds/gyN3nyZJSUlOCrr74CIBVo165ds7gMBUj3vrz66qvo2LEjAgMDERYWhrZt2+KHH35AeXm5wll0rLi4GBcuXLCZv/DwcFy/ft00h//9738BAHFxcRbbx8TEWBQTjrRq1Qp///vfcfr0afznP//BmjVr0LFjRyxduhSvvPKKqd2FCxcwc+ZMtGvXDkFBQWjbti1uu+02AHB63N9++y1GjRqF0NBQhIaGom3btnjwwQdlt42JiYFOp7PpY+rUqaZ7S4x9fvfdd5gyZYrTY5w4cSIuXbqE7du3AwAuXryIXbt2WdwQPmTIEIwcORLPPfccwsLCMHbsWKxfv1723hw5zZs3x6BBg2y+brnlFlMbnU6HPn36mO6lKSwsRPv27REdHQ0ASEpKMhU2xj+tCxtj8R0fH4+SkhKUlJTg0qVLuPPOO3k5ijzGp6KoUerYsSPuv/9+rF69WvYR6NraWlNeh9wPKPOzH3379oXBYMDBgwdRUFBgKmBSUlJQUFCAEydO4MKFC04LG0D6wffnP/8Zer0eVVVVOHToEN544w3T+k2bNmHatGkW24hmT/3cd999mDt3LvLy8tCrVy/k5eWhTZs2GDp0qMU2L7zwAl5++WVkZGQgNTUVrVq1gp+fHx555BHZm1vNGc/0WDO/ZwaQ5jA6Ohrr1q2TbW+8kdnbYmNj8eCDD2LMmDGIjY1Fbm4u5s2bB0C60fbbb7/FU089hfj4eAQHB+PatWsYNWqUw+MuKytD//790bZtW7z88summ48PHTqE+fPn22xrryC788470bVrV2zYsAETJkzAhg0b0KxZM5unueT069cPkZGReO+99zB27Fhs2bIFBoPBorDx8/PDP//5TxQWFmLbtm3YuXMn0tLSsGzZMhQWFiouFJ3p27cv8vPzcfLkSdP9NUZJSUmYP38+ysrKsH//fsTGxto8gZibm4va2lrZXCU/Pz+7sQVESrCwoUZr3rx52LBhg8Vv9EadOnWCKIqIjY21+G1VTq9evdCkSRMUFBSgoKAATz31FADpB9GaNWuwe/du02tn7r33XsyZMwcbN27E1atXERAQYPGDa+jQocjPz7e7fUxMDPr164dNmzbhmWeewe7du5GRkYGAgACLdu+//z6GDx+OVatWWSz/7bff0LFjR4djbNWqFX777Teb5cYzL0adOnXCl19+iX79+qFJkyZ2+zPe/FtcXGzxA/Dnn3+2uGTjqrCwMHTo0AF6vR4AcO7cORQWFuKVV17B008/bWp3/Phxp3199tlnKC8vx65duyx+GH///fcuj2vq1KmYN28eLly4gI0bN2LMmDE2N9bK8fPzw/jx45GVlYUrV65g06ZN6NKliyk8z1xycjKSk5OxePFivP3225g+fTo++OADRZc0lTDPszlw4IDFDdS9e/eGTqfD7t27ceTIEUyYMMFi2xMnTuDrr7/GnDlzbG6INxgMmDJlit3YAiIleCmKGq1OnTrh/vvvx6pVq2wu6YwdOxY6nQ4LFiywyUERRRG//vqr6XXTpk2RkJCAjRs34vTp0xZnbK5evYrXX38dnTp1QmRkpNMxhYWFYfjw4diwYQNyc3MxbNgwhIWFmdZHRkbaXCawNnnyZJw7dw4PP/wwampqbC5DAdLlBOvjeueddyyOy55OnTrh+PHj+N///mda9tVXX+Hw4cMW7SZMmIBr167JXu4zGAymyzdDhgyBTqezCU1ctmyZ07EA0hNncoVWSUkJiouL0aVLFwAwnXmzPm4l+5HbtqqqCm+99ZaiMZqbPHkyampqMHPmTJw5c8alYmPixImorKxEdnY2du/ebZNLJDcPxsKnqqrK5bHa06dPH/j7+yMrKwtlZWUWZ2yCg4MRHx+P5cuXo6qqyuYy1IYNG+Dn54enn34a99xzj8XXpEmTkJSUxMtR5BGesaFG7fnnn8c777yDkydPomvXrqblnTp1wksvvYS5c+fip59+Mv1W/eOPP2LLli3IyMiw+I0yJSUFS5YsQYsWLdC9e3cAQLt27dClSxecPHkS6enpisc0depU3HPPPQCARYsWuXxM48ePx6xZs/Dxxx/j5ptvtvihY3T33Xfj1VdfxYwZM5CQkIBvv/0WmzZtMp09cWT69Ol44403MHToUKSnp+Ps2bNYs2YNbr/9dosbVocOHYq0tDS88MILOHz4MAYOHAidTocffvgBmzdvxpo1a3D33XfjpptuwmOPPYbXXnsNo0ePxtChQ/HVV19hz549aNGihdPxfPLJJ1iyZAlGjx6N3r17Izg4GCUlJcjKykJNTY3pbELbtm3Rq1cvvPTSS7hy5QrCw8OxY8cOi1wie/r164fQ0FDcd999mDVrFmpqapCTk2NzJkyJm266Campqdi8eTPatWuHIUOGKN42MTERMTExePbZZ1FdXW1T2KxevRo5OTkYM2YMOnbsiIsXL2L16tVo1aqVzeVIOb/99hs2bNhgs1yn01nc6BsUFIQ//OEPOHjwIEJCQmwyeJKSkrBixQoAtvfXGC+T2rsUOWrUKDz11FP497//jdtvv93pmIlsqPU4FlFDMn/c21paWpoIwOJxb6MPPvhA7Nu3rxgcHCwGBweLt956qzhz5kzx5MmTFu0++eQTEYA4fPhwi+UPPvigCMD0+Ks5WD3ubVRVVSW2atVKbNGihXj16lUXj1Typz/9SQQgPvfcc7Lrr1y5Ij722GNiRESEGBQUJPbr1088fPiwzaPcco97i6I0nzfffLPYpEkT8c477xQ///xzm8e9RVF6/P3NN98U//CHP4hNmzYVQ0NDxfj4eHHu3LniuXPnTO2qq6vFefPmiREREWKzZs3EgQMHiidOnBDDw8OdPu5dXFwszps3T+zVq5fYtm1b0d/fX2zXrp04atQocd++fRZt//vf/4qjRo0SW7RoIbZs2VKcNGmS+N///lcEIC5evNjUTu5x771794oJCQlis2bNxJtuukl8/vnnxa1bt4oAxIMHD5ra9e7dW+zZs6fDMRsf0zaPHFDqiSeeEAGI3bp1s1n31VdfiRMmTBBjYmLEJk2aiOHh4eLo0aPFo0ePOu3X0ePegYGBNu1nz54tAhBTU1Nt1uXl5YkAxDZt2ljEChQWFooAbGIUzJ04cUIEIM6dO9fpmInkCKKogbxxIjKprq5GVFQURo4ciaysLLWHQ/Vg06ZNuPfee/HVV1+ZHtUmIu/gPTZEGvPRRx/hwoULmDp1qtpDoXqyZs0a3HbbbSxqiOoB77Eh0ogvv/wSx44dw6JFi/CHP/wB/fv3V3tI5EW1tbV47733cOTIEezevdvmiTQi8g5eiiLSiPT0dGzYsAF33HEHsrOz0a1bN7WHRF507do1NGvWDM2bN8fkyZPxxhtvyGYkEZFnWNgQERGRz+A9NkREROQzWNgQERGRz/D5m4dra2tx9uxZNG/e3O5n3BAREZG2iKKIS5cuISoqCn5+ys/D+Hxhc/bsWcTExKg9DCIiInLDzz//bPr0eCV8vrAxfrjczz//jNDQUI/7MxgM2LVrF4YMGeJWnHpjwDlShvOkDOfJOc6RMpwnZbQyTxUVFYiJiVH0IbHmfL6wMV5+Cg0N9VphExQUhNDQUP7DsINzpAznSRnOk3OcI2U4T8pobZ5cvY2ENw8TERGRz2BhQ0RERD6DhQ0RERH5DBY2RERE5DNY2BAREZHPYGFDREREPoOFDREREfkMFjZERETkM1jYEBERkc9gYUNEREQ+Q9XCZuXKlYiPjzd93EFiYiJ27NhhWj9gwAAIgmDx9dBDD6k4YiIiItIyVT8rKjo6GkuWLEFcXBxEUUROTg5Gjx6Nb775Bl27dgUAzJgxAwsXLjRtExQUpNZwiehGpdcDxcVAXBzgwqcE+yTORf1orPOqweNW9YzNyJEjMWLECMTFxeGWW27Byy+/jJCQEBw6dMjUJigoCBEREaYvb3yQJRE1IllZQIcOQGqq9GdWltojUg/non401nnV6HFr5tO9a2pqsHnzZlRWViIxMdG0PDc3Fxs2bEBERARGjhyJ+fPnOzxrU1VVhaqqKtPriooKANKnlRoMBo/HaezDG335Ks6RMpwnZTyaJ70e/hkZEGprpde1tRAzM1GdmqqZ3y69QdEcNZK5cKRe/s354Lxq5f3k7t+T6oXN8ePHkZiYiGvXriEkJARbtmzB7bffDgC477770KFDB0RFReHYsWN45plncPLkSXz44Yd2+1u8eDEWLFhgs3zXrl1evYyVn5/vtb58FedIGc6TMu7MU9jx40g2/sf7O6GmBl/m5uLX7t29NTTNcDRHjW0uHPHmvzlfnle1309XrlxxaztBFEXRKyNw0/Xr13H69GmUl5fj/fffx9q1a7F3715TcWPu888/x8CBA1FSUoJOnTrJ9id3xiYmJgZlZWVeuYxlMBiQn5+PwYMHIyAgwOP+fBHnSBnOkzIezZNeD//Onet+qwQg6nSoLi6+YX+blqNojhrJXDhSL//mfHBetfJ+qqioQFhYGMrLy136+a36GZsmTZqgc+fOAICePXuiqKgIy5cvx6pVq2za9u7dGwAcFjaBgYEIDAy0WR4QEODVHx7e7s8XcY6U4Twp49Y8xcYCq1cDmZlATQ2g00FYtQoBsbH1M0iVOZyjRjYXjnj135wPz6va7yd3/45UL2ys1dbWWpxxMXf06FEAQGRkZEMOiYhuZNOnA0OHAiUlQOfON+xv0V7BuagfjXVeNXrcqhY2c+fOxfDhw9G+fXtcunQJeXl5+OKLL7Bz506cOnUKeXl5GDFiBNq0aYNjx45h9uzZ6NevH+Lj49UcNhHdaKKjNfOfruo4F/Wjsc6rBo9b1cLml19+wdSpU1FaWooWLVogPj4eO3fuxODBg/Hzzz/js88+w7Jly1BZWYmYmBiMGzcO8+bNU3PIREREpGGqFjZZDp55j4mJwd69extwNERERHSj42dFERE5o9cDe/ZIfzbktp5Qa79EKmNhQ0TkiCfpqmols2o0EZaoIbCwISKyR68HMjIAs3RVZGYqOwviybaeUGu/RBrBwoaIyJ7i4roCwaimRnq8tT639YRa+yXSCBY2RET2xMUBflb/Tep0UmZHfW7rCbX2S6QRLGyIiOyJjpbSVXU66bVOB6xapSy3w5NtPaHWfok0QnPJw0REmuJJuqpayawaTYQlaggsbIiInPEkXVWtZFYNJsISNQReiiIiIiKfwcKGiIiIfAYLGyIib2oMib+uHGNjmA9v4Vx5BQsbIiJvaQyJv64cY2OYD2/hXHkNCxsiIm9oDIm/rhxjY5gPb+FceRULGyIib2gMib+uHGNjmA9v4Vx5FQsbIiJvaAyJv64cY2OYD2/hXHkVCxsiIm9oDIm/rhxjY5gPb+FceRUD+oiIvKUxJP66coyNYT68hXPlNSxsiIi8qTEk/rpyjI1hPryFc+UVvBRFREREPoOFDREREfkMFjZERK7whXRYXzgGZxrDMZIsFjZEREr5QjqsLxyDM43hGMkuFjZEREr4QjqsLxyDM43hGMkhFjZEREr4QjqsLxyDM43hGMkhFjZEREr4QjqsLxyDM43hGMkhFjZEREr4QjqsLxyDM43hGMkhBvQRESnlC+mwvnAMzjSGYyS7WNgQEbnCF9JhfeEYnGkMx0iyeCmKiIiIfAYLGyIiIvIZLGyIqHFRK5GWSbhEDYKFDRE1Hmol0jIJl6jBsLAhosZBrURaJuESNSgWNkTUOKiVSMskXKIGxcKGiBoHtRJpmYRL1KBY2BBR46BWIi2TcIkaFAP6iKjxUCuRlkm4RA2GhQ0RNS5qJdIyCZeoQfBSFBEREfkMVQublStXIj4+HqGhoQgNDUViYiJ27NhhWn/t2jXMnDkTbdq0QUhICMaNG4fz58+rOGIiIiLSMlULm+joaCxZsgRHjhzB4cOHkZqaitGjR+O7774DAMyePRtbt27F5s2bsXfvXpw9exZjx45Vc8hEdKMoKgKWLpX+dEavB957T/pSK1/GW8nETDimRk7Ve2xGjhxp8frll1/GypUrcejQIURHRyMrKwt5eXlITU0FAKxbtw633XYbDh06hD59+qgxZCK6EaSnAzk5da/T0oDsbPm2WVnAjBmAKEqvBQFYs0a64behZGXVhfj5+UlPUbmxf2HdOuDhhz3uh+hGppmbh2tqarB582ZUVlYiMTERR44cgcFgwKBBg0xtbr31VrRv3x4HDx60W9hUVVWhqqrK9LqiogIAYDAYYDAYPB6nsQ9v9OWrOEfKcJ6UcXmeiorgn5MDwWyRmJOD6owMICHBsq1eD/+MDAjGogYARBFiRgaqU1Mb5mZf4xjMkonFzEyX9m8wGNC0rAw6Y1HjZj++jv/mlNHKPLm7f9ULm+PHjyMxMRHXrl1DSEgItmzZgttvvx1Hjx5FkyZN0LJlS4v24eHhOHfunN3+Fi9ejAULFtgs37VrF4KCgrw27vz8fK/15as4R8pwnpRROk+dPv4Y3ayWCQBOZGXhPxcuWCwPO34cydapwACE2lp8mZuLX7t3d3O0ysmNQaipcXn/YaWldcWRB/00Bvw3p4za83TlyhW3thNE0fxXlYZ3/fp1nD59GuXl5Xj//fexdu1a7N27F0ePHsW0adMszr4AQK9evXDXXXfhlVdeke1P7oxNTEwMysrKEBoa6vF4DQYD8vPzMXjwYAQEBHjcny/iHCnDeVLG5XkqKoJ/crLlGRsA1YWF8mdsOne2KQhEPz9Ul5Q03BkbqzGIOh2qi4tdOmNTsHEjhpif+XGjH1/Hf3PKaGWeKioqEBYWhvLycpd+fqt+xqZJkybo/Hu0eM+ePVFUVITly5dj4sSJuH79Oi5evGhx1ub8+fOIiIiw219gYCACAwNtlgcEBHj1L8jb/fkizpEynCdlFM9TUpJ0T43ZPTZCWhoCkpJs28bGSvehmH9IpSBAWL0aAbGxXhq5E8YxZGZKnyGl00FYtcrl/V8LC0PNypXwf+QRj/ppDPhvThm158ndfate2Firra1FVVUVevbsiYCAAOzevRvjxo0DAJw8eRKnT59GYmKiyqMkIk3LzgZmzgQKC4HkZNszNeaMqcAHD0qvExMb/gyHl5KJxWnTgBEjmHBMjZqqhc3cuXMxfPhwtG/fHpcuXUJeXh6++OIL7Ny5Ey1atMD06dMxZ84ctG7dGqGhoZg1axYSExP5RBQROZeQ4LigMRcdDYwfX7/jUTIGbxQiTDimRk7VwuaXX37B1KlTUVpaihYtWiA+Ph47d+7E4MGDAQCvvfYa/Pz8MG7cOFRVVWHo0KF488031RwyERERaZiqhU1WVpbD9U2bNsWKFSuwYsWKBhoRERER3cj4WVFERI4wyZc8wfdPg2NhQ0RkT1a4O8LJAAAgAElEQVQW0KEDkJoq/enkLDORBb5/VMHChohIjl5v+Rh4ba30SDZ/8yYl+P5RDQsbIiI5xcV1P5SMamqkR6mJnOH7RzUsbIiI5MTFSR8kaU6nk/JhiJzh+0c1LGyIiORER0uJwDqd9FqnA1atYkYMKcP3j2o0lzxMRKQZXkoEpkaK7x9VsLAhInKESb7kCb5/GhwvRREREZHPYGFDREREPoOFDRH5Pq2kv9obh1bGp3WcJ1KAhQ0R+TatpL/aG4dWxqd1nCdSiIUNEfkuraS/2htHUZE2xqd1Wvl7pBsCCxsi8l1aSX+1N479+7UxPq3Tyt8j3RBY2BCR79JK+qu9cfTtq43xaZ1W/h7phsDChoh8l1bSX+2NIyFBG+PTOq38PdINgQF9ROTbtJL+am8cWhmf1nGeSCEWNkTk+7SS/mpvHFoZn9ZxnkgBXooiIiIin8HChoiIiHwGCxsirXEnXZWJrEREAFjYEGmLO+mqTGQlIjJhYUOkFe6kqzKRlYjIAgsbIq1wJ12ViaxERBZY2BBphTvpqkxkJSKywMKGSCvcSVdlIisRkQUG9BFpiTvpqkxkJSIyYWFDpDXupKsykZWICAAvRREREZEPYWFDREREPoOXoohU1OKHH+D3ww9A27bAb78BKSlAQoKUQ1NcLD31BNR9r/Ryk/n23rhE5U5/rm7j7TETUaPEwoZIJX7Tp6P/O+9AsF6RlAQcOiTl0wi/rxVF6bHu1aulm4UdycqqC+1Tuo23+3N1G2+PmYgaLV6KIlJDURH85IoaADhwoC50TxSlL0CdJOKGSENmejIReRELGyI1FBTIFzXONHQScUOkITM9mYi8iIUNkRpSUiC6s11DJxE3RBoy05OJyItY2BCpISEBtVOmyBc3SUl1ScJ+fnX32aiRRNwQachMTyYiL+LNw0Qqqc3KQkH37kjx84OuTRvg4kUgObnuqShjkjCgbhJxQ6QhMz2ZiLyEhQ2RispvuQW1I0ZAFxBgucI6SVjtJOKGSENmejIReQEvRREREZHPULWwWbx4MRISEtC8eXO0a9cOY8aMwcmTJy3aDBgwAIIgWHw99NBDKo2YiIiItEzVwmbv3r2YOXMmDh06hPz8fBgMBgwZMgSVlZUW7WbMmIHS0lLT16uvvqrSiIlUptcDe/bIZ7yYr3PUztV+G2J7IiIvUfUem08//dTidXZ2Ntq1a4cjR46gX79+puVBQUGIiIho6OERaYujdF7zda6mFXua+svUYCLSEE3dPFxeXg4AaN26tcXy3NxcbNiwARERERg5ciTmz5+PoKAg2T6qqqpQVVVlel1RUQEAMBgMMBgMHo/R2Ic3+vJVnCNlXJonvR7+GRkQzNJ5xcxMVKemAoDlOtHsIXLzdnI35jrqV+HnO3m0vQJ8PznHOVKG86SMVubJ3f1rprCpra3F448/juTkZHTr1s20/L777kOHDh0QFRWFY8eO4ZlnnsHJkyfx4YcfyvazePFiLFiwwGb5rl277BZD7sjPz/daX76Kc6SMknkKO34cyVbpvEJNDb7MzYUA2KyTa/dr9+4u9SvX3tvbu4LvJ+c4R8pwnpRRe56uXLni1naCKIpuBaB628MPP4wdO3Zg//79iHbwm97nn3+OgQMHoqSkBJ06dbJZL3fGJiYmBmVlZQgNDfV4nAaDAfn5+Rg8eDACrB/RJQCcI6Vcmie9Hv6dO9edGQEg6nSoLi4GAJt15kzt7J2xsdev0jM2nmyvAN9PznGOlOE8KaOVeaqoqEBYWBjKy8td+vmtiTM2jz76KLZt24Z9+/Y5LGoAoHfv3gBgt7AJDAxEYGCgzfKAgACv/gV5uz9fxDlSRtE8xcZK965kZkqfo6TTQVi1CgGxsdJ683V+fnUfnmndztV+nfF0exfw/eQc50gZzpMyas+Tu/tWtbARRRGzZs3Cli1b8MUXXyBWwX+GR48eBQBERkbW9/CItMVROq/1OqDhUn+ZGkxEGqJqYTNz5kzk5eXh448/RvPmzXHu3DkAQIsWLdCsWTOcOnUKeXl5GDFiBNq0aYNjx45h9uzZ6NevH+Lj49UcOpE6HKXzepJW7GnqL1ODiUgjVC1sVq5cCUAK4TO3bt06pKeno0mTJvjss8+wbNkyVFZWIiYmBuPGjcO8efNUGC0RERFpneqXohyJiYnB3r17G2g0REREdKPjZ0URNSSlycHe7Ncb/RMR3SBY2BA1lKwsoEMHIDUV6NABwrp1dtchK8vtfmW39aR/IqIbCAsbooag19d97AAA1NZC98gjaFpWJrsOmZnKzqwo2daT/omIbjAsbIgaQnFxXWHxO6GmBsGlpRBKSmzWoaZGenzajX5ttlXShojIR7CwIWoIcXFScJ4ZUadDZWQkxM6dbdZBp6vLo3GxX5ttlbQhIvIRLGyIGkJ0tJTQq9NJr3U61Lz5Jq6Fhcmuw6pVynJhlGzrSf9ERDcYTXykAlGjYJXQK4aHA9u3y65zqehQsi3TgYmokWBhQ9SQzBN6DQb76zzp15M2REQ3OF6KIiIiIp/BwoaIiIh8Bi9FEWmNXi89oh0X51uXjpwdlyvHbWwbEgJcvux7c0VEbuMZGyIt8dWEYGfH5cpxm7ft1cv35oqIPMLChkgrfDUh2NlxuXLc1m2NfGWuiMhjLGyItMJXE4KdHZcrxy3X1tk2RNSosLAh0gpfTQh2dlyuHLdcW2fbEFGjwsKGSCt8NSHY2XG5ctzWbY18Za6IyGN8KopIS3w1IdjZcbly3OZtg4OBykrfmisi8ggLGyKt8dWEYGfH5cpx++ocEZHHeCmKiIiIfAYLGyIiIvIZLGyItEKvB/bs8U4Wizf78vYYtDA2IvJZLGyItMCbicNaSC+2NwYtjI2IfBoLGyK1eTNxWAvpxfbGUFSk/tiIyOexsCFSmVBS4r3EYS2kF9sbw/796o+NiHweCxsilYmdO3svcVgL6cX2xtC3r/pjIyKfx8KGSG3eTBzWQnqxvTEkJKg/NiLyeQzoI9ICbyYOayG92N4YtDA2IvJpLGyItMKbabpaSOa1NwYtjI2IfBYvRREREZHPYGFDREREPoOFDZEWaTmdV+nYtHwMROSzWNgQaY2W03mVjk3Lx0BEPo2FDZGWaCE52B6lY9PyMRCRz2NhQ6QlWkgOtkfp2LR8DETk81jYEGmJFpKD7VE6Ni0fAxH5PBY2RFqiheRge5SOTcvHQEQ+jwF9RFqj5XRepWPT8jEQkU9jYUOkRVpO51U6Ni0fAxH5LF6KIiIiIp+hamGzePFiJCQkoHnz5mjXrh3GjBmDkydPWrS5du0aZs6ciTZt2iAkJATjxo3D+fPnVRoxERERaZmqhc3evXsxc+ZMHDp0CPn5+TAYDBgyZAgqKytNbWbPno2tW7di8+bN2Lt3L86ePYuxY8eqOGqiBuBKaq91WyXb1lcqMNOGiUhlbhU2e/bs8crOP/30U6Snp6Nr167o0aMHsrOzcfr0aRw5cgQAUF5ejqysLCxduhSpqano2bMn1q1bhwMHDuDQoUNeGQOR5riS2mvdNj3d+bb1lQrMtGEi0gC3bh4eNmwYoqOjMW3aNKSlpSEmJsYrgykvLwcAtG7dGgBw5MgRGAwGDBo0yNTm1ltvRfv27XHw4EH06dPHpo+qqipUVVWZXldUVAAADAYDDAaDx2M09uGNvnwV50gZ2XnS6+GfkQHBLLVXzMxEdWqq7Y24cm1zciAY18tt60r/rqivfsH3kxKcI2U4T8poZZ7c3b9bhc2ZM2fwzjvvICcnBwsWLEBqaiqmT5+OMWPGoEmTJm4NpLa2Fo8//jiSk5PRrVs3AMC5c+fQpEkTtGzZ0qJteHg4zp07J9vP4sWLsWDBApvlu3btQlBQkFtjk5Ofn++1vnwV50gZ83kKO34cyVapvUJNDb7MzcWv3btbLJdta9W39bau9O+K+urXHN9PznGOlOE8KaP2PF25csWt7QRRFEVPdvz1119j3bp12LhxIwDgvvvuw/Tp09GjRw+X+nn44YexY8cO7N+/H9G//4aXl5eHadOmWZyBAYBevXrhrrvuwiuvvGLTj9wZm5iYGJSVlSE0NNTVw7NhMBiQn5+PwYMHIyAgwOP+fBHnSBnZedLr4d+5c92ZDwCiTofq4mL5MzbWbWFZ3Nhs60r/rqivfsH3kxKcI2U4T8poZZ4qKioQFhaG8vJyl35+e5xjc+eddyIiIgJt2rTBkiVL8Pbbb+PNN99EYmIi3nrrLXTt2tVpH48++ii2bduGffv2mYoaAIiIiMD169dx8eJFi7M258+fR0REhGxfgYGBCAwMtFkeEBDg1b8gb/fnizhHyljMU2yslNqbmSl9vpJOB2HVKgTExtpuKNf2/vuBDRvsb+tK/66or37N8P3kHOdIGc6TMmrPk7v7dvupKIPBgPfffx8jRoxAhw4dsHPnTrzxxhs4f/48SkpKEB0djfHjxzvsQxRFPProo9iyZQs+//xzxFr9J9izZ08EBARg9+7dpmUnT57E6dOnkZiY6O7QibRt+nTgp5+kp4t++kl6rbRtdrbzbV3pv77GTURUT9w6YzNr1ixs3LgRoihiypQpePXVV033xQBAcHAwXnnlFdx8880O+5k5cyby8vLw8ccfo3nz5qb7Zlq0aIFmzZqhRYsWmD59OubMmYPWrVsjNDQUs2bNQmJiouyNw0Q+w5XUXuu2Sratr1Rgpg0TkcrcKmz+/e9/4x//+AfGjh0re9kHAKKiopw+Fr5y5UoAwIABAyyWr1u3Dunp6QCA1157DX5+fhg3bhyqqqowdOhQvPnmm+4Mm4iIiHycy4WNwWBAhw4d0KdPH7tFDQD4+/ujf//+DvtSct9y06ZNsWLFCqxYscLVoRIREVEj4/I9NgEBAfjggw/qYyxEjU7TsjIIX3wBFBXJJ/bWZ5Kvs74drbe3jsnDRKQyt24eHjNmDD766CNvj4WoURHWrcOQGTPgP2QI0KuXbWJvfSb5Ouvb0Xp765g8TEQa4NY9NnFxcVi4cCEKCwvRs2dPBAcHW6x/7LHHvDI4Ip+l10P38MMQrC/H1tZKj0zHxwMZGdJr8+VDh3p+c65e77hvR+sB+XX1OV4iIhe4VdhkZWWhZcuWOHLkiOlznYwEQWBhQ+RMcbFFmJ2Fmhpg//66IsF8eUmJ54VCcbHjvh2tF0X5dfU5XiIiF7hV2Pz444/eHgdR4xIXB9HPT7640emAvn0BPz/LYkGnAzp39sq+HfbtbL3cuvocLxGRC9wO6CMiD0RHo2blStT6Wf0T1OmAVauAhAQpyVens1zujbMf0dGO+3a03t66+hwvEZEL3P5IBb1ej3/+8584ffo0rl+/brFu6dKlHg+MyNeJ06YhX6fDwA4d4N+iBVBZKZ3hMBYD06dL96iUlFgu9wZnfTtab29dfY6XiEghtwqb3bt3Y9SoUejYsSNOnDiBbt264aeffoIoirjzzju9PUYin3UtLAxi//6Avc9Eqc8kX2d9O1pvbx2Th4lIZW5dipo7dy6efPJJHD9+HE2bNsUHH3yAn3/+Gf3793f6+VBERERE9cWtwub777/H1KlTAUgJw1evXkVISAgWLlyIV155xasDJCIiIlLKrUtRwcHBpvtqIiMjcerUKXTt2hUAUFZW5r3REfkavR7YuhUoLQWGDVPWvrhYelIJqPve/HKPsU1ICHD5su16peOS67uhtvdWH0TU6Ll1xqZPnz7Yv38/AGDEiBF44okn8PLLL+OBBx7gp24T2ZOVBbRvDzzyCLBoEfyTk3HH8uWO2xuTfNu3l74cpf3KpRcrHZcnicHeSBxmajEReYlbhc3SpUvRu3dvAMCCBQswcOBAbNq0CTfffDOy+B8SkS1jmq9Z0rAAoP2ePdLnRNlrb8yFEcW6bY2pvkVFlm2MjOuVfF6TvZRhpZ/15On23uqDiOh3bl2K6tixo+n74OBgvPXWW14bEJFPkkvzhVTc+B08CCQlKWpvYi/t13y9ktRfZynEzni6vbf6ICL6HQP6iBqCMc3XigigNjFRcXsT87Rfe+uVpP7K7ceVxGBPt/dWH0REv1Nc2LRq1QqtW7dW9EVEVoyJvYJgWiQCOH3XXVJqr732xiRfP7+6be2l/Rq5kvrrLIW4vrf3Vh9ERL9TfClq2bJl9TkOIt9nTObdtg04dw7VQ4bg6IULiHLW3pjkCzhO+w0Otk0vdmVc7iYGeyNxmKnFROQligubtLS0+hwHUeMQHQ089JD0vcEAbN/uvL35D/n6Svv1tA8tjIGICB58VpTRtWvXbD4rKjQ01NNuiYiIiFzm1s3DlZWVePTRR9GuXTsEBwejVatWFl9EREREanCrsHn66afx+eefY+XKlQgMDMTatWuxYMECREVFYf369d4eIxF5g14P7NnDfBgi8mluFTZbt27Fm2++iXHjxsHf3x8pKSmYN28e/vrXvyI3N9fbYyQiTzHZl4gaCbcKm99++80U0hcaGorffvsNANC3b1/s27fPe6MjIs8x2ZeIGhG3CpuOHTvixx9/BADceuuteO+99wBIZ3JatmzpvdERkeccJfsSEfkYtwqbadOm4dtvvwUAPPvss1ixYgWaNm2K2bNn46mnnvLqAInIQ0z2JaJGxK3HvWfPnm36ftCgQThx4gSOHDmCzp07Iz4+3muDIyIvMCb7ZmZKZ2qY7EtEPsylMzYHDx7Etm3bLJatX78eAwYMwEMPPYQ33ngDVVVVXh0gEXnB9OnATz9JT0X99JP0mojIB7lU2CxcuBDfffed6fXx48cxffp0DBo0CHPnzsXWrVuxePFirw+SiLwgOhoYMIBnaojIp7lU2Bw9ehQDBw40vX733XfRu3dvrFmzBrNnz8brr79uupGYiIiIqKG5VNj873//Q3h4uOn13r17MXz4cNPrhIQE/Pzzz94bHREREZELXCpswsPDTY95X79+HV9//TX69OljWn/p0iUEBAR4d4REjZl5WrC95OCiImDpUulPdxQVAX/5C7BypeNsGyYXE9ENwKXCZsSIEXj22WdRUFCAuXPnIigoCCkpKab1x44dQ6dOnbw+SKJGyTwtuH176cs6OTg9HejVC3jiCenP9HTX9mHcftEi4JFHgJgY+VRiJhcT0Q3CpcJm0aJF8Pf3R//+/bFmzRqsWbMGTZo0Ma1/++23MWTIEK8PkqjRsU4LFkXpC6hLDt62DcjJsdwuJ0f5mZuiItvtAWDGDMuzMkwuJqIbiEs5NmFhYdi3bx/Ky8sREhICnU5nsX7z5s0ICQnx6gCJGiW5tGBzNTXA9u3y6woLgYQE5/soKJBfLopSKrHx6SlHycV8woqINMat5OEWLVrYFDUA0Lp1a4szOETkJrm0YHM6HTBihPy65GRl+zC7jGxBECxTiZlcTEQ3ELcKGyKqZ8a0YOMvEH5+UsEB1CUH3303kJZmuV1amrKzNYDUznp7AFizxvJMjPVYmFxMRBrm1kcqEFEDmD4dGDpUuuRjPDti/N5YVGRnAzNnSpefkpOVFzVGxu0/+QSIiJCKJbmCxXosLGqISKNY2BBpWXS07dkTawkJrhc07mxvPRYiIg3ipSgiIiLyGaoWNvv27cPIkSMRFRUFQRDw0UcfWaxPT0+HIAgWX8OGDVNptERERKR1ql6KqqysRI8ePfDAAw9g7Nixsm2GDRuGdevWmV4HBgY21PBIbXq99KhxXJz02vi9+eUQvR44cED6Pimpbp35tqWl0qPNKSm2l1zM2/EyCxHRDU/Vwmb48OEWnzUlJzAwEBEREQ00ItKMrKy6UDjj00CiKD0dtHq1dDNrVpYUJmcMrhME6YkewHJb43pAegooO9t2H+b9EhHRDUvzNw9/8cUXaNeuHVq1aoXU1FS89NJLaNOmjd32VVVVqKqqMr2uqKgAABgMBhgMBo/HY+zDG335Ko/nSK+Hf0YGBPPUXaPaWoiZmai+7Tapjfk6UYSYkQGIYt1y8/UAxJwcVGdkAJGRlvsw9pua2mBnbvheUobz5BznSBnOkzJamSd39y+IotX//CoRBAFbtmzBmDFjTMveffddBAUFITY2FqdOncJzzz2HkJAQHDx4UDYgEABefPFFLFiwwGZ5Xl4egoKC6m385D1hx48jef58h22OP/AAur/9tlv9H3/gAVTExsruY/+iRfi1e3e3+iUiIu+5cuUK7rvvPpSXlyM0NFTxdpoubKz95z//QadOnfDZZ59h4MCBsm3kztjExMSgrKzMpYmxx2AwID8/H4MHD+Ynmdvh8Rzp9fDv3LnubIoVUadD9b598E9JsWkj+vlZnrGx3hZAdWGhdMbGah+iTofq4uIGPWPD95JznCfnOEfKcJ6U0co8VVRUICwszOXCRvOXosx17NgRYWFhKCkpsVvYBAYGyt5gHBAQ4NW/IG/354vcnqPYWOl+l8xM6TOJfi9WIIqATgdh1SoEJCVJbcw/nFEQIKxeLX1v3NbqHhshLU3aFrDch7Hf2FgPj9p1fC8pw3lyjnOkDOdJGbXnyd1931CFjV6vx6+//orIyEi1h0L1TUnqrrHNwYPS68TEunXm25aWyifzMk2XiMjnqFrYXL58GSUlJabXP/74I44ePYrWrVujdevWWLBgAcaNG4eIiAicOnUKTz/9NDp37oyhQ4eqOGpqMEpSd6OjgfHjHW8bHW0/WZdpukREPkXVwubw4cO46667TK/nzJkDAEhLS8PKlStx7Ngx5OTk4OLFi4iKisKQIUOwaNEiZtkQERGRLFULmwEDBsDRvcs7d+5swNEQERHRjY6fFUXaVVQEPP649FVUZLtu6VLL5Xo9sGeP9KccZ+sdkdvWk/6IiKhe3FA3D1Mjkp4O5OTUvV6+vC412HpdWpr0cQmOUoQ9SRmW2xZgajERkQbxjA1pT1GRZeFilJMjFTbW63JygAcfrHvsu7ZWeozbeCZFr7d8LNx6vSP2tp0xw73+iIioXrGwIe0pKLC/bssWZX3U1EiPcQPSh1xah/2Zr3fE3rbW94Yp7Y+IiOoVCxvSnpQU++v+9Cdlfeh0dfk3cXHS5SJ76x2xt63xgzld7Y+IiOoVCxvSnoQE6b4Za2lp0v011uvS0oC1a6XiApD+XLXKMsdm9Wr76x2xt+2aNe71R0RE9Yo3D5M2ZWcDM2cCGzdKrydNqgvZM66zThN2lCLsScqwvW2ZWkxEpDksbEi7EhLsJwbLrXOWIuxJyrDctkwtJiLSHF6KIiIiIp/BwoaIiIh8Bi9Fkbbo9cCBA9L3SUmuXeopKpIeFU9JkS5T6fXS49pxccDRo8D27cCIEcDddysbh3Hb6GjbvuXaEBGR6ljYkHZkZUnBd8aMGEGQnj5SkuhrnUaclAQcOmSbQbNypbSusNDxOMxThfv0qSu2AGVJx0REpApeiiJtMCb8mgffiaK0zFmir1xS8YEDtkWN+bpt2xyPwzxV2LyoAZwnHRMRkWpY2JA2yCX8AtIyZ4m+jpKK7fn0U9fG4QyTh4mINIGFDWmDXMIvIC1zlujrKKnYnmHDXBuHM0weJiLSBBY2pA3GhF/zokIQpGXObsyVSypOSqpLBraWlGT/BmK5pOGkJMs2zpKOiYhINbx5mLTDmPB78KD0OjFRebEgl0as19clAx89Kl1+GjbM+VNRcknDRUWuJR0TEZEqWNiQtkRHA+PHu7etdRqxeTJwdLSyx7zltpXrW64NERGpjpeiiIiIyGewsCEiIiKfwUtRdOMxT/wF6j/91zph2Pg6JAS4fLluHOaJydavecmKiKhBsLChG4t5KrAgSMtEsf7Sf61TiKdMAd55xzLrRhAsgwWtuZKgTEREHuGlKLpxWKcCi2JdQVEf6b9yKcQ5ObYBfo6KGuN6JQnKRETkMRY2dONwlgrs7fRfd1OI5ShJUCYiIo+xsKEbh7NUYG+n/7qbQixHSYIyERF5jIUN3TisU4H9/Orus6mP9F+5FOK0NNtEY/NxANL31q+VJCgTEZHHePMw3VisU4GB+k3/lUshfukl6XVwMFBZWTcO88Rk69csaoiIGgQLG7rxWCf+1nfRILc/uX1aJya7m6BMRERu46UoIiIi8hksbIiIiMhn8FIUaYu9lF9HKcPW2xiXWSf/FhUBBQXALbdI98c46rOoCNi6FYiMBEaOdH65S24MRETU4FjYkHY4Svm1lzJsvc3q1VK7GTPqgvMEQbqB11joGNnrMz1dCuIzeuQRYO1a+8nBcmNgyjARkSpY2JA22Ev5NTJP9zWmDMfH226TmSn9ad5eFG2LGnt9hodb7tdoxgzp6SjrszFy487MlG9LRET1jvfYkDa4mvJbUwPs32+7TU2N8484cNTn9u3y60RRPjlYbtzeTkAmIiLFWNiQNria8qvTAX372m6j01mG47lCpwNGjJBfJwjyycFy4/Z2AjIRESnGwoa0wVnKr1zKcEKC7TarVkmfpG1ebAiCdAOxNbk+775b2q+1NWvkLy3JjdvbCchERKQY77Eh7XCU8msvZVhuG0BaZp38W1QEFBZK7UJC7PeZnQ3MnAl88gkQESEVO44KFXtjICKiBsfChrTFWcqvvbMm1sujo22TfxMSpC+57a3Za6t03EREpApeiiIiIiKfoWphs2/fPowcORJRUVEQBAEfffSRxXpRFPGXv/wFkZGRaNasGQYNGoTi4mKVRktERERap+qlqMrKSvTo0QMPPPAAxo4da7P+1Vdfxeuvv46cnBzExsZi/vz5GDp0KP7973+jadOmKoyYGpR5enBsLHD5svQUUmkpkJsrLZ88WUoHLi6W7psxtpHLm7GXWmydUGxvLNYJyI72R0REqlC1sBk+fDiGDx8uu04URSxbtgzz5s3D6NGjAQDr169HeHg4PvroI9x7770NOVRqaFlZlunBRoJguWz5ctttrdN/7SUDW+9DEKSnn6xTg823N08rtrc/IiJSjWZvHt7qRusAACAASURBVP7xxx9x7tw5DBo0yLSsRYsW6N27Nw4ePGi3sKmqqkJVVZXpdUVFBQDAYDDAYDB4PC5jH97oy1d5PEd6PfwzMiDIBe0pCd+rrYWYmYnq1FQAkPoySwYWMzNRfdtttvsQRYgZGdJ2Zp85ZbG93P7N9+fCmRu+l5ThPDnHOVKG86SMVubJ3f1rtrA5d+4cACA8PNxieXh4uGmdnMWLF2PBggU2y3ft2oWgoCCvjS8/P99rffkqd+co7PhxJLuSQixDqKnBl7m5EACbvoSaGpzIykJ3mX0ItbX4MjcXv3bv7tJYjPszbucKvpeU4Tw5xzlShvOkjNrzdOXKFbe2E0TR3fx57xIEAVu2bMGYMWMAAAcOHEBycjLOnj2LyMhIU7sJEyZAEARs2rRJth+5MzYxMTEoKytDaGiox+M0GAzIz8/H4MGDERAQ4HF/vsjjOdLr4d+5c91ZEjeIOh2qf7/R3LovUadD9b598E9JsdmH6OeH6pISyzM2CsZi2p+LZ2z4XnKO8+Qc50gZzpMyWpmniooKhIWFoby83KWf35o9YxMREQEAOH/+vEVhc/78edxxxx12twsMDERgYKDN8oCAAK/+BXm7P1/k9hzFxkr3rJh/uKSR9T02cnQ6CKtWISA2Vnq9erX0wZQ1NXXrkpJs9yEIEFavrtvOfCzG7f38pP2bj8F6fy7ie0kZzpNznCNlOE/KqD1P7u5bs4VNbGwsIiIisHv3blMhU1FRgS+//BIPP/ywyqOjemdM8zWmB998M1BZKSX7lpYCGzdKyydNkp6KKikBgoPr2pifObGXDGy9D2NCsb2xWCcg29sfERGpRtXC5vLlyygx+xTkH3/8EUePHkXr1q3Rvn17PP7443jppZcQFxdnetw7KirKdLmKfJxcerBxuXUqsLPCwl4ysL19ONuehQwRkSapWtgcPnwYd911l+n1nDlzAABpaWnIzs7G008/jcrKSmRkZODixYvo27cvPv30U2bYEBERkSxVC5sBAwbA0b3LgiBg4cKFWLhwYQOOioiIiG5Umr3HhhoxeynBnvQhlxxsvc6dJGEl/RrTkgsKgJQU1z5ck4iIXMLChrTFXkqwJ31MmQK8845tcrD1OiOl+7WXSCy3T/Mzk2lpQHa2a8dERESK8NO9STv0esvHr2trpces9XrP+sjJqXtt/qi29TojJfu13o+jfq0vt+bkAEVFyo+JiIgUY2FD2lFcbFtk1NRIj1Z70oc7nO3X0/0UFrq/LRER2cXChrQjLk66jGNOp6vLjnG3D3c426+n+0lOdn9bIiKyi4UNaUd0tHRvi04nvdbpgFWrXLuBWK6PtLS6135+dffDWK8zUrJf6/046te43CgtjTcQExHVE948TNpiLyXY0z5eesk2Odh6natJwvYSieX2WVoqXX5KTmZRQ0RUj1jYkPbYSwn2pA9HycGe7E9pv3JpyURE5HW8FEVEREQ+g4UNERER+QxeiiLtkUseLiqqS+6NjAQOHJCWx8ZapgUrSS12NdlYrwe2bpXukxk5UvklJesxe5qmTERETrGwIW2RSx4uKJBC7RyxTvu1lx7sarJxVhYwY0ZdyN6iRcqSg9PT5cfsbpoyEREpwktRpB1yqcEZGc6LGmNb87RfufRgV5ONje1dTQ4uKrI/ZnfSlImISDEWNqQdcmm+nqT7WqcHu5ps7Chd2FFycEGBa+MiIiKvYWFD2iGX5utJuq91erCrycaO0oUdJQenpLg2LiIi8hoWNqQdcqnBq1dL97Q4Y532K5ce7GqysbG9q8nBCQn2x+xOmjIRESnGm4dJW+RSg6dPB2bOrEvujYwEDh6U2t98s2VasHnar1zx4GqysbH9tm3AuXPA//t/yp6Kys62HbMnacpERKQICxvSHrkk4IQEy4Ji/Hjl27rTxrr9Qw8pb29kPWYWNERE9Y6XooiIiMhnsLAhIiIin8FLUaQ95om9gPT9LbcAV65Ir63ThuWYpwsfPQps3w706gV06GB/O/P9ml9C0uvrko6TkqQ/mSJMRKRJLGxIW+wl9spRki5sbuVK+9tZ79eYLmydPAxIT0mJIlOEiYg0iJeiSDscJfbKUZIurGQ7uf3m5EhPQsklDxtfM0WYiEhzWNiQdjhL7JWjJF3Y2Xb29rtjh/O+mCJMRKQpLGxIO5wl9spRki7sbDt7+x0+3HlfTBEmItIUFjakHY4Se+UoSRdWsp3cftPSgLvvlvoyL24EoS6JmCnCRESaw5uHSVusE3sB6fvOnYGrV6XX1mnD1qzThY8eBT79FPjjH6Vt5baz3q/xqShjX8ak48RE6U+mCBMRaRILG9Ie68ReJR9hYM08XTg6Wjr74up+zfuyTjpmQUNEpEm8FEVEREQ+g4UNERER+QxeiiLtMU8NBmy/DwkBDh8GSkulNOHgYGUpwPb6LS21TRw2b+uoX3t9Rkcr74OIiLyGhQ1pi3lqsPHpI1G0/F6OsxRgR/2a95mWJhU4xraO+rXXp58fMGUK8M47zvsgIiKv4qUo0g7r1GBRrCs6zL+X4ygF2Fm/5nJygAcfrGtrr19HfdbWSv0464OIiLyOhQ1ph9LUYHvspQDXR7+u9smEYiKiBsHChrRDaWqwPfZSgOujX1f7ZEIxEVGDYGFD2mGdGuznV3fvivn3chylADvq17rPtDRg7dq6tvb6ddSnTif146wPIiLyOt48TNpinRoM2H4fHAwcOQKcOyelCYeEOE8BdtRvaalt4rB5W3v9OuozOhp46SUmFBMRNTAWNqQ95qnBxtfW33uaRmzeV3S0bX/Wbd0dKwsaIqIGxUtRRERE5DM0Xdi8+OKLEATB4uvWW29Ve1hERESkUZq/FNW1a1d89tlnptf+/pofMnnKmNgbEgJcvmyb3FtUZJkUbHx9yy2WKcTW7ZwlAbuaFGyvvfVyJhATETUYzVcJ/v7+iIiIUHsY1FDM03yNzJN709Ol8DujTp2AU6cs+/DzA/r0AQ4cqFuWlAQcOmQ/Cdh8v0qSgu21t17OBGIiogal+cKmuLgYUVFRaNq0KRITE7F48WK0b9/ebvuqqipUVVWZXldUVAAADAYDDAaDx+Mx9uGNvnyV23Ok18M/IwOCdfBdbS3EzExUt2kD/5wcmD+gLZ46BZuHwGtrIR44YNnO/LWxv9RU0xkVi/1ar3c2TmP7226zXW4+Xqt++V5ShvPkHOdIGc6TMlqZJ3f3L4iio5x6de3YsQOXL19Gly5dUFpaigULFuDMmTP417/+hebNm8tu8+KLL2LBggU2y/Py8hAUFFTfQyYPhB0/juT58+2u/3HYMMR++qnX9rd/0SL82r273f0a1ysd5/EHHkD3t99WvF8iIrLvypUruO+++1BeXo7Q0FDF22m6sLF28eJFdOjQAUuXLsV0O6fz5c7YxMTEoKyszKWJscdgMCA/Px+DBw9GQECAx/35IrfnSK+Hf+fOtmdsAIg6Harffx/+f/qT5ZkYwPaMjcxym9c6HaqLi+vO2Fjt12K9gnGKOh2q9+2Df0qK5XIH++V7SRnOk3OcI2U4T8poZZ4qKioQFhbmcmGj+UtR5lq2bIlbbrkFJQ4+cycwMBCBgYE2ywMCArz6F+Tt/nyRy3MUGyvdg5KZKX22kpFOB2HVKgSMGSMl+prdYyPI3WOj00Ho3dviHhshKQn48kupX2N/sbHy+7Ve72ycxvZJSbbL778f2LDBYb98LynDeXKOc6QM50kZtefJ3X3fUIXN5cuXcerUKUyZMkXtoUhPuvz0k/pPunjyxI31tuZPEQF1TxpduSK9jo0FfvxR+j4oCPjhB9snjkJCIBQXI+qbb4C2bYEvvgBOnABSU4GrV6WU344dgaNHpX4mT7YMxzNP8w0OBiorLZN7s7OBmTMtk4KLiqTXnTtbphAblxvb6fX2k4CtU4SdzaW99nLLmUBMRNRgNF3YPPnkkxg5ciQ6dOiAs2fP4oUXXoBOp8OkSZNUHVf7/Hz4jx2r/pMurj7J42hb66eIXGH+xBGkN1UCAPFvf6tr88478tsuXy6dhcnOrlvmLLE3IcGyGLJ+bW+5s35dTQq2114ujZgFDRFRg9B0QJ9er8ekSZPQpUsXTJgwAW3atMGhQ4fQtm1bNQeFO9580+LJF2RmSmcDGngcFo9FuzIOuW3dLWoAaVuZ+2IcfGSlpZwc6ewKERGRhzR9xubdd99Vewg2hJISCNb3W9fUSJcaGvK38uJi22JC6TjktlVbYaF7n/9ERERkRtNnbLRI7NwZomB1LkKnq/t054YSFyddQnJnHHLbqi05We0REBGRD9DYT7cbQHQ0jj7yCP5/e/ceFNV5/gH8uyALCIisRJYVuQkRGxUTLxTSiBQUdMLESxo0koBRGiMaFY2XZhC0Rm1sbaYZGzUaMK1ak6mm0dpYQ8V4WdGojJMZamWjMamAqYkKyE15f3+c3y4s7LKHBTnr+v3M7MB5z/u++/DmJHnmXJ4jXF2lbVdXYOvWnr+HIihIuqfGnjgsjY2Lsz+WuLiWuVqRXUcgI4Nna4iIqFs49KUoR3Vt/HgMXbIEbt98o+yTLp19ksfW2NZPEQEtTxrV1UnboaHSk2AA4OkpjW37xJGXF+6Vl+P8+fN4csoUuB07Bly6BIwbB9TXA5WV0jwXL0rzzJjBpIaIiLoNExt7BQVJjz8rrStP3LQda+lpo7asJSGt5hIjRqCid288OXp0184EERERdRIvRREREZHTYGJDREREToOXohyRrWrC1vbbavf2BmpqpP0AcOBASyXgH34ANBrp5zPPAIGB0pjaWuDMGWk7NdV8XmOl4tbViePigICAlv2ffSaNHTWqpWpxXJzpHU2meCsqWqoe854bIiKyExMbR2OrmrC1/XLajVQqwJ53n86bB2zfLs2bmWn2zqbWc6u2bMGIv/wFvY4etTyPSgW8/LJUjbi5uX08bSsRExERycRLUY7EVjVha/vPnpXXbtSVF7pnZQEHD1pOav5/bte5cxF89Kj1ysNCSOONcbWNh5WIiYjITkxsHElH1YQ72n/ihPz2rhICOHSowy4qIeS/TsGakye7OgMRET2CmNg4ElvVhK3t/9nP5Ld3lUoFTJrUYRehUskvzmcNKxETEZEdmNg4ElvVhK3tHz1aXrtRV5Kd998Hnn1Wug/GEpUK97dswbWEBOvJjUoljTfG1fYVFaxETEREduLNw47GVjVha/vltHt5SU85Gc8AHTzYUgn41i2gb1/p59NPS08ylZdLT1F9+SWg1UoJjXHewkIgO7t9deLYWIiAAJQGBEC3di3c/vlPaezIkS1Vi2NjpXnWrm2Jt6KipeoxkxoiIrITExtHZKuasLX9nW2fO9d2HICU0FjStlKxUVNTy/7WlYfb9m0dV1AQExoiIuoyXooiIiIip8HEhoiIiJwGL0UpwVZl4a6OlzN/2z7ffQecOiXtM1YG7mhcbS3wn/+0VApuVd1Ydfo0Bp84IT0a3tjYMidgXml461bgxx+l+2pu3bJc3ZiIiKgTmNj0NFuVhbs6Xs78bfu89BLw4YcthfJUKunpp47GtRYXB5w+bWrvBSAKgPjoI/N+xgrDbSsN79vX8nvr6sZERESdxEtRPclWZeGujpczv6U+O3eaJxpCSH06GtfaqVMW29sV6TN+h63Kx1lZ8teEiIioFSY2PclWZeGujpczv6U+ljQ32zeuOwghf02IiIhaYWLTk2xVFu7qeDnzW+pjiYuLfeO6g0olf02IiIhaYWLTk2xVFu7qeDnzW+qTkWGetKhUUp+OxrUWF2ex3eyCk0rVUmG4baXhtt5/nzcQExGRXXjzcE+zVVm4q+PlzG+pz9q1gF4v7TdWBu5oXE2N9NNYKfi770zVje+VlODyiROImD4dbsZifbGx0s/WlYa3bZOehoqNBe7caV/dmIiIqJOY2CjBVmXhro6XM3/bPkFBwC9+Yf93t2oXI0bgPwMHImLSJMDNrX0/409WGiYiom7GS1FERETkNJjYEBERkdPgpShnZ60K8dmzwPHjLZWDrW0DQGkpEBUFjB8v3VsTGSm1HToETJoEBAQABw5IlYM9PeGi16O/vz8wfDjw2WfS/TTh4cDXX0t9Ro0CrlyR7repr5f2/fBDy3cTERHZiYmNM7NWhTgzUyrKZzRoEGAwWN82evPN9m3vvdeuyRXATwFg3brOx5yRARQWdn4cEREReCnKeVmrQnzwoHlSA7RPYiwlNZ2kgoXKw3Ls3CmdLSIiIrIDExtnZa0K8aFDysTTGSdPKh0BERE9pJjYOCtrVYgnTVImns54+mmlIyAioocUExtnZa0K8bPPSvextDZoUMfbdhBoU3lYrowM3kBMRER2483DzsxaFeLCQiA7W7rkY6wcfPas5e3mZuDiRWDwYCApCaitleYqLZWeeEpJkZ6K+vvfpcrBHh64X1KCMxoNRs2ZA7fDh4HKSiA0FLh6VeozcqT0e3k50NAg7bt1q+W7iYiI7MTExtlZqxQ8erR5EmFr29K8zz5r3v//Nc+ciRuHDkl95s61PJ4JDBERPQC8FEVEREROg4kNEREROQ0mNkREROQ0mNgQERGR02BiQ0RERE7joUhsNm/ejNDQUHh4eCAmJgZnzpxROiQiIiJyQA6f2Ozduxc5OTnIy8vD+fPnER0djeTkZNy4cUPp0IiIiMjBOHxis2nTJmRlZWHWrFn4yU9+gi1btqB379744IMPlA6NiIiIHIxDF+hrbGzEuXPnsHLlSlObi4sLkpKSoNfrLY5paGhAQ0ODafvOnTsAgKamJjQ1NXU5JuMc3TGXs+IaycN1kofrZBvXSB6ukzyOsk72fr9KCGHXK316wvXr1zFgwACcOnUKsbGxpvZly5bh2LFjKCkpaTcmPz8fq1evbte+e/du9O7d+4HGS0RERN3j7t27ePHFF3H79m306dNH9jiHPmNjj5UrVyInJ8e0fefOHQwcOBATJkzo1MJY09TUhCNHjmD8+PFwc3Pr8nzOiGskD9dJHq6TbVwjebhO8jjKOhmvuHSWQyc2/v7+cHV1RVVVlVl7VVUVtFqtxTHu7u5wd3c3bRtPSNXV1XXLP6CmpibcvXsXdXV1uHfvXpfnc0ZcI3m4TvJwnWzjGsnDdZLHUdaprq4OQMv/x+Vy6MRGrVZj5MiRKCoqwuTJkwEAzc3NKCoqwvz582XNUV1dDQAYOHDgA4uTiIiIHozq6mr4+vrK7u/QiQ0A5OTkICMjA6NGjcKYMWPwzjvvoLa2FrNmzZI1XqfT4dtvv4WPjw9UKlWX4zFe2vr222+75dKWM+IaycN1kofrZBvXSB6ukzyOsk5CCFRXV0On03VqnMMnNmlpafj++++xatUqVFZWYsSIEfjss88QEBAga7yLiwuCgoK6Pa4+ffrwXwwbuEbycJ3k4TrZxjWSh+skjyOsU2fO1Bg5fGIDAPPnz5d96YmIiIgeXQ5foI+IiIhILtf8/Px8pYN42Li6umLcuHHo1euhOOGlCK6RPFwnebhOtnGN5OE6yfMwr5NDF+gjIiIi6gxeiiIiIiKnwcSGiIiInAYTGyIiInIaTGyIiIjIaTCx6YLQ0FCoVCqzz4YNG5QOS3GbN29GaGgoPDw8EBMTgzNnzigdkkPJz89vd9xERUUpHZaivvjiC6SmpkKn00GlUuGTTz4x2y+EwKpVqxAYGAhPT08kJSXh8uXLCkWrHFvrlJmZ2e7YSklJUShaZaxfvx6jR4+Gj48P+vfvj8mTJ+PSpUtmferr65GdnY1+/frB29sb06ZNa/dOQmcnZ53GjRvX7niaO3euQhHLx8Smi9asWYOKigrTZ8GCBUqHpKi9e/ciJycHeXl5OH/+PKKjo5GcnIwbN24oHZpDeeKJJ8yOmxMnTigdkqJqa2sRHR2NzZs3W9z/9ttv4w9/+AO2bNmCkpISeHl5ITk5GfX19T0cqbJsrRMApKSkmB1be/bs6cEIlXfs2DFkZ2fj9OnTOHLkCJqamjBhwgTU1taa+ixevBgHDhzAxx9/jGPHjuH69euYOnWqglH3PDnrBABZWVlmx9Pbb7+tUMSdIMhuISEh4ve//73SYTiUMWPGiOzsbNP2/fv3hU6nE+vXr1cwKseSl5cnoqOjlQ7DYQEQ+/fvN203NzcLrVYrNm7caGq7deuWcHd3F3v27FEiRIfQdp2EECIjI0M899xzCkXkmG7cuCEAiGPHjgkhpGPHzc1NfPzxx6Y+ZWVlAoDQ6/VKham4tuskhBDx8fFi4cKFCkZlH56x6aINGzagX79+ePLJJ7Fx40ZFX/GutMbGRpw7dw5JSUmmNhcXFyQlJUGv1ysYmeO5fPkydDodwsPDMXPmTFy7dk3pkBzWlStXUFlZaXZc+fr6IiYmhseVBcXFxejfvz8GDx6M1157DTdv3lQ6JEXdvn0bAKDRaAAA586dQ1NTk9nxFBUVheDg4Ef6eGq7Tka7du2Cv78/hg4dipUrV+Lu3btKhNcpD19JQQfy+uuv46mnnoJGo8GpU6ewcuVKVFRUYNOmTUqHpoj//e9/uH//frsXlAYEBODf//63QlE5npiYGBQWFmLw4MGoqKjA6tWr8cwzz+Crr76Cj4+P0uE5nMrKSgCweFwZ95EkJSUFU6dORVhYGAwGA371q19h4sSJ0Ov1cHV1VTq8Htfc3IxFixbh6aefxtChQwFIx5NarUbfvn3N+j7Kx5OldQKAF198ESEhIdDpdLh48SKWL1+OS5cuYd++fQpGaxsTmzZWrFiB3/zmNx32KSsrQ1RUFHJyckxtw4cPh1qtxquvvor169fD3d39QYdKD6mJEyeafh8+fDhiYmIQEhKCjz76CLNnz1YwMnrYTZ8+3fT7sGHDMHz4cAwaNAjFxcVITExUMDJlZGdn46uvvnrk72Gzxdo6/fKXvzT9PmzYMAQGBiIxMREGgwGDBg3q6TBlY2LTxpIlS5CZmdlhn/DwcIvtMTExuHfvHq5evYrBgwc/gOgcm7+/P1xdXds9XVBVVQWtVqtQVI6vb9++ePzxx1FeXq50KA7JeOxUVVUhMDDQ1F5VVYURI0YoFdZDITw8HP7+/igvL3/kEpv58+fj4MGD+OKLLxAUFGRq12q1aGxsxK1bt8zO2jyq/52ytk6WxMTEAADKy8sdOrHhPTZtPPbYY4iKiurwo1arLY4tLS2Fi4sL+vfv38NROwa1Wo2RI0eiqKjI1Nbc3IyioiLExsYqGJljq6mpgcFgMPufNrUICwuDVqs1O67u3LmDkpISHlc2fPfdd7h58+YjdWwJITB//nzs378f//rXvxAWFma2f+TIkXBzczM7ni5duoRr1649UseTrXWypLS0FAAc/njiGRs76fV6lJSUICEhAT4+PtDr9Vi8eDHS09Ph5+endHiKycnJQUZGBkaNGoUxY8bgnXfeQW1tLWbNmqV0aA5j6dKlSE1NRUhICK5fv468vDy4urpixowZSoemmJqaGrMzVleuXEFpaSk0Gg2Cg4OxaNEirF27FpGRkQgLC0Nubi50Oh0mT56sYNQ9r6N10mg0WL16NaZNmwatVguDwYBly5YhIiICycnJCkbds7Kzs7F792787W9/g4+Pj+m+GV9fX3h6esLX1xezZ89GTk4ONBoN+vTpgwULFiA2NhY//elPFY6+59haJ4PBgN27d2PSpEno168fLl68iMWLF2Ps2LEYPny4wtHboPRjWQ+rc+fOiZiYGOHr6ys8PDzEkCFDxLp160R9fb3SoSnu3XffFcHBwUKtVosxY8aI06dPKx2SQ0lLSxOBgYFCrVaLAQMGiLS0NFFeXq50WIo6evSoANDuk5GRIYSQHvnOzc0VAQEBwt3dXSQmJopLly4pG7QCOlqnu3fvigkTJojHHntMuLm5iZCQEJGVlSUqKyuVDrtHWVofAKKgoMDUp66uTsybN0/4+fmJ3r17iylTpoiKigrlglaArXW6du2aGDt2rNBoNMLd3V1ERESIN954Q9y+fVvZwGVQCSFETyZSRERERA8K77EhIiIip8HEhoiIiJwGExsiIiJyGkxsiIiIyGkwsSEiIiKnwcSGiIiInAYTGyIiInIaTGyIqMsKCwvbvS2ZiEgJTGyIyKbMzEyoVCqoVCqo1WpERERgzZo1uHfvntKhyRIaGmqKv/Vnw4YNAKR33xh/N1qxYgVUKhWKi4vN2seNG4eXXnrJrK2urg4ajQb+/v5oaGh4oH8LEXWMiQ0RyZKSkoKKigpcvnwZS5YsQX5+PjZu3Kh0WGaampqs7luzZg0qKirMPgsWLAAgJSttE5ijR49i4MCBZu319fU4ffo0fv7zn5v1/etf/4onnngCUVFR+OSTT7rt7yGizmNiQ0SyuLu7Q6vVIiQkBK+99hqSkpLw6aefWuxrMBjw3HPPISAgAN7e3hg9ejQ+//xz0/41a9Zg6NCh7caNGDECubm5pu3t27djyJAh8PDwQFRUFP74xz+a9l29ehUqlQp79+5FfHw8PDw8sGvXLqvx+/j4QKvVmn28vLwAAAkJCTh58qTpDFR1dTUuXLiA5cuXmyU2er0eDQ0NSEhIMJt7x44dSE9PR3p6Onbs2NHBKhLRg8bEhojs4unpicbGRov7ampqMGnSJBQVFeHChQtISUlBamoqrl27BgB45ZVXUFZWhrNnz5rGXLhwARcvXjS9CX7Xrl1YtWoV3nrrLZSVlWHdunXIzc3Fzp07zb5rxYoVWLhwIcrKyux+i3VCQgJqampM8Rw/fhyPP/44pk2bhpKSEtTX1wOQzuKEhoYiNDTUNNZgMECv1+OFF17ACy+8gOPHj+Obb76xKw4i6jomNkTUKUIIfP755zh8+HC7SzJG0dHRePXVVzF06FBERkbi17/+NQYNGmQ6wxMUFITk5GQUFBSYxhQUFCA+Ph7h4eEAgLy8PPzud7/D1KlTERYWY1unNQAAA+RJREFUhqlTp2Lx4sXYunWr2XctWrTI1CcwMNBq3MuXL4e3t7fZ5/jx4wCAyMhIDBgwwHR2pri4GPHx8dBqtQgODoZerze1tz1b88EHH2DixInw8/ODRqNp93cRUc9iYkNEshw8eBDe3t7w8PDAxIkTkZaWhvz8fIt9a2pqsHTpUgwZMgR9+/aFt7c3ysrKTGdsACArKwt79uxBfX09GhsbsXv3brzyyisAgNraWhgMBsyePdssEVm7di0MBoPZd40aNUpW/G+88QZKS0vNPq3Htr7Ppri4GOPGjQMAxMfHo7i4GHV1dSgpKTFLbO7fv4+dO3ciPT3d1Jaeno7CwkI0NzfLiouIulcvpQMgoodDQkIC3nvvPajVauh0OvTqZf0/H0uXLsWRI0fw29/+FhEREfD09MTzzz9vdukqNTUV7u7u2L9/P9RqNZqamvD8888DkBIjAHj//fcRExNjNrerq6vZtvE+GVv8/f0RERHR4d+3cOFC3Lx5ExcuXEB8fDwAKbHZunUrxo4di8bGRrOzVIcPH8Z///tfpKWlmc11//59FBUVYfz48bJiI6Luw8SGiGTx8vLqMDFo7eTJk8jMzMSUKVMASInK1atXzfr06tULGRkZKCgogFqtxvTp0+Hp6QkACAgIgE6nw9dff42ZM2d2699hTUJCAmpra7Fp0yZERkaif//+AICxY8di9uzZ+Mc//mG6ZGW0Y8cOTJ8+HW+++abZXG+99RZ27NjBxIZIAUxsiKjbRUZGYt++fUhNTYVKpUJubq7FSzNz5szBkCFDAEjJUGurV6/G66+/Dl9fX6SkpKChoQFffvklfvzxR+Tk5HQ6purqalRWVpq19e7dG3369AEAhIeHIzg4GO+++65ZMjVw4EDodDps27YNM2bMMLV///33OHDgAD799NN2T3i9/PLLmDJlCn744QdoNJpOx0pE9uM9NkTU7TZt2gQ/Pz/ExcUhNTUVycnJeOqpp9r1i4yMRFxcHKKiotpdcpozZw62b9+OgoICDBs2DPHx8SgsLERYWJhdMa1atQqBgYFmn2XLlpn1SUhIQHV1ten+GqP4+HhUV1eb3V/z4YcfwsvLC4mJie2+KzExEZ6envjzn/9sV6xEZD+VEEIoHQQRPZqEEIiMjMS8efPsOgtDRNQWL0URkSJu3LiBP/3pT6isrDTVriEi6iomNkSkiICAAPj7+2Pbtm3w8/NTOhwichJMbIhIEbwKTkQPAm8eJiIiIqfBxIaIiIicBhMbIiIichpMbIiIiMhpMLEhIiIip8HEhoiIiJwGExsiIiJyGkxsiIiIyGkwsSEiIiKn8X+VbZtroYw8MgAAAABJRU5ErkJggg==",
      "text/plain": [
       "PyPlot.Figure(PyObject <matplotlib.figure.Figure object at 0x000000003D66CA58>)"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plot(data[:,\"EWA\"], data[:,\"Salary\"], \"r.\")\n",
    "xlabel(\"Player EWA\")\n",
    "ylabel(\"Salary\");\n",
    "title(\"Newly-Valued Salary vs EWA\")\n",
    "grid()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "As is shown above, the adjusted salaries are considerably more correlated with player EWA. This new salary assignment will allow the Suns management to make better decisions when deciding how much to pay a particular player."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='2'></a>\n",
    "\n",
    "## Section 2: Five Season Free Agency Plan"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The second model is an assignment problem. In this model, we seek to determine the roster which will produce the greatest team-total EWA over five seasons. \n",
    "\n",
    "*Assumptions:*\n",
    "\n",
    "* The only way a player can join our team is through free agency\n",
    "* All free agent contracts last exactly three years\n",
    "* Players will play at a single position for a particular season during their tenure with the Suns\n",
    "* A player’s performance statistics (EWA, TS, REBR, etc.) and salary are static over the time horizon\n",
    "* If we sign a player, he will play on our team (i.e. if he is included on our roster he will join our team)\n",
    "\n",
    "*Decision variables:*\n",
    "* X: a set of 5 matrices, each 343 rows by 5 columns, of all binary values. The value in $x_k$ at row $i$ and column $j$ will equal one if player $i$ is signed to the Suns and plays in position $j$ in year $k$. If player $i$ is not signed to the suns, the sum of row $i$ will be zero. One matrix exists for each of the five seasons under consideration.\n",
    "\n",
    " $x_{ijk}  \\in \\{0,1\\}$\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "*Constraints:*\n",
    "* Players can only play one position on a team for a given season.\n",
    "    \n",
    "  $\\sum_{j\\: \\in \\: positions} x_{ijk} \\leq 1\\hspace{10pt}\\forall \\: k \\in \\: seasons , \\: \\forall \\: i \\in \\: players$\n",
    "\n",
    "\n",
    "* Position: each team can have only two players signed to play a position (point guard, shooting guard, center, small forward, and power forward).\n",
    "\n",
    "  $\\sum_{i\\: \\in \\:players} x_{ijk} = 2 \\hspace{10pt} \\forall k \\: \\in \\: seasons, \\forall \\: j \\in \\: positions$\n",
    "  \n",
    "\n",
    "* Salary cap: The suns cannot spend over the league salary cap on player salaries in any season. We use \\$95 million as the salary cap each season.\n",
    "\n",
    " $\\sum_{j\\: \\in \\:positions} x^{T} Salary \\leq SalaryCap \\hspace{10pt}  \\forall \\: k \\: \\in \\: seasons$\n",
    "  \n",
    "\n",
    "* Current Suns players must stay on the team until they are eligible for free agency.\n",
    "\n",
    "  $\\sum_{j\\: \\in \\:positions} x_{ijk} \\geq Suns_{i} \\hspace{10pt} \\forall \\: i \\: \\in  \\: players, \\: k = Year \\: 1$  \n",
    "\n",
    "\n",
    "* The only players on the team in year 1 are free agents or current Suns players.\n",
    "  \n",
    "  $\\sum_{j\\: \\in \\:positions} x_{ijk} \\leq Suns_{i}+YearAvail_{ik} \\hspace{10pt} \\forall \\: i \\: \\in  \\: players, \\: k = Year \\:$ 1  \n",
    "  \n",
    "  \n",
    "* The only players on the team are newly added free agents or players from a previous season.\n",
    "\n",
    "  $\\sum_{j\\: \\in \\:positions} x_{ijk} \\leq YearAvail_{ik}+\\sum_{j\\: \\in \\:positions} x_{ijk+1} \\hspace{10pt} \\forall\\: i\\: \\in\\: players,\\: k\\: \\in\\: \\{Year \\: 1,\\:Year\\: 2,\\:Year\\:3,\\:Year\\:4\\}$  \n",
    "  \n",
    "  \n",
    "* Contract length: if a player is signed, he must remain on the team for at least 3 consecutive years.\n",
    "  \n",
    "  $\\sum_{j\\: \\in \\:positions} x_{ijk} \\geq - YearAvail_{ik}+\\sum_{j\\: \\in \\:positions} x_{ijk+1} \\hspace{10pt}\\: \\forall \\:i\\: \\in\\: players,\\: k \\:\\in\\: \\{Year\\:1,\\:Year\\:2,\\:Year\\:3,\\:Year\\:4\\}$  \n",
    "  \n",
    "  \n",
    "* Play within positions: players can only play within the positions they are qualified to do so.\n",
    "\n",
    "  $x_{ijk} \\leq PlayerPos_{ij} \\hspace{10pt} \\forall k \\in seasons, \\: \\forall \\: j \\: \\in \\: positions, \\forall i \\in players$\n",
    "  \n",
    "  \n",
    "  \n",
    "\n",
    "*Objective:*\n",
    "\n",
    "* The objective maximizes the sum of the selected player statistic(s) over the course of the five season time horizon. This objective function is flexible and allows the decision maker to decide which player statistics for which they would like to optimize the team. The decision maker can decide the statistics they would like to maximize by varying $\\lambda_i$ where i is the set of player statistics EWA, TS, AST, TO, REBR, and POP. A larger value of $\\lambda_i$ will weight statistic $i$ as more important in the maximization function. The signs of each $\\lambda_i$ represent if the statistic is helpful or detrimental for team success. We decided popularity should be negative because optimizing a team for popular players carries the risk of not being able to sign them because these players will likely have many team offers. If team management would like a higher team popularity, set $\\lambda_{POP} < 0$\n",
    "\n",
    " $\\underset{x}{\\text{maximize}}\\hspace{5pt} \\\\ {\\large\\lambda}_{EWA}\\sum_{k\\:\\in \\:seasons} x^{T}EWA\\:+\\:{\\large\\lambda}_{TS}\\sum_{k\\:\\in \\:seasons}x^{T}TS\\:+\\:{\\large\\lambda}_{AST}\\sum_{k\\:\\in \\:seasons}x^{T}AST \\\\ \\\\\n",
    " \\:- \\:{\\large\\lambda}_{TO}\\sum_{k\\:\\in \\:seasons}x^{T}TO\\: +\\:{\\large\\lambda}_{REBR}\\sum_{k\\:\\in \\:seasons}x^{T}REBR\\:-\\:{\\large\\lambda}_{POP}\\sum_{k\\:\\in \\:seasons}x^{T}POP$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "\n",
    "The matrices/vectors involved in this program are:\n",
    "\n",
    "Each of the following vectors contains the listed data values below for each player. \n",
    "* EWA  =  Expected Wins Added to a team’s season\n",
    "* TS = Shooting percentage weighted with point values for free throws and 3-pointers\n",
    "* TO = Percentage of possessions that end in a turnover\n",
    "* AST = Percentage of possessions that end in an assist.\n",
    "* REBR = Number of rebounds per 100 possessions.\n",
    "* POP = Binary value; is one if player is in the top 50 selling jerseys, zero otherwise.\n",
    "* Suns = Binary value; is 1 if player is a Suns player in the first year, zero otherwise\n",
    "* Salary = adjusted salary set in Section 1\n",
    "\n",
    "\n",
    "The model also uses the following matrices:\n",
    "* PlayerPos = Matrix indexed by player name and position. PlayerPos[\"Player name\",\"Position type\"] is one if player is able to play that position and zero if not.\n",
    "* YearAvail = Matrix indexed by player name and year. YearAvail[\"Player name\",\"Year\"] is one if player is available to sign that year and zero if not."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "\n",
    "\n",
    "The program in standard form is represented by the following:\n",
    "\n",
    "\\begin{equation*}\n",
    "\\begin{aligned}\n",
    "& \\underset{x}{\\text{maximize}}\n",
    "& & {\\large\\lambda}_{EWA}\\sum_{k\\:\\in \\:seasons} x^{T}EWA\\:+\\:{\\large\\lambda}_{TS}\\sum_{k\\:\\in \\:seasons}x^{T}TS\\:+\\:{\\large\\lambda}_{AST}\\sum_{k\\:\\in \\:seasons}x^{T}AST\\:- \\:{\\large\\lambda}_{TO}\\sum_{k\\:\\in \\:seasons}x^{T}TO\\: \\\\ \\\\\n",
    "& & & +\\:{\\large\\lambda}_{REBR}\\sum_{k\\:\\in \\:seasons}x^{T}REBR\\:-\\:{\\large\\lambda}_{POP}\\sum_{k\\:\\in \\:seasons}x^{T}POP\\\\\n",
    "\\\\\n",
    "\\\\\n",
    "& \\text{subject to}\n",
    "\\end{aligned}\n",
    "\\end{equation*}\n",
    "\\begin{alignat}{2}\n",
    "  &\\sum_{j\\: \\in \\: positions} x_{ijk} \\leq 1\n",
    "  &&\\forall \\: k \\in \\: seasons , \\: \\forall \\: i \\in \\: players \\\\ \\\\\n",
    "  &\\sum_{i\\: \\in \\:players} x_{ijk} = 2 \\hspace{5pt} \n",
    "  &&\\forall k \\: \\in \\: seasons, \\forall \\: j \\in \\: positions  \\\\ \\\\\n",
    "  &\\sum_{j\\: \\in \\:positions} x^{T} Salary \\leq SalaryCap \\hspace{5pt}  \n",
    "  &&\\forall \\: k \\: \\in \\: seasons\\\\ \\\\\n",
    "  &\\sum_{j\\: \\in \\:positions} x_{ijk} \\geq Suns_{i} \\hspace{5pt} \n",
    "  &&\\forall \\: i \\: \\in  \\: players, \\: k = Year \\: 1\\\\ \\\\\n",
    "  &\\sum_{j\\: \\in \\:positions} x_{ijk} \\leq Suns_{i}+YearAvail_{ik} \\hspace{5pt} \n",
    "  &&\\forall \\: i \\: \\in  \\: players, \\: k = Year \\: 1\\\\ \\\\\n",
    "  &\\sum_{j\\: \\in \\:positions} x_{ijk} \\leq YearAvail_{ik}+\\sum_{j\\: \\in \\:positions} x_{ijk+1} \\hspace{5pt} \n",
    "  &&\\forall\\: i\\: \\in\\: players,\\: k\\: \\in\\: \\{Year \\: 1,\\:Year\\: 2,\\:Year\\:3,\\:Year\\:4\\}\\\\ \\\\\n",
    "  &\\sum_{j\\: \\in \\:positions} x_{ijk} \\geq - YearAvail_{ik}+\\sum_{j\\: \\in \\:positions} x_{ijk+1} \\hspace{5pt}\\: \n",
    "  &&\\forall \\:i\\: \\in\\: players,\\: k \\:\\in\\: \\{Year\\:1,\\:Year\\:2,\\:Year\\:3,\\:Year\\:4\\}\\\\ \\\\\n",
    "  &x_{ijk} \\leq PlayerPos_{ij} \\hspace{5pt}   \n",
    "  &&\\forall k \\in seasons, \\: \\forall \\: j \\: \\in \\: positions, \\forall i \\in players \\\\ \\\\\n",
    "  &x_{ijk}  \\in \\{0,1\\}\n",
    "\\end{alignat}"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [],
   "source": [
    "#EWA_param = tradeoff paramter for EWA\n",
    "#TS_param = tradeoff paramter for True Shooting Percentage\n",
    "#AST_param = tradeoff paramter for Assist Ratio\n",
    "#TO_param = tradeoff paramter for Turnover Ratio\n",
    "#REBR_param = tradeoff paramter for Rebound Rate\n",
    "#POP_param = tradeoff paramter for Popularity\n",
    "\n",
    "function fiveSeasons(EWA_param, TS_param, AST_param, TO_param, REBR_param, POP_param)\n",
    "\n",
    "    cap = 95\n",
    "\n",
    "    m = Model(solver=CbcSolver())\n",
    "    \n",
    "    #Player i, playing position j, during season k\n",
    "    @variable(m, x[playernames, positions, seasons], Bin)\n",
    "\n",
    "    # Each player can be signed once\n",
    "    @constraint(m, a[i in playernames, k in seasons], sum(x[i,j,k] for j in positions) <= 1 )\n",
    "\n",
    "    # each position has exactly two players\n",
    "    @constraint(m, b[j in positions, k in seasons], sum(x[i,j,k] for i in playernames) == 2 )\n",
    "\n",
    "    # Players can only play their positions\n",
    "    @constraint(m, c[j in positions, i in playernames, k in seasons], x[i,j,k] <= data[i,j])\n",
    "\n",
    "    # Team must stay under salary cap\n",
    "    @constraint(m, d[k in seasons], sum(data[i, \"Salary\"]*x[i,j,k] for j in positions, i in \n",
    "                playernames) <= cap)\n",
    "\n",
    "    # Current Sun players must stay on team\n",
    "    # Anywhere Sun is equal to 1 must be on team\n",
    "    @constraint(m, e[i in playernames], sum(x[i,j,\"Year 1\"] for j in positions) \n",
    "        >= data[i, \"SUNS\"])\n",
    "\n",
    "    # Only add players available in year one\n",
    "    @constraint(m, f[i in playernames, \"Year 1\"], sum(x[i,j,\"Year 1\"] for j in positions) \n",
    "        <= data[i,\"Year 1\"] + data[i, \"SUNS\"])\n",
    "\n",
    "    # Appropriate players for other years\n",
    "    @constraint(m, g[i in playernames, k in 1:4], sum(x[i,j,seasons[k]] for j in positions) \n",
    "        <= data[i,seasons[k]] + sum(x[i,j,seasons[k+1]] for j in positions))\n",
    "\n",
    "    # Contract length constraint, players must play for three consecutive years\n",
    "    @constraint(m, h[i in playernames, k in 1:4], sum(x[i,j, seasons[k]] for j in positions) \n",
    "        >= sum(x[i,j,seasons[k+1]] for j in positions) - data[i, seasons[k]])\n",
    "\n",
    "    \n",
    "    # Expressions for each statistic\n",
    "    @expression(m, EWA[k in seasons], sum( x[i,j,k]*data[i, \"EWA\"] for i in playernames, \n",
    "                j in positions))\n",
    "    @expression(m, TS[k in seasons], sum( x[i,j,k]*data[i, \"TS%\"] for i in playernames, \n",
    "                j in positions))\n",
    "    @expression(m, AST[k in seasons], sum( x[i,j,k]*data[i, \"AST\"] for i in playernames, \n",
    "                j in positions))\n",
    "    @expression(m, TO[k in seasons], sum( x[i,j,k]*data[i, \"TO\"] for i in playernames, \n",
    "                j in positions))\n",
    "    @expression(m, REBR[k in seasons], sum( x[i,j,k]*data[i, \"REBR\"] for i in playernames, \n",
    "                j in positions))\n",
    "    @expression(m, POP[k in seasons], sum( x[i,j,k] * data[i, \"POP\"] for i in playernames, \n",
    "                j in positions))\n",
    "\n",
    "\n",
    "    # Objective\n",
    "    @objective(m, Max, EWA_param*sum(EWA) + TS_param*sum(TS) - TO_param*sum(TO) \n",
    "        + AST_param*sum(AST) + REBR_param*sum(REBR) - POP_param*sum(POP))\n",
    "\n",
    "    # Display data\n",
    "    solve(m)\n",
    "\n",
    "    \n",
    "    return getvalue(x)    \n",
    "    \n",
    "end;"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [],
   "source": [
    "#Converts a binary variable to a string either yes if == 1, no if == 0\n",
    "function parseBinaryYesNo(bin)\n",
    "   \n",
    "    if round(bin) == 1\n",
    "        return \"Yes\"\n",
    "    else\n",
    "        return \"No\"\n",
    "    end\n",
    "    \n",
    "end;"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [],
   "source": [
    "#Prints the results from season k\n",
    "#EWA_param = tradeoff paramter for EWA\n",
    "#TS_param = tradeoff paramter for True Shooting Percentage\n",
    "#AST_param = tradeoff paramter for Assist Ratio\n",
    "#TO_param = tradeoff paramter for Turnover Ratio\n",
    "#REBR_param = tradeoff paramter for Rebound Rate\n",
    "#POP_param = tradeoff paramter for Popularity\n",
    "\n",
    "function printFiveSeasons(k, EWA_param, TS_param, AST_param, TO_param, REBR_param, POP_param)\n",
    "    \n",
    "    x = fiveSeasons(EWA_param, TS_param, AST_param, TO_param, REBR_param, POP_param)\n",
    "\n",
    "    #Clearing Data Frame\n",
    "    roster = 0\n",
    "    \n",
    "    #Creating Data Frame\n",
    "    roster =  DataFrame(Position = [], Player = [], EWA = [], TrueShootingPercent = [], \n",
    "        TurnoverRatio = [], AssistRatio =[], ReboundRate =[], Popular =[], Salary =[]) \n",
    "    \n",
    "\n",
    "    for j in positions \n",
    "        for i in playernames\n",
    "            if round(sum(x[i,j,k])) == 1\n",
    "                push!(roster, [j, i, data[i,\"EWA\"], data[i,\"TS%\"], data[i, \"TO\"], \n",
    "                        data[i,\"AST\"], data[i, \"REBR\"],\n",
    "                    parseBinaryYesNo(data[i,\"POP\"]), data[i, \"Salary\"]])\n",
    "            end\n",
    "        end\n",
    "    end\n",
    "    \n",
    "    push!(roster, [\"N/A\", \"TOTAL\", round(sum( x[i,j,k]*data[i, \"EWA\"] for i in playernames, \n",
    "                        j in positions),1), \n",
    "                round(sum( x[i,j,k]*data[i, \"TS%\"] for i in playernames, j in positions)/10,3),\n",
    "                round(sum( x[i,j,k]*data[i, \"TO\"] for i in playernames, j in positions)/10,1),\n",
    "                round(sum( x[i,j,k]*data[i, \"AST\"] for i in playernames, j in positions)/10,1),\n",
    "                round(sum( x[i,j,k]*data[i, \"REBR\"] for i in playernames, \n",
    "                        j in positions)/10,1),\n",
    "                sum( x[i,j,k] * data[i, \"POP\"] for i in playernames, j in positions),\n",
    "                round(sum(data[i, \"Salary\"]*x[i,j,k] for j in positions, i in playernames),1)\n",
    "            ])\n",
    "    \n",
    "    return roster\n",
    "end;"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='2a'></a>\n",
    "\n",
    "### Section 2a: Free Agency Plan Results"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The following tables list the optimal roster for years 1 through 5 given the values of the optimization parameters.\n",
    "\n",
    "Currently the parameters are set to only maximize EWA, however the team management should feel free to change the paramaters within the following code block to experiment with different combinations statistics to optimize."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [],
   "source": [
    "EWA_param = 1;\n",
    "TS_param = 0;\n",
    "AST_param = 0;\n",
    "TO_param = 0;\n",
    "REBR_param = 0;\n",
    "POP_param = 0;"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Season 1\n"
     ]
    },
    {
     "data": {
      "text/html": [
       "<table class=\"data-frame\"><thead><tr><th></th><th>Position</th><th>Player</th><th>EWA</th><th>TrueShootingPercent</th><th>TurnoverRatio</th><th>AssistRatio</th><th>ReboundRate</th><th>Popular</th><th>Salary</th></tr></thead><tbody><tr><th>1</th><td>PG</td><td>Quinn Cook</td><td>0.6</td><td>0.564</td><td>14.1</td><td>30.5</td><td>6.1</td><td>No</td><td>1.4</td></tr><tr><th>2</th><td>PG</td><td>Yogi Ferrell</td><td>0.3</td><td>0.538</td><td>11.3</td><td>14.3</td><td>6.9</td><td>No</td><td>1.4</td></tr><tr><th>3</th><td>SG</td><td>Devin Booker</td><td>7.1</td><td>0.616</td><td>11.4</td><td>23.1</td><td>8.5</td><td>Yes</td><td>20</td></tr><tr><th>4</th><td>SG</td><td>JJ Redick</td><td>4.6</td><td>0.582</td><td>14.9</td><td>20.8</td><td>15.7</td><td>No</td><td>5</td></tr><tr><th>5</th><td>SF</td><td>TJ Warren</td><td>7.7</td><td>0.619</td><td>11.8</td><td>25.8</td><td>13.1</td><td>No</td><td>19</td></tr><tr><th>6</th><td>SF</td><td>Josh Jackson</td><td>1.2</td><td>0.603</td><td>9.7</td><td>15.8</td><td>16</td><td>No</td><td>14</td></tr><tr><th>7</th><td>PF</td><td>Jeff Green</td><td>3.1</td><td>0.544</td><td>7.4</td><td>9.6</td><td>5.9</td><td>No</td><td>5</td></tr><tr><th>8</th><td>PF</td><td>Tarik Black</td><td>0.8</td><td>0.614</td><td>14.8</td><td>15.5</td><td>12.5</td><td>No</td><td>1.4</td></tr><tr><th>9</th><td>C</td><td>Alex Len</td><td>5.6</td><td>0.588</td><td>9.5</td><td>10.6</td><td>9.2</td><td>No</td><td>19</td></tr><tr><th>10</th><td>C</td><td>Tyson Chandler</td><td>2.1</td><td>0.613</td><td>7.9</td><td>8.5</td><td>16.5</td><td>No</td><td>8</td></tr><tr><th>11</th><td>N/A</td><td>TOTAL</td><td>33.1</td><td>0.588</td><td>11.3</td><td>17.4</td><td>11.0</td><td>1.0</td><td>94.2</td></tr></tbody></table>"
      ],
      "text/plain": [
       "11×9 DataFrames.DataFrame\n",
       "│ Row │ Position │ Player           │ EWA  │ TrueShootingPercent │\n",
       "├─────┼──────────┼──────────────────┼──────┼─────────────────────┤\n",
       "│ 1   │ \"PG\"     │ \"Quinn Cook\"     │ 0.6  │ 0.564               │\n",
       "│ 2   │ \"PG\"     │ \"Yogi Ferrell\"   │ 0.3  │ 0.538               │\n",
       "│ 3   │ \"SG\"     │ \"Devin Booker\"   │ 7.1  │ 0.616               │\n",
       "│ 4   │ \"SG\"     │ \"JJ Redick\"      │ 4.6  │ 0.582               │\n",
       "│ 5   │ \"SF\"     │ \"TJ Warren\"      │ 7.7  │ 0.619               │\n",
       "│ 6   │ \"SF\"     │ \"Josh Jackson\"   │ 1.2  │ 0.603               │\n",
       "│ 7   │ \"PF\"     │ \"Jeff Green\"     │ 3.1  │ 0.544               │\n",
       "│ 8   │ \"PF\"     │ \"Tarik Black\"    │ 0.8  │ 0.614               │\n",
       "│ 9   │ \"C\"      │ \"Alex Len\"       │ 5.6  │ 0.588               │\n",
       "│ 10  │ \"C\"      │ \"Tyson Chandler\" │ 2.1  │ 0.613               │\n",
       "│ 11  │ \"N/A\"    │ \"TOTAL\"          │ 33.1 │ 0.588               │\n",
       "\n",
       "│ Row │ TurnoverRatio │ AssistRatio │ ReboundRate │ Popular │ Salary │\n",
       "├─────┼───────────────┼─────────────┼─────────────┼─────────┼────────┤\n",
       "│ 1   │ 14.1          │ 30.5        │ 6.1         │ \"No\"    │ 1.4    │\n",
       "│ 2   │ 11.3          │ 14.3        │ 6.9         │ \"No\"    │ 1.4    │\n",
       "│ 3   │ 11.4          │ 23.1        │ 8.5         │ \"Yes\"   │ 20     │\n",
       "│ 4   │ 14.9          │ 20.8        │ 15.7        │ \"No\"    │ 5      │\n",
       "│ 5   │ 11.8          │ 25.8        │ 13.1        │ \"No\"    │ 19     │\n",
       "│ 6   │ 9.7           │ 15.8        │ 16          │ \"No\"    │ 14     │\n",
       "│ 7   │ 7.4           │ 9.6         │ 5.9         │ \"No\"    │ 5      │\n",
       "│ 8   │ 14.8          │ 15.5        │ 12.5        │ \"No\"    │ 1.4    │\n",
       "│ 9   │ 9.5           │ 10.6        │ 9.2         │ \"No\"    │ 19     │\n",
       "│ 10  │ 7.9           │ 8.5         │ 16.5        │ \"No\"    │ 8      │\n",
       "│ 11  │ 11.3          │ 17.4        │ 11.0        │ 1.0     │ 94.2   │"
      ]
     },
     "execution_count": 11,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "println(\"Season 1\")\n",
    "roster = printFiveSeasons(\"Year 1\",\n",
    "    EWA_param, TS_param, AST_param, TO_param, REBR_param, POP_param)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Season 2:\n"
     ]
    },
    {
     "data": {
      "text/html": [
       "<table class=\"data-frame\"><thead><tr><th></th><th>Position</th><th>Player</th><th>EWA</th><th>TrueShootingPercent</th><th>TurnoverRatio</th><th>AssistRatio</th><th>ReboundRate</th><th>Popular</th><th>Salary</th></tr></thead><tbody><tr><th>1</th><td>PG</td><td>Devin Booker</td><td>7.1</td><td>0.616</td><td>11.4</td><td>23.1</td><td>8.5</td><td>Yes</td><td>20</td></tr><tr><th>2</th><td>PG</td><td>Isaiah Thomas</td><td>0.7</td><td>0.591</td><td>8.7</td><td>22</td><td>6.3</td><td>No</td><td>2.4</td></tr><tr><th>3</th><td>SG</td><td>JJ Redick</td><td>4.6</td><td>0.582</td><td>14.9</td><td>20.8</td><td>15.7</td><td>No</td><td>5</td></tr><tr><th>4</th><td>SG</td><td>Quinn Cook</td><td>0.6</td><td>0.564</td><td>14.1</td><td>30.5</td><td>6.1</td><td>No</td><td>1.4</td></tr><tr><th>5</th><td>SF</td><td>TJ Warren</td><td>7.7</td><td>0.619</td><td>11.8</td><td>25.8</td><td>13.1</td><td>No</td><td>19</td></tr><tr><th>6</th><td>SF</td><td>Josh Jackson</td><td>1.2</td><td>0.603</td><td>9.7</td><td>15.8</td><td>16</td><td>No</td><td>14</td></tr><tr><th>7</th><td>PF</td><td>Jeff Green</td><td>3.1</td><td>0.544</td><td>7.4</td><td>9.6</td><td>5.9</td><td>No</td><td>5</td></tr><tr><th>8</th><td>PF</td><td>Tarik Black</td><td>0.8</td><td>0.614</td><td>14.8</td><td>15.5</td><td>12.5</td><td>No</td><td>1.4</td></tr><tr><th>9</th><td>C</td><td>David West</td><td>4.5</td><td>0.578</td><td>12.8</td><td>25.5</td><td>10.5</td><td>No</td><td>9</td></tr><tr><th>10</th><td>C</td><td>Tyson Chandler</td><td>2.1</td><td>0.613</td><td>7.9</td><td>8.5</td><td>16.5</td><td>No</td><td>8</td></tr><tr><th>11</th><td>N/A</td><td>TOTAL</td><td>32.4</td><td>0.592</td><td>11.4</td><td>19.7</td><td>11.1</td><td>1.0</td><td>85.2</td></tr></tbody></table>"
      ],
      "text/plain": [
       "11×9 DataFrames.DataFrame\n",
       "│ Row │ Position │ Player           │ EWA  │ TrueShootingPercent │\n",
       "├─────┼──────────┼──────────────────┼──────┼─────────────────────┤\n",
       "│ 1   │ \"PG\"     │ \"Devin Booker\"   │ 7.1  │ 0.616               │\n",
       "│ 2   │ \"PG\"     │ \"Isaiah Thomas\"  │ 0.7  │ 0.591               │\n",
       "│ 3   │ \"SG\"     │ \"JJ Redick\"      │ 4.6  │ 0.582               │\n",
       "│ 4   │ \"SG\"     │ \"Quinn Cook\"     │ 0.6  │ 0.564               │\n",
       "│ 5   │ \"SF\"     │ \"TJ Warren\"      │ 7.7  │ 0.619               │\n",
       "│ 6   │ \"SF\"     │ \"Josh Jackson\"   │ 1.2  │ 0.603               │\n",
       "│ 7   │ \"PF\"     │ \"Jeff Green\"     │ 3.1  │ 0.544               │\n",
       "│ 8   │ \"PF\"     │ \"Tarik Black\"    │ 0.8  │ 0.614               │\n",
       "│ 9   │ \"C\"      │ \"David West\"     │ 4.5  │ 0.578               │\n",
       "│ 10  │ \"C\"      │ \"Tyson Chandler\" │ 2.1  │ 0.613               │\n",
       "│ 11  │ \"N/A\"    │ \"TOTAL\"          │ 32.4 │ 0.592               │\n",
       "\n",
       "│ Row │ TurnoverRatio │ AssistRatio │ ReboundRate │ Popular │ Salary │\n",
       "├─────┼───────────────┼─────────────┼─────────────┼─────────┼────────┤\n",
       "│ 1   │ 11.4          │ 23.1        │ 8.5         │ \"Yes\"   │ 20     │\n",
       "│ 2   │ 8.7           │ 22          │ 6.3         │ \"No\"    │ 2.4    │\n",
       "│ 3   │ 14.9          │ 20.8        │ 15.7        │ \"No\"    │ 5      │\n",
       "│ 4   │ 14.1          │ 30.5        │ 6.1         │ \"No\"    │ 1.4    │\n",
       "│ 5   │ 11.8          │ 25.8        │ 13.1        │ \"No\"    │ 19     │\n",
       "│ 6   │ 9.7           │ 15.8        │ 16          │ \"No\"    │ 14     │\n",
       "│ 7   │ 7.4           │ 9.6         │ 5.9         │ \"No\"    │ 5      │\n",
       "│ 8   │ 14.8          │ 15.5        │ 12.5        │ \"No\"    │ 1.4    │\n",
       "│ 9   │ 12.8          │ 25.5        │ 10.5        │ \"No\"    │ 9      │\n",
       "│ 10  │ 7.9           │ 8.5         │ 16.5        │ \"No\"    │ 8      │\n",
       "│ 11  │ 11.4          │ 19.7        │ 11.1        │ 1.0     │ 85.2   │"
      ]
     },
     "execution_count": 12,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "println(\"Season 2:\")\n",
    "roster = printFiveSeasons(\"Year 2\",\n",
    "    EWA_param, TS_param, AST_param, TO_param, REBR_param, POP_param)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Season 3:\n"
     ]
    },
    {
     "data": {
      "text/html": [
       "<table class=\"data-frame\"><thead><tr><th></th><th>Position</th><th>Player</th><th>EWA</th><th>TrueShootingPercent</th><th>TurnoverRatio</th><th>AssistRatio</th><th>ReboundRate</th><th>Popular</th><th>Salary</th></tr></thead><tbody><tr><th>1</th><td>PG</td><td>Isaiah Thomas</td><td>0.7</td><td>0.591</td><td>8.7</td><td>22</td><td>6.3</td><td>No</td><td>2.4</td></tr><tr><th>2</th><td>PG</td><td>Quinn Cook</td><td>0.6</td><td>0.564</td><td>14.1</td><td>30.5</td><td>6.1</td><td>No</td><td>1.4</td></tr><tr><th>3</th><td>SG</td><td>JJ Redick</td><td>4.6</td><td>0.582</td><td>14.9</td><td>20.8</td><td>15.7</td><td>No</td><td>5</td></tr><tr><th>4</th><td>SG</td><td>Justise Winslow</td><td>0.9</td><td>0.509</td><td>4.4</td><td>13.6</td><td>5.8</td><td>No</td><td>2.4</td></tr><tr><th>5</th><td>SF</td><td>LeBron James</td><td>25.8</td><td>0.57</td><td>6.4</td><td>8.6</td><td>14</td><td>Yes</td><td>35</td></tr><tr><th>6</th><td>SF</td><td>Jeff Green</td><td>3.1</td><td>0.544</td><td>7.4</td><td>9.6</td><td>5.9</td><td>No</td><td>5</td></tr><tr><th>7</th><td>PF</td><td>TJ Warren</td><td>7.7</td><td>0.619</td><td>11.8</td><td>25.8</td><td>13.1</td><td>No</td><td>19</td></tr><tr><th>8</th><td>PF</td><td>Josh Jackson</td><td>1.2</td><td>0.603</td><td>9.7</td><td>15.8</td><td>16</td><td>No</td><td>14</td></tr><tr><th>9</th><td>C</td><td>David West</td><td>4.5</td><td>0.578</td><td>12.8</td><td>25.5</td><td>10.5</td><td>No</td><td>9</td></tr><tr><th>10</th><td>C</td><td>Tarik Black</td><td>0.8</td><td>0.614</td><td>14.8</td><td>15.5</td><td>12.5</td><td>No</td><td>1.4</td></tr><tr><th>11</th><td>N/A</td><td>TOTAL</td><td>49.9</td><td>0.577</td><td>10.5</td><td>18.8</td><td>10.6</td><td>1.0</td><td>94.6</td></tr></tbody></table>"
      ],
      "text/plain": [
       "11×9 DataFrames.DataFrame\n",
       "│ Row │ Position │ Player            │ EWA  │ TrueShootingPercent │\n",
       "├─────┼──────────┼───────────────────┼──────┼─────────────────────┤\n",
       "│ 1   │ \"PG\"     │ \"Isaiah Thomas\"   │ 0.7  │ 0.591               │\n",
       "│ 2   │ \"PG\"     │ \"Quinn Cook\"      │ 0.6  │ 0.564               │\n",
       "│ 3   │ \"SG\"     │ \"JJ Redick\"       │ 4.6  │ 0.582               │\n",
       "│ 4   │ \"SG\"     │ \"Justise Winslow\" │ 0.9  │ 0.509               │\n",
       "│ 5   │ \"SF\"     │ \"LeBron James\"    │ 25.8 │ 0.57                │\n",
       "│ 6   │ \"SF\"     │ \"Jeff Green\"      │ 3.1  │ 0.544               │\n",
       "│ 7   │ \"PF\"     │ \"TJ Warren\"       │ 7.7  │ 0.619               │\n",
       "│ 8   │ \"PF\"     │ \"Josh Jackson\"    │ 1.2  │ 0.603               │\n",
       "│ 9   │ \"C\"      │ \"David West\"      │ 4.5  │ 0.578               │\n",
       "│ 10  │ \"C\"      │ \"Tarik Black\"     │ 0.8  │ 0.614               │\n",
       "│ 11  │ \"N/A\"    │ \"TOTAL\"           │ 49.9 │ 0.577               │\n",
       "\n",
       "│ Row │ TurnoverRatio │ AssistRatio │ ReboundRate │ Popular │ Salary │\n",
       "├─────┼───────────────┼─────────────┼─────────────┼─────────┼────────┤\n",
       "│ 1   │ 8.7           │ 22          │ 6.3         │ \"No\"    │ 2.4    │\n",
       "│ 2   │ 14.1          │ 30.5        │ 6.1         │ \"No\"    │ 1.4    │\n",
       "│ 3   │ 14.9          │ 20.8        │ 15.7        │ \"No\"    │ 5      │\n",
       "│ 4   │ 4.4           │ 13.6        │ 5.8         │ \"No\"    │ 2.4    │\n",
       "│ 5   │ 6.4           │ 8.6         │ 14          │ \"Yes\"   │ 35     │\n",
       "│ 6   │ 7.4           │ 9.6         │ 5.9         │ \"No\"    │ 5      │\n",
       "│ 7   │ 11.8          │ 25.8        │ 13.1        │ \"No\"    │ 19     │\n",
       "│ 8   │ 9.7           │ 15.8        │ 16          │ \"No\"    │ 14     │\n",
       "│ 9   │ 12.8          │ 25.5        │ 10.5        │ \"No\"    │ 9      │\n",
       "│ 10  │ 14.8          │ 15.5        │ 12.5        │ \"No\"    │ 1.4    │\n",
       "│ 11  │ 10.5          │ 18.8        │ 10.6        │ 1.0     │ 94.6   │"
      ]
     },
     "execution_count": 13,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "println(\"Season 3:\")\n",
    "roster = printFiveSeasons(\"Year 3\",\n",
    "    EWA_param, TS_param, AST_param, TO_param, REBR_param, POP_param)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Season 4:\n"
     ]
    },
    {
     "data": {
      "text/html": [
       "<table class=\"data-frame\"><thead><tr><th></th><th>Position</th><th>Player</th><th>EWA</th><th>TrueShootingPercent</th><th>TurnoverRatio</th><th>AssistRatio</th><th>ReboundRate</th><th>Popular</th><th>Salary</th></tr></thead><tbody><tr><th>1</th><td>PG</td><td>Isaiah Thomas</td><td>0.7</td><td>0.591</td><td>8.7</td><td>22</td><td>6.3</td><td>No</td><td>2.4</td></tr><tr><th>2</th><td>PG</td><td>Quinn Cook</td><td>0.6</td><td>0.564</td><td>14.1</td><td>30.5</td><td>6.1</td><td>No</td><td>1.4</td></tr><tr><th>3</th><td>SG</td><td>JJ Redick</td><td>4.6</td><td>0.582</td><td>14.9</td><td>20.8</td><td>15.7</td><td>No</td><td>5</td></tr><tr><th>4</th><td>SG</td><td>Justise Winslow</td><td>0.9</td><td>0.509</td><td>4.4</td><td>13.6</td><td>5.8</td><td>No</td><td>2.4</td></tr><tr><th>5</th><td>SF</td><td>TJ Warren</td><td>7.7</td><td>0.619</td><td>11.8</td><td>25.8</td><td>13.1</td><td>No</td><td>19</td></tr><tr><th>6</th><td>SF</td><td>Jeff Green</td><td>3.1</td><td>0.544</td><td>7.4</td><td>9.6</td><td>5.9</td><td>No</td><td>5</td></tr><tr><th>7</th><td>PF</td><td>LeBron James</td><td>25.8</td><td>0.57</td><td>6.4</td><td>8.6</td><td>14</td><td>Yes</td><td>35</td></tr><tr><th>8</th><td>PF</td><td>Josh Jackson</td><td>1.2</td><td>0.603</td><td>9.7</td><td>15.8</td><td>16</td><td>No</td><td>14</td></tr><tr><th>9</th><td>C</td><td>David West</td><td>4.5</td><td>0.578</td><td>12.8</td><td>25.5</td><td>10.5</td><td>No</td><td>9</td></tr><tr><th>10</th><td>C</td><td>Tarik Black</td><td>0.8</td><td>0.614</td><td>14.8</td><td>15.5</td><td>12.5</td><td>No</td><td>1.4</td></tr><tr><th>11</th><td>N/A</td><td>TOTAL</td><td>49.9</td><td>0.577</td><td>10.5</td><td>18.8</td><td>10.6</td><td>1.0</td><td>94.6</td></tr></tbody></table>"
      ],
      "text/plain": [
       "11×9 DataFrames.DataFrame\n",
       "│ Row │ Position │ Player            │ EWA  │ TrueShootingPercent │\n",
       "├─────┼──────────┼───────────────────┼──────┼─────────────────────┤\n",
       "│ 1   │ \"PG\"     │ \"Isaiah Thomas\"   │ 0.7  │ 0.591               │\n",
       "│ 2   │ \"PG\"     │ \"Quinn Cook\"      │ 0.6  │ 0.564               │\n",
       "│ 3   │ \"SG\"     │ \"JJ Redick\"       │ 4.6  │ 0.582               │\n",
       "│ 4   │ \"SG\"     │ \"Justise Winslow\" │ 0.9  │ 0.509               │\n",
       "│ 5   │ \"SF\"     │ \"TJ Warren\"       │ 7.7  │ 0.619               │\n",
       "│ 6   │ \"SF\"     │ \"Jeff Green\"      │ 3.1  │ 0.544               │\n",
       "│ 7   │ \"PF\"     │ \"LeBron James\"    │ 25.8 │ 0.57                │\n",
       "│ 8   │ \"PF\"     │ \"Josh Jackson\"    │ 1.2  │ 0.603               │\n",
       "│ 9   │ \"C\"      │ \"David West\"      │ 4.5  │ 0.578               │\n",
       "│ 10  │ \"C\"      │ \"Tarik Black\"     │ 0.8  │ 0.614               │\n",
       "│ 11  │ \"N/A\"    │ \"TOTAL\"           │ 49.9 │ 0.577               │\n",
       "\n",
       "│ Row │ TurnoverRatio │ AssistRatio │ ReboundRate │ Popular │ Salary │\n",
       "├─────┼───────────────┼─────────────┼─────────────┼─────────┼────────┤\n",
       "│ 1   │ 8.7           │ 22          │ 6.3         │ \"No\"    │ 2.4    │\n",
       "│ 2   │ 14.1          │ 30.5        │ 6.1         │ \"No\"    │ 1.4    │\n",
       "│ 3   │ 14.9          │ 20.8        │ 15.7        │ \"No\"    │ 5      │\n",
       "│ 4   │ 4.4           │ 13.6        │ 5.8         │ \"No\"    │ 2.4    │\n",
       "│ 5   │ 11.8          │ 25.8        │ 13.1        │ \"No\"    │ 19     │\n",
       "│ 6   │ 7.4           │ 9.6         │ 5.9         │ \"No\"    │ 5      │\n",
       "│ 7   │ 6.4           │ 8.6         │ 14          │ \"Yes\"   │ 35     │\n",
       "│ 8   │ 9.7           │ 15.8        │ 16          │ \"No\"    │ 14     │\n",
       "│ 9   │ 12.8          │ 25.5        │ 10.5        │ \"No\"    │ 9      │\n",
       "│ 10  │ 14.8          │ 15.5        │ 12.5        │ \"No\"    │ 1.4    │\n",
       "│ 11  │ 10.5          │ 18.8        │ 10.6        │ 1.0     │ 94.6   │"
      ]
     },
     "execution_count": 14,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "println(\"Season 4:\")\n",
    "roster = printFiveSeasons(\"Year 4\", \n",
    "    EWA_param, TS_param, AST_param, TO_param, REBR_param, POP_param)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Season 5:\n"
     ]
    },
    {
     "data": {
      "text/html": [
       "<table class=\"data-frame\"><thead><tr><th></th><th>Position</th><th>Player</th><th>EWA</th><th>TrueShootingPercent</th><th>TurnoverRatio</th><th>AssistRatio</th><th>ReboundRate</th><th>Popular</th><th>Salary</th></tr></thead><tbody><tr><th>1</th><td>PG</td><td>Isaiah Thomas</td><td>0.7</td><td>0.591</td><td>8.7</td><td>22</td><td>6.3</td><td>No</td><td>2.4</td></tr><tr><th>2</th><td>PG</td><td>Quinn Cook</td><td>0.6</td><td>0.564</td><td>14.1</td><td>30.5</td><td>6.1</td><td>No</td><td>1.4</td></tr><tr><th>3</th><td>SG</td><td>Justise Winslow</td><td>0.9</td><td>0.509</td><td>4.4</td><td>13.6</td><td>5.8</td><td>No</td><td>2.4</td></tr><tr><th>4</th><td>SG</td><td>Luke Kennard</td><td>0.7</td><td>0.54</td><td>7.5</td><td>10.5</td><td>7.7</td><td>No</td><td>1.4</td></tr><tr><th>5</th><td>SF</td><td>LeBron James</td><td>25.8</td><td>0.57</td><td>6.4</td><td>8.6</td><td>14</td><td>Yes</td><td>35</td></tr><tr><th>6</th><td>SF</td><td>TJ Warren</td><td>7.7</td><td>0.619</td><td>11.8</td><td>25.8</td><td>13.1</td><td>No</td><td>19</td></tr><tr><th>7</th><td>PF</td><td>Anthony Davis</td><td>22</td><td>0.576</td><td>10.6</td><td>15.5</td><td>8.7</td><td>Yes</td><td>29</td></tr><tr><th>8</th><td>PF</td><td>Channing Frye</td><td>0.5</td><td>0.539</td><td>10.4</td><td>24.6</td><td>6.4</td><td>No</td><td>1.4</td></tr><tr><th>9</th><td>C</td><td>Tarik Black</td><td>0.8</td><td>0.614</td><td>14.8</td><td>15.5</td><td>12.5</td><td>No</td><td>1.4</td></tr><tr><th>10</th><td>C</td><td>Cristiano Felicio</td><td>0.7</td><td>0.507</td><td>12.6</td><td>14.3</td><td>15.9</td><td>No</td><td>1.4</td></tr><tr><th>11</th><td>N/A</td><td>TOTAL</td><td>60.4</td><td>0.563</td><td>10.1</td><td>18.1</td><td>9.7</td><td>2.0</td><td>94.8</td></tr></tbody></table>"
      ],
      "text/plain": [
       "11×9 DataFrames.DataFrame\n",
       "│ Row │ Position │ Player              │ EWA  │ TrueShootingPercent │\n",
       "├─────┼──────────┼─────────────────────┼──────┼─────────────────────┤\n",
       "│ 1   │ \"PG\"     │ \"Isaiah Thomas\"     │ 0.7  │ 0.591               │\n",
       "│ 2   │ \"PG\"     │ \"Quinn Cook\"        │ 0.6  │ 0.564               │\n",
       "│ 3   │ \"SG\"     │ \"Justise Winslow\"   │ 0.9  │ 0.509               │\n",
       "│ 4   │ \"SG\"     │ \"Luke Kennard\"      │ 0.7  │ 0.54                │\n",
       "│ 5   │ \"SF\"     │ \"LeBron James\"      │ 25.8 │ 0.57                │\n",
       "│ 6   │ \"SF\"     │ \"TJ Warren\"         │ 7.7  │ 0.619               │\n",
       "│ 7   │ \"PF\"     │ \"Anthony Davis\"     │ 22   │ 0.576               │\n",
       "│ 8   │ \"PF\"     │ \"Channing Frye\"     │ 0.5  │ 0.539               │\n",
       "│ 9   │ \"C\"      │ \"Tarik Black\"       │ 0.8  │ 0.614               │\n",
       "│ 10  │ \"C\"      │ \"Cristiano Felicio\" │ 0.7  │ 0.507               │\n",
       "│ 11  │ \"N/A\"    │ \"TOTAL\"             │ 60.4 │ 0.563               │\n",
       "\n",
       "│ Row │ TurnoverRatio │ AssistRatio │ ReboundRate │ Popular │ Salary │\n",
       "├─────┼───────────────┼─────────────┼─────────────┼─────────┼────────┤\n",
       "│ 1   │ 8.7           │ 22          │ 6.3         │ \"No\"    │ 2.4    │\n",
       "│ 2   │ 14.1          │ 30.5        │ 6.1         │ \"No\"    │ 1.4    │\n",
       "│ 3   │ 4.4           │ 13.6        │ 5.8         │ \"No\"    │ 2.4    │\n",
       "│ 4   │ 7.5           │ 10.5        │ 7.7         │ \"No\"    │ 1.4    │\n",
       "│ 5   │ 6.4           │ 8.6         │ 14          │ \"Yes\"   │ 35     │\n",
       "│ 6   │ 11.8          │ 25.8        │ 13.1        │ \"No\"    │ 19     │\n",
       "│ 7   │ 10.6          │ 15.5        │ 8.7         │ \"Yes\"   │ 29     │\n",
       "│ 8   │ 10.4          │ 24.6        │ 6.4         │ \"No\"    │ 1.4    │\n",
       "│ 9   │ 14.8          │ 15.5        │ 12.5        │ \"No\"    │ 1.4    │\n",
       "│ 10  │ 12.6          │ 14.3        │ 15.9        │ \"No\"    │ 1.4    │\n",
       "│ 11  │ 10.1          │ 18.1        │ 9.7         │ 2.0     │ 94.8   │"
      ]
     },
     "execution_count": 15,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "println(\"Season 5:\")\n",
    "roster = printFiveSeasons(\"Year 5\", \n",
    "    EWA_param, TS_param, AST_param, TO_param, REBR_param, POP_param)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='2b'></a>\n",
    "\n",
    "### Section 2b: Free Agency Plan Pareto Curves"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "A common discussion in the NBA is whether it is better to have a team that plays together well and passes a great amount or if it is ideal to build a team with individual offensive talent. A team that passes a lot will have a high assist ratio (AST). Alternatively, a team with individual offensive talent may have a higher true shooting percentage (TS). To compare these two potential situations, we set up a pareto curve between assists ratio (AST) and true shooting percentage (TS) as seen below:\n",
    "\n",
    "(Please note generating each curve takes two or three minutes of computational time as it runs the model 30 times)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {
    "scrolled": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "PyPlot.Figure(PyObject <matplotlib.figure.Figure object at 0x000000003D657A58>)"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "Npts = 30\n",
    "J1 = zeros(Npts) #Tradeoff Parameter for True Shooting Percentage\n",
    "J2 = zeros(Npts) #Tradeoff Parameter for Assist Ratio\n",
    "for (l,λ) in enumerate(linspace(0,1,Npts))\n",
    "    x = fiveSeasons(0, λ, 1-λ, 0, 0, 0)\n",
    "    J1[l] = sum( x[i,j,k]*data[i, \"TS%\"] for i in playernames, j in positions, k in seasons)/50\n",
    "    J2[l] = sum( x[i,j,k] * data[i, \"AST\"] for i in playernames, j in positions, k in seasons)/50\n",
    "end;\n",
    "\n",
    "figure(figsize=(8,4))\n",
    "plot( J1, J2, \"b.-\" )\n",
    "xlabel(\"J1 True Shooting Percentage\")\n",
    "ylabel(\"J2 Assists\");\n",
    "title(\"Pareto curve for True Shooting Percentage vs Assists in Five Season Problem\")\n",
    "grid()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "These curves are normalized to represent the average player on the optimally chosen team. \n",
    "\n",
    "We can see from this curve that as predicted there is a negative correlation between the two quantities. Players who have a high AST ratio are more likely to have assists because they believe the team will have a better shot at scoring if they are to pass it than shooting themselves. On the other hand, players with a high TS will be more likely to shoot and not pass as they know they have a better chance of scoring themselves. It is likely that a team that maximizes assists will have a better balance of players that shoot well (when every team member assists, it implies all team members can shoot reliably). It is up to the team management to determine whether they would like to optimize for a team that is more assist or true shooting oriented. \n",
    "    \n",
    "Another thing to consider is how well our team is able to keep possession of the ball. Players that have a high rebound ratio (REBR) are capable of gaining the team possession, while players with a high turnover ratio (TO) are more likely to lose team possession. We can form a similar trade off analysis, as seen below:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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/HmcOnUq160tM2bMgJaWFoYPH453797h119/Rbdu3XDu3Dn5MitXrkRQUBDq16+PH3/8EQ8ePECbNm1gYWEhTwBUlZqaiqioKKV9l5PzrXLlypg8eTImTJiAvn37yn9QyC7JHzt2DL6+vvDw8MDEiROhpaWF1atXo2nTpjh58iRq166daUw2NjZo1KgRQkNDMXHiRIV5mzZtgra2trxeBwcHY/r06ejduzdq166N2NhYXLhwAZcuXVK6vJsfkpKS4O3tjebNm+P333+HqampfF50dDR8fX0REBCALl26YOPGjRg6dCjc3NzQpEkTANIv6oYNG+LJkycYPHgwypQpg02bNqFbt254//49goKCYGhoiDZt2mDbtm1YuHCh/FwGpH0gU1NTERAQAED6mdOyZUtcuHABQUFBqFixIi5fvoyZM2ciIiJCIREHpD9q161bh4EDB6J48eK5+mH58OFDaGtrK7z3mJgYrFmzBgEBAQgKCsLbt2+xYsUKeHl54dKlS3BxcUGpUqUwf/58/PDDD/D394efnx8AoHr16lluq3v37ti0aRMCAgLg6emJU6dOYfLkybh37x42bNigcuwAcPToUWzcuBEDBgyAkZER5syZgw4dOuDx48coVqzYZ/8+Li4Or169UigzNzfPtCXP2NgYfn5+2Lp1K+bNm6dw1XDLli1IS0uTH8vU1FS0aNECV65cQVBQECpUqICLFy9i2rRpiIyMxF9//ZVlTHZ2dtDW1saOHTvQu3fvbN+HKttZuHAh6tWrh/bt20NLSwvbtm3D999/Dy0tLfTs2RMA8OTJE7Ro0QL29vYYN24cTE1N8eDBAxw8eFBpm//++y+CgoLg4uKCPXv2YPDgwXjx4gV++eUXhRgPHTqEdevWYcCAATAwMMCcOXPQvn17PH78WKHe5VTGfOPT95eWloaBAwdCS0sLpqamiI2NRcOGDfH06VMMHjwYdnZ22LBhAwICAvDhwwf873//U1hHSEgIEhMT8eOPP+L9+/eYO3cumjRpghs3bih97n5q9OjR+PXXX9G1a1f069cPz549w/z58/Hvv//i4sWLClcunz9/jnbt2qFnz57o0qULFixYgI4dO+LPP//E0KFDMWDAAHTr1g0zZ85Ex44d8ejRo7y90VF85VavXi0AiCNHjojo6Gjx5MkTsXHjRmFpaSkMDQ1FVFSUEEKI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",
      "text/plain": [
       "PyPlot.Figure(PyObject <matplotlib.figure.Figure object at 0x0000000002FF1668>)"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "Npts = 30\n",
    "J1 = zeros(Npts) \n",
    "J2 = zeros(Npts)\n",
    "for (l,λ) in enumerate(linspace(0,1,Npts))\n",
    "    x = fiveSeasons(0, 0, 0, λ, 1-λ, 0)\n",
    "    J1[l] = sum( x[i,j,k]*data[i, \"REBR\"] for i in playernames, j in positions, k in seasons)/50\n",
    "    J2[l] = sum( x[i,j,k]*data[i, \"TO\"] for i in playernames, j in positions, k in seasons)/50\n",
    "end;\n",
    "\n",
    "figure(figsize=(8,4))\n",
    "plot( J1, J2, \"b.-\" )\n",
    "xlabel(\"J1 Rebound Rate\")\n",
    "ylabel(\"J2 Turnover Ratio\");\n",
    "title(\"Pareto curve for Rebound Rate vs Turnover Ratio in Five Season Problem\")\n",
    "grid()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "As you can see, there is a positive correlation between teams which collect a great amount of rebounds and teams that turn the ball often. When maximizing rebounds, the average player will turn the ball over four times less than he rebounds per 100 posessions. The primary reason to maximimze rebounding is to gain more posessions and according to this curve it is not particulary efficient in doing so as the player will also turn the ball over more about as much. \n",
    "\n",
    "Thus, maximizing rebounds will not help the team as much as it may seem. It is possible that when we build a team that maximizes rebound rates we are creating a team of players that more often plays in the paint under the hoop. Their proximity to the hoop would allow them to get more rebounds, but have more opportunities to turn the ball over given the crowded area they occupy. \n",
    "\n",
    "Again, it is up to team management to decide how to interpret these statistics, there is no one correct way to build a team."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='3'></a>\n",
    "## Section 3: Building a Stadium"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Our final model is a combination of the previously described assignment problem and a network flow model in which we seek to find the optimal one-time investment the Suns need to create a winning team and expand their profile with a new stadium. This problem builds off the assignment problem in Section 2 by including more of the Suns financial context.\n",
    "\n",
    "A diagram illustrating the concept of this model is shown below:"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "![](Investment.png)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In addition to the assumptions, decision variables, and constraints from the Section 2, this model contains the following additions.\n",
    "\n",
    "*Assumptions:*\n",
    "* Any profit taken from the team cannot be invested back into the team at a later time.\n",
    "* When a stadium is built, it is paid for in the same year it is built, but the team does not receive and revenue from the stadium until the next year.\n",
    "* Any investment in the team can come only from the owner. This ignores the role of the league and cities in finacially sustaining a team."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "*Decision variables:*\n",
    "* Profit (p): a sink associated with each season that represents any profit removed from the team. Profit is discounted according to its present value at the beginning of season, using the present value formula: $PV =  \\frac{P_{Year \\: k}}{(1+0.07)^{k}}$. Therefore, any profits accrued later in the five year period are worth less to the Suns presently than profits accrued earlier in the five year period.\n",
    "\n",
    "  $p_k \\geq 0 \\hspace{10pt} \\forall k \\in seasons$\n",
    "\n",
    "\n",
    "\n",
    "* Hold (h): a vector that represents the amount of money transferred from one season to the next. This is different from Profit because the 'hold' is cash that remains within the Suns organization. \n",
    "\n",
    "  $h_k \\geq 0 \\hspace{10pt} \\forall k \\in seasons$\n",
    "\n",
    "\n",
    "\n",
    "* Stadium build (S): a 5 element vector of binary decision variables that takes the value of 1 if the new stadium is built (and paid for) during its corresponding season. This variable will take the value 0 if the stadium is not built during the corresponding season.\n",
    "\n",
    " $S_k \\in \\{0,1\\} \\hspace{10pt} \\forall k \\in seasons$\n",
    "\n",
    "\n",
    "\n",
    "* Initial investment (I): a scalar that represents the one-time investment that must be made to accomplish the team's goals over the time horizon. We cap this investment at \\$400 million because this is the net worth owner Robert Sarver.\n",
    "\n",
    " $0 \\leq I \\leq 400$\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "*Constraints:*\n",
    "* Conservation of resources: the sum of money flowing into a season must equal the sum of money flowing out of a season. This constraint for Year 1 is different from the constraints for the subsequent years because of the initial investment and therefore must be written separately. \"Upgrade cost\" is the cost to build the stadium and must be paid in the same season the stadium is built.\n",
    "\n",
    "\\begin{equation}\n",
    "  I\\: = \\: x^{T}Salary_1 + h_1 + p_1 + UpgradeCost * S_1 \\hspace{10pt}k \\: = \\: Year\\:1 \\\\ \\\\ \\\\\n",
    "  70+h_{k-1} + 30\\sum_{n=2}^{k}SV_{n-1}+15x^{T}POP  \\hspace{10pt}\\forall \\: k\\in\\: \\{Year\\:2,\\:Year\\:3,\\:Year\\:4\\,\\:Year\\:5\\}\n",
    "\\end{equation}\n",
    "\n",
    "* The stadium must be built during one of the five seasons.\n",
    "\n",
    "  $$\\sum_{k\\:\\in\\:seasons}Stadium_k = 1$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "*Objective:*\n",
    "* The objective function maximizes the total team EWA over the five season time horizon, while trading off for the basic return on investment (total profit - initial investment). Like the objective function in the assignment problem, this objective function also allows the decision maker to decide how much to weight maximizing EWA or return. \n",
    "\n",
    "  $\\underset{x}{\\text{maximize}} \\hspace{10pt} \\bigg(1-{\\large\\lambda_{loss}}\\bigg)\\sum_{k\\:\\in\\:seasons}x^{T}EWA \\: + \\:\\bigg\\lbrack\\bigg(\\sum_{k\\:\\in\\:seasons}pv\\bigg) - I\\bigg\\rbrack{\\large\\lambda_{loss}}$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The model is written in standard form below:\n",
    "\n",
    "\\begin{equation*}\n",
    "\\begin{aligned}\n",
    "& \\underset{x}{\\text{maximize}}\n",
    "& & \\bigg(1-{\\large\\lambda_{loss}}\\bigg)\\sum_{k\\:\\in\\:seasons}x^{T}EWA \\: + \\:\\bigg\\lbrack\\bigg(\\sum_{k\\:\\in\\:seasons}pv\\bigg) - I\\bigg\\rbrack{\\large\\lambda_{loss}}\n",
    "\\\\\n",
    "\\\\\n",
    "\\\\\n",
    "& \\text{subject to}\n",
    "\\end{aligned}\n",
    "\\end{equation*}\n",
    "\\begin{alignat}{2}\n",
    "  &\\sum_{j\\: \\in \\: positions} x_{ijk} \\leq 1\n",
    "  &&\\forall \\: k \\in \\: seasons , \\: \\forall \\: i \\in \\: players \\\\ \\\\\n",
    "  &\\sum_{i\\: \\in \\:players} x_{ijk} = 2 \\hspace{5pt} \n",
    "  &&\\forall k \\: \\in \\: seasons, \\forall \\: j \\in \\: positions  \\\\ \\\\\n",
    "  &\\sum_{j\\: \\in \\:positions} x^{T} Salary \\leq SalaryCap \\hspace{5pt}  \n",
    "  &&\\forall \\: k \\: \\in \\: seasons\\\\ \\\\\n",
    "  &\\sum_{j\\: \\in \\:positions} x_{ijk} \\leq Suns_{i}+YearAvail_{ik} \\hspace{5pt} \n",
    "  &&\\forall \\: i \\: \\in  \\: players, \\: k = Year \\: 1\\\\ \\\\\n",
    "  &\\sum_{j\\: \\in \\:positions} x_{ijk} \\leq YearAvail_{ik}+\\sum_{j\\: \\in \\:positions} x_{ijk+1} \\hspace{5pt} \n",
    "  &&\\forall\\: i\\: \\in\\: players,\\: k\\: \\in\\: \\{Year \\: 1,\\:Year\\: 2,\\:Year\\:3,\\:Year\\:4\\}\\\\ \\\\\n",
    "  &\\sum_{j\\: \\in \\:positions} x_{ijk} \\geq - YearAvail_{ik}+\\sum_{j\\: \\in \\:positions} x_{ijk+1} \\hspace{5pt}\\: \n",
    "  &&\\forall \\:i\\: \\in\\: players,\\: k \\:\\in\\: \\{Year\\:1,\\:Year\\:2,\\:Year\\:3,\\:Year\\:4\\}\\\\ \\\\\n",
    "  &x_{ijk} \\leq PlayerPos_{ij} \\hspace{5pt}   \n",
    "  &&\\forall k \\in seasons, \\: \\forall \\: j \\: \\in \\: positions, \\forall i \\in players \\\\ \\\\\n",
    "  &I\\: = \\: x^{T}Salary_1 + h_1 + p_1 + UpgradeCost * S_1\n",
    "  && \\: k \\: = \\: Year\\:1 \\\\ \\\\\n",
    "  &70+h_{k-1} + 30\\sum_{n=2}^{k}SV_{n-1}+15x^{T}POP\n",
    "  &&\\forall \\:k\\in\\: \\{Year\\:2,\\:Year\\:3,\\:Year\\:4\\,\\:Year\\:5\\}\\\\ \\\\ \n",
    "  & \\sum_{k\\:\\in\\:seasons}Stadium_k = 1\\\\ \\\\\n",
    "  &x_{ijk}  \\in \\{0,1\\}\\\\ \\\\\n",
    "  &0 \\leq I \\leq 400\\\\ \\\\\n",
    "  &h_k \\geq 0, p_k \\geq 0, h_k \\geq 0\n",
    "  &&\\forall \\: k \\in \\: seasons \\\\ \\\\\n",
    "  &S_k \\in \\{0,1\\}\n",
    "  &&\\forall \\: k \\in \\: seasons \n",
    "\\end{alignat}"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {},
   "outputs": [],
   "source": [
    "function stadiumBuild(loss_param) # Maximize EWA vs sava initial investment\n",
    "    \n",
    "    stadium_upgrade = 200 #Cost of Stadium upgrae\n",
    "    cap = 95 #NBA Cap\n",
    "    r = 1.07 #Present value of currency rate\n",
    "\n",
    "    m = Model(solver=CbcSolver())\n",
    "\n",
    "    \n",
    "    @variable(m, x[playernames, positions, seasons], Bin) #Player matrix\n",
    "    @variable(m, hold[seasons] >= 0) #Holdover until next year\n",
    "    @variable(m, p[seasons] >= 0) #Yearly profit\n",
    "    @variable(m, stadium[seasons], Bin) #Whether or not stadium is built in year k\n",
    "    @variable(m, 0<= initial_investment <=400) # Owners potential investment\n",
    "\n",
    "      \n",
    "    # Profit exp\n",
    "    @expression(m, salary[k in seasons], sum(data[i, \"Salary\"]*x[i,j,k] for j in positions, i in playernames))\n",
    "    @expression(m, EWA[k in seasons], sum( x[i,j,k]*data[i, \"EWA\"] for i in playernames, j in positions))\n",
    "    @expression(m, TS[k in seasons], sum( x[i,j,k]*data[i, \"TS%\"] for i in playernames, j in positions))\n",
    "    @expression(m, AST[k in seasons], sum( x[i,j,k]*data[i, \"AST\"] for i in playernames, j in positions))\n",
    "    @expression(m, TO[k in seasons], sum( x[i,j,k]*data[i, \"TO\"] for i in playernames, j in positions))\n",
    "    @expression(m, REBR[k in seasons], sum( x[i,j,k]*data[i, \"REBR\"] for i in playernames, j in positions)) \n",
    "    @expression(m, Merch[k in seasons], 15*sum( x[i,j,k] * data[i, \"POP\"] for i in playernames, j in positions))\n",
    "    @expression(m, pv_profit[k in 1:5], p[seasons[k]]/r^(k-1))  # present value profit\n",
    "    @expression(m, svalue_added[k in 1:5], sum(30*stadium[seasons[k]]))\n",
    " \n",
    "    \n",
    "    # Each player can be signed once\n",
    "    @constraint(m, a[i in playernames, k in seasons], sum(x[i,j,k] for j in positions) <= 1 )\n",
    "\n",
    "    # each position has exactly two players\n",
    "    @constraint(m, b[j in positions, k in seasons], sum(x[i,j,k] for i in playernames) == 2 )\n",
    "\n",
    "    # Players can only play their positions\n",
    "    @constraint(m, c[j in positions, i in playernames, k in seasons], x[i,j,k] <= data[i,j])\n",
    "\n",
    "    # Team must stay under salary cap\n",
    "    @constraint(m, d[k in seasons], sum(data[i, \"Salary\"]*x[i,j,k] for j in positions, i in playernames) <= cap)\n",
    "\n",
    "    # Current Sun players start on team\n",
    "    # Anywhere Sun is equal to 1 must be on team\n",
    "    @constraint(m, e[i in playernames], sum(x[i,j,\"Year 1\"] for j in positions) >= data[i, \"SUNS\"])\n",
    "\n",
    "    # Only add players available in year one\n",
    "    @constraint(m, f[i in playernames, \"Year 1\"], sum(x[i,j,\"Year 1\"] for j in positions) <= \n",
    "        data[i,\"Year 1\"] + data[i, \"SUNS\"])\n",
    "\n",
    "    # Appropriate players for other years\n",
    "    @constraint(m, g[i in playernames, k in 1:4], sum(x[i,j,seasons[k]] for j in positions) <= \n",
    "        data[i,seasons[k]] + sum(x[i,j,seasons[k+1]] for j in positions))\n",
    "\n",
    "    # Contract length constraint, players must play for three consecutive years\n",
    "    @constraint(m, h[i in playernames, k in 1:4], sum(x[i,j, seasons[k]] for j in positions) >=\n",
    "        sum(x[i,j,seasons[k+1]] for j in positions) - data[i, seasons[k]])\n",
    "\n",
    "\n",
    "\n",
    "    # Financial Constraints\n",
    "\n",
    "    # Year 1\n",
    "    @constraint(m, initial_investment == salary[\"Year 1\"] + hold[\"Year 1\"] + p[\"Year 1\"] \n",
    "        + stadium_upgrade*stadium[\"Year 1\"])\n",
    "\n",
    "    # Years 2 - 4\n",
    "    # 70 is from ticket sales\n",
    "    @constraint(m, l[k in 2:5], 70 + hold[seasons[k-1]] + sum(svalue_added[n-1] for n in 2:k) + Merch[seasons[k-1]]  \n",
    "        == salary[seasons[k]] + hold[seasons[k]] + p[seasons[k]] + stadium_upgrade*stadium[seasons[k]])\n",
    "\n",
    "    # Must build stadium\n",
    "    @constraint(m, sum(stadium) == 1)\n",
    "\n",
    "\n",
    "    # Objective\n",
    "    # Max of Profit:\n",
    "    @objective(m, Max, (1-loss_param)*sum(EWA) + (sum(pv_profit) - initial_investment)*loss_param)\n",
    "    # Display data\n",
    "    solve(m)\n",
    "\n",
    " \n",
    "    \n",
    "    return (getvalue(x), getvalue(hold), getvalue(p), getvalue(stadium), getvalue(initial_investment))    \n",
    "    \n",
    "end;\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {},
   "outputs": [],
   "source": [
    "#Helps print data correctly\n",
    "function isSeason1(k)\n",
    "    if k == 1\n",
    "        return 0\n",
    "    else\n",
    "        return 1\n",
    "    end\n",
    "end\n",
    "\n",
    "\n",
    "#Prints EWA, and financial data for five seasons\n",
    "function printStadiumBuild(loss_param)\n",
    "    r = 1.07 #Present value of currency rate\n",
    "    (x, hold, p, stadium, initial_investment) = stadiumBuild(loss_param)\n",
    "    \n",
    "    println(\"Initial Investment: \", initial_investment)\n",
    "    \n",
    "    #Clear Data Frame\n",
    "    finacnialData = 0\n",
    "    \n",
    "    #Create Data Frame\n",
    "    financialData =  DataFrame(Season = [], EWA = [], Holdover = [], PresentValueProfit = [],\n",
    "                StadiumUpgrade =[], StadiumValueAdded =[], MerchandiceSales =[], SalarySpending =[]) \n",
    "    count = 1\n",
    "    \n",
    "    for k in 1:5        \n",
    "        push!(financialData, [seasons[k], round(sum( x[i,j,seasons[k]]*data[i, \"EWA\"] for i in playernames, \n",
    "                            j in positions),1),\n",
    "        round(hold[seasons[k]],2), round(p[seasons[k]]/r^(count-1),2), parseBinaryYesNo(stadium[seasons[k]]), \n",
    "            round(30*sum(stadium[seasons[n]]for n in 1:k)*isSeason1(k),2), 15*sum( x[i,j,seasons[k]] \n",
    "                    * data[i, \"POP\"] for i in playernames, j in positions),  round(sum(data[i, \"Salary\"]\n",
    "                        *x[i,j,seasons[k]] for j in positions, i in playernames),2)])\n",
    "    \n",
    "        count = count + 1\n",
    "    end\n",
    "    \n",
    "    return financialData\n",
    "end;"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='3a'></a>\n",
    "### Section 3a: Building a Stadium Results"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here, we have printed EWA and the financial data for the five year period. In the first model, we adjust the trade-off to purely maximize EWA while maintaining the available salary to pay for a stadium.\n",
    "\n",
    "\n",
    "Currently the strategies tested are as follows:\n",
    "trial_1 - Maximize EWA without regard to profit.\n",
    "trial_2 - Maximize EWA and profit equally.\n",
    "trial_3 - Maximize profit without regard to EWA.\n",
    "\n",
    "Again the team management should feel free to change the paramaters within the following code block to compare decision strategies side by side. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {},
   "outputs": [],
   "source": [
    "trial_1 = 0; \n",
    "trial_2 = .5;\n",
    "trial_3 = 1;"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Initial Investment: "
     ]
    },
    {
     "data": {
      "text/html": [
       "<table class=\"data-frame\"><thead><tr><th></th><th>Season</th><th>EWA</th><th>Holdover</th><th>PresentValueProfit</th><th>StadiumUpgrade</th><th>StadiumValueAdded</th><th>MerchandiceSales</th><th>SalarySpending</th></tr></thead><tbody><tr><th>1</th><td>Year 1</td><td>33.1</td><td>219.4</td><td>0.0</td><td>No</td><td>0.0</td><td>15.0</td><td>94.2</td></tr><tr><th>2</th><td>Year 2</td><td>32.4</td><td>219.2</td><td>0.0</td><td>No</td><td>0.0</td><td>15.0</td><td>85.2</td></tr><tr><th>3</th><td>Year 3</td><td>49.9</td><td>209.6</td><td>0.0</td><td>No</td><td>0.0</td><td>15.0</td><td>94.6</td></tr><tr><th>4</th><td>Year 4</td><td>49.9</td><td>0.0</td><td>0.0</td><td>Yes</td><td>30.0</td><td>15.0</td><td>94.6</td></tr><tr><th>5</th><td>Year 5</td><td>60.4</td><td>20.2</td><td>0.0</td><td>No</td><td>30.0</td><td>30.0</td><td>94.8</td></tr></tbody></table>"
      ],
      "text/plain": [
       "5×8 DataFrames.DataFrame\n",
       "│ Row │ Season   │ EWA  │ Holdover │ PresentValueProfit │ StadiumUpgrade │\n",
       "├─────┼──────────┼──────┼──────────┼────────────────────┼────────────────┤\n",
       "│ 1   │ \"Year 1\" │ 33.1 │ 219.4    │ 0.0                │ \"No\"           │\n",
       "│ 2   │ \"Year 2\" │ 32.4 │ 219.2    │ 0.0                │ \"No\"           │\n",
       "│ 3   │ \"Year 3\" │ 49.9 │ 209.6    │ 0.0                │ \"No\"           │\n",
       "│ 4   │ \"Year 4\" │ 49.9 │ 0.0      │ 0.0                │ \"Yes\"          │\n",
       "│ 5   │ \"Year 5\" │ 60.4 │ 20.2     │ 0.0                │ \"No\"           │\n",
       "\n",
       "│ Row │ StadiumValueAdded │ MerchandiceSales │ SalarySpending │\n",
       "├─────┼───────────────────┼──────────────────┼────────────────┤\n",
       "│ 1   │ 0.0               │ 15.0             │ 94.2           │\n",
       "│ 2   │ 0.0               │ 15.0             │ 85.2           │\n",
       "│ 3   │ 0.0               │ 15.0             │ 94.6           │\n",
       "│ 4   │ 30.0              │ 15.0             │ 94.6           │\n",
       "│ 5   │ 30.0              │ 30.0             │ 94.8           │"
      ]
     },
     "execution_count": 21,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "313.5999999999999\n"
     ]
    }
   ],
   "source": [
    "printStadiumBuild(trial_1)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Initial Investment: 290.6\n"
     ]
    },
    {
     "data": {
      "text/html": [
       "<table class=\"data-frame\"><thead><tr><th></th><th>Season</th><th>EWA</th><th>Holdover</th><th>PresentValueProfit</th><th>StadiumUpgrade</th><th>StadiumValueAdded</th><th>MerchandiceSales</th><th>SalarySpending</th></tr></thead><tbody><tr><th>1</th><td>Year 1</td><td>30.5</td><td>0.0</td><td>0.0</td><td>Yes</td><td>0.0</td><td>15.0</td><td>90.6</td></tr><tr><th>2</th><td>Year 2</td><td>25.2</td><td>0.0</td><td>39.25</td><td>No</td><td>30.0</td><td>15.0</td><td>73.0</td></tr><tr><th>3</th><td>Year 3</td><td>42.6</td><td>0.0</td><td>29.35</td><td>No</td><td>30.0</td><td>15.0</td><td>81.4</td></tr><tr><th>4</th><td>Year 4</td><td>42.6</td><td>0.0</td><td>27.43</td><td>No</td><td>30.0</td><td>15.0</td><td>81.4</td></tr><tr><th>5</th><td>Year 5</td><td>42.6</td><td>0.0</td><td>35.25</td><td>No</td><td>30.0</td><td>15.0</td><td>68.8</td></tr></tbody></table>"
      ],
      "text/plain": [
       "5×8 DataFrames.DataFrame\n",
       "│ Row │ Season   │ EWA  │ Holdover │ PresentValueProfit │ StadiumUpgrade │\n",
       "├─────┼──────────┼──────┼──────────┼────────────────────┼────────────────┤\n",
       "│ 1   │ \"Year 1\" │ 30.5 │ 0.0      │ 0.0                │ \"Yes\"          │\n",
       "│ 2   │ \"Year 2\" │ 25.2 │ 0.0      │ 39.25              │ \"No\"           │\n",
       "│ 3   │ \"Year 3\" │ 42.6 │ 0.0      │ 29.35              │ \"No\"           │\n",
       "│ 4   │ \"Year 4\" │ 42.6 │ 0.0      │ 27.43              │ \"No\"           │\n",
       "│ 5   │ \"Year 5\" │ 42.6 │ 0.0      │ 35.25              │ \"No\"           │\n",
       "\n",
       "│ Row │ StadiumValueAdded │ MerchandiceSales │ SalarySpending │\n",
       "├─────┼───────────────────┼──────────────────┼────────────────┤\n",
       "│ 1   │ 0.0               │ 15.0             │ 90.6           │\n",
       "│ 2   │ 30.0              │ 15.0             │ 73.0           │\n",
       "│ 3   │ 30.0              │ 15.0             │ 81.4           │\n",
       "│ 4   │ 30.0              │ 15.0             │ 81.4           │\n",
       "│ 5   │ 30.0              │ 15.0             │ 68.8           │"
      ]
     },
     "execution_count": 22,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "printStadiumBuild(trial_2)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {
    "scrolled": true
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Initial Investment: 286.99999999999994\n"
     ]
    },
    {
     "data": {
      "text/html": [
       "<table class=\"data-frame\"><thead><tr><th></th><th>Season</th><th>EWA</th><th>Holdover</th><th>PresentValueProfit</th><th>StadiumUpgrade</th><th>StadiumValueAdded</th><th>MerchandiceSales</th><th>SalarySpending</th></tr></thead><tbody><tr><th>1</th><td>Year 1</td><td>25.8</td><td>0.0</td><td>0.0</td><td>Yes</td><td>0.0</td><td>15.0</td><td>87.0</td></tr><tr><th>2</th><td>Year 2</td><td>20.7</td><td>0.0</td><td>42.62</td><td>No</td><td>30.0</td><td>15.0</td><td>69.4</td></tr><tr><th>3</th><td>Year 3</td><td>11.4</td><td>0.0</td><td>61.84</td><td>No</td><td>30.0</td><td>0.0</td><td>44.2</td></tr><tr><th>4</th><td>Year 4</td><td>11.4</td><td>0.0</td><td>45.55</td><td>No</td><td>30.0</td><td>0.0</td><td>44.2</td></tr><tr><th>5</th><td>Year 5</td><td>11.6</td><td>0.0</td><td>52.18</td><td>No</td><td>30.0</td><td>0.0</td><td>31.6</td></tr></tbody></table>"
      ],
      "text/plain": [
       "5×8 DataFrames.DataFrame\n",
       "│ Row │ Season   │ EWA  │ Holdover │ PresentValueProfit │ StadiumUpgrade │\n",
       "├─────┼──────────┼──────┼──────────┼────────────────────┼────────────────┤\n",
       "│ 1   │ \"Year 1\" │ 25.8 │ 0.0      │ 0.0                │ \"Yes\"          │\n",
       "│ 2   │ \"Year 2\" │ 20.7 │ 0.0      │ 42.62              │ \"No\"           │\n",
       "│ 3   │ \"Year 3\" │ 11.4 │ 0.0      │ 61.84              │ \"No\"           │\n",
       "│ 4   │ \"Year 4\" │ 11.4 │ 0.0      │ 45.55              │ \"No\"           │\n",
       "│ 5   │ \"Year 5\" │ 11.6 │ 0.0      │ 52.18              │ \"No\"           │\n",
       "\n",
       "│ Row │ StadiumValueAdded │ MerchandiceSales │ SalarySpending │\n",
       "├─────┼───────────────────┼──────────────────┼────────────────┤\n",
       "│ 1   │ 0.0               │ 15.0             │ 87.0           │\n",
       "│ 2   │ 30.0              │ 15.0             │ 69.4           │\n",
       "│ 3   │ 30.0              │ 0.0              │ 44.2           │\n",
       "│ 4   │ 30.0              │ 0.0              │ 44.2           │\n",
       "│ 5   │ 30.0              │ 0.0              │ 31.6           │"
      ]
     },
     "execution_count": 23,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "printStadiumBuild(trial_3)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='3b'></a>\n",
    "### Section 3b: Building a Stadium Pareto Curve"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "This model naturally raises the question: how much does one need to invest in a team to obtain a winning team and a new stadium? Since the model requires the stadium be built, this question is really only about the relationship between the investment return and the team’s EWA over five years. We can understand this relationship with another tradeoff analysis. The results of this analysis are seen below:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 24,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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gdQfC69fv07jxo05fvw4zz33HAULFmTu3Lls2LAhXdt8N4mJibRs2ZL69evz3nvvMX/+fJ599ll8fX15/fXX6dGjBx06dOCTTz6hZ8+ehIeHU6xYsXuuNy4uzvpZv3btGlu3bmX27Nl0797dJpHNaE899RTz5s2je/fu1K5dmw0bNtCqVav7Wuft32nJZs6cSVxcHP3798fT05M8efJw/fp1IiIiOHz4MM8++yzFihUjOjqa3r17c/HiRYYMGWKzjjlz5nDlyhUGDRpEXFwckyZNolGjRuzdu9e636RkzJgxvPHGG3Tu3JmnnnqK8+fP8/HHH1O/fn27Y8M///xD69at6dq1K506dSIqKoquXbsyf/58nn/+eZ5++mm6d+/O+++/z2OPPcaJEyfIlSvXfb1nOZohOcbMmTMNwFi/fr1x/vx548SJE8bChQuNoKAgw9vb2zh58qRhGIYRFxdnJCYm2jz3jz/+MDw9PY3Ro0dbyzZu3GgARvHixY3Y2Fib5d966y3D19fXOHjwoE35q6++ari6uhrHjx83DMMwzp8/bwDGiBEj7OKtUqWKkS9fPuOvv/6ylv3yyy+Gi4uL0bNnz7tu62effWYAxvjx4+0eS0pKsol/48aNdtsKGDNnzrSW9erVywCMV1991W5dhQoVMjp27GhT/uWXXxqA8d133xmGYRhXrlwxAgMDjX79+tksd+bMGSMgIMCu/HbJMb3//vs25e3btzc8PDyMI0eOWMtOnTpl5MqVy6hfv761LLnu69ata9y8efOur3Xr693ptn37duuyL730kgFY95/PP//c8PLyMuLj442VK1carq6uxuXLlw3DMIzJkycbgLF161ab1zt79qzh5uZmTJ8+3VpWu3Zto127dveMNbV1sGTJEgMwduzYcc913q5BgwZG2bJljfPnzxvnz583fvvtN+O5554zAKNNmzaGYRjGjRs3jHz58hkVK1Y0rl+/bn3uihUrDMB48803rWXJ+9PgwYNttqNVq1aGh4eHcf78ecMw0raPjhgxwrj9kH3759IwDKN58+ZG8eLFbcrCwsIMwFi9erXd8mFhYUavXr2s96Ojo1OMKTEx0QgNDTW6dOliUz5+/HjDYrEYR48etVv3rXr16mWEhYXZbWNQUJDx999/W8uXLVtmAMby5cvvur59+/YZ3t7eBmBUqVLFGDJkiLF06VLj2rVrdstWqFDBaNCggV15ao+FEydONADjyy+/tJZdu3bNKFmypN17dft2puc49M4771jL/vnnH8Pb29uwWCzGwoULreW///77HY+tt7vT57x9+/ZGXFyczbK37w/JGjRoYPMepmYf3b17twEYAwcOtFlX9+7dUxV78muMGjXKOH/+vHHmzBlj06ZNxsMPP2wAxldffWWznL+/v3Hu3DmbdSTX3bx586xlN27cMMLDww0/Pz/rsSt5Hbd+VxqGYfzwww8GYAwdOvSO23ns2DHD1dXVGDNmjM1r792713Bzc7Mpb9CggQEYCxYssJYl16WLi4sRExNjLV+zZo3deyz21LUgB2rSpAl58+alcOHCdO3aFT8/P5YsWUKhQoUA8PT0tPZxTUxM5K+//sLPz48yZcqwa9cuu/X16tULb29vm7Lo6Gjq1atH7ty5uXDhgvXWpEkTEhMT+e677+4a4+nTp9m9eze9e/cmT5481vLKlSvTtGlTVq5cedfnf/XVVwQHBzN48GC7x+5nWJRnnnnGbl2dOnVi5cqVXL161Vr+xRdfUKhQIWvL47p167h48SLdunWzeT9cXV2pWbMmGzduTHMsiYmJrF27lvbt21O8eHFreYECBejevTtbtmyxdvNI1q9fP2sLcWr079+fdevW2d3Kly9vXSZ5G7///nvA7FZQrVo1PDw8CA8Pt3YnSH7My8vLbsSFhQsX4uLiQseOHa1l3bp1Y9WqVfzzzz93jTG1dZDc4rFixYoUT3/fy++//07evHnJmzcv5cqV4+OPP6ZVq1Z89tlngNlt4dy5cwwcONCmb2CrVq0oW7asTct0slsv3LNYLDz77LPcuHEjw04X3vq5vHTpEhcuXKBBgwYcPXqUS5cu2SxbrFgxmjdvnu7XcnFxoUePHnz99ddcuXLFWj5//nxq166dqlbBlHTp0oXcuXNb79erVw8wW0vvpkKFCuzevZvHH3+cY8eOMWnSJNq3b0/+/PmZPn16ql47tcfClStXUqBAAR577DFrmY+PD/3790/1dqbFU089Zf0/MDCQMmXK4OvrS+fOna3lZcqUITAw8J7vU7J27dpZP9/Lli1j+PDhrF69mu7du9uNSpJRko/jzz33nE35888/n6b1jBgxgrx58xISEkJERARHjhxh3Lhx1rN8yTp27GjtznZrDCEhITbXh7i7u/Pc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OXXqlHWIJDBHzUhp9rrbZeRxKKMtX74cgIceeshaVqJECWJiYrhx44a1bMWKFXbDSKVGy5YtAfjoo49syidOnJiecNMlMjKSM2fO8MUXX1jLbt68yccff4yfnx8NGjSwWX7p0qU29f/jjz/yww8/WLclJR06dMDV1ZVRo0bZ7U+GYVi7U0nmUIusE2rdujWjR4+mT58+1K5dm7179zJ//vw0/dp+6aWX+Prrr2ndujW9e/emWrVqXLt2jb1797Jo0SKOHTtmHcuzfPnyfPHFF5QuXZo8efJQsWJFKlasyPvvv0/Lli0JDw+nb9++1uG3AgIC7jkHd8+ePZkzZw7Dhg3jxx9/pF69ely7do3169czcOBA2rVrR0BAAJ06deLjjz/GYrFQokQJVqxYcc/+uympWrUqJUuW5PXXXyc+Pt7mlDaYfWCjoqJ44oknqFq1Kl27diVv3rwcP36cb775hjp16qSYdN/L22+/zbp166hbty4DBw7Ezc2NadOmER8fz3vvvZfm9d1u165dzJs3z668RIkShIeHW+8nt7Ju377dbozJ0qVLExwczPbt26lUqZLNMDM//PCDddiblBQqVIiqVasyf/58XnnllbvGeq86mD17NlOnTuXRRx+lRIkSXLlyhenTp+Pv73/PH0ap4e7uzrhx4+jTpw8NGjSgW7du1uG3ihYtytChQ22W9/LyYvXq1fTq1YuaNWuyatUqvvnmG1577TXrD4H72UebNWuGh4cHbdq0YcCAAVy9epXp06eTL18+m9bItKpSpQqurq6MGzeOS5cu4enpaR2rFswzBS1atCA6OprAwMD7HkopvcaNG8fOnTvp0KGDdUi/Xbt2MWfOHPLkyWNzQVG1atWIiori7bffpmTJkuTLl49GjRql+ljYr18/Jk+eTM+ePdm5cycFChRg7ty5qZopMSOPQ/fj4MGD1s96bGwsMTExzJ49m5IlS/LEE09Yl3vqqadYtGgRLVq0oHPnzhw5coR58+ala0jDKlWq0K1bN6ZOncqlS5eoXbs23377LYcPH86w7bqX/v37M23aNHr37s3OnTspWrQoixYtYuvWrUycONFuWKuSJUtSt25dnnnmGeLj45k4cSJBQUF37EYH5vHy7bffZvjw4Rw7doz27duTK1cu/vjjD5YsWUL//v158cUXM3tTnZcDRkqQTJI8BNO9hh+K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",
      "text/plain": [
       "PyPlot.Figure(PyObject <matplotlib.figure.Figure object at 0x000000003D657A20>)"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "r = 1.07 #Present value of currency rate\n",
    "\n",
    "Npts = 30\n",
    "J1 = zeros(Npts) #Tradeoff Parameter for profit gained\n",
    "J2 = zeros(Npts) #Tradeoff Parameter for EWA\n",
    "for (l,λ) in enumerate(linspace(0,1,Npts))\n",
    "    (x, hold, p, stadium, initial_investment) = stadiumBuild(λ)\n",
    "    J1[l] = sum(p[seasons[k]]/r^(k-1) for k in 1:5) - initial_investment\n",
    "    J2[l] = sum( x[i,j,k] * data[i, \"EWA\"] for i in playernames, j in positions, k in seasons)/5\n",
    "end;\n",
    "\n",
    "figure(figsize=(8,4))\n",
    "plot( J1, J2, \"b.-\" )\n",
    "xlabel(\"J1 Return\")\n",
    "ylabel(\"J2 EWA\");\n",
    "title(\"Pareto curve for EWA vs Popularity in Stadium Build Problem\")\n",
    "grid()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here J1 Return is the total profit over the five year period minus the initial investment. This is essentially the amount of money from the initial investment that remains with the team and is not removed as profit. This return or loss is defined from the owner's perspective.\n",
    "\n",
    "From this chart, we can see that the organization will always lose money within the five year time horizon. However, the organization can lose less money if they sign players that have lower EWAs and salaries and therefore can pull more money out of the team as profit. In theory, a team that has more popular and high EWA players will have more merchandise revenue. This is likely why the first part of the pareto curve is flat; we shift towards signing more popular players that give higher merchandise revenue that helps offset their high salary, thereby allowing us to increase our return. \n",
    "\n",
    "However, after this it is hard to win games if you are unwilling to pay your players a competitive salary.\n",
    "\n",
    "The team recieves diminishing returns on EWA for each additional dollar invested into the team by the owner. Perhaps the best decision with regards to optimizing EWA is to take an approximatly \\$220 million loss. Any further investment does not significantly affect the team EWA. This is likely due to the result of the salary cap. If none existed we might see EWA continuously increase with increased investment."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='Limitations'></a>\n",
    "## Model Limitations"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "While we believe that while the models presented provide interesting insights to develop the Suns, they do have limitations.\n",
    "\n",
    "One limitation of these models is that they rely heavily on the accuracy of the data. Since all of our data for player statistics are point estimates, they have no notion of uncertainty or variance. If a data point deviates from its point estimate, that point can dramatically alter our set of feasible solutions, which affects the optimal solution. \n",
    "\n",
    "The optimization models presented in this report are deterministic and will produce the same solution(s) for a set of parameters. However, this is not always reflective of reality. In reality, the systems described in this model have some element of stochasticity/randomness. This randomness vary in how it manifests in the system, from players going on a 'hot streak,' to national or global macroeconomic factors affecting the financial health of the team. This example is dramatic, but it points out the degree to which events that could occur can dramatically alter our optimal decisions.\n",
    "\n",
    "Another limitation of the models, particularly the model in Section 3, is that they do not fully capture the full complexity of financially supporting a team. For example, we assume that a team's merchandise revenue is linearly related to it's players' popularity. However, this is likely not the case, given the complexity of consumer economics."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id='Conclusion'></a>\n",
    "## Conclusion"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If awarded this contract, BK&S has several ideas for future work:\n",
    "\n",
    "* We would like to rerun our models with the Suns official team data sets to ensure our results correspond to the most accurate data available.  \n",
    "\n",
    "\n",
    "* We would like to run our k-means clustering MINLP with a full KNITRO solver license for all players  in the league instead of our random set to more accurately determine their paygrade. \n",
    "\n",
    "\n",
    "* We would also like to expand our network flow and assignment models to capture more of the nuances of team ownership and management. Currently our models highly simplify the complications in NBA cap and contract rules and are unable to take advantage of the nuances of these policies.\n",
    "\n",
    "\n",
    "* We would like to address the shortcomings of our models as relating to talent evaluation, ability changes over player careers.\n",
    "\n",
    "\n",
    "* We would like to construct more advanced merchandise and popularity models to more accurately reflect the relationship of these metrics to revenue. \n",
    "\n",
    "\n",
    "* We would like to add the concept of player time to our model.\n",
    "\n",
    "For instance, a brief plan to implement our last point is the following:\n",
    "\n",
    "Since different players on a team have different productivity, it is important to consider how much playing time each player on the roster should get. However, it is important that the players with the most productivity are not constantly playing for each game and have adequate breaks (during games and between games).  We could consider this as a scheduling problem, with 82 games that we need to schedule players for, and the sum of each player’s playing time in each game must equal the length of the game. This problem would have constraints related to how many minutes in a game a player can be on the court, how many games back to back in which he can play over a certain number of minutes, among others. This type of problem would require close collaboration with the coaching staff and could help reduce the injury rate of Suns players.\n",
    "\n",
    "\n",
    "We at BK&S are confident that our models will be indispensable to the Suns organization as the Suns prepare to improve their eminence in the NBA. We have demonstrated a new way of valuing players that cuts through the randomness that accompanies player salaries using a MINLP to find the optimal paygrades for players. We have also demonstrated how to optimize a team roster for various player statistics over a five year horizon. Finally, we have shown differing investment strategies for building a new stadium within the next five years. \n",
    "\n",
    "We hope our project proposal meets the needs of the Suns organization. We look forward to the possiblity of firmly establishing the Phoenix Suns in a place of respect around the league.\n",
    "\n",
    "Sincerely,\n",
    "\n",
    "&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;B, K, & S Consulting\n",
    "\n",
    "\n",
    "\n",
    "\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Appendix\n",
    "\n",
    "<a id='Footnote'></a>\n",
    "\n",
    "[1] CHANGING THE GAME: The Rise of Sports Analytics. (n.d.). Retrieved May 6, 2018, from https://www.forbes.com/sites/leighsteinberg/2015/08/18/changing-the-game-the-rise-of-sports-analytics/#761010184c1f\n",
    "\n",
    "[2] Data analytics have revolutionized the NBA — Quartz. (n.d.). Retrieved May 6, 2018, from https://qz.com/1104922/data-analytics-have-revolutionized-the-nba/\n",
    "\n",
    "[3] How can K-Means be Reduced to Integer Programming. (Febuary 15, 2016). Retrieved May 6, 2018, from https://cs.stackexchange.com/questions/29638/how-can-k-means-be-reduced-to-integer-programming"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Julia 0.6.2",
   "language": "julia",
   "name": "julia-0.6"
  },
  "language_info": {
   "file_extension": ".jl",
   "mimetype": "application/julia",
   "name": "julia",
   "version": "0.6.2"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}