BatterySimulatorBLAST/python/simulation_with_custom_prof...

313 lines
164 KiB
Plaintext

{
"cells": [
{
"attachments": {},
"cell_type": "markdown",
"metadata": {},
"source": [
"### Battery life model library\n",
"Example notebook demonstrating how to use the battery life models in Python.\n",
"\n",
"First examples use the Kokam NMC111|Gr 75Ah battery life model. The battery modeled here is a high-power cell with long cycle life. Because nominal cell resistance is low, the relative change of resistance at end-of-life is quite high compared to other cell designs (~300% increase in cell resistance at 80% capacity if not more). Fade rates can be changed in the code to accomodate other cell models. Documentation is provided in the life model class. See https://ieeexplore.ieee.org/abstract/document/7963578 for the aging test details and results used to parameterize this model."
]
},
{
"cell_type": "code",
"execution_count": 1,
"metadata": {},
"outputs": [],
"source": [
"import numpy as np\n",
"import matplotlib.pyplot as plt\n",
"from nmc111_gr_Kokam75Ah_2017 import Nmc111_Gr_Kokam75Ah_Battery\n",
"from battery_profile import BatProfile"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We instantiate a BatProfile and apply the methods in the specific order to process the intervals for both soc and temperature"
]
},
{
"cell_type": "code",
"execution_count": 2,
"metadata": {},
"outputs": [],
"source": [
"profile = BatProfile()\n",
"profile.init_intervals()\n",
"profile.preprocess_soc_intervals()\n",
"profile.temp_sequence_generation()\n",
"profile.process_soc_time()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"After the pre-processing done earlier, we can execute `generate_day_values(number_of_discharges)` to generate curves"
]
},
{
"cell_type": "code",
"execution_count": 3,
"metadata": {},
"outputs": [],
"source": [
"soc_day_sequence, temp_day_sequence, time_day_sequence = profile.generate_day_values(4)"
]
},
{
"cell_type": "code",
"execution_count": 4,
"metadata": {},
"outputs": [
{
"data": {
"text/plain": [
"[<matplotlib.lines.Line2D at 0x7fb0bbb44820>]"
]
},
"execution_count": 4,
"metadata": {},
"output_type": "execute_result"
},
{
"data": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAAAh8AAAGdCAYAAACyzRGfAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjcuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8pXeV/AAAACXBIWXMAAA9hAAAPYQGoP6dpAABgwklEQVR4nO3deZwU5Z0/8E/1Od1zAQIzjByCIV54BQyKbsAD3Ii5jEYBDcZNolETSXaDMZrNaCIYsnHZDYn5abKGrCLqesQYTcAkogYPlKCItyIgMA7gMPd0T3fX74+nn+rqnu6ePurorvq8X695OUfbXVRXV33r+3yf76OoqqqCiIiIyCIeuzeAiIiI3IXBBxEREVmKwQcRERFZisEHERERWYrBBxEREVmKwQcRERFZisEHERERWYrBBxEREVnKZ/cGZEokEtizZw/q6+uhKIrdm0NEREQFUFUV3d3daGlpgceTP7dRccHHnj17MGHCBLs3g4iIiEqwa9cujB8/Pu9jKi74qK+vByA2vqGhweatISIiokJ0dXVhwoQJ2nU8n4oLPuRQS0NDA4MPIiKiKlNIyQQLTomIiMhSDD6IiIjIUgw+iIiIyFIMPoiIiMhSDD6IiIjIUgw+iIiIyFIMPoiIiMhSDD6IiIjIUgw+iIiIyFIMPoiIiMhSDD6IiIjIUgw+iIiIyFIVt7CcWWLxBG5+7HVTX+Oso5pw6sdGm/oa+URjCfz6mfewrzti2zZUkmNaGnH+9PzLOpdi6wedeHjLbiRU1fDnNlPI78XiWYehqaHG8te+67kdeHdfj+WvWw6vouC8T4zH0S3WL3D53r4e3LtpF6LxhOWvTe7g8yi4fv7R9r2+ba9ssYQK3Pn39019jT+8vBcv3nCWqa+Rz5NvtmPFn9607fUr0YkTR+DwMXWGPucPH3kVm3ceNPQ5rRJLqPj+OUdZ+ppvf9iNGx5+1dLXNMpre7uw5msnW/66P1v3Fv64da/lr0vuEfB5GHxYwaMAV51+uCnPPRhXcftT72F/TwQDg3HU+L2mvM5w9vWIjMeUMbX49LRmW7ahUvzib+8CAJ5/7yPDgw+5n8+fPh5NDUFDn9ssL+/qxDPv7LclKyZf85DaAC765ATLX78Uew4O4KF/7Mb+HnuyiLs6+gAA5x43DpMOCduyDeRsXo+9VReuCT58Xg++e/aRpjy3qqr47cb3EY0lsL8ngvEj7TlZ9AzEAAAnjB9h2r+1WrR1RvDA5g/Q2T9o+HPL/fz1T03Bx5vqDX9+M6x5fieeeWc/upPbbqXuiHjNiYeEq+a43PpBJx76x25b9hcAtHeJoOdr/zQFx08YYcs2EJmJBacGUBQFY+rEHXC7jfUW8kRZX+OamDKncEBkn/qjxl48VFWtyv0st7V7wPhgbDip/eW3/LVLVZfcXz02BB+JhKplXMZWSWaNqFgMPgzSEBInVjtOVlJPpPpO8maRwUdfNG7o80ZiCcQSotC0mvazDD7kMWKlnmTAU43BWk80hkTC2sLij/qiiCVUKAowuo7BBzkTgw+DmHWxK0ZX8iRfV0UnebOE5PsxaOz7IfexogBhm2p7SpHKfNgw7CIzH8HqOS7rktuqqiIAsZIcchkVDsDv5SmanIlHtkFSwYeNmY8qHA4wi/Z+GHynL/dxXdAHj0cx9LnNJLM0tmQ+ItV3XNb4vfAl39++iLU3FO3dAwCAMfXMepBzMfgwSCVkPrp1F0a3CwfEPjD6/ajGu3ggdUx0DwxCtbg/SZd2XFbPMBWQyp71G5w9G46sGxtrQz8WIqsw+DBIrXaxs7/mo6GKahHMEjbpwlGtdTUy6zAYVxGJWdu4qhozH4BoygYA/RbfUMipyWOZ+SAHY/BhkFBFZD5Y8yGZlYmq1n1cG/BBSY4SWV33Ua37LJX5sLrmQwy7MPggJ2PwYZDaoDlp/mJU6x2mGUJmD7tU2T72eBTUBeyZ8SLrZBqqbJ+lMh/WZoramfkgF2DwYRB5orJz2KWLNR+aWpMKgKu5rqbOpl4f3VVe82H1Z5o1H+QGDD4MUhuUsyvsyXxEYnFEk2P51VaPYAazhsGqsWGWZNd02+4q7PMB6DIflhecctiFnI/Bh0HMSvMXSt/crBrvyo0mZ7sYXSzYE6nOCymQCpgsDz6SwzzVVvOR6pJr3WdaVVVdwSkzH+RcDD4MItP8vTYNu8gLSm3AC28V9Z8wi77vipFTS6t1qi2QPt3WKomEWrW1SDU2ZD66IzEMDIoMJlurk5Mx+DCIHXdJetU6BdQsctglocLQqaXdVXohBexpsd43GIeM/aptCrhZ07Xzkd1N62t8tq2OTWQFBh8GkcMuvTYFH2ytnk7f+tzIoTCteLLKLqSAPTUfMsvi8ygI+qrrdGNHnw/We5BbVNfZoILVmrSKaqHYWj2dz+tBIHmxM3K2QjUukibZ0WJdf1wqSnUNB9bYkM1kvQe5BYMPg4S0mg97Mh/VPAXULGYMhbHmozja9O8qDNbC/mQRuQ3DLqz3IKdj8GGQWpNmVxSKrdWHCvuNn25bzbU1dgy7aPurynp8AEAoIE6PAxx2ITIcgw+DhHWzXaxeuAvQtbCuwjtys4RN6DrbXcV38qnMh/U1H9W4v0ImBK/DaeewC7kEgw+DyAudavDsikJVa9tvM4UN7lAZr+Jpo4C+z4d1wy7dVdpaHbBnqi2HXcgtGHwYJKSbXdFr8doZQPU2cjKT0Xeu+h4u1ZhhsmOqbU8V1yLJguXBuHU3E3LYZQyHXcjhGHwYxOtRUOOXsyusr/uo5rbfZjG64FTu44DXU5U9GOycaluNx6WcGhy1MJPJYRdyi6KCj1gshhtuuAGTJ09GKBTClClTcNNNNyGRSH04VVVFa2srWlpaEAqFMGfOHGzbts3wDa9EYRtbrGtTQKvwDtMsqffDmIttTxXXewC6qbZWBh9VnJHze63NfAwMxrXAkMMu5HRFBR8/+clP8Ktf/QqrVq3C66+/jhUrVuCnP/0pfv7zn2uPWbFiBW699VasWrUKmzZtQnNzM+bOnYvu7m7DN77SGF1jUAzWfAylvR8GjdlX6wJpkhz66InGkEhYUxRdzcelHHaxqoZL1nvU+D28iSDHKyr4ePbZZ/G5z30O8+fPx2GHHYbzzz8f8+bNw4svvghAZD1WrlyJ66+/Hueddx6mTZuG1atXo6+vD2vWrDHlH1BJwiatpFqIap4Cahbt/TBopeFqbq0OpLZbVa1bg6iniocDA8nMR9SizEdqmm1N1TVkIypWUcHHaaedhr/85S946623AAAvv/wynnnmGZxzzjkAgO3bt6OtrQ3z5s3T/p9gMIjZs2dj48aNWZ8zEomgq6sr7ata2TnsUs1TQM1i9ErD1d7ILejzwO8VFzWr6j66I9U7HOi3uOBU1nuw2JTcoKgzwrXXXovOzk4ceeSR8Hq9iMfjuPnmm7FgwQIAQFtbGwCgqakp7f9ramrCjh07sj7n8uXLceONN5ay7RXHzmEX+ZpyG0i/MJgx70e/to+r70IKAIqioL7Gj496o5bNeJGBX6gKj0st82HZsAsbjJF7FJX5uPfee3HXXXdhzZo12Lx5M1avXo3/+I//wOrVq9Mel5kyVFU1ZxrxuuuuQ2dnp/a1a9euIv8JlcPOzIc8QVbb4l1mksFHl0F3+U7Yx1a3WK/mfZaaamtNfUxqpguDD3K+om7hvvvd7+J73/seLrroIgDAscceix07dmD58uVYvHgxmpubAYgMyLhx47T/r729fUg2RAoGgwgGnfFh07qc2tDnQ45LB6rwJG+WlhEhAMDz731kyPPJwsNq3sdWT7eNVvE+szzzIYOPBk6zJecr6ozQ19cHjyf9f/F6vdpU28mTJ6O5uRnr16/X/h6NRrFhwwbMmjXLgM2tbLVB61fBBIBEQtXuzuQJk4Dpk0YCAPb3RAxpea8FeFW8j61usR5xQObD6uCDNR/kBkVlPj7zmc/g5ptvxsSJE3HMMcfgH//4B2699VZcdtllAMRwy5IlS7Bs2TJMnToVU6dOxbJlyxAOh7Fw4UJT/gGVJJRcBdPqlW311fjVeIdpFn2QkFABb5kTCCKD1XsXL6VarFub+Qj6qq/mw6+b7TIYT2g/m4U1H+QmRQUfP//5z/GDH/wAV155Jdrb29HS0oLLL78c//7v/649ZunSpejv78eVV16Jjo4OzJw5E+vWrUN9fb3hG19pUpkPa4dd9H0IqvEkbxaPJxVtxBMqvJ7yog8Z5FXzPk61WLeo5qOKhwPl5xkANry5D2cdnX3o2Cj72N2UXKSo4KO+vh4rV67EypUrcz5GURS0traitbW1zE2rPiFtZVuLMx+64MNf7u29g+iDjYQRwy5VXL8gWV3zEUk2eKvGYZdwwAePIrJm+3oipr7WYDyBj/qiANjdlNyh+s4IFaw2OdvF6pqPSEy8XsDnYXMiHa+Snvkol34/VyvLC06rOPMBAJ89vgWA+S3pD/REoaqAz6NgVDhg6msRVYLqPCNUqFTmw9phF21cvYoLIc2gz3zEDcx8VONdvFQXtK7mwwmF0KkaGXOHqWR309F1wbThQiKnqs4zQoWqtanPh1aL4OfbqZcWfBjQq8EJwYeVNR/6QuhgFa4CDKQ6BnebPH1eruvCIRdyi+o9i1YguzqcarUIVXp3aRb9DaQhmY8qH0IArB120RdCV+uxadX+YoMxcpvqPCNUKLsWlpOvV1OFLazNpCiKFoAYsYqrtp+r9C4e0Gc+zA8+ZO2T16NUbSF0KPleDxi0MnIuXclhncYQ6z3IHRh8GEhrr27QKqqF6q7ilUPNJodejMh8yP3cUMWL91lZ8yHrJOprfFVbCO1LZmxiJrdYd8JMKqJi8Eg3UDhoz7BLTxWvHGo2GXwYcfHo0Va1rd4gLzWMYH7Nh6yTqNZVgAHAL4+fhLldTp1QT0RUDB7pBrJr2CWV+ajek7xZ5HRbI/p86O/kq5WV7dWdkJGTmQ+zF5eT07gZfJBb8Eg3kBx2iSVUy9aDABh85COnLRrR50PeyVfzfm5IBgKRWML0Y1Rmiqo5IydrVazKfHDYhdyCR7qBwrqCTyuHXrodMBxgFjnsUm7mI5FQtSLNuioOPvQtw80uOnVCpkgeP2ZnPpywaCFRMXikG8jv9WgnDyuHXrSajyo+yZvFp2U+ynuevsE4ZPzSUOXDCDJINrvuo8cBmSJfchVvIzJn+chFC9mrh9yCR7rBQjb0+uCwS24exZi0ubxQ+zxK1Y/LW9W7omug+jNF2rBLudHrMCLMfJDL8Eg3WK0NRac9DD5y0oZdyrx26AO8ap02KllVdNrDgtOCpWo+qreHDFExGHwYTFvfxcJeH6z5yE1mPsrt89HtgLt4SQYDVtV8cKrt8CKcaksuwyPdYLXJE23/oHXDLl0OKOwzy+6D/QCA32/ZXdbzaMWTDgjwrOr14YSmbFY0GXunvRtPvbUPAGe7kHvwSDeYbMdsZebDCYV9Zrvz7++X9f87aR9bVfPhhNlB2mwXEzMfz757QPv+mJYG016HqJIw+DCYnEnQb2HNBwtOzeekfSyHQSybalvF2SJZcGrEqsi5yMLc+ceNw5Qxdaa9DlElYfBhsHDyxN5r0WwXVVV1d+XVe5KvdE4onpTkv6HL7GEXB2Q+5FTbQROn2srPL1e0JTdh8GGwsN/a2S79g3GtB0E1F/ZVOicUT0pa5sPkYRcnZIusmGqbasZW/YEtUaEYfBhMFpxa1edDXkA8SnqHVTKWE1qrS5bVfGjt1av3ompFwakT2tATFYvBh8FCFvf50Bo5Bau//0Qlc9ZUW/NrPgbjCfQPxtNerxrJzEfU1MyHcwJbokIx+DCY1mTMotkurPfI778XnAig/CmMTkqNy3+DmVNte3WBTTUHbLXJxSIjsQQGTQpAnFAbQ1QsBh8GCyVPVn2D1gQfTli8y0yfPGwUALEwXDlkkFfNPSskK4Zd5HPX+D3wV3HLcH1AYFaNTLeDipmJClW9Z4UKlcp8WFvzweAjO5nxiCXUshYH69YNb1U7K9qrO6Xrrt/r0Xr3mDVM5aRiZqJCMfgwmNU1H7xryk/frlqun1EKJ061NbPmQ15QnZApktkPs6YmOymrRlQoBh8Gk2PEVs126eJdU14Bg4KPLgdlPvQFp2qZa97k4qQiSvlv+NOrbYY/t6qqvIEgV2LwYbCwxZkPJ7X9NoPPoyDZIRuReOnvSU/EObU18t8QT6imHadOaK0udfaJ935/T8Tw5x4YTKT69DhgXxEVisGHwcJanw9rh1144spOURQt+xEZLC3zMRhPYCD5/zoh+Aj5vdqaJWbXMVRzjw/p65+aAiC18qyR5H5SlFS9GJEbMPgwWCrzYW3BaQNTtjkFkrMtSu3VoJ/l4IRhF0VRdEWn5tQxOGn6qKwbMiX4iKSG89inh9yEwYfBrB526Y6w5mM4weRshVJrPmR2KeT3ah0vq53ZM16cVPMR8JV3/OTTzZsHcilnnEkrSFjXlKicqZ2FctJJ3ixa5qPEi0eXA3upmN3rw0ktw+WwnRnBR4+DCpmJisHgw2D69VWsWNnWSf0nzBL0i8N8oMTGb04s6jW7xbqTOsJqNUMx47OZbBJIbsXgw2BBn0dbD8LsVUMBtlcvhAzMSg0GU0W9ztnHNcmhKDMuqICzZrsETcx8OKk2hqgYDD4Mpi/mM7OJk8Q7p+GVO8Qgp9k6qQlUuUNRw+ly0HCgNuxiwtou7PFBbsXgwwRWLNwlsb368GQw2FVi8OHEoS0z6xgAZ9UyBE0M1HjzQG7F4MME9TXlXewKFU+o6I3KZct555SL1k68zODDSReIgInTR4HULCwnHJdm7isnFeYSFYPBhwm0YReTgw/9sI4T7jDNUm5PC6cskqZnZu8KwFkZuaAFU22dsJ+IisHgwwSpYRdzgw95MQ36PGlrmFC62mB5vVec1FpdMnPYJX29kurfZ6GA2Fdm9O7piThneIqoGLximSA1jdHcmg8nneDNFPAm71xLLBh04n4ud5/kMzCYQEyuV+KAi6rMeJmxEF+Xg6YkExWDwYcJzG7gJHGabWHKXdvFSUMIUrn7JB9Z7yHWK6n+faZfiK+/xF4xuThpSjJRMRh8mMCq4EMOuzjh7tJMwTKnSjpxOmRqn5jROCs1lODxVP96JeGAV1sZ2eg6Lidm1YgKweDDBDJNmxl8DAzGcd+mXXh8615D0rc8cRUmVd9Q2oW2y4FBnhUtw50yg0Pfu6eta8DQ507tK+cEtkSFYPBhglw1H7/fshtLH3gF37h7M7bu7iz7dZzUyMlM5U6VdGJ7dZn5GDBh2MWJdQxyxdlHX9lr6POyzwe5FYMPE+Qadtl9MHXXtOdg+XdQbZ39AICmhpqyn8vJym2P7cQMk9Zy3oQuvHs7xbE9tiFo+HPb5dARIcOfM71Pj3OOLaJCFBV8HHbYYVAUZcjXVVddBUBMsWttbUVLSwtCoRDmzJmDbdu2mbLhlSzXol368WIjWq/vTQYw4xqNPzE6STnBh6qqjizslQWO3WYEH8njssVBx+WcI8YAAAYNnB2U1qeHwQe5TFHBx6ZNm7B3717ta/369QCACy64AACwYsUK3HrrrVi1ahU2bdqE5uZmzJ07F93d3cZveQXL1edD3+TKiNbre5KZj5YRzHzkU87aHP2DccQdNG1UMrMXzV7tuHRO8OFLtliPxY2baivPAQGfR2tkRuQWRQUfY8aMQXNzs/b16KOP4vDDD8fs2bOhqipWrlyJ66+/Hueddx6mTZuG1atXo6+vD2vWrDFr+ytSqqNmZvChy3wYcNLfw8xHQWRPi1Kmlcr3yetREA445wJhZi+aPclhl3EOCor9yekusYTxmQ+nFOYSFaPkmo9oNIq77roLl112GRRFwfbt29HW1oZ58+ZpjwkGg5g9ezY2btyY83kikQi6urrSvqpdquYj/cSuT7Pe/tR7Zb1GIqGiTZ7kG51zkjdDOZmPp9/eD0AElLLo0AnqcwTIRth7MJn5cFBQLDMfg4ZmPpxXS0RUqJKDj4cffhgHDx7EpZdeCgBoa2sDADQ1NaU9rqmpSftbNsuXL0djY6P2NWHChFI3qWLIzEcklkBMd8HTByPltkPvjsS0i+mYeucU9pkh5Jft1Yu/0L67rwcA0Nlv/grFVtIvtmd0184DvVEAzjou/d5k5sPAmg/Zrj3kgEZsRMUq+Qr4m9/8Bp/+9KfR0tKS9vvMu0NVVfPeMV533XXo7OzUvnbt2lXqJlWMkC4936friKgv7iu30E9mUQJeD2r8zhkOMIM2xFDCXb68O7369I8Zuk12kwWOsYRq+HRbJ3aE9WrDLsYFarIAOsh1mciFSjo77NixA0888QQefPBB7XfNzc0ARAZk3Lhx2u/b29uHZEP0gsEggkHn3CEBIiDwehTRjjkaR0OW4r5oLIFILF5yoRn7AxROXmh7o6J41FtE1025nxtDzpnpAgC1ya6dCVW0Qw8ZVM8yMBjXMnJOOjbNKDiNJJvecVFIcqOSjvo777wTY8eOxfz587XfTZ48Gc3NzdoMGEDUhWzYsAGzZs0qf0uriKIoCPuHrqSaeeddTtGp1sLaQSd4s+gvgsVOcXZigzEgvWunkXUf8rmcsq6LZEbBKTMf5GZFH/WJRAJ33nknFi9eDJ8vdXJRFAVLlizBsmXL8NBDD+HVV1/FpZdeinA4jIULFxq60dWgJpBeZzAYTwxZlKqck74TU9tmCfq82t1lscFHl4ODPFn3sdeAhneStlBawBnrukhmFJwy+CA3K/qM+sQTT2Dnzp247LLLhvxt6dKl6O/vx5VXXomOjg7MnDkT69atQ319vSEbW03ktMz+ZOZDn+UYXRfA/p5oWY3GtBbWXBOiIPVBHw7EoslhlMJnYaSCPOftZzn89PCW3Tht6mhDnlNb7NBhwZpWcGpk5iM5PMVhF3Kjos8Q8+bNy1kdrygKWltb0draWu52Vb1QxrCLDDRq/B6MCIvgo6uMRmNcirs4wRKXkJfLwzupwZg06ZAwdn7UByMTFE7NyPk8xmc+5LEY8DL4IPfhUW8SLfORHGrRL7YlL2RG1Hw47SRvlmAyGCy214d8jxocuJ9nf1y0DDdyZdsuh2aKtNkuBk61lcciu5uSGzH4MEk4WWyXOexSH/TlXHiuGE5bttxs8u6ymAutqqq6IM9ZF1OgvOZruWgZOYcdl3LYJW7gVFu5yjKHXciNeNSbJBRIH3bRZypyLTxXjG4HLltupkAJi8tFYgmtr4MTh7dKCciG49Qp4GYWnDL4IDfiUW+ScMZsF32NhiwSLWdxuW7WfBRFnuBlb4VCyKEyMW3Ueanx1D4xMvhw5nCgGVNt7/z7dgAMPsideNSbJHO2S7dudkq9AcuZO/Ukb5ZgCRdarZeKw9Z1kWStgZHBR6ovirMyckG/OH6M7AbbkGxc57QhKqJCMPgwScgvTih9WsFpKlNRZ0DNhzalkSeugpQy7JIqNnXWhVQqZZ8Mx6nHZX1N+dnKTHK/n31Ms2HPSVQtGHyYJBQQu7Y/Y6qtqPlILepVKvl8Tr0wGk2rbyiiuFKf+XAic4IPZ2bktBlqEeMW4mOTMXIzHvUmkbNdZM2HvkA0tZx5GTUfDu68aYZACX0+eiLOLJ6UZEBWTB3McJwasMljYDCuGjZMxbVdyM141Jsks8nYC9s/ApA+1fbpt/eX/PxObeZkFlnfUEzmw8mt1YFUHYMZU22dVvNRG/BBlv0YsRZOLJ6AnLXLzAe5EY96k+gLTuMJFW992AMAaAj5MLI2AEAsz72vO1LS8zu5/4QZSsp8OHwfa5kPA4sonTrV1uNRUBcoP2Mp6QM+Zj7IjZx1hqgg+j4f+tqOeUc3p52YP+wawJj6YFHPHYmlli13WnrbLHVB8X70Rgu/a3XqEIIk/129Zcy6yuTkjFx9jQ/dkVhZ/XkkfZ0N26uTG/GoN4lW8zEY1/pF1Pg9GFkbgM/rweFjagGUlsLV/z9OvTAarZTZCvKxTmytDqQChN5kds4ITs7IGTFLTZJ1I16PojUwI3ITHvUmSQ27xHQtp1Mn5Do546WEuyh5d1kb8GprTlB+dcHiLxz6GUpOpK9lMeJuPpFQ0RN1brbIyOm2WndTBh7kUjzyTaIfdunOsjhZQ03p48dOvrs0Synr6Th92CXo82r1BkZcUHujMchZqE4M2EoJYHPhui7kdjzyTaIvONUaL+lOyOWcyLI9H+VXyno63Q6duaFXHyx+v+Qij2W/V3HkDA4jFoSUfvG3dwAw+CD34pFvktqAHE+PZU3fl7O4XLfDhwPMUFtCcaUbgjy5X8ppeCfpp9k6sR29EQtCSv/Y2QGA02zJvXjkm0RmNgYGE+jojab9DkjdTXeVMezi1OEAM5TS4dTJMzckLUM3WH6jMae2VpeMrPmQAcyvLp5e9nMRVSMGHybR3y3v7RwAkJ6+ryvjjrNHm4Xh3OEAo5XSSlyrrQk6dz/ra5PK5dTW6pIZQ1Qjws49tojyYfBhEr/Xo3U53ZMMPtIzH+XUfDj7JG+GUlZwdfpsF2Do6svlcHpGTt5QdJU5RBWNJbTj0MmBLVE+DD5MJE9Wew/2A0if7VLO+HFq6q4zT/JmKDbzEU+oqf3s4OBDW33Z0MyHMy+oqWGX8oIP/bCNk48tonwYfJhIBhhy2KWuZmjNRynjx10OP8mbIVhk8KEPCt2Q+egrovNrLk5fiC81VFpezYc8tsLs00MuxuDDRDI42NPZn/YzUN5UWzfckRtNCz4KLDiV+zjg9WhDNk5kxrCLU4OPBoOm2sohlxq/c48rouEw+DCRLFCTjZeMq/lw9h2mGeSwSzyhIlZAAOKWfawVnBoy28XZw4F1Bk21lQv5sbspuRmPfhNlXriy9fkoq8OpQ0/yZtA3cyok++GGabaAWZkPZw4HGlXzEY2LfR308/RL7sWj30SZd4D1WWo+eiIxqGpxi3o5fal3M+jvMgup+9Du4h0ffMiCU9Z8DEdfJJ4oYyG+CNd1IWLwYabM4ED/szyRJdTiZxq4ofOm0Xxej1bcV1DwIafZOnwqpJwO3j9Y+BTkXJxe86G/megpI1iLcl0XIgYfZqoLejN+Tp28Qv5UpXuxY8hsr14aeaEtJNhzS4CnX325XL3J/SqzKU5To/vM9kVKH6bionJEDD5MVRNIDz70wYKiKLoZL4XXfSR0/ScYfBSnrogOlU6/i5eM7HAq7+idvF5JsVO2s3HDfiIaDo9+E4V0U+kUJbXYnFTKdNu+wXhq2XKHDwkYTQYShayn0+OSot5UzYcRwYd4Diff0WvN6uKl76/UsAun2pJ7OfcsUQH08/jrAj54MhoKlTLdVmZJfB4FNayWL0pdEfs7NdXW2QGekbNd5CwiRwcfySLRYtr0Z9L2EwtOycV49JtIn/nIlr4vpcV6j24WhhOXLTeTNsOokODDJY3cUn0+yq/5cEP/ChlYlRN87Ekut8BhF3IzHv0m0mcmsl3ESmmx3uWSWgQz1BdRY+Oamg+/8ZkPJ2fkjKj5+P2WPUZtDlHVcu5ZogLUpGU+hqbvyxl2qWO9R9FkU6dC7lrd0kslbELBacDr3FoGWadRTvAxIiyOqaNbGgzZJqJqxODDRPphl2wtp0spOOVMl9IFi0iZd8uGWQ4vOJXDLv2D8aKb3WVyQ/8KI4Zd5H46fvwIIzaJqCo59yxRAWqzrOWiV0q7ZrZWL52sRSjkrtU97dVT6w+Vc0GNJ1TEkl0/nVzLYMSwi9zPbK9Obsaj30RjG4La96EsK1imCk4Lr/lwy0XRDMHke1DI2i5uaa+uPy7LGXrRX4ydnPkIGjnV1sGFuUTD4dFvotG1qeCjP8uqoeXUfDi9FsEMxWQ+nL5ImuT1KNoFtZz1Xd7d16N97+TgQx5Df3xlb8nPwQ6nRAw+TOXxKDjpsJEAgDOOHDvk7zLl3VvEHadbpoCaITVen39/R2JxLTvi1OXh9eTwYG8ZLcP/sbND+97nce4UcFlzle1molARFzRjIxqO88+sNvvff5mJPQf7MWVM3ZC/ad0Sh7kY6rllCqgZCi0W1Gei3BB81Nf48FFvtKjhv0zRuKj3OOuosY7uP3PJKZPw/PaPMBgrvTiX7dWJmPkwXY3fmzXwAEorXnNL228zFLq/5T6uDaQWEnMyGWB1FTH8l0nu0xHhgCHbVKlqklNtIwXUDWWjqqorOsESDYdHv41S60QUfiLTpoA6vBbBDIECgw+31HtIWuFzGcGHW4YSCj2GcoklVG1tpqCD+6EQDcfZZ4oKF5TrRAwWfiJ7/r2PALhjOMBoha7LIQM8t9TVyIZ1xRQ+Z3LLDI5C64Zy0deKOD1QI8qHR7+N5Dz/QjMf7V0DWi8F2SWRCien2g534XBbXU1DTeFt53OJuqR3Rbl9Pv72Rrv2PYMPcjMe/TaSbagLPZF9kFyQCgBOmDDCjE1ytLpgYa3E3dJaXaorYYHDTFrjLJdkPkoNPvZ1RwAAigJX1BMR5VL0mWL37t24+OKLccghhyAcDuOEE07ASy+9pP1dVVW0traipaUFoVAIc+bMwbZt2wzdaKco9kQmL4pHNtfD5/CTvBkKHV7Qeqm4ZGirlH4zmdzQWh3QNxkrLfiQ+3jRzImGbRNRNSrqTNHR0YFTTz0Vfr8fjz/+OF577TX87Gc/w4gRI7THrFixArfeeitWrVqFTZs2obm5GXPnzkV3d7fR2171il0nwm3DAUYr9CLrtv1sSM2HS2ZwyGxlMXVaelrnXC4MSS5X1Nn1Jz/5CSZMmIA777xT+91hhx2mfa+qKlauXInrr78e5513HgBg9erVaGpqwpo1a3D55Zcbs9UOUez4cQ9nupQltZBf/toGOfzglqLeegNqPmQdTdDn7BkcxdZpZUp9ht1xbBHlUtRtyiOPPIIZM2bgggsuwNixY3HiiSfijjvu0P6+fft2tLW1Yd68edrvgsEgZs+ejY0bN2Z9zkgkgq6urrQvt9BPtS1kRVG33ZEbrSEZtEViibwBX5fLaj7k8bTutQ9LWtn2QE8Ej21tA+CGzIf498UTKmIlBCDyM9zAzzC5XFFnivfeew+33XYbpk6dij//+c+44oor8K1vfQu/+93vAABtbeIE1NTUlPb/NTU1aX/LtHz5cjQ2NmpfEyZMKOXfUZX0i3oV0q45lbLliasU4aB+EbXcQww9Lmthf0Rzvfb9vp5I0f//3989oH1/eI6Gek4RChT3mc3ktmOLKJeigo9EIoFPfOITWLZsGU488URcfvnl+NrXvobbbrst7XGZ7ZVVVc3Zcvm6665DZ2en9rVr164i/wnVKxzwQu6WQho8ua35ldF8HkXb3/kyH6nF+9xxgTiyuUH7PhYvPvMxkLwITxldi09OHmXYdlWioM+jrV1TyuwgLavGmg9yuaKCj3HjxuHoo49O+91RRx2FnTt3AgCam5sBYEiWo729fUg2RAoGg2hoaEj7cgtFUVJ1CAWcyNx2UTSaoqRWcM1X5OvGFvbh5B19KcGHDOSmNjk76wGIY6ic2UHyM8zMB7ldUcHHqaeeijfffDPtd2+99RYmTZoEAJg8eTKam5uxfv167e/RaBQbNmzArFmzDNhc55F1CIWcyOSdFoOP0skx+3wFg27MMMm7+cFE8XUMqWm2zi42lerKCD56WLdFBKDI2S7f/va3MWvWLCxbtgxf+tKX8MILL+D222/H7bffDkDcFSxZsgTLli3D1KlTMXXqVCxbtgzhcBgLFy405R9Q7WTmo5hhF9Z8lE5cIGN5p0q68e7UnwzKSsp8xN3RWl0SQyb9Jc0O6uawCxGAIoOPk046CQ899BCuu+463HTTTZg8eTJWrlyJRYsWaY9ZunQp+vv7ceWVV6KjowMzZ87EunXrUF9fn+eZ3auYaY7dEffdkRutkCZR3S7MMPm8ycxHCTM4ZCDn9NbqUqnDLrF4QitSddOxRZRN0Z+Ac889F+eee27OvyuKgtbWVrS2tpazXa4hq+eHa/kNsObDCMP1VkkkVFcOb/k8ycxHopTMR3JFW5dkPmq0NYKKC9T0BapuyqoRZeOOs0UFk4V+fQVM2+vhsEvZhmtp3zcY15Y8d1NqXGY+4mXUfAQd3uNDKnV9F5kpqfF7tGEuIrfiJ8Bm4YAIJPrz9J2QUg2K3HNRNNpwS6LL7JLPo6DGJcMIgK7gtIzZLk5vMCYNdwzlwtbqRCnuOFtUsEKHXfTjxUzZlk6b7ZLjrlXLLtX4cvamcaJyCk4jLst8BIc5hnKRwy7sbkrE4MN24eT4cf9wy7zrx4s57FKy4dbm6HLpVEit4LSEYZe1m0RjQLdkPrRjqOhhF/fNoiLKxR1niwoWLjDzIVO2QZ/HNSd5M9T48gd7Hb1RAEBjyF2pca3gtMjMh+heLL4/pDZo9GZVpEJ6xWTDtZmIUngVs1koWfNRaPDBabblkSf+XK2x93b2AwBaGkOWbVMl8CczH8UultavK9A9e1qz0ZtVkQIFdMnNRpvCzZoPIgYfdpOZj/7B/AWnnGZrDJny7srRo2FP5wAAoGWEu4IPr9bhtLjMh6yRURSgNuCODqfBZPaMwy5EpWPwYTNZcFpozQeDj/LIzFGujrJ7D4rMx7jGGsu2qRL4taXii7ugdummf7ulQLfUzAdbqxOlMPiwWbE1HzxxlUdbyC9HR9k9B0XmY5zLMh+lTrVNzeBwz1BCuX0+3LRgIVEuDD5slhp2GSb4iLDBmBEahmmN3daVHHZxWebDl8x8FNte3Y3DgXJK8UCRfT56uDwCkYbBh81C/kILTuVJnieucgS11tjZ9/fBPjHbZUQ4YNk2VQJZr9EXKfKC6sKuu7WySDxH0XIurPkgSmHwYbNwoTUfLjzJmyHfwnKqqrq2EZQMaotdqdWNw4HDzZjKxa09ZIiyYfBhs1TNx3CzXdx5UTRavg6nfdE45GQPt2WY5N14d7F383I40EX7q67EVW15A0GUwuDDZnKFzEKHXZiyLU++mQryTtbrsnVdgNKXiXdjzUcqS1RsoMahUyLJXWfYCiQzH5FYAvE8PRZYrGaMfD0a9BdSt0wblYabgpyLG2dwDDdjKhdOtSVKYfBhM7mqLZB/xksXU7aGyDdNstvF+1gGD/LuvFBuvKA26Go+VLWwqcmqqrqyPoYoFwYfNqvxe7S1MfLVfbjxJG+GfMMubm5hrxVRcihhWHLoM6EOP1wqRWIJxJKZTTcGt0SZGHzYTFEUhJJ1HwPR3D0W3HiSN4MsOM0bfLjw4pAaSiht2MVNF9SQ36u1oy90f3Ulh2hEG3r37CuiXBh8VABtxkue9V2Y+TBGajn0oXesPRH3FU9KMqjNteZNLm4cSlAURTfdtrBhKv1MF4/HXfVERNkw+KgAoWFarHO82Dj5lkPX7uJduI+LvZhKPRF37jOZ6Sk0WHNzVo0oGwYfFSCc7HKaq9EYx4uNIzMfkVhiSLGgmwM8+W8eGEwU1WJdzvhw09ouQPGzg9xcT0SUDYOPCjBc0yKOFxtH7j9VHTq7KFW/4L4LhD6oLabo1K2Ns+qLrJGRGSW3ZYiIcmHwUQGG6xugXRQDHC8uVzjghdyFmRcON9d8+LwerfC50AtqPKGiN5mtc9s+K3aYiq3VidIx+KgAw60VwWJT4yiKknNmh9tb2Mvjq6vA5ln6DInb7uiLbbHu1gwRUS4MPirAcK2tOV5srFyLqLm1eFKqGyYIziSnfwd8Hq1zrFsU246en2GidAw+KsBwK4pyvNhYuS4cWmrchTUfQPFrlrg5UyTrgoqt+WD2kkhg8FEBZBFkb47ZLhwvNpZMfWd2lHX74n11wcJWWJa0TJELhxKKrfn4qFc8rjHkzsCWKBODjwqQb70RgOPFRsvVYt3ttTX5ur9mk1qIz30X1IYih132dvYDAFpG1Ji2TUTVhMFHBci33gjA8WKj5drf3S4fdhnuOMzkxtbqUrEFp3s7BwAA4xpDpm0TUTVh8FEBgr7cLb+B9KXeqXzBLJmmWDyh9f1w636WRaO5MnCZXN2UTdZ8FFCcq6oq9hxMZj4YfBABYPBREYYddomwNbORAlkusvoZHm6t+RjuOMzk5tlB8t/8ygcHh31sR9+glk1qagyauVlEVYPBRwXQ7sRztLV285ojZsi2vovcxzV+D/xed34sig4+XLxeiSwcVVVg10d9eR8rsx6j64Kum5JMlIs7z7IVRiv0G8wRfERY82EkrbZhcGjw4cbW6lKq4DT78F8mOUxVE3DfBfWIpnrtexlc5NLVL4ZNR9W699giysTgowJoy7znzHyw5sNIqUxT6iKbWiDNvftYOw4LzHzIx7nxbt7jUfDxpjoA0BZ9zKWLBeNEQzD4qAABb/5CPzent82QreBUq6txc/CRZTgqn1Tw4c7TiNcj/t3DBR9u7odClIs7zxoVhlNtrZVtf7OuJvtwVD4ySAm4tEbG7xUrFMaGCdaYuSQayp1njQpT6GwXN18YjaQVnOqDj4i7e3wAuuOwwMyHrA0JuDTz4UsujzwYHybz4eIpyUS5uPOsUWHkUuaygE8vnlA5JGCwUGDo/nZ7a3VAdxzmaPOfye3DLj6vHHYZJvPBgnGiIdx51qgw2mqiWbolpvWf4JixIeR+1O9v3p0Wv6qtHLZya+YjNeySP/OhBbb8/BJp3HnWqDDypBSNJ4ZMc5QXgoDXgxq/+2YVmEFrja27yHazqDe1UmuBwUfU5cGHL1lwOjhszQcDW6JM7jxrVBj9HVHmWhEcDjBetqXje5ga1y6O8pgbTsTFU22BVOYjPsxsFzevgUOUC4OPCuD1KKhN1iFkDr1wOMB42rCLbjl0Bnm6ZeILXCzt3X09AJj5GCxwqq2bA1uiTO48a1SgbHfj+p8ZfBgn23LoXdzPqcXSCgg+OnqjqZb0bg0+ONWWqGTuPGtUoFQdQnrKu5sNigwnZ7v06WZ19DA1rl0c+wfjw15QP+hItRQ/YeIIMzerYsk1gIYrOGX2kmioooKP1tZWKIqS9tXc3Kz9XVVVtLa2oqWlBaFQCHPmzMG2bdsM32gnqs9yNy5+lndNTNkaJRxIFvjGEtp4vQz63Lyf9UNOw814kcflx5vqXFvz4ZV9PoabassmgURDFJ35OOaYY7B3717ta+vWrdrfVqxYgVtvvRWrVq3Cpk2b0NzcjLlz56K7u9vQjXaibNM/9T+7eRaG0UK6WUOy14fcz25e28Xv9aAmub7LcEMvzMgVNtU2kVDRE+W+IspUdPDh8/nQ3NysfY0ZMwaAyHqsXLkS119/Pc477zxMmzYNq1evRl9fH9asWWP4hjtNg1bzkTHswpSt4eQFFhANtVRVZXv1pLoC6z5S+8u9d/Oy4DTfEFVvNAY1GZvwM0yUUnTw8fbbb6OlpQWTJ0/GRRddhPfeew8AsH37drS1tWHevHnaY4PBIGbPno2NGzfmfL5IJIKurq60LzdKzcDgVFuzKYqS1s0zEktoi4O5PTXeUGCjsR4WUaYKTvPMdpFBmt+ruLYTLFE2RX0aZs6cid/97nf485//jDvuuANtbW2YNWsWDhw4gLa2NgBAU1NT2v/T1NSk/S2b5cuXo7GxUfuaMGFCCf+M6pez5oPT9EwR1rVY70peSBUFCLu8kVuhvT56k8W6coq4G8lal4E8C/Hpp9kqimLJdhFVg6KCj09/+tP44he/iGOPPRZnnXUW/vjHPwIAVq9erT0m8wOmqmreD911112Hzs5O7WvXrl3FbJJjyMxGF6faWqJGt56OfqaLx+PuC0ShLdbd3mAMSH0me/PsK7ZWJ8qurDxgbW0tjj32WLz99tvarJfMLEd7e/uQbIheMBhEQ0ND2pcbycxG5kmfU0DNkZpuG2NrdR3Z6yMzCM7k9hVtgdRnMnN6vB5vHoiyK+vMEYlE8Prrr2PcuHGYPHkympubsX79eu3v0WgUGzZswKxZs8reUKeTF74hBafJE1sDh10MJYddBgbjnAqpk2+RQz23r2gL5B4q1WNrdaLsivpE/Nu//Rs+85nPYOLEiWhvb8ePf/xjdHV1YfHixVAUBUuWLMGyZcswdepUTJ06FcuWLUM4HMbChQvN2n7HkCeyt9rSpyX3cBaGKeSwS180jqhHXEi5jwuv+XD7onJAKqB4sy13KwEGtkTZFXW2/eCDD7BgwQLs378fY8aMwcknn4znnnsOkyZNAgAsXboU/f39uPLKK9HR0YGZM2di3bp1qK+vN2XjnaQhJE5OezoHcLAvihHhAACmbc2iFZxG45BzFbiPUxm4Qms+3Bx8yM9se3cEHb1RjKwNDHlMT4SzgoiyKeoTsXbt2rx/VxQFra2taG1tLWebXGn6pJHa9x909KeCDzZzMoWcajswGMdgskkU93HuNYYyRVlwihN1beXbugayBh+8eSDKzr23LRWmxu/F4WNqAaROWJFYXDvJM21rrJBu2IWp8ZS6AuoYAA67ACLwam6oAQCtTX8mBh9E2fETUUEyZ7zoLwC8KzdWSNfnozfCC4RUaM2HnO0S9Lo3+ABSjcYGc3Q5TRWcMrAl0nP3maPCZJ74ZbFpbcCrLWJFxtB3OOVU25SCh12SF9ug392nEG1l2xyZD9Z8EGXn7jNHhanPaPDE4QDz6DucdjPzocnV5j/T3985AAAIuD3z4Sks88Fjiyidu88cFaY+Y1Gvjr4oAKAxxODDaDWBoZkPNy+SJsngI1/Xzg+7BrTvx48Mm75NlcwnMx85VrZNtaFn8EGkx+CjgmQW++3t7AcANDfW2LZNTqUVnA7GtWEu3p2mmobJgtJsOvtT9SDHjm80fZsqmV9bXC77/ooMJmtjXD48RZSJn4gKklnzseeguMNsGcHgw2hah9Noam0X1nykZq9E8iwTL4/PiaPcnfUAoNVi5cp8yNoYtw9PEWXiJ6KCZI63y8zHuMaQbdvkVPqF5VhbkxLQZT5UNf/0Uc7AAvye/AWnkUFOSSbKhp+ICtKQMdNgb6fIfIzjsIvhwskx+L5oXAv22F49/SIZZRHlsIabaqtlPhh8EKXhJ6KC1GUMu8jgo2UEMx9GkzUfvZGYFnzwYpq+UFwkR90Hg4+U4QpO2QmWKDsGHxUkc5XMg30iCBkZHtq2mcoTCohDf39PRPsdhxHSaxNyFZ2meldwmMrvyV9wytV/ibLjJ6KCyIufDD44C8M8Ib/Ypx3JAC/g9Wh1IG6mKIoWgOQKPljzkZIadslR85HsBMthF6J0/ERUEH179WgsoaW9GXwYT7ZXl1jvkaLNeOGwy7B8suA0S81HLJ6ArENl5oMoHT8RFUTf4VS/tgbvMI0Xzgg+eCFNGa7XB2cHpfi0Ph9DMx/6gl1mPojS8RNRQeQFMJ5QsS9ZixAOeLWiNjJO5hALg4+UwDDBh6z5YLZIl/nIEnzIPj0A+3wQZeInooKE/KkF5PYmT1zMepgjlBF8cD+n6HugZCMzHw0MPlJDVINDA7WN7+7XvucNBFE6fiIqiKIo2kVwT7LBGO/IzRHwebRFwQAOIeilmt0NZv271heFAZtuqHTovpKZo+mTRlq6TUTVgMFHhZEndC3zwYuiafTZD7ZWT8mc8p2JNR8p9XlWAZY1H1NG11q6TUTVgMFHhZEnfpn5YGrbPPoZL8wwpWRO+c7EqbYpsu6lK8u+kpkPFpsSDcVPRYWRF8F32nsA8ARvJn3wweLJFP2U72zYfyZF21dZgo8Igw+inPipqDByfZdXPugEwBO8mdKGXTiEoMlcXVmP/WfSpbJEuWs+2FqdaCiePSrMgk9OxAcd/RiMJ1Dj9+KLnxhv9yY5VlrmgxkmTb6ajw+7RC1SwOvRAmU3a8izrzjsQpQbz7gV5qyjm3DW0U12b4YrpGc++FGQtNkuWS6ocrHD5sYaeHSzhdwq3xAV13Uhyo2fCnKtMAtOs5IX1GxFlHuThdDjGmss3aZKVZcn86Gt68IeH0RD8FNBrlXDmo+s6vL0rpBdO1tGhCzdpkqlXxIhkdHlVE61Dfp5miXKxE8FuRaHXbLLV/PBzEc6fa1QTzR9fz22tQ0AMx9E2fBTQa41YVRY+765gRdTKV/jrH3dYs2hJu4vACJ7JoMLfY1MfzTVmn5sQ9Dy7SKqdLzdI9f6+qem4IjmeowfGcKIcMDuzakYcggqW+ZDW9clxFOHVFfjw0e90bT91aWbejvn42Pt2CyiisYzCLlWjd+Ls49ptnszKo5W85E1+Eg2GAuyRkaqTwYf+hoZGYg0hvycFUSUBYddiCiNrPmIxhMYyFjZtlsuKscaGU19lhbr7AJLlB+DDyJKUxvQFVFm1H2kFpXjRVWSRadd/UMzH2xeR5Qdgw8iSuP1KDkXl5NDMRx2SZHB2u1Pvaf9TgZt7AJLlB2DDyIaQjZg69VlPgbjCfQnh2GY+UiRxcr6QEMOu3B4iig7Bh9ENIQMPvp1NR/6AlReVFPOOkrMZoklEtrvODxFlB+DDyIaIpQcSujT9auQQwk1fg/8bJyl8SX3xWA81eGUNR9E+fEMQkRDaJmP6NDeFWxFn87nFVNp9ZkPGahxXxFlx+CDiIaQwUda5kMrNuXdvJ7fI06jsbTMB6faEuXD4IOIhpDr3uiDD9YxZOdNNhEbjLPmg6hQDD6IaIjUsMvQmg8Wm6bzJ4dd4rpVbbV9xSwRUVYMPohoiFCWYRe2Vs8uW8Fp1wBrPojyYfBBREOE/OKOXT/VtjvCoYRsfJ4sBaes+SDKi8EHEQ2RbbaLNn2UF9Q0ctpxjFNtiQrG4IOIhsg27MLZLtnJqbb6glO2VyfKj8EHEQ2hTbXVDbvIIZhQgMGHXmrYRWQ+YvGEFrQxS0SUXVnBx/Lly6EoCpYsWaL9TlVVtLa2oqWlBaFQCHPmzMG2bdvK3U4islC22S7RmLizD/h4z6InC05l8NEbSe0zDrsQZVfyWWTTpk24/fbbcdxxx6X9fsWKFbj11luxatUqbNq0Cc3NzZg7dy66u7vL3lgiskaqvXqq5iMSExdVBh/p/DLzkRx2kZ1ggz4P9xVRDiV9Mnp6erBo0SLccccdGDlypPZ7VVWxcuVKXH/99TjvvPMwbdo0rF69Gn19fVizZo1hG01E5gr7c2c+glzXJY3MfCRUIJFQdQ3GWO9BlEtJZ5GrrroK8+fPx1lnnZX2++3bt6OtrQ3z5s3TfhcMBjF79mxs3Lgx63NFIhF0dXWlfRGRvbK1V48m7+yDfgYferLgFAAGEwndui4cciHKpehPx9q1a7F582Zs2rRpyN/a2toAAE1NTWm/b2pqwo4dO7I+3/Lly3HjjTcWuxlEZKJss120mg9mPtLo90cklkBvMvioDXrt2iSiilfUWWTXrl245pprcNddd6Gmpibn4xRFSftZVdUhv5Ouu+46dHZ2al+7du0qZpOIyAThwNAmYxEWnGYV9Hm0GS+9kZhWGxP0MfggyqWozMdLL72E9vZ2TJ8+XftdPB7HU089hVWrVuHNN98EIDIg48aN0x7T3t4+JBsiBYNBBIPBUradiEySGnZJFZxqNR+8qKZRFAX1NT509A2ieyCWCtKYISLKqahPx5lnnomtW7diy5Yt2teMGTOwaNEibNmyBVOmTEFzczPWr1+v/T/RaBQbNmzArFmzDN94IjKHHHYZGEwgkZxCyqm2ucl+Ht0DsVSQxtoYopyKynzU19dj2rRpab+rra3FIYccov1+yZIlWLZsGaZOnYqpU6di2bJlCIfDWLhwoXFbTUSmkpkPQAy91AZ9aOsaAMDgIxux2F4/ugcGtcJcZj6IcjO8HHvp0qXo7+/HlVdeiY6ODsycORPr1q1DfX290S9FRCap0Q2t9EXj6InEtOLTIIOPIWTmoycSQ2SQGSKi4ZQdfDz55JNpPyuKgtbWVrS2tpb71ERkE49HQW3Ai95oHL2RGD7o6Nf+NnVsnY1bVpka9MMucdbGEA2HoTkRZaW/m+9Odu2cMWmk1lSLUmRDsR5dzQczH0S58dNBRFnJC2rXwCC62TgrL7mGS/fAoG5WEE+vRLnwTEJEWclAo2cgprUMr2PL8KzkvuqOxLSeH8x8EOXG4IOIskrdzaeGXZj5yE4/1fbZdw8AYOaDKB9+OogoKxl89EZjWstwLhGfnbavIjF81BsFwKm2RPnw00FEWck792gswTqGYcj9EoklEEuIffXZE1rs3CSiisYzCRFlFdBdUNkyPD+5r7oHBjEYFx1hR9UG7NwkoorGMwkRZSX7VET0mQ+2DM9K7qsDPWLIRVGA2gCHqIhy4ZmEiLIK6IZdImwZnpfcL/t7IgCAuoAPHk/2lbyJiMEHEeUQyFLzEWDXzqzkvuoaYD8UokIw+CCirOTdfCQWT9V8sOA0q8z9Us9+KER58UxCRFnJ+g6R+eCicvlk7pc6Zj6I8uKZhIiykpmPaDzB9UqGMTTzweCDKB+eSYgoK613xWBCW6mVwUd2QzIfbMZGlBfPJESUlVZwGk/g1d1dADjskkswoxCXNR9E+fFMQkRZ1fjFBfWNvV3a78bW19i1ORWtMZwebHDYhSg/Bh9ElJUcOmjrGtB+97GxdXZtTkVrqPGnDUnVc9iFKC8GH0SUlQw+EqJbOCYdErZxayrfJw8bpX3P2S5E+TH4IKKsMusWWO+Rn37/sOaDKD+eTYgoq8y6Bc50yU+/fzjbhSg/nk2IKKshwQfXdclLH3w0cNiFKC+eTYgoq8ZQ+tABMx/56YMz1nwQ5cezCRFlpSgK5h7dpP2c2cuC0sl29ABrPoiGw+CDiHLSZzuY+cjP52HNB1GheDYhopyCXgYfhYolEtr3bDJGlB/PJkSUkz7gCLLgNK/IYCr44LRkovz4CSGinPQX0ZjsNkZZHdFcDwAYEfZDURSbt4aosjE3SEQ56TMfnzuhxcYtqXwXnzwJI8IBHDe+0e5NIap4DD6IKCd98HHoyJCNW1L5avxenD99vN2bQVQVOOxCRDkFvKnptZw+SkRGYfBBRDnpSxc4g4OIjMLgg4hyUnU1prUBBh9EZAwGH0SU0znHNmPCqBAumD4eXg9ncBCRMXgrQ0Q5TW2qx9NLz7B7M4jIYZj5ICIiIksx+CAiIiJLMfggIiIiSzH4ICIiIksx+CAiIiJLMfggIiIiSzH4ICIiIksx+CAiIiJLMfggIiIiSzH4ICIiIksVFXzcdtttOO6449DQ0ICGhgaccsopePzxx7W/q6qK1tZWtLS0IBQKYc6cOdi2bZvhG01ERETVq6jgY/z48bjlllvw4osv4sUXX8QZZ5yBz33uc1qAsWLFCtx6661YtWoVNm3ahObmZsydOxfd3d2mbDwRERFVH0VV9YtmF2/UqFH46U9/issuuwwtLS1YsmQJrr32WgBAJBJBU1MTfvKTn+Dyyy8v6Pm6urrQ2NiIzs5ONDQ0lLNpREREZJFirt8lr2obj8dx//33o7e3F6eccgq2b9+OtrY2zJs3T3tMMBjE7NmzsXHjxpzBRyQSQSQSSdt4Gka0D3j2F8DB94f+zeMHPnEJcOh0yzeLSLPvTeCFO4BYf/IXCnD054GpZ9m5VZWrZx/w7M+BvgOp340/CfjEYkBR7NsuIpMUHXxs3boVp5xyCgYGBlBXV4eHHnoIRx99NDZu3AgAaGpqSnt8U1MTduzYkfP5li9fjhtvvLHYzXCvRAJ46HLg9UdyP2br/cBlfwKaj7Vuu4ikjh3Ab+cDvfvSf7/lbmDBWuDjZ9uzXZUq2gvcfT6wd0v67/9xlwhG/ulfbdksIjMVHXwcccQR2LJlCw4ePIgHHngAixcvxoYNG7S/KxlRuqqqQ36nd9111+E73/mO9nNXVxcmTJhQ7Ga5x19uFIGHNwCc9m3AV5P+97f+DOx6DlhzIfDVvwAN4+zZTnKngU5x7PXuA8YeAxx7vvj9By8Cb/4R+L/LGBjrJRLAg18XgUf4EOCUqwAoQNduYNOvgb/cBIyaAhzzBbu3lMhQRQcfgUAAH/vYxwAAM2bMwKZNm/Bf//VfWp1HW1sbxo1LXfDa29uHZEP0gsEggsFgsZvhTpt/B/x9pfj+s6uA4y8c+pgZXwF+Mw/Y/xZwz0XAVx4DArWWbia5VDwG3H8psO91oH4csOh+oPHQ5N8GgbvOA7Y/JYKTr/0VqG+2dXMrwhM/BN54VNxMXLQGmHhy6m8eP/D8bcBDVwCNE4DxM+zbTiKDld3nQ1VVRCIRTJ48Gc3NzVi/fr32t2g0ig0bNmDWrFnlvgy9twF49Nvi+9nfyx54AEBoJLDwPnEXtXeLuKtKxC3bTHIpVQUe/y7w7l8Bf1gMr8jAAwC8fuBLvwNGf1zc1a+5UAw3uNlLvwU2/rf4/vO3pQceAHD2zcDH/xmIDYgbiY7cw9dE1aao4OP73/8+nn76abz//vvYunUrrr/+ejz55JNYtGgRFEXBkiVLsGzZMjz00EN49dVXcemllyIcDmPhwoVmbb877HsLuO8SIBEDpp0PzPle/sePmgxcdA/gDYq7qid+aM12ukksMvxj3OS5XwIv/g8ABfjir4GWE4Y+JjQSWHhvRmCcsHhDK8S7fwMeTQ43z/l+anhKz+MFvvgbMUTVu08EbAOd1m4nkUmKCj4+/PBDXHLJJTjiiCNw5pln4vnnn8ef/vQnzJ07FwCwdOlSLFmyBFdeeSVmzJiB3bt3Y926daivrzdl412hdz+w5gJx0plwMvC5XxRW/T5xJvD5X4rvN/4cePFOc7fTLWJRYM1FwE+nimwUAW88Bvz5evH9vB8DR87P/dhRU8Twgjfg3sC4/Q3gvsWAGgeOuxCYvTT3Y4N1wIJ7xTDWvtfFsFY8ZtmmEpml7D4fRmOfD53BAeB3nxMFpCMPEwWktaOLe44NK4C/3QwoXuDiB4DDTzdlU11BVYFHrhazEACgphH4lyeAMR+3d7vstGcLcOengcE+YMZlwPxbCwuOt/4f8MC/iO8/81/A9EvN3MrK0bMP+PWZwMEdwMRTgC//HvAVUPNW6n4mslAx12+u7VKp5IVu13NAsBFYeH/xgQcAfOq74u5KjYu7rfY3jN9Wt/j7ShF4KB5g9BHJmR0XAL0Hhv1fHalzt6hFGOwDDj8D+PSKwi+Ix54vhhsAMfzw7t/M285KMTgArF0oAo+Rk4EL7y4s8ADEMNYXfw1AEcNbz/3SzC0lMh2Dj0r15C2iX4fHB1z4u9LvrhUF+OzPgYmzgEjyYtmzb/j/j9Jtexh4olV8/88/EbOIRkwCOt4XF5TBARs3zgaRHuCeC4HuvcCYI4ELfiuKSosxe6l7AuNEAnj4G8AHL4iM2aL7gdpDinuOI+eLYS1ADHO98Zjx20lkEQYfleiV+4ANt4jvz/1PYMqc8p7PFwQuuluMtx/cCaxdAAz2D///kfDBS6KxGwDMvAKY+XWRhVp0v8hK7XpOZKkqawTTPIk48MBXgbatQO0YMbuqprH459EC41OSgfGXnBsYP7kc2PZg8mbiLmD01NKe55SrgOlfAaCKYas9W4zcSiLLMPioNDueBX5/lfj+1CXAJ75szPOGRyUvEiOADzYBD1/p3pkGxTi4UwwtxAaAqWcDZy9L/W3MESIr5fGJLNWGn9i3nVZadwPw1uOiwd1F9wAjJ5X+XL6gGH4YOVkMRzgxi7TlHuCpFeL7z/wXMPlTpT+XogDn/FQMcw32iWOzc7cx20lkIQYfleTAu+LkG48CR30GONPgmQCjp4q7Lo9f3IU9uWz4/8fNtG6d7UDTscD5vxHTH/WmzBHFf4C4u33lPss301Iv3JGqN/j8bcCEk8p/ztpDRBapplEMS/zeQYHx+38HHvmm+P607wAnXlz+c3r9YphrzJFi2OueC8UwGFEVYfBRKfo7RNq5/yOg5RPAF24HPCa8PZP/Sdx9AcBTPxV3ZTRUPAbc/xWg/TWgrhlYuBYI5pgyPn0xcOo14vvfXyWyV0709hPA46KTMc74ATDtPOOeWwuMfcCrD4hArtodeBe4dxGQGBSL6p3xA+Oeu6ZRZDJrx4jhrwe+ymaCVFUYfFSCWBS49xLgwDuijfKCtUAgbN7rnbgotVjVI98E3n/GvNeqRqoKPL4UePcvolvnwrVA4/j8/8+ZrSJbFY+K7NVH71myqZb58DXRY0KNAycsMmexs8mf0gXGK6o7MO77CLj7AnFTcegM4Au/Mv5mYuQkMezlqxHDYOtuMPb5iUzE4MNuqirapr//NBCoFx0g63OvhWOY028Qd2OJQWDtImD/O+a/ZrV47jbgxd8AUIDz7gBaThz+//F4RLaq5USRvbr7S+LC4wTdH4qsXLQbmHQacO5K83pMnHixGJ4AkoHx3815HTPJm4mP3gUaJwIL7gH8IXNea8JJYvgLEMNhL9xhzusQGYzBh92e+U9gS7J3xAV3Ak3HWPO6Ho+4Gzt0BjBwUFxc+j6y5rUr2ZuPA39O9p+YexNw1LmF/7+B5JomDeOBA2+LC1Asas52WiXaJ2ZHde4CRh0OXPi/gC9g7mue8QPg6M+JwPjeRWL4olqoKvCHa4Adz6RuJurGmvua085LDek8fq0YHiOqcAw+7LTtYeAvN4rvP70CmDrX2tf3h8RdWeNEcZd278XuXrNk78vA//0LAFV03Jz1zeKfo75ZXHACdSKb9cdvV+8U3EQCePgKYPdLYl2WRfeLWVNm83iAL/w/4NDpInt09wXVExg//TPg5TWio/CXfgs0HW3N6/7TvwLHLxTDYvdfCny4zZrXJSoRgw+7pPWO+Abwya/Zsx11Y4FF9wHBBmDH38VdW7VeLMvRtUes2TLYK2awnPMfpQ8tNE8Dzr9TZLP+cZfojFqN/noT8Nrvxeyoi9YAhxxu3Wv7Q8mVcWVgXAVZpFcfAP76I/H9OSuAj51l3WsriqiXmXSaGB5bc6EYLiOqUAw+7DCkd8TN9m7P2KPE1D3FC7x8D/D0f9i7PVaL9CRP1nuS3TpXF9+tM9PH54lOqIDojLrt4XK30lqb/1cMCQLA51YBk2ZZvw11Y5NZpHoxjFHJgfGuF4CHviG+P/kq4KSvWr8NvoAYFht1uBgmW7tADJsRVSAGH1Yb6BTFiPl6R9jhY2cC85NBx19/LO7i3CARBx78GtD2ChAeLS52oRHGPPfMr4uOqIDIcn3wkjHPa7btTwGPLhHff2opcPxF9m1L09Fi+ELxiuGMp39m37bk0vE+cM8CIB4BPv5pYN6P7NuW8CgxPBYaKYbLHrrcOT1TyFEYfFhJ9o7Y93qyd8S9uXtH2GHGZcApV4vvH/qGuJtzuvX/Drz5GOANivqXkYcZ+/xnLxPZrdiAyHYd3Gns8xtt31ui9icRA6Z9ETj9+3ZvkRi+OCfZIfSvPwJefdDe7dGTjej69gPNx4nF3+y+mTjkcDFM5vEDrz8ihs+IKgyDD6tk7R1xqN1bNdTcm4AjzhF3cfcsEHd1TrXpN8Czq8T3X7gNmPBJ41/D4xXZraZjRbZrzYXiglWJeg+IhQcHOoHxnwQ+98vKWbb9pK+K4QwAeOgKYNcme7cHAOKDYkG8fW8A9eOSNxN1dm+VMGmWGC4DxPDZ5v+1d3uIMjD4sEopvSPs4PGKu7fm48Td3N1fAvoP2r1VxnvnCeCx74rvz7hB3OWbJVgvgs26ZtEx9f6viCxYJYlFRHO0jvfFar0L7gH8NXZvVbp5PxLDGvGIyCLZGRirqjh+3vtb8mbiXqChxb7tyeb4i8SwGSCG0bY/ZevmEOkx+LCCvnfEvB8V1zvCDoHaZLOzFmD/m8D9i8VdnlN8mAwA1Dhw/ALgn/7N/NdsHC8CEH9YZL8eX1o5xZOqCvz+arE6b1Au9z7a7q0aKjMwtjOL9OwvgJfuBKAAX/wNMO54e7ZjOKd/XwTWiZgYTtv3lt1bRASAwYf50npHfCVVU1HpGlpEAOKvBd57Evjjv1bOxbIcPcmhj0gXMOlUMT3RqqGFlhNF1guKyII9/ytrXnc4G34CbL0vudz778RqvZUqWJcMjMeJ4Y77bAiMX3801cr87GXAkedY+/rFUBQxfDb+k8n6lAvE8BqRzRh8mKlrj7jQDfYCU04XS2FXyhh6IcYdB5z/P6JfxebVwMaf271F5RnsTy5BvjPZrfMusaS7lY46NzUb4k/XiayYnV65L7WI2/yfiR4nlU4LjMNi2OOx71oXGO/5h5gdBRWY8S/Ayd+w5nXL4a8Rw2gjJomhqrUL3d1MkCoCgw+zaL0j9iZ7R/y2/N4Rdjjin8XdHSBmhrz+B3u3p1SJhChUtLpbZzanXC06qEIVWbG9L9uzHTufE6vwAsCsbyW3qUqMO14Md0ARwx/P/sL81+zcnWxE1wccfoboSlwtNxO1o8UxH2wUw2u/v8oZmUyqWgw+zGBm7wg7zLwi2TRJBR74mrj7qzZ//RHw2sNi+uGFd1vbrTOToogOqlNOF1mxNReJLJmVPnpP3AHHo8CR5wJn3Wjt6xvhyHNSgfG6G4A3/mjea0WSXUN72oAxyaZ8Xp95r2eGMUeIYTWPD9h6vxhuI7IJgw8zrPuBrnfEWuN7R1hNUUS3zo+dBcT6xcWy8wO7t6pw/7gLeOZW8f1nfw4cdqq92wOILNgFvxVZse7k8Fykx5rX7u8Qs5j6DqTqUIxe7t0qJ39DDH9ABR74qjmBcSIuMlQfbgVqx4jlCGoajX8dK0yZI4bXADHc9sp9tm4OuVeVnnEq2KZfA88lU8BfuE0see0EXp9Yr2Ts0eLub82F4m6w0m1/SrTlBoBPfRc4YYG926MXGiGyYuHRIkv24NfEhc5Mcrn3A28DDYeK4DgQNvc1zaQoYvjj8DPEcMiai8TwiJH+fD3w9p8BX43YXyMmGvv8Vpt+qRhmA8Twy45nbd0ccicGH0Z65wngseS8erN7R9ihpkFcLGvHAh++CvzfZZXXr0Jvf3JZ+0QMOOY8YE4FdOvMNPIwUQzoDYps2fp/N++1VFWssvv+02LV3YX3iVV4q53Xl8wiHaULjA3KIr1wB/D8beL7L/w/YPwMY57XbmfdKIbb4lEx/PbRe3ZvEbmMoqqVVXXU1dWFxsZGdHZ2oqGhwe7NKdyHrwH/c7aYwnn8QuDzFdQd0mi7XwLunC+GYE68BDjqsyJtr8gvr/ivx6v7nSfL7+Tjyvx/s+k9APz6TKBjOzD+JGDxH8RKqZXq1QdEMAeIIGn8dDE27/En/+sT/36PTwzZ6H/WHqf/Ofl3/TH4zH+KRe4UD7DgXrH4nZMc3AnccQbQuw+YOg+YebnYL14/4A0k910g+bNf9zf5ffJvcp+9vR5Y8yVATQBn/hD4p+/Y++8zWrQP+O05YqjqkKliFpb8fEER+0FRdD/Lz17m75KPS/s58+9mPj7zd/LxZLVirt/uCT7ig+KuMhHTfcXTf47H8v897efB9J8HukTnxUmnAZc8JFaYdLLXfg/c92W7t0LIFrgkYmI9lRETga/+FagbY/dWDu+pn4pF/YykD0aiyWzAp38qFr1zog9eBH47X7z3pZLBXDwiAo8TLhatyp14QetuEwFbl8FDVZVg2IAmX5BVbsCEjEAu3/+DAp+zxG3I/Lv8nddv+IrqDD6yiUWAH4817vmyGXs0cOkf7ZvCabWX14r1UeJRcZLWfyXiye+T/03o/x7XPUbN8rvkz+WqHQMsfhQYe2T5z2UFVQWe/g/gjceGBrcy+I0PZg+E1QJXLj3lasNPOBXnnSeAp34GRLvFDUU8KvZRPPmV+X0+HzsLuOgeZ99MtL8OrP+hyBipCQDyM4mMn9U8P6vD/D1RxGOSP5O5fDXADR8a+pQMPrJJJMR0y8wUdrafs6a1s/2c8TVqSvVNv6tk8kQ0JJCJ605UWYIW+beGlsoeajFSIvlv17J4WYIXXw3QMM7uLa0sqprcX9FUYCe/hyoaczkx41ENig1WCnq8/nco4Dl1QVNB21DI40sN3Ix8fEJcswxetbqY67d7rpQeD3DWD+3eCiqGooihFLuXKK8GHg8AT3U2srOToqTqPqiyaMMMnBfhRHxXiYiIyFIMPoiIiMhSDD6IiIjIUgw+iIiIyFIMPoiIiMhSDD6IiIjIUgw+iIiIyFIMPoiIiMhSDD6IiIjIUgw+iIiIyFIMPoiIiMhSDD6IiIjIUgw+iIiIyFIVt6qtqqoAxNK8REREVB3kdVtex/OpuOCju7sbADBhwgSbt4SIiIiK1d3djcbGxryPUdRCQhQLJRIJ7NmzB/X19VAUxdDn7urqwoQJE7Br1y40NDQY+txUPr4/lY/vUWXj+1P5nPweqaqK7u5utLS0wOPJX9VRcZkPj8eD8ePHm/oaDQ0NjnvTnYTvT+Xje1TZ+P5UPqe+R8NlPCQWnBIREZGlGHwQERGRpVwVfASDQfzwhz9EMBi0e1MoC74/lY/vUWXj+1P5+B4JFVdwSkRERM7mqswHERER2Y/BBxEREVmKwQcRERFZisEHERERWco1wccvf/lLTJ48GTU1NZg+fTqefvppuzep6i1fvhwnnXQS6uvrMXbsWHz+85/Hm2++mfYYVVXR2tqKlpYWhEIhzJkzB9u2bUt7TCQSwTe/+U2MHj0atbW1+OxnP4sPPvgg7TEdHR245JJL0NjYiMbGRlxyySU4ePBg2mN27tyJz3zmM6itrcXo0aPxrW99C9Fo1JR/ezVavnw5FEXBkiVLtN/x/bHf7t27cfHFF+OQQw5BOBzGCSecgJdeekn7O98j+8RiMdxwww2YPHkyQqEQpkyZgptuugmJREJ7DN+fEqkusHbtWtXv96t33HGH+tprr6nXXHONWltbq+7YscPuTatqZ599tnrnnXeqr776qrplyxZ1/vz56sSJE9Wenh7tMbfccotaX1+vPvDAA+rWrVvVCy+8UB03bpza1dWlPeaKK65QDz30UHX9+vXq5s2b1dNPP109/vjj1Vgspj3mn//5n9Vp06apGzduVDdu3KhOmzZNPffcc7W/x2Ixddq0aerpp5+ubt68WV2/fr3a0tKiXn311dbsjAr3wgsvqIcddph63HHHqddcc432e74/9vroo4/USZMmqZdeeqn6/PPPq9u3b1efeOIJ9Z133tEew/fIPj/+8Y/VQw45RH300UfV7du3q/fff79aV1enrly5UnsM35/SuCL4+OQnP6leccUVab878sgj1e9973s2bZEztbe3qwDUDRs2qKqqqolEQm1ublZvueUW7TEDAwNqY2Oj+qtf/UpVVVU9ePCg6vf71bVr12qP2b17t+rxeNQ//elPqqqq6muvvaYCUJ977jntMc8++6wKQH3jjTdUVVXVxx57TPV4POru3bu1x9xzzz1qMBhUOzs7zftHV4Hu7m516tSp6vr169XZs2drwQffH/tde+216mmnnZbz73yP7DV//nz1sssuS/vdeeedp1588cWqqvL9KYfjh12i0SheeuklzJs3L+338+bNw8aNG23aKmfq7OwEAIwaNQoAsH37drS1taXt+2AwiNmzZ2v7/qWXXsLg4GDaY1paWjBt2jTtMc8++ywaGxsxc+ZM7TEnn3wyGhsb0x4zbdo0tLS0aI85++yzEYlE0lLYbnTVVVdh/vz5OOuss9J+z/fHfo888ghmzJiBCy64AGPHjsWJJ56IO+64Q/s73yN7nXbaafjLX/6Ct956CwDw8ssv45lnnsE555wDgO9POSpuYTmj7d+/H/F4HE1NTWm/b2pqQltbm01b5TyqquI73/kOTjvtNEybNg0AtP2bbd/v2LFDe0wgEMDIkSOHPEb+/21tbRg7duyQ1xw7dmzaYzJfZ+TIkQgEAq5+n9euXYvNmzdj06ZNQ/7G98d+7733Hm677TZ85zvfwfe//3288MIL+Na3voVgMIgvf/nLfI9sdu2116KzsxNHHnkkvF4v4vE4br75ZixYsAAAP0PlcHzwISmKkvazqqpDfkelu/rqq/HKK6/gmWeeGfK3UvZ95mOyPb6Ux7jJrl27cM0112DdunWoqanJ+Ti+P/ZJJBKYMWMGli1bBgA48cQTsW3bNtx222348pe/rD2O75E97r33Xtx1111Ys2YNjjnmGGzZsgVLlixBS0sLFi9erD2O70/xHD/sMnr0aHi93iGRYXt7+5AokkrzzW9+E4888gj+9re/Yfz48drvm5ubASDvvm9ubkY0GkVHR0fex3z44YdDXnffvn1pj8l8nY6ODgwODrr2fX7ppZfQ3t6O6dOnw+fzwefzYcOGDfjv//5v+Hw+bb/w/bHPuHHjcPTRR6f97qijjsLOnTsB8DNkt+9+97v43ve+h4suugjHHnssLrnkEnz729/G8uXLAfD9KYfjg49AIIDp06dj/fr1ab9fv349Zs2aZdNWOYOqqrj66qvx4IMP4q9//SsmT56c9vfJkyejubk5bd9Ho1Fs2LBB2/fTp0+H3+9Pe8zevXvx6quvao855ZRT0NnZiRdeeEF7zPPPP4/Ozs60x7z66qvYu3ev9ph169YhGAxi+vTpxv/jq8CZZ56JrVu3YsuWLdrXjBkzsGjRImzZsgVTpkzh+2OzU089dcj09LfeeguTJk0CwM+Q3fr6+uDxpF8mvV6vNtWW708ZLC5wtYWcavub3/xGfe2119QlS5aotbW16vvvv2/3plW1b3zjG2pjY6P65JNPqnv37tW++vr6tMfccsstamNjo/rggw+qW7duVRcsWJB1Gtr48ePVJ554Qt28ebN6xhlnZJ2Gdtxxx6nPPvus+uyzz6rHHnts1mloZ555prp582b1iSeeUMePH1+109DMop/toqp8f+z2wgsvqD6fT7355pvVt99+W7377rvVcDis3nXXXdpj+B7ZZ/Hixeqhhx6qTbV98MEH1dGjR6tLly7VHsP3pzSuCD5UVVV/8YtfqJMmTVIDgYD6iU98QpsOSqUDkPXrzjvv1B6TSCTUH/7wh2pzc7MaDAbVT33qU+rWrVvTnqe/v1+9+uqr1VGjRqmhUEg999xz1Z07d6Y95sCBA+qiRYvU+vp6tb6+Xl20aJHa0dGR9pgdO3ao8+fPV0OhkDpq1Cj16quvVgcGBsz651elzOCD74/9/vCHP6jTpk1Tg8GgeuSRR6q333572t/5Htmnq6tLveaaa9SJEyeqNTU16pQpU9Trr79ejUQi2mP4/pRGUVVVtTPzQkRERO7i+JoPIiIiqiwMPoiIiMhSDD6IiIjIUgw+iIiIyFIMPoiIiMhSDD6IiIjIUgw+iIiIyFIMPoiIiMhSDD6IiIjIUgw+iIiIyFIMPoiIiMhSDD6IiIjIUv8fjsTuwQxmbGoAAAAASUVORK5CYII=",
"text/plain": [
"<Figure size 640x480 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"plt.plot(time_day_sequence, soc_day_sequence)\n",
"plt.plot(time_day_sequence, temp_day_sequence)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"To run, the life model needs timeseries data: the time in seconds since beginning-of-life of the battery, the state-of-charge of the battery (0 to 1), and the ambient temperature (or battery temperature, if you have a thermal model)."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Set the `expected_rate` (expected number of discharges per day) and the `number_of_years` (number of years to simulate).\n",
"\n",
"The code below will simulate one day at a time for the given time. \n",
"\n",
"It should not take more than 20s.\n",
"\n",
"There might be occasional runtime warnings"
]
},
{
"cell_type": "code",
"execution_count": 5,
"metadata": {},
"outputs": [],
"source": [
"# expected_rate parameter is the expected number of discharges per day\n",
"expected_rate = 42 / 236.0\n",
"number_of_years = 30\n",
"# 1 year simulation\n",
"cell = Nmc111_Gr_Kokam75Ah_Battery()\n",
"total_day_time = 60 * 60 * 24\n",
"t_days = np.arange(365 * number_of_years)\n",
"for day in t_days:\n",
" num_discharges = np.random.poisson(expected_rate, 1)\n",
" soc_day_sequence, temp_day_sequence, time_day_sequence = profile.generate_day_values(num_discharges)\n",
" cell.update_battery_state(\n",
" t_secs=np.array([total_day_time * day + time for time in time_day_sequence]),\n",
" soc = (soc_day_sequence)/100, # from 0 to 1\n",
" T_celsius=temp_day_sequence\n",
" )"
]
},
{
"cell_type": "code",
"execution_count": 6,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "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",
"text/plain": [
"<Figure size 640x480 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"plt.plot(cell.stressors['t_days']/365, cell.outputs['q'])\n",
"plt.xlabel('Time (years)')\n",
"plt.ylabel('Relative discharge capacity')\n",
"plt.ylim((0.7, 1.02))\n",
"plt.show()"
]
},
{
"attachments": {},
"cell_type": "markdown",
"metadata": {},
"source": [
"The battery model should be run in timesteps relavent to battery degradation, such as once per day. Larger or smaller timesteps could be used if desired, but timesteps should avoid splitting up cycles, or at least be long enough that miscounting cycles due to splitting them up does not introduce much error.\n",
"\n",
"Each battery model tracks the history of it's inputs (`stressors`), calculated degradation rates (`rates`), internal states (`states`), and outputs (`outputs`) each time `update_battery_state` is called. Debugging models is easier because the values of all inputs, internal calculations, and outputs are tracked."
]
},
{
"attachments": {},
"cell_type": "markdown",
"metadata": {},
"source": [
"The cell resistance and capacity trajectories are wiggily because the temperature of the battery is varying throughout each year, varying the degradation rate. Dispatch is the same each day, so that is constant.\n",
"\n",
"The model keeps track of how much charge-throughput has occured throughout life, as well, based on the input state-of-charge timeseries. Conversion from charge-throughput, in Amp-hours, to changes of cell state-of-charge, which is dependent on battery performance (health, temperature and SOC dependent resistances), is assumed to happen externally to the model. This simple simulation is essentially assuming that the current magnitude is continuously being adjusted based on the the state-of-health of the battery."
]
},
{
"cell_type": "code",
"execution_count": 7,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAAAk0AAAGwCAYAAAC0HlECAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjcuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8pXeV/AAAACXBIWXMAAA9hAAAPYQGoP6dpAABfFklEQVR4nO3deVxUVf8H8M+wDiCgiLKDuIMIIiqbS5rilo9LT6ImitriUz0uZJmZaxZZT6aWYuaW5VappaUm5h6urIqKKCiIIKKyKLLN3N8f/Lw5gjqjA3cYPu/Xa14v5twzl+/Bko/nnnuuTBAEAURERET0RAZSF0BERERUFzA0EREREamBoYmIiIhIDQxNRERERGpgaCIiIiJSA0MTERERkRoYmoiIiIjUYCR1AbpIqVTi+vXrsLS0hEwmk7ocIiIiUoMgCCgqKoKjoyMMDLQ/L8TQVI3r16/DxcVF6jKIiIjoGWRmZsLZ2Vnr52VoqoalpSWAyh+6lZWVxNUQERGROgoLC+Hi4iL+Htc2hqZqPLgkZ2VlxdBERERUx9TU0houBCciIiJSA0MTERERkRoYmoiIiIjUwNBEREREpAaGJiIiIiI1MDQRERERqYGhiYiIiEgNDE1EREREamBoIiIiIlIDQxMRERGRGhiaiIiIiNTA0ERERESkBoYmIiIiIjUwNBERERGpgaGJiIiISA0MTURERERqYGgiIiIiUoOkoenw4cMYNGgQHB0dIZPJ8Ouvvz71M4cOHYKfnx/kcjmaN2+OFStWVOmzdetWeHp6wtTUFJ6enti+fXsNVE9ERET1iaSh6d69e/Dx8cE333yjVv/09HQMGDAA3bp1Q3x8PD788ENMmjQJW7duFfscO3YMoaGhCAsLQ2JiIsLCwjB8+HCcOHGipoZBRERE9YBMEARB6iIAQCaTYfv27RgyZMhj+0yfPh07duzA+fPnxbaJEyciMTERx44dAwCEhoaisLAQu3fvFvv069cPjRo1wqZNm6o9b2lpKUpLS8X3hYWFcHFxQUFBAaysrJ5zZP84n12IqVsSYG8tx7pxXbR2XiIiIqr8/W1tba31398P1Kk1TceOHUNISIhKW9++fXH69GmUl5c/sU9MTMxjzxsZGQlra2vx5eLiov3iAdwvV+BCThHSbt6rkfMTERFRzalToSknJwd2dnYqbXZ2dqioqEBeXt4T++Tk5Dz2vDNmzEBBQYH4yszM1H7xREREVKcZSV2ApmQymcr7B1cXH26vrs+jbQ8zNTWFqampFqskIiIifVOnZprs7e2rzBjl5ubCyMgIjRs3fmKfR2efiIiIiDRRp0JTYGAgoqOjVdr27t2LTp06wdjY+Il9goKCaq1OIiIi0j+SXp67e/cuLl26JL5PT09HQkICbGxs4OrqihkzZiArKwvr168HUHmn3DfffIOIiAi8/vrrOHbsGFavXq1yV9zkyZPRvXt3LFy4EIMHD8Zvv/2Gffv24ejRo7U+PiIiItIfks40nT59Gr6+vvD19QUAREREwNfXF7NnzwYAZGdnIyMjQ+zv7u6OXbt24eDBg+jQoQM+/vhjLF26FC+//LLYJygoCJs3b8batWvh7e2NdevWYcuWLfD396/dwREREZFe0Zl9mnRJTe3zEJdxB8OWx8DVxhyH3++ptfMSERER92kiIiIi0gkMTURERERqYGgiIiIiUgNDExEREZEaGJqIiIiI1MDQRERERKQGhiYiIiIiNTA0EREREamBoYmIiIhIDQxNRERERGpgaCIiIiJSA0MTERERkRoYmoiIiIjUwNBEREREpAaGJiIiIiI1MDQRERERqYGhiYiIiEgNDE1EREREamBoIiIiIlIDQxMRERGRGhiaiIiIiNTA0ERERESkBoYmIiIiIjUwNBERERGpgaGJiIiISA0MTURERERqYGgiIiIiUgNDUy0ykMkAAIUl5VAqBYmrISIiIk0wNNWi1nYNAAD5xeW4ebdU4mqIiIhIEwxNtcjcxAhy48ofeVmFUuJqiIiISBMMTbXM2KDyR17By3NERER1CkNTLTMyrFzXVKHgTBMREVFdwtBUywz/f6apXMGZJiIiorqEoamWNTA1BABcvFEkcSVERESkCYamWubv3hgAsD0+S+JKiIiISBMMTbVsaEcnAMChizeRx20HiIiI6gyGplrm724Deys5ACAhI1/aYoiIiEhtDE21TCaTwd5aLnUZREREpCGGJgmYGFX+2NPz7klcCREREamLoUkCndwaAQB+P5MtcSVERESkLoYmCfTxtAMApN+8K3ElREREpC6GJglYmxlLXQIRERFpiKGJiIiISA0MTRLig1SIiIjqDoYmCZiZVD5KpaikAvfLFBJXQ0REROpgaJKAg7WZ+HVOYYmElRAREZG6JA9N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",
"text/plain": [
"<Figure size 640x480 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"plt.plot(cell.stressors['efc'], cell.outputs['q'])\n",
"plt.xlabel('Equivalent full cycles')\n",
"plt.ylabel('Relative discharge capacity')\n",
"plt.ylim((0.7, 1.02))\n",
"plt.show()"
]
},
{
"attachments": {},
"cell_type": "markdown",
"metadata": {},
"source": [
"This dispatch has a little more than 1 EFC per day.\n",
"\n",
"We can plot the separate contributions to capacity or resistance fade, as well."
]
},
{
"cell_type": "code",
"execution_count": 8,
"metadata": {},
"outputs": [
{
"data": {
"text/plain": [
"(0.5, 1.02)"
]
},
"execution_count": 8,
"metadata": {},
"output_type": "execute_result"
},
{
"data": {
"image/png": "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qRR+fn4IDQ1VGg8NDUVgYOBz1z158iTu3LmDcePGqfx+REREVDuoXW4GDhyIefPmoaSkBEDZbqWkpCR89tlnGDJkiFrbmjp1KtavX4+NGzfi+vXrmDJlCpKSkjBx4kQAZbuURo0aVW69DRs2oF27dvD29lY3PhEREek4tXdLLVq0CH369IG9vT2ePHmCLl26IC0tDQEBAfjf//6n1raGDh2KzMxMzJs3D6mpqfD29sahQ4cUZz+lpqaWu+ZNdnY29uzZg+XLl6sbnYiIiGqBSl/n5vjx47h06RLkcjlat26Nnj17ajqbVvA6N0RERDWPOn+/1S43iYmJcHNze5l8omK5ISIiqnm0ehG/hg0bomPHjli7dq3iAn5ERERE1YXa5SYiIgIBAQGYP38+6tWrh4EDB2L37t0oKirSRj4iIiIitahdblq3bo3vvvsOSUlJOHz4MOzt7TFhwgTY29vj7bff1kZGIiIiIpVp5MaZly5dwrhx43D16lXIZDJN5NIaHnNDRERU82j9xpkAkJycjIULF8LX1xdt2rSBmZkZVq5cWdnNEREREWmE2te5WbduHbZt24a///4bHh4eGDFiBPbv31+jz6AiIiIi3aF2ufn6668xbNgwLF++HL6+vlqIRERERFR5apebpKQkle7aTURERCQGlcrN1atX4e3tDT09PURHRz932RYtWmgkGBEREVFlqFRufH19kZaWBnt7e/j6+kIikeDfJ1k9fS6RSKr92VJERESk21QqNwkJCahbt67i30RERETVlUrl5uldugHg7t27CAwMhIGB8qqlpaU4c+aM0rJEREREVU3t69x069atwntKZWdno1u3bhoJRURERFRZapebp8fW/FdmZibMzMw0EoqIiIioslQ+FXzw4MEAyg4eHjNmDIyMjBSvyWQyXL16FYGBgZpPSERERKQGlcuNlZUVgLKZGwsLC5iYmChek0qlaN++Pd59913NJyQiIiJSg8rlZtOmTQAANzc3TJ8+nbugiIiIqFrSyF3BaxLeFZyIiKjmUefvt9q3XwCAX3/9Fbt27UJSUhKKi4uVXrt06VJlNklERESkEWqfLbVixQqMHTsW9vb2iIqKQtu2bWFra4v4+HgEBwdrIyMRERGRytQuN6tWrcK6deuwcuVKSKVSfPLJJwgNDcVHH32E7OxsbWQkIiIiUpna5SYpKUlxyreJiQlyc3MBAG+99Ra2b9+u2XREREREalK73Dg6OiIzMxNA2W0Zzp07B6DsnlO17NhkIiIiqobULjfdu3fH77//DgAYN24cpkyZgl69emHo0KF49dVXNR6QiIiISB1qnwoul8shl8sVN87ctWsXwsPD0bhxY0ycOBFSqVQrQTWFp4ITERHVPOr8/eZ1boiIiKja0/h1bq5evarym7do0ULlZYmIiIg0TaVy4+vrC4lE8sIDhiUSCWQymUaCEREREVWGSuUmISFB2zmIiIiINEKlctOgQQNt5yAiIiLSCLVPBQeArVu3okOHDqhXrx7u3r0LAFi2bBl+++03jYYjIiIiUpfa5Wb16tWYOnUq+vTpg8ePHyuOsbG2tsayZcs0nY+IiIhILWqXm++//x4//vgjZs2aBX19fcW4v78/oqOjNRqOiIiISF1ql5uEhAS0atWq3LiRkRHy8/M1EoqIiIiostQuN+7u7rh8+XK58cOHD6N58+aayERERERUaSqdLfVvM2bMwPvvv4/CwkIIgoALFy5g+/btCAkJwfr167WRkYiIiEhlapebsWPHorS0FJ988gkKCgowfPhwODs7Y/ny5Rg2bJg2MhIRERGp7KXuLZWRkQG5XA57e3sAQEpKCpydnTUWTht4bykiIqKaR52/35W6zs1TdnZ2sLe3R1paGj788EM0btz4ZTZHRERE9NJULjePHz/GiBEjULduXdSrVw8rVqyAXC7Hl19+iYYNG+LcuXPYuHGjNrMSERERvZDKx9x8/vnnOHXqFEaPHo0jR45gypQpOHLkCAoLC3H48GF06dJFmzmJiIiIVKJyuTl48CA2bdqEnj17YtKkSWjcuDGaNm3KqxITERFRtaLybqn79+8rrmPTsGFDGBsb45133tFaMCIiIqLKULncyOVyGBoaKp7r6+vDzMxMK6GIiIiIKkvl3VKCIGDMmDEwMjICABQWFmLixInlCs7evXs1m5CIiIhIDSqXm9GjRys9HzlypMbDEBEREb0slcvNpk2btJmDiIiISCNe6iJ+RERERNUNyw0RERHpFJYbIiIi0iksN0RERKRTWG6IiIhIp7DcEBERkU5huSEiIiKdwnJDREREOkXli/jVNjKZDCUlJWLHqHGkUin09NiZiYhIPCw3/yEIAtLS0vD48WOxo9RIenp6cHd3h1QqFTsKERHVUiw3//G02Njb28PU1BQSiUTsSDWGXC7H/fv3kZqaCldXV353REQkCpabf5HJZIpiY2trK3acGqlu3bq4f/8+SktLYWhoKHYcIiKqhUQ/OGLVqlVwd3eHsbEx/Pz8cPr06ecuX1RUhFmzZqFBgwYwMjJCo0aNsHHjRo1keXqMjampqUa2Vxs93R0lk8lETkJERLWVqDM3O3fuxOTJk7Fq1Sp06NABa9euRXBwMGJjY+Hq6lrhOm+88QYePHiADRs2oHHjxkhPT0dpaalGc3F3SuXxuyMiIrGJWm6WLFmCcePG4Z133gEALFu2DEePHsXq1asREhJSbvkjR47g5MmTiI+Ph42NDQDAzc2tKiMTERFRNSfabqni4mJERkYiKChIaTwoKAhnzpypcJ0DBw7A398fCxcuhLOzM5o2bYrp06fjyZMnz3yfoqIi5OTkKD2IiIhId4k2c5ORkQGZTAYHBwelcQcHB6SlpVW4Tnx8PMLDw2FsbIx9+/YhIyMDkyZNQlZW1jOPuwkJCcFXX32l8fxERERUPYl+QPF/j9EQBOGZx23I5XJIJBJs27YNbdu2RZ8+fbBkyRJs3rz5mbM3M2fORHZ2tuKRnJys8c9ARERE1YdoMzd2dnbQ19cvN0uTnp5ebjbnKScnJzg7O8PKykox5unpCUEQcO/ePTRp0qTcOkZGRjAyMqp0TkEQ8KREnDN/TAz11TpANz8/H++99x727t0LCwsLTJ8+Hb///jt8fX2xbNky7QUlIiKqRkQrN1KpFH5+fggNDcWrr76qGA8NDcXAgQMrXKdDhw7YvXs38vLyYG5uDgC4desW9PT0UL9+fa3kfFIiQ/Mvj2pl2y8SO683TKWq/59oxowZOHHiBPbt2wdHR0d8/vnniIyMhK+vr/ZCEhERVTOi7paaOnUq1q9fj40bN+L69euYMmUKkpKSMHHiRABlu5RGjRqlWH748OGwtbXF2LFjERsbi1OnTmHGjBl4++23YWJiItbHqBby8vKwYcMGLFq0CL169YKPjw9++uknpevNLF68GHPmzCm3bkXjixcvxqxZs7Sem4iISNNEPRV86NChyMzMxLx585Camgpvb28cOnQIDRo0AACkpqYiKSlJsby5uTlCQ0Px4Ycfwt/fH7a2tnjjjTcwf/58rWU0MdRH7LzeWtv+i95bVXFxcSguLkZAQIBizMbGBh4eHornMTExCA4OLrduReMxMTHo3Vucz01ERPQyRL/9wqRJkzBp0qQKX9u8eXO5sWbNmiE0NFTLqf4hkUjU2jUkFkEQXrhMTEwMZsyYodJ4TEwMpk2bprF8REREVUX0s6VIMxo3bgxDQ0OcO3dOMfbo0SPcunULQFn5iYuLQ9OmTZXWq2hcEATcuXNHadaHiIiopqj+UxKkEnNzc4wbNw4zZsyAra0tHBwcMGvWLOjplfXX+Ph41K9fHwYGyv8nr2j86RhvfElERDURy40O+e6775CXl4cBAwbAwsIC06ZNQ3Z2NoCy3UxeXl7l1qloPCYmBj4+PlWSmYiISNO4W0qHmJubY+vWrcjPz0daWprScTQxMTHw9vYut05F489aloiIqCZguaklrl27hqVLl8LNzQ1ubm4YNmzYM8evXbvGckNERDUWd0vVEr/88ota40RERDUVy42OCwsLEzsCERFRleJuKSIiItIpLDdERESkU1huiIiISKew3BAREZFOYbkhIiIincJyQ0RERDqF5YaIiIh0CssNERER6RSWGyIiItIpLDdERESkU1huiIiISKfw3lIvIghASYE4721oCkgkKi+en5+P9957D3v37oWFhQWmT5+O33//Hb6+vli2bJn2chIREVUjLDcvUlIAfFNPnPf+/D4gNVN58RkzZuDEiRPYt28fHB0d8fnnnyMyMhK+vr7ay0hERFTNcLeUjsjLy8OGDRuwaNEi9OrVCz4+Pvjpp58gk8kUyyxevBhz5sx55jYGDx6Mrl27Ko0tXrwYEokEN2/eVIyNHz8eenp6yM/P1/jnICIielmcuXkRQ9OyGRSx3ltFcXFxKC4uRkBAgGLMxsYGHh4eiucxMTEIDg6ucP2oqCikpaUhPj5eaTwmJgY+Pj64efMmPDw8kJCQgIiICDRs2BBmZqrPKhEREVUVzty8iERStmtIjIcax9sIgvDCZWJiYuDt7V3ha7Nnz8aCBQtgZmaGjIwMpXXeeOMNxczN119/jUGDBsHLy0vlbERERFWJ5UZHNG7cGIaGhjh37pxi7NGjR7h16xaAsvITFxeHpk2bllv3/PnzKCoqQufOneHp6YnY2FjFOomJiejXrx9u3LiB27dvIyUlBba2ts8sSURERGJjudER5ubmGDduHGbMmIG//voLMTExGDNmDPT0yv5PHB8fj/r168PAoPye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gTh9+jQSEhJw8uRJfPzxx7h3716F6+jp6aFnz54IDw+vcHspKSn48ccf8fbbbyu99uWXX2LLli2YO3curl27huvXr2Pnzp344osvAJSVptLSUnz//feIj4/H1q1bsWbNmhd+hoSEBMycORNnz57F3bt3cezYMdy6dQuenp6KZU6fPo2GDRuiUaNG6nw9RKQilhsiqjZMTU1x6tQpuLq6YvDgwfD09MTbb7+NJ0+ePHcmZ/z48dixY4di99ZTlpaWGDJkCMzNzTFo0CCl13r37o0//vgDoaGhaNOmDdq3b48lS5agQYMGAABfX18sWbIE3377Lby9vbFt2zaEhISo9Blu3LiBIUOGoGnTphg/fjw++OADTJgwQbHM9u3b8e6776rxzRCROniFYiKq8QRBQPv27TF58mS8+eabSq/16tULnp6eWLFihUjplMXExKBHjx64desWrKysxI5DpJM4c0NENZ5EIsG6deuULsCXlZWFHTt24Pjx43j//fdFTKfs/v372LJlC4sNkRZx5oaIdJKbmxsePXqE2bNnY/r06WLHIaIqxHJDREREOoW7pYiIiEinsNwQERGRTmG5ISIiIp3CckNEREQ6heWGiIiIdArLDREREekUlhsiIiLSKSw3REREpFP+DxSk5ZYVpfyNAAAAAElFTkSuQmCC",
"text/plain": [
"<Figure size 640x480 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"plt.plot(cell.stressors['t_days']/365, cell.outputs['q_LLI'])\n",
"plt.plot(cell.stressors['t_days']/365, cell.outputs['q_LAM'])\n",
"plt.plot(cell.stressors['t_days']/365, cell.outputs['q'], '--k')\n",
"plt.xlabel('Time (years)')\n",
"plt.ylabel('Relative discharge capacity')\n",
"plt.legend([r'q$_{LLI}$', r'q$_{LAM}$', 'q'])\n",
"plt.ylim((0.5, 1.02))"
]
},
{
"attachments": {},
"cell_type": "markdown",
"metadata": {},
"source": [
"From the result, the cell will experience sudden failure very shortly; considering this is near 70% remaining capacity, this is physically reasonable."
]
},
{
"cell_type": "code",
"execution_count": 9,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "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",
"text/plain": [
"<Figure size 640x480 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"plt.plot(cell.stressors['t_days']/365, cell.outputs['r_LLI'])\n",
"plt.plot(cell.stressors['t_days']/365, cell.outputs['r_LAM'])\n",
"plt.plot(cell.stressors['t_days']/365, cell.outputs['r'], '--k')\n",
"plt.xlabel('Time (years)')\n",
"plt.ylabel('Relative DC resistance')\n",
"plt.legend([r'r$_{LLI}$', r'r$_{LAM}$', 'r'])\n",
"plt.show()"
]
}
],
"metadata": {
"kernelspec": {
"display_name": "base",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.10.12"
},
"orig_nbformat": 4,
"vscode": {
"interpreter": {
"hash": "e4cce46d6be9934fbd27f9ca0432556941ea5bdf741d4f4d64c6cd7f8dfa8fba"
}
}
},
"nbformat": 4,
"nbformat_minor": 2
}