diff --git a/docs/examples/pyEQL_Carbonate_System_Guide v1+RK.ipynb b/docs/examples/pyEQL_Carbonate_System_Guide v1+RK.ipynb new file mode 100644 index 0000000..3facf6b --- /dev/null +++ b/docs/examples/pyEQL_Carbonate_System_Guide v1+RK.ipynb @@ -0,0 +1,390 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": { + "id": "XpoZsdg7uIVJ" + }, + "source": [ + "# **Calculating Carbonate System Equilibrium with `pyEQL`**" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "ZZZWMSR3zFCG", + "jp-MarkdownHeadingCollapsed": true + }, + "source": [ + "![pyeql-logo.png](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABAkAAAE4CAYAAAA5GaouAAAACXBIWXMAAC4jAAAuIwF4pT92AAAgAElEQVR4nOzBAQEAMAzDoNy/6E7IgbctAAAA4HPVAQAA///s0AENAAAAwqDP/qEtAhGYAgAAAKDqAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s0KEKgEAAg+GdGOwGMdlNRpPvbjRdNJotgu3aLOITKMjxfw+wsZXc8K1hdXcXNJKSpDPYKfbFnuvmN03LUUlqg/2kzmO95bANAAAAAH5F0gUAAP//7NghC4QADIbhd8Vs1GrQJAdGsdwPN9osBsFqOrCYBWGiRYNRkIPvqSvjbZv55fiSZxT9+gEyILWbvuZuwAIMQNfmwaj0p28zxUAJJEC4D4yj2dXP3PdnQVNX0fz+1iIiIiIiIn8O2AAAAP//Gh0koCIwu/gDNDjgwMDAwA839T9q55aRAeugAWiQYMcJQ+4XQ8m/1AbOh5+DBgd8Gf//V0Q3mhE9HFHT7TUGBobNuxxkRgcLRsEoGAWjYBSMglEwCkbBKBgFo4BcwMDAAAAAAP//Gh0koAKwOP8VtCQ+gPH/fw1k09A7tmCAFt5oavYfNeXfP1j9SUvgfuCxKwMDgwsDtnDDvRoDmQ/ayrFxm4vimaEaBqNgFIyCUTAKRsEoGAXUBoyMjKBVmQZQYx2gtAIUw4A9GdZ+ZGBguIDEB7E/QDGY/f///wt49I+CUTAKBiNgYGAAAAAA//8aHSSgEFif/ggaIEhiZPgvgW4SgdlvrGoYGBjuM/z/v/SgpciPQeVRGgGvPfc5GRgYEqBbC7AOrKCHG5atB8gDCac3u6uuGDohMApGwSgYBaNgFIyCUUA5YGRkhHX8HZAGAcjp/FMbwAYTQPgBjP3///8Po9E+CkbBIAQMDAwAAAAA//8aHSSgANifeAsaIEhhYGCQILBCACaGYRl6hxeqBjRAsGSvjcS9weNb6gPfnbelGRgYEhkYGARhhpM5sIKu7tB6b831g9v3o2AUjIJRMDwAIyMjqEMyIlfBjQKC4OD///8dRoOJ+gC6OsABukIARvPT2x0UgofQAYMDIDy66mBgAb3L8v/YVlyPgsEBGBgYAAAAAP//Gh0koAA4HX0ZAjqnkAFbZ5aYGXHCao7ucpDZPND+pAUI2HbDjPH//0hMo0kfJMChZu5qf71Lg9Lzo2AUjIJRMIzA6CDBKMADRgcJqASQBgVgWH9YeAwTHGRgYNgwOmhAfzA6SDAK4ICBgQEAAAD//xodJCATuB58Cloen8ZA/AoBUs8ngIk9Y2BgWLDNRXFYHMoXvPkKaHtBEOicRzIGTTAGEbCpgZrznYGBoW5FkNF3qjl+FIyCUTAKRgEGGB0kGAV4wOggAQUAun0gAIoHw7YBeoOPsAEDED26PYG2YHSQYBTAAQMDAwAAAP//YhkNDfIA898/bgwMDEwMZC6RJ2ZgAQz+/5dhYGAo8d15e/lmd9UrA+RdqoCwDReEmCEDK9IUrBBAP9QQ16ABN2ixBwMDw9bB4ftRMApGwSgYBaNgFIwC/AA6MFAwzFcLEAtA2yfioXg+IyPjRuigweiAwSgYBbQEDAwMAAAAAP//Gh0kIAP47LorxcLAoMJA+BA9OKBwIIGLgYEhOXDr9dMMDP/Xr/fWGnKz41FrzuizMDDEMjAwcIIFyBw0IXH1gcvoIMEoGAWjYBSMglEwCgYzQFoxkDA6MIAX+EMxbMBgwf///zcMYveOglEwNAEDAwMAAAD//xodJCADMP/9Y4ZrFQEDZUvkCamxYGBgkA3deGnJan+9p3TzMIUgduUJH2YGBm80vxAcJCBnIAFNDXfSkkMG82LsRve0jYJRMApGwSgYBaNgUAFGRkbYwID/aMyQDMADBoyMjKAtCQsYGBgm/P///8EQ88MoGAWDEzAwMAAAAAD//xodJCADMP/9I0PtrQYkHNgnC1qGFrHu3LYVQUaDeg9o/LKjoBUQmcz//6shi5O7QoCcGyQYGf7Lo93hOwpGwSgYBaNgFIyCUTAgAHoAYQF0cEB+NBYoBqAtCfkgDF1dABosODDE/TQKRsHAAgYGBgAAAAD//xodJCADsPz5A+30UmeFAFZ1+PWB9tuHxqw6qc7AwLBwSZj5oNt+kLz4oCwLA0M2w///wuhy5JzPQOxViFgGEjQZGBg2kur+UTAKRsEoGAWjYBSMAmoB6JaCBui2gqF2VeFQAbDVBaCrFRv+//+/YKQHyCgYBWQBBgYGAAAAAP//Gh0kIAMw//2DfasBsQMCVLrmj+H/f0MGBga5+GVHpy+Msn5MSz+TAtIW7LVmZmBIwuZuYjr22NQRFUYMhLcsjIJRMApGwSgYBaNgFNALIA0OxI8GOt2APPTcgobRwYJRMArIAAwMDAAAAAD//xodJCADMP/9w8xA7qoB4pbIk7JCQRR01V/y4oOb58bab6Klv4kBmXN2pjAzMFhjczMDrjBC79xjDyNyB1aYqOrBUTAKRsEoGAWjYBSMAgJgdHBgUIDRwYJRMArIAQwMDAAAAAD//xodJCADMP/5w0S1JfLEdqQJDyT4p8/fo8HAwDBlZqLLN6p7mgDImbVNhOH//3xmBgY5kvxB5qAJCecTjK4kGAWjYBSMglEwCkYBXcDo4MCgBKODBaNgFJACGBgYAAAAAP//Gh0kIAOw/P3zk+H/f05kneR2dqk1kAA1B7T/vidr9o5J01I9btDC79hA/rRNmiz//xdAr2pEuAndv9S/GhLZbFwrFEZXEoyCUTAKRsEoGAWjgKYA6UDCgtEzBwYtgA0WJEAHC0YPOBwFowAbYGBgAAAAAP//Gh0kIAOw/Pl9i4GBwRBZJ9VO46d8OT4PAwNDVd70zTsnZfoupbbf0UHR5HXBzAwMQVTbeoHlXAEKBxKuk+KfUTAKRsEoGAWjYBSMAlIA9CrDCaO3FQwZYM/AwLCfkZFxIWhQ5////x9GeoCMglGAAhgYGAAAAAD//xrWgwRhGy6qMv/9w8D09++7pWFmb6llLvOfP6BBAmNkMXIO0aPxcnzPwinrtRkYGPr7cwJf4/UQGaC0fxXkekMGBhNiOvbk+o2YgQQC5lyjordHwSgYBaNgFIyCUTAKIG0NyNaCBdBO5ygYegC0JSQAtA3h////E0bjbxSMAihgYGAAAAAA//9i/I/1zv6hBzz2PeRk/vtXh/nvH13mv39BgwNcoFsImP/+ZQLTf/4wMf/7+5T575/jzH/+nJ+e4v6GXE/mztgC6iDPgPHJXSJPznJ8bGYRUAM6n2BGd0HoGVz+IRVU9iwDVYol0EMTiVr+T4MVAvjsgvFfN1Qnp1PL36NgFIyCUTAKMAEjI6MDaFZuNGhGARZw8P///w7DMWAYGRkLoGcPjG4tGB7gIAMDQ8L///8fjNQAoHdZ/n/0BrLBCxgYGAAAAAD//xrygwTOh59zsPz9Y8v0968dC2hg4M8fJqZ/fxlZQIMCf/8wMf39y8TyF5XN9PcvI2iwgOXvn/X92QFkzbIXTt0A6nzagjnkzJCT3wEmyxzG//8PMTAwLGwvifqK3UfEgZrORaACJBH5/AEqrhAg/eBH/GavqK1PX0GJf0fBKBgFo2AU4AejgwSjAA8YdoME0NUDGxgYGPQHgXNGAXXBR+hZBSNyVcHoIMEogAMGBgYAAAAA//8a0tsNnI6+lGT+9y+O8d8/YaZ//5gY//1jZPz/j5EJSoM6lEwg+h8qmwmixpbx3z/T0gmrF3cXhB4i1W7mP3/WMTAwmDL+/8+FIUn5Enmi1ZBglyMDA4NiTeeiqS3lcWSNkta3zc9h/v/fEc0u6viDAet2DAwlxGzrgKp5xcDAsBmnZ0gA/ttvSv9lZuH4y8ws9ZeZhf0vM/O9v8ws/w9Yid6nhvmjYBSMglEwCkbBKBj8YHT1wLAHoHjth54xMaJXFYyCEQ4YGBgAAAAA//8asisJHI++MmL699cXtHoAvlqAiFUEUDXIKwqYWP782dFWGr2QVDeU962wZ/z/PxNdnM4rBEgdSABtP1jZWJ20BdNR2EFT82wx0C4Dxv//FQj6g1g3kjFoguPARlzmVJa15V8myoNYQOTas6p/mZnN/zKz6PxjYmb/w8Ly7x8T8/+/LCz//jIx//vHzPzvDzMLiL72l5nl+jFj3vPk2jUKRsEoGAVDGYyuJBgFeMCwWEkAvbkAdPaA/yBwziigD/gIHSjYMFLCe3QlwSiAAwYGBgAAAAD//xqSgwT2x99oMv/7G8sMHQyAnzsAYTNCzyBgZv73lxF6FgHyuQSMYDlktRD2oqbKBKI7zjBQ3bU4G/nAGqqtEGDAu9eeMrMhak4yMDBMqq1Px7v9oLV+ug7Im6DtBeQOZFB5hQCyubjU9Bd3Fu/G4SW8IGHpEeF/zMzxf5hZVEADAX+ZWf79ZWZGGSCA05BBgv9/Iere/WVi3nDKgHN01HkUjIJRMKLA6CDBKMADhvwgASMjowF0e8HozQUjE0z8D7nme9iD0UGCUQAHDAwMAAAAAP//GnKDBHYn3wkw//mTy/TvLxcLouNP8ioCZPVMUP0sf//U19alXSHVTfVt80F79L3BHDI69gwD19kGLclvq2zKvofFWwwdNZOjQJPquOwjd4UA1c5wwO63vvyecrIGCFIX7LP+y8IS9peJmQN5gABK/wcPCoAHB8Dsv3AxxKqC//+YmI+f0ufYSY79o2AUjIJRMBTB6CDBKMADhvQgAXR7Qf8gcMooGFhwkYGBwWG4X5U4OkgwCuCAgYEBAAAA//8acoME9sffJDP/+6tM9CqCv4hBBDyrCGArDd7WNGSkkuOupubZTgwMDMkYZxSQu7KARsvxsZnFyPB/WWlbwTIYv7tqAjfj//9FDAwMFkhmEzaHWisEsPiFCLO/Mv7/350zofoYhkIiQOacnW7/mJnD/0JXDIAGA6Adf/ggAVgMbdsB0vaD/0iDCs//MjEvOq/N/IMct4yCUTAKRsFQAqODBKMADxiygwSMjIwLoFfkjYJRwADdfgAaKLgwXENjdJBgFMABAwMDAAAA//8aUoMEdiffKTL/+ZOCvBoAPgCA1PEnZRUB2q0HIP6kipbcveS4r61+GmjvfhXogECY2IAux2cgadYetH+/iYGBQZzx//9iBgYGJXz2EdOxx+YXcrdjMOC3/y4DA0NX1qS6u5j6CIO86Ztt/zEzJ/+Bbx9AdPzRBgoQWwywbDuAq4UMIlw/q8O6ihz3jIJRMApGwVACo4MEowAPGHKDBNDzBw6M3l4wCrAA0EBBwf///xcMx8AZHSQYBXDAwMAAAAAA//8aUrcbMP775wRavg++vQB6YwEj4iYDBkbI7QVM8BsNoDcZoNx6ANHHgO0GBOitB9EMDAxkDRJUNWaBlu8XdFZPAq1G8KPWcnxs6qi4rx/GB+25WwxVw03IjcQdUEglf+BXA1raPzVtWtMXDEVEgOJJa+WZmFnS/jMy/mdi/PefgREUan8Z/zOCkwcDE9M/RgZQMmGEijH+ZQKlOiYGUJL5xwiiYWLMUDVMIDP+/dMwuvrH7pw2C8k3Z4yCUTAKRsEoGAWjgP5g9PyBUUAAgG4/mA+6BvP///8No4E1CoYtYGBgAAAAAP//GjKDBOCzCP79U0LqzCNoJAwbAGCCDQD8g4vD1TMi6WP8hzALarZ4X1mPUlFXCdZ9+sSA8ta82T0VfVegS/bRO9wMaHxyBxKo3dkGAV6o4YTdSJ8VAoTcPSV5ZtsaTDOJB0z//sXBOvnwAQBG6AAAIyMDw9+/jKCRAybwAME/0CAAA5RmBG1TAQ8q/GP895/pH3jMCTqowAAdVLA3vPr34nlt5o+UuHEUjIJRMApGwSgYBbQF0AGCAyPgekPQ/voPUL+CwAUoHzSzewC/VgSArrgwgAoooGGDYR6O9dCBgoRB4JZRMAqoDxgYGAAAAAD//xoygwSM//4pMaGuBiBvFcE/xEAB8ioC2IACVJ8eAwMD2YMEIFDSUXR8Ykkn6EDDegYGBl2w4ODtbJOkhlorBLCqI8b/DP9B1zjmJczpuo1hCQmgqnupFiMLixaofw/r5DNAVwMwM4IHAMBLC5ggckxMjH8ZoIMJYDWgAQLoYALjf+hgAsPfv0z/GSADDdDBBHsGBuZNlLhzFIyCUTAKRgEKaBwNjiEDhsSNP4yMjKDO3oRh2LE9CB0EAGNq7qeHHuKHc1ABaRABhh2G2QqNeFBTcHSgYBQMS8DAwAAAAAD//xoygwRM//5JMiCtBsC2igBZDucqAgboSgPsqwhg4irUcHN+TzloCXzplILWWAYGhlh6drapNZBA1QMTGaiy+uECw///lbEL+sjaXoBq9j9vUHz/Z2BkYIJ28v+DxgSg2w7+McIHAMArDEDbDv4xgdIIYlUBM3RrAnjbAWQwgQGx7QCsz8Do6p9D57RZhvWJuKNgFIyCUUAvMLrMdxRQE0AHCOYPk0C9CN0ucYCUVQG0AEiDCHB3gGbfoYMFDsNk0CAe6qeA4X7zwSgYYYCBgQEAAAD//xo6gwT//0khd+yxrSIAsylcRQAdRJCgpttzJlQvnpHTcAm0EwF0MCBMfKD39RO1ZYGIKxwpGEgg9QyFVVGLJk7AUEQmYPr3z+w/w9//aAMADDjOGAAPIoAOx2RAOocALP/vH2hVAdP/v9CVBkjbDqADDeoMDAwnqeXuUTAKRsEoGAWjYBRQDobJAMFG6MDAhsHeUf3//z9oZckCKIZt8QiA4qF6UKQ9aCAEdOjf6EDBKBg2gIGBAQAAAP//GjoHF6KuBsC7igDtjAJSVxEwMVFpJQEyyJjScHF2Zk0aAwNDBQMDgzUDDWftqdaxx2LfAF3XCFo10By+bOpBTAeSB5qaZ+swMbNAzhj4h3LGALiTDz93AL7tAH6YIRMjE/gIAgbEtgO0swyQth2ABhoYIKPMo4MEo2AUjIJRMApGwSABQ3yAYMgMDOAD0O0PINwAnZEvgA4YDLUVBvqjAwWjYFgBBgYGAAAAAP//GkrbDRjQVxHAVwWgrSJgZPiPdxUBE8pKA4xVBCA1PLTwQ+r0FlBnt2ZeakUo4///OejyVFqOT61Ze7pf14hjIAF07kBjyMqZtzAdQz5g/PdPkQlxYCFkAICBEZLGECsFULcdQAYTGBig2w+Qtx0wwQYVGMCDAvCbEcCrChj/SlLT7aNgFIyCUTAKRsEooKANMDQHCB7CZuGhM/LDCkD9BBokKGBkZAQNFIDiyH8I+VEfGj8Bg8Ato2AUUAYYGBgAAAAA//8aStsNMFYRIN9kQOicAuRVBAyw8wqwryIAs2dl1RqkTWum2gEvyCBpdsfqxYnFILOrGBgYIKsWiOjYM9Bw1p5qdmGxj+wDExn+g64PbAhYM/czpiWUAaZ//3hArQT4AAAD9NyBv9AtBqBkgv2MAchhhqB0hLLtAH6YIdO/f//+g7coQM1i+McoSG33j4JRMApGwSgYBaOAdADtgA6lAYKD0IGBYXk3Pzbw//9/8CoJpNUFCUPkUEl/RkbGBaOHGY6CIQ8YGBgAAAAA//8aSrcb3GP6908V2yoC5NUCyKsI4Dcg4FhFgLz1AGkVAWzwgab+iZ3fe3tZXH4utPDzouesPbXswqYO21YHBvJucOj13bBwGaZDqQNAV12Cohq6neA/8rYD6BkDDP+hWwYgAwQQMbTDDMHbDmCHGTIgzjKArDRggK4+YMByhuQoGAWjYBSMglEwCugKoHvgh0pnGzQ40DDQBxAOJICtLmBkZGyArTIYAoMFo7cejIKhDxgYGAAAAAD//xpK2w1+MP7/h3UVAZhN4LYDbKsIUM45QFpFALXHALpPimYgatFE0PaDlpVR2ecZGf4XMjAwwLc50HSFADEHFFLpukQy7AKFSaH3piVnMDRSETD9/SsOPWOAgZEJFPfI2w4QnXwsAwCQ7QSIQQUGxGGGiG0H0EEFxM0Io2AUjIJRMApGwSgYMAAdIDgwBDqZI35wAB1A9/mDzi2YMEQGC0ADBaArJ6l22PYoGAV0BQwMDAAAAAD//xpKgwTPwPO9eFYRIN9ogLyKAHYDAq5VBEzIZkIHHxj//eOll9/Cl03dujYs7RwDA0MPAwODKgN1OtswfVQZSKBghQAp9t8E7cZw37aC6tsL0AHT/3888Fl+6PWH4BUCjPBzB5APM/yPdsYAdNsBbAAA5WYE5MMM/0NvRvhJa/+MglEwCkbBKBgFowA7gN7Zv2CQdyxBZw4kjA4O4AZIgwWguAStLogfrG5lYGDoZ2Rk/DCStomMgmEEGBgYAAAAAP//GjrbDf7/e09oFQHsEEJcqwgY/0NXC6CtImD4j3zOAVyfKj39F7xq1nMGBoboDcFJxYz//0dh+p8ms/a4zKHKGQZQ+4hdfbDEZeeaDkwDaAMY//1TYoJef4h0ZSG2qw0Z/oEGo0DbDqCDCVgOMwQPJqAfZojYdvD3Bb38NQpGwSgYBaNgFIwCDHBgEF+x9xG6cmB01plIAN2GkAAdLJgwiON2AnRFAU1XJo+CUUB1wMDAAAAAAP//GjKDBJvdVd8Fbr1G1CoClDMKkFYRwG5AwLWKAOWMgv//B+RE+oC183q3+seCVhU0IW8/IGfWntwzDKi1jQGbGgx/MPwHbS/ocNyzYT2mQ2gHkM4dgGwxgHTyGUDbDtAPM2RmgB9myIh8mCFk2wFkxQBEL/phhohtB/T02ygYBaNgFIyCUTAKIADakRysnUjQVYYFw/G2AnoA6KoLA0ZGxgLoyoLBtlKEH3o1osLo1YijYEgBBgYGAAAAAP//GjKDBAzwLQf/ZAmtIoDfgIBjFQHy4ADyKgIGBqQVCv/+Ddi1dd4bF+/f4R3pBR0dNSFq1p6a5xOgqyNihQKZKx1uMP7/X2V7YMt1DM00BJML2/SZmZkhs/yMiMMFoTQjlnMHENsOoCsGQEmEETKYwIDYdoBxMwJs28F9evpvFIyCUTAKRsEoGAXwqw4H45L0j9CtBRsGgVuGPACtwmBkZNwA3VJiP8j8AxooALnNYRC4ZRSMAuIAAwMDAAAA//8aaoMEP6CrAShaRQA7rwDXKgLYQMGK6BzViKVTbg+EXz22Lgfty0/e7RGaxfj/fxayHLE3D2CZtafnCgFC5uxlYGCosD60/ROGWTQGoJsrYLP8YBrayUe6shDLGQNI2w6ggwmwwwyRtx0wQQ8zZIJuTYAeZkhvL46CUTAKRsEoGAUjGkAPKhyMVx1uhA4QjM4sUxFAV2M4QFcV9A8y59mDDl38//9/wSBwyygYBYQBAwMDAAAA//8aUoMEjP//PWX6908NfTUAuasIkLceIK8iQLoBgW6HF+ICrjtWT9vvEgA66b+NgYFBioGS8wlotEIAqzr8alotju0esINcmP79VfmPtFUAOgCAfLUh6MYCBtCwEvJhhvBtB7AtCtDDDJHOMvgP22qAdpjhaENgFIyCUTAKRsEooBOAHlQ4GGfpC0fPHqAtgK4qOACNf/lB5LR8kLtGV4+MgiEBGBgYAAAAAP//GmKDBP+/w1cRwFYG4FhFgLxCANcqAuTbEtBXEUDZxgwMDOcG2t+OezacOuzgE8TAwNDOwMDgTKsVAsRsWcBmFgn2g1ZHpJuc3H8Cw1A6AqZ//3jgHXj0MwaQth3gOcyQETqowPAfcTMC6DBDJiakbQfQLQqgrQnvB9K/o2AUjIJRMApGwQgDCwZZBxG0vcBh9AA7+gBQOENXkoDSgf8gctqC0fMJRsGQAAwMDAAAAAD//xpq2w1u41sNgLyKAMBt5CoAACAASURBVH6VIfmrCEDsAV9JAAO2B7aAluVnH7dxB+2vq0KRJGcVAbmrBsi/ZeEG6LZHwzOH6b69AMMt//9JgDvwkBsLmEBDSKBOPfyMAdi2g7+IMwZghxlCtxiAVhWAFwuAtxRgHGaI2HYATmcMjN8H2s+jYBSMglEwCkbBSACMjIwBg6xjeBE6QDDaMaQjgIZ3AGiZP2gWf5A4a/R8glEwNAADAwNAQ2slwb9/3zFWESCtBsC2ioAJRYykVQQgrD4IvI0CLI/sXHDK0vkUAwPDDAYGBmmyzycg5uwBIlYIELn6YI3++WPF+PxFT8AEPpQSvh2AEe2QQeQzBphg2w6QDzOEn2WAejPCP/BZBrCbERgRhxlu8lB7Nlj8PgpGwSgYBaNgFAxXAJqlhc4eDxaw8P///wmjCW7gAOgcANA1hIPofArQ+QQFo9tORsGgBgwMDAAAAAD//2IaSjG0LNT0Cc5VBP//YV1FALsBgRh9aKsIBsWZBNiA2fG915j//PFh/vNnPfOfP0wY+C8qZvnzm4kFRCNhbGrQxdDNZfn9G1PsL178leXvn5LBNEDAAL3+EBTvzH//QuL/718mtMEhiBjOazL/og4oIaUr5n9/mWBbYmB6BoGXR8EoGAWjYBSMgpEAFgyia/Amjg4QDA7w//9/ULpwhG77GAygATqgNQpGweAEDAwMAAAAAP//GlIrCUCA6f+/d4z//olgrCKArRLAc1sB1tUHSOcVoHcUGQfhSgIYMD59ELRsv+SiodVJBgaGegYGBvCABtVWCDCQt40BSc0TBgaGJI1r566S5DE6AKZ/fw1RzhhgAG8xgG47gG4xQDrMELbtgBmqBukwQybEtgOshxmCxO4ONv+PglEwCkbBKBgFww1ArzscLNffJUI7pqNgkID///8fYGRkBC3zPzAIBpL4oQNao9sORsHgBAwMDAAAAAD//xpSKwkYIJ3Qt3hXESDdaIC8igB2AwIefUxoqwjAclv9YqQGgbdxAv3zx1az/P0TzvL3zw1yVwhgwyy/fzOzgGgkjMVsZgyz//4Bie1m/vvHbTAOEDDAVhJA0wCo44+cDpDTETN0xQDsXAtkMaZ/0JUGyKsJoCsSwCsUUM68GAWjYBSMglEwCkYBrQD0NoPBsnx7dIBgkALowZEOg2RFgT10YGsUjILBBxgYGAAAAAD//xpyKwkY//17wvT/nybOVQSwQwhxrCLAeesBA9KKAtRl5qBBgkG9p1z70ilQZ9z9hpZRI+P//6moskTN/lPndgTICoVupTvXukn2BJ3A8tg8VUZmFkaUMwb+wc8YgFxjCF0xAL7FAHaYIQPSuQOoNyOAzjKArz5AvhkBlHyYGP+OnkcwCkbBKBgFo2AU0BZMGCTbDEYHCAY5gN58MFhWFICua9wweqjlKBh0gIGBAQAAAP//GnrbDf79+0bUKgKU6xERqwjgbByrCJAHExggZxtoMDAwnBkEXicINK6dq7+jpgu6XnAiAwMDHwORNw8wkHPLAaa6T4z//8fJPbh1lFb+owZg/PePF7YdAD4AAO3kg7Yd/AOlBaRtB8yYhxkith1Arz8EbTtgglx0wADfdoA4zHD0ZoNRMApGwSgYBaOARgDa4YsfBOE7OkAwRMAgGigA2d3AwMBQMKQCcBQMf8DAwAAAAAD//xqKZxLcRFsNgH0VwX/EtYbYD5/7x4htFQHyDQhM/0BbFv7xDQJvEw1Ubl3efl9Z8woDA8Nkxv//rdH1EbNCAOs1h/gHEkD2xco8uvuI9j6kDDD9/ycJXSkAurKQAT4AADljgAG0VYABcrYA/GpD0G0GDIgbC0DrT+DnDsBXFSANJkDPMmBggAwivB3sYTIKRsEoGAWjYBQMYTAYthk0jg4QDC0wiAYK8hkZGRdAt0KMglEwOAADAwMAAAD//xqK2w1wrQbAvooAaUAAWR/SeQVYVxEgrVYwY2BgmDYIvE40ULx7/THobtjH8irlDAwMZcj6yNlGQGAgYbnks4dZ9PMdZQC0fQQ8+w/dKoDYdgDp5INWATBCDyxEbDtA2k4AHUxAPswQfHDhP/hAA3j1AeQwQ/C2g3dDJWxGwSgYBaNgFIyCoQSge7r1B9jJoGsOG4ZWyI0CBsRAQcEguB5xwughhqNgUAEGBgYAAAAA//8acgcXzkh2u4FrNQDWVQRIhxDivfUAbRUB0pkHQ2olATKQfXink+XPH3+WP3++sOC4whDjSkNsBx1iv1LxC8vfPzlDaYCAAbbdAHLIINYrMeGHGaINHkGvNkQ5sBCu9y/qYYYoZ1r8/Tu63WAUjIJRMApGwSigMhgkhxUeHL3mcGgD6AqQwgH2hD10VcMoGAWDAzAwMAAAAAD//xpyKwkYILPB3xn//+OBDQBQsooA+QYEbJ1Gxv/gMwmGLJB8+uDIKwkZPQYGhumM//97I/uDmK0GWFcaMPwHrVSIEHrz8tJQCxfmf381oKsCGKGHDDIhth1AzxOAHmbIAFlNgLjaELrtAHqWASOewwxBWxnA+hbG2D0eBN4eBaNgFIyCUTAKhhsoGOBl4hdBqzZHU9XQB////wcdIGgwwGdbgAa8DIZLmI6CIQ4YGBgAAAAA//8acisJGCCDBI/RVwNQuooAefYX7eYEhsP23tKDwNtkA7EXTz6KvXgSxfz3TxX0ikIYxlwl8PcPMzLGomYb858/lkNxgIABspIAfO4A0z/ElYWMKGkIthrgLyMjWhphhooxw9QgpS1mqFlgM5HS2CDw8igYBaNgFIyCUTCsAHQVwUAe9ga6Qi9h9FT64QOgK0IuDqCH9EevRBwFgwYwMDAAAAAA//8akoMEjP//vUFeRQA+Sg7vKoJ/BFcRgHabY1lFABtMGNKDBDAg9OblVOY/f6yY//w5inWrwe/fzBhif+H4CcvfPxkC79+E8394OxjulyULMP37Z8KINDAAo0EDB+jbDqDpgYkZbTCBEW0wAZ7O/qEONDD/+3t7CAbRKBgFo2AUjIJRMNjBQK8iSBg9aG5YggDoANBAgdGzLUbB4AAMDAwAAAAA//8aqtsN3mBbRcCEJIa6iuA/2asIoGpkGBgYTg0Cr1MM+D+8Ba0AcP/Kwwc66CeXgYHBjoGBQY4B93WJmxkYGDZxfvuyaCj6Fx2A4hgUzQzQgwrhBxcyMDIxMf37D9lWANt2AN1OgLixAOkwQ6RtB2iHGSJtOxhdSTAKRsEoGAWjYBRQEQyCVQQT////v2E0Tocf+P///wPobP76AfKcPMj+0ZsyRsGAAwYGBgAAAAD//xqqgwQPsa0igF1liHMVAWJwgJRVBCBxmUHgbaoC7i+fQEuqUkBm/uTkkmf4/18B3Xz2H98PDmlPooFdXuEaTEzMoE7+f/C5A6hnDDCABwDQzxiADhjAzhhgYkAMAEBvMfiPfDMC9CwDBuhgwqC/EnIUjIJRMApGwSgYYmAgVxFcHJ3tHd4ANADEyMg4EXQ14QB5FJS+RwcJRsHAAgYGBgAAAAD//+ydMQ6AIBAE12t8hr2v8Gk+za/wCSzPnBCEhFhpRN2p6MwRGsky+8pLAqj6sxRB+V48SxHkvoJKiqCw1h8pAluPDUx9G/3qHQD30fESe7MBqhcAEsSFSWYYqg0RfvxjUkAktBoilxl2Yi0IdlJKmWH8DpsNCCGEkItoIEVAD8E/mOPTg+GBac1NMKnq8seNJ40AYAMAAP//GpJnEnQXhl1Dv9EAeRUB7CpDnKsIkM8uQFpFgHwDAspgwv+hew3iKEAA5r9/pVEOGUQaJGL+h3mYISPaYYbwaxCR9MLOMoDrRz3M8M1o8I+CUTAKRsEoGAVUAwEDuIqgcfQcgpEBoANBA3mI4OhqlVEwsICBgQEAAAD//xqSgwQM0L3l8JUBOFYRoBxAh3rrAQO+VQTIWw+gAw4Wg8DLo4BCwPj/nzTmShLYAYRotxzADjPEMpjASMTNCFAzRgcJRsEoGAWjYBSMAuqBgeo8PYReUTcKRgiAzuQvHCDf2jMyMmJsAx4Fo4BugIGBAQAAAP//7J3BDYAgEAQvVwC9+LUqW+VlNayExDOCGj8kF8JOCYQPx9zuuEMCYP+zCCyE8NMiOPBqEdzzCuwBGJeVNsHgKBDUfv5T0tYYuUwB1DWGTYuBVoOGs/aw3MVHrgUw+5ETQgghXSgKtpP+LVwzmJbNse2ANgHxQ0QyAAAA//8asoMEjP//fyV2FQGyHMoqApQbEDBXETAhX6v4/7/2IPD2KKAAMP37p4W2HYAJ2snHOLiSCSHHxIiWRmCDCfAtBti2Lfz7y9SXG3R9NL5GwSgYBaNgFIwCqoCBOotg4+j+8JEJoANDA9VZD4CewTEKRgH9AQMDAwAAAP//7J27DcAgEEMvE2S0rJYRmQSnsQIXBBXKKcGvproOy58PiwQ5OVfAwEXAEsKui6D+OLrVAwoKfPO7hYPV2JDNxQJQx0puAaCJHThR4bmeUdwEjeC0+r2FEEKIGdB6fQQdM7IoUQQD4Awq997ZwSHE+5jZBQAA//8aytsNXsPPGiByFQHaGQVwMQbkGxCwrCKAissOAm+PAgoA89+/5ui3WsC2HTCjnTGAvO0AttIAdcUJ9sMMQdsOwGb++zd6/eEoGAWjYBSMglFAHTBQnSXQYYUPRuNwxIOBOsRwIA9PHAUjGTAwMAAAAAD//xq6Kwn+/XuFvIoAeYUArlUE8LMLcKwiYEIxB7GKAHoDgtwg8PYooACgHTKIHO9MyKsKmP5iOcwQMZiAkVZQbkZA6Pk2GlejYBSMglEwCkYBVcBAzOZ/HD2scBQwIA4xPDgAgTF6gOEoGBjAwMAAAAAA//8ayisJ7iOvImBEWg1A7ioCBsQNCOirCED06EqCIQzOmtqDziNgQjljAHaN4T/4YYbYBgCYmLANJqENCqCsQIAMJrwe6WE+CkbBKBgFo2AUUAoYGRkNBujAwgmjhxWOAiQwUGcTjK4mGAX0BwwMDAAAAAD//xqygwTVjZlfsa0igJ8tQMEqAuRZZOgqApAanUHg7VFAJmD6/48PFq/MsBsO0G4xwDjMELFSBWXbAfrNCNgOM2T8/290kGAUjIJRMApGwSigHAxEJ2l0FcEoQAEDuJpgdJBgFNAfMDAwAAAAAP//GrKDBAyQjt9V9FUEcDYR5xTgWkXAgLxCAaGPfxB4eRSQCRj//eNH7vhjrgwADxgwoQ8UYTvMEGXbAfJZBqgrDEa3G4yCUTAKRsEoGAWUg4E4j2B0FcEowAYGYjWBPHQ1zSgYBfQDDAwMAAAAAP//GtKDBIz//n3FtYoA2sHHWEUAuwGBxFUEYH0PlDSsB4G3RwEZAHb9ITTumVDOGMA8zBBzAADtwEK0KzOZYOccIK1suT8aT6NgFIyCUTAKRgH5YAC3GiwYjbZRgA6gqwkuDkDAjN5yMAroCxgYGAAAAAD//xraKwn+/buH6KChriJAufUAyyoC5I4hEasIYJ3C0dUEQxRgnDGAfjAh5mGGqFcbQm4sQNmegHQzAsrKFag9Iz3IR8EoGAWjYBSMAkrBQCy1Xjh6o8EowAMGYhvK6CDBKKAvYGBgAAAAAP//GurbDb6Czx3As4oA49YDxCAC3lUEyCsNYIMPjP//6Q4Cb48CMgDT379W6IcMwgYAsJwxwAS/2hBtgAnt3AHUdPcfcZhhVWPWldF4GgWjYBSMglEwCigCDgMQfKNnEYwCnOD///8LoGdW0BPoj95yMAroChgYGAAAAAD//+ydwQ3CMAxFv1N2YAwW4MAeHYI7K3BhNLpPY1e/BkRBiANSpIr/jol/Dk4ucex4s0aPn0+XbTeOfee+f3npf8siuLcy/JRF8KRbZBFg8c/Bw15tEFdKcUdYLQwTwaqFmRXjtjvDRWA2QMDmSz6LU3Le066mLmrqwCNkTj3XzDHMNijUFrd/97cQQgjxC7dL0a6xE4eIuGrjxBcYKDg2dtJBZTCiGQAmAAAA///snT0KgDAMhZN6Hj2Ls4dxdXXxuG3kpf50KQiCRXgfnUo7pUs+Hs2vJMEyb32IcepSGnxModk9zu5MCVRSBGVCoEwRHBMQqimCUhSoGSXBT8F0ioAShuSlhAAQ/63iEAAQBGjusQJqrnoJAHiB5FJALUsE6TQK7vlelgkuGiSf4X8EhBBCyDtapAjYhJEnrA0kwcj3ST5DRHYAAAD//+yduw2AMAwF7aSkoWQKWmZhGirWYCf2CQ6y8lEoEAIkQOJdmcJFlMZPF/vzIcEwTpWVpbPO9VakKWwAc8YiyEMIdyyCMhzYbD0gXwYI7QeuBFzAiNQ66tJHYyBZBdrkpwCAojGQm319EhxNA4pnxJSDhhAq5FoaKHCohc0GAAAAwD3e+IeNJgwcojMrmHl+2HR5IzQDf4WIVgAAAP//GrSDBFVdS0RZ/v5xZP7/z4/x3z8e8In0qKsBGMhZRYC6lxyxigDOxrGKADqYMHpw4RAED5Q0ZJmZmCFbBxCrCRhg2w6YGf8yMUBSEXhQCXXbAcYAAAN82wFsiwJ4COof8raDVyM9zEcBZKns6OFXo2AUjIJRQDagd6do4+i1h6OABAAaUOqnY4Dxg277GN0OMwroAhgYGAAAAAD//xp0gwRl/SvlWf788Wb6/88R3OH//x8+OABaHI53FQFKJx/7KgKkQwixriJAufUAaRUB7AaEdyLiekJvXl4aBEE1CogEoLMkIAMEaGcMIG07gJ8xwAA/dwCx7QC6coABafXBf8hgAhNi2wFEH3SggWdiSad4fk/5y9E4Gj6AkZFRgIGBwQCKBZAasCA+1gFE8LgRJjgIFQFV9B+g9IPRin8UjIJRMAogAHr1Ib0nZjaMBv8oIAFsoPMgAQO03THaVhgFtAcMDAwAAAAA//8aNIMEhVPW27H8+WPP/O+fNgN0YACj4499NQAj0moARkpXEaDceoBtEGL0GsQhB5j+/eWHdOAhhwuCth2AtxggbTtgRh8AQD1jALSqALLSADKowAg/ywBp2wF0UAF0mKH1f0ZGywmlXbv+MLPsKukoujzS4wAcZOSDxv///zcMgJsNoBWyA3QggFp3dduj0TD7GKADCKAGAOgu5gODZVaLkZHxARX8Lzg6S0cbAD3gjZKzUD7+//9fYDD7cRSMODAQS6tHBwlGAdFgALccjN6+MQpoDxgYGAAAAAD//xrQQYKs2Tu4mP/+sWX5+8eT6d8/UUbolgJsVxIiryKArRLAuYoAWS+ZqwiQBwpgqwigNyDYMTAwHB7IcCMHMDIygjpZ9ZSY8f///yF5aj/Tv3+6iNsIIKsJkM4dYEA7zBBxxgADdIsBAyMDYtsB/GYEBqSzDMDbDkBXKTJAb0aA2uPGzPDXpaey/8VfJuYNf1lY9lQ1Zn0dBEEyCnAARkbGAOg+WAcqDgqQAuyhGHwgErQBAmq4bhjglQYTqDBjUsDAwED3wZ4RAii9S3600TkKBhswoLN7RrcajAJyAL23HIyeSzAK6AMYGBgAAAAA//8akEGCtAV7RZj//HFj/v/PFrQ0G+WgQBj7P5SNZzUAcsceZRUB8nkFhPVhXUWAsqIAddBiNHUOMQCKO+i5A/BOPsYZAwzw7QT/Uc4YgG5NQN52AL/NgBF+mCETE9O//6Aky4i4GQF63SL4YERxJkbG1P9//6a01k/f84+ZeW9tXdqVkR4vgwVAVwwUQAcHBttKIX0ormdkZHwIbZAsGICzDhZAO/iUhE/C6CABzUABhQaPHtY2CgYboHdn6MBoChgFZAB6pxv+0fOORgFdAAMDAwAAAP//ousgQeLSw+rMf/64svz7ZwTt1DNjdOCxrCJAvtEAeRUBI3QQgdBqAPRVBNAbEIhaRQAXh6wiAN+cMJo6hxZg+v/PFmk7ANK2A+h5AgyIwwwR2w5QzhhA23aANADACB9ogIhBDzWEbDv4BzsYESIGuRnB+f8/RsfGljkv/zExb/7LzLy/pTxudHXBAABGRsYEaOeK3vdwkwvkoauBQAMGB6GDBXTp3IFm2BgZGSm9F1oeFOb0cvNIAdB0TMngzcLRBucoGEwAev4LvVdyjW41GAUkA9AKP+gAPj3TK2hiY7TMHgW0BQwMDAAAAAD//2KihyWxK09YJiw9Usv0718J0/9/hjgPCsSxioAB5VpDrB14nLcekKAP6yoC0DYHtEGL0VQ5xABo9Qd4NcHfv7iuwAQfZoh1gOofWA5p5QlMHiLG/O8vxmATaNsBTA3KQZsQe2C0OOP/f0lM//5Nr+pakl3Ru1xhpMcTvQCoUwXdYz9/CA0QoAPQloT5IH8wMjIWQBvVtAbUWJJO6Yz3KMAElK7OGN1qMAoGG6D3VoOHowNlo4ACQO/VBPTOH6NgJAIGBgYAAAAA//+i2UqCsA0XOZn//nFk+vvXiuXfPxH4zD1iiT8Teqee0CoC5M4d8ioC+CoBXKsIUPXBVxHAVyWQsIqA6d+/R6OZZWgBpr9/Df5Dzh+AHTLIgNh2gHbGANK2A8QWBZTDDCFiSNsO0A4zRNl2ADvMEMvNCAzQswy4mRn/OjAwMtqV96148JeZZetfZuYz/TmB30Z6vFEbQM8bmDBAZw3QCshD90M2MDIyTqDlAY/QQ5oWMjAwxFNgjD4jI6PD////R5f2UgGAwpLC9Hxw9FaNUTAIAb07QaPl0SigBBygsF4kFYyeSzAKaA8YGBgAAAAA//+i+iBB4NZrQsx//3oy//9nAb6+ENEhJ2prAL5VBAwMSNcaYlkNgH7rARNiNQDeVQQYtyXgXkUAUn9xNGkOLcD0/x///3///mGcMQDp5DPBth0wMyAOM2Ri+gdKGkjbDlDOGEC5GYEBaaABNpgA23aAfJghE3T7ARPumxEU/jP+zfzPyPilcOqGM3+YWbZPzvAZHZSiEEDPHJjAgHabwDAD/NBtCOB9/zRc0r+ACo2hhNFGOdUApSszRlcRjILBCEYHCUbBUAL0HmgdXXk6CmgPGBgYAAAAAP//otogge+uO8rMf/54Mv3/r8IEnfXH6JAjOtsYqwiQrzIkdxUB+q0HGKsIkG40QF5FgHHrAdoqAiS3PGb//m10kGCIAcgBhdBZfgbIGQOggwqZ4DcWMDLCzh34h3GYIdK5A7AzBqArBpiQbkZAOssAfjMCZGALZdUCWB8D0s0I0LMMQCsUwENSTJCbEbj/MzLaMTP8tcmZufXBPybmndNSPY6M9HgkB1DjVo8hBuSh2xDA5y1Qe5YYtAKAClc+xYPiZXR5L2UAeu2hPwWGgJZYj+7DHgWDEdC7EzS6mmYUkA2g5xJ8pOPBx8NpNeQoGKyAgYEBAAAA//+iaJDA9eBT0JYCbea/f92Z//0Thl1hCO2QM6F05GFsBjxL/NFm98ldRcAEtRtjFQHiKkPctx5gWUWAdAPCotHEPPQAdACA4T9sBh86yw/adoB0mCHskEEmtMMMsd2MADITIgYdTEDedgAdVIANAPxD3naAdEAi7GYEhv+wQQvoqoL/qIMX8gyMjCmZc3ZG/WVhOfyXiXnX3DiHtyM9TgkB6OqBBUP4zAFKAWjVxHlGRsZGGmxBmAA9z4ESMHrTAeVgdBXBKBiugK4rCUa33IwCKoAL9FytOLptbxTQHDAwMAAAAAD//yJrkMDx6CtBpn9/jVn+/7Nl/P+fiwk+OIDUkUfvkKOtIsBY4o/lKkNsqwiQzcS1igDWqce5igBpsAHt1gN8qwhA4qODBEMQgA4XRDkPAPWMAdBsP3jbwX/Gf/9RzhiAzvL/B/f6/6FdbQi/sQD53AH4QAMDJCXDth8gth1AbkgADwAwMiKtWoBshYDfjAAbaICeZcDAxMDI9f/fP9f/DIzOSUsO3fjLxHxsYZT1sZEet9gAdBZ9wiC8znAgQD30LIYEajWEQVsZoCs0KJnNKICeoTB6LzkZAHpQZQIFRnwcvfZwFAxiQM+y++BoQhgFVAAH6LylkR6HFY+CkQwYGBgAAAAA//8iaZDA5vQHReY/f4yYGf4bg2ZSGZG2FTD+R+mQI1YRIHfqGVCW+DNg6/ijnFeAZRUB8g0IZK8iwHVbApYDFJFWEbSw/fzxcKQnmKEIINsNoOcBwLcdILYFMMJm+XGdMcAA7cAzMKJsO4CZiXyYIRN0pQBo6IAJbD50AIABZdUCdNsBxuAFE2zbAXylAXTQAmwfdBDh/9+/Gv8ZGdXilx8L/cPMcuwfM/O+5cHGo6sLIJ0nauyZH24AtJoCtE2ggIpnFSygcBsHqBMQMNpRJRtQeu3hgtEBmlEwGAH0ME56gtFVBKOAGoDe6chg9NrOUUBTwMDAAAAAAP//ImqQwOL8VwWmv38dWf79U4IODsA754jONo5VBP9RDg3EWEXAhDLjj1hFAL8BAU8HnvJVBGjnHCCbh7qK4DLjv3+TR1Pj0ARM//4d/s/41wbcWWeEz9Ijz+CjH2aItO0A2jHHfjMCeJafAXyUAfQwQ+hKAaSBBpRVC7CVArBtB2g3I/xD3nbwDzF4wQh1O/qZCVzMjH+d/zMyOkasO3fzLzPL/tX+epdGYhxDZ1Y3DPPDCSkB/NCzCkBLFCmZgYaBCdDl7pR0VBtGBwnIBiN6qwG4yBwFAwb+///PSEO76T1DOno2yiigBqB3OhpdSTAKaAsYGBgAAAAA///CO0hgfOU3B/OfPxEs//4pIq0GQFmqT+kqApy3HmAZTEBeRYB8AwK2VQRMKCsEcK0iQF5pgHMQ4hPT/38pbD9/jM66DFHA+P/fJqZ/jLZI5wFgXG0IPWQQPsuPcsYApGPO9P8v5BYE8BkD0IEG+BYDBowBAKRtB2gHJDKAO/nQbQdoVzAibTtghqqBHmYIWWnA8Bc8KPEfcWYCA3RQQe0/41+VkE2X3/xlZj75l5nl1CYPtXcjIn4hAwQHRvD5A6SAeOiBdwGUzCSD9DIyMm6gcNWG/Oi+StIBdPsIJVs9Fo4eGjkKlU2uiQAAIABJREFUBjGg980GoysJRgHFAHp4IT0Dkt75ZBSMNMDAwAAQzkECw6t/xVn+/Utg+v+Pk+E/2qGBWDrilK4iQB4oQF5FgHwDArZVBEyoqwHgqwhgVxlSsoqAkeH/R6Z//9xHbzQY2oD5799NDIyMPVjOA0CawUc6DwD7GQOQjjl0+wHyQAN8OwDsgMS/8NUH8G0H8DMGGJBWLUAHE2DbDpC2GIDSPvgmBoQYYqCBEfVmhH9IWyFAgwnC/xkZPRkY/rr77rx96R8T8+mtrkpXhmvcDuAAwUdo4/IB0gzCBywNTuSlswbQ0f+BXu1gD91+4EDhkvMGKmztaBi985lkQOkqgtHVG6NgFCDA6IDZKKAWeDh688AoGDaAgYEBAAAA///COkhgeO2fONP/f3GM//5x4DovAHkVAawjj3MVAao+rKsIUA4NJDCYgLyKAGkAA+sqAibkQQjSVhEcYfz3L5Xz25fRcwiGOGD5/evBP3aOxUwMjLFoHfP/TEiHC8K2HcAPGUQMADDAtx1gvxkBuu0AutIAMZiAPNCAOGPgH/yMAciqhX8YNyPAb2JA2XaAcDvGmQnMsAMOoW6ADlroMjAy6njtuf/2LwvLrp0OsmeGU7zSeYBgI3QAAGTfBRI611hnyaGz+QbQDrLDAAxygOx7AB0oIGsmDTQbzcjIeJDCQQ97UFiMzmwTB6C3dlAS3hdHV26MgkEO6H2zwWjZMwqoBR7QcZBgdCXBKKAtYGBgAAAAAP//whgk0L/BwMH8/18c079/nNAOOeqhgQQ64lhXEWDfGkDSKgJGhv94VxHAByHQVhHA9OFcRYB+tsH/f08Y//1r5/30fvFo8hs+gPnv3+b/jIxxTEiz/ExM/5hABxSgXW0IOWQA4zYDpG0H/yC3IDDjOcwQOgAAP8wQ9WpDpMMMQWkdadsBM+ZhhohtB4jrFpmYIAsbGP4zoPgH+SwDuH1MDIxC//79C3M78MT6LwvLqr02Es+HesTSYYAAdvr7AVrcJQ9tmD6AHTwE9U8AFFNy9z0pgB9pRQG5S25BKwH2U+iOBgpP6h9JYPTaw1Ew3AE991qPTgKNAmqCB3RcKTh6e9MooC1gYGAAAAAA//9iQreB6d+/UMb//9mxdeCZsHS2kVcRoBwaiG0VAfJhgmSuIkC59QBpFQHszANCgxcYqwgY4OccXGX89y9L6M1LLf4Pb0cHCIYZYP7z+wHTv3/N4DTw9y/kQMy/f1HSM1zs/z9wxxx9hQnoKkWoGib09Mr07y8qjZxWQWYh3QSCvIIFNNDAhH0lC8gsbPYwwWhGNHuYof4Bm4lpD2iljTTT37/pTkdfGg2D2N1AowEC0IqBwP///wv8//+/gBYDBNgAaGUC6OaB////gwYJBBkYGBLp1ICFDRQokKMZOitNqTsDoIMkowAPgIYRJds7HlLxdotRMAqGAxhdRTAKqAlG09MoGD6AgYEBAAAA//9CGSTQv8Egz/j/nzxs6T6uVQTIVwvi6ohjXUXAgHa2AfZBCLyrCJBvQMC2igB5hQDyKgL4AAbmKoLtjP/++Yq9eGIt8vr50tHkPXwB66+fTYz//i3GWPWCPACAmq7ggwkoaew/VAzLYAJIDzO0A4/SWUfYgzoAgDaYwARVw4iWt5ihgxfoeQzZ7UiDBgg3YQ5acDL9/RvqePSV1lCNaOg1h9QerV/IwMCgCOqk02tgABdAGjAAddwd6XCPN2igYAMFHfUGKtg/upKAMBg9i2AUjARA1oDlKBgFIw2QO7g/CkYBUYCBgQEAAAD//0IZJGD6988O1pkmZhUBUicHZRUBvHOOowOPbDbKoYEMiPMKyF1FgLxKAMfgBahD9Znp37/ZjAz/jaQf34uReP7oyGiKGRmA7eePZMb//xbDOvlMkBl2tFl+aGcdS8cc3oGH6UHOG8grDDAHADDyEawDz4y00gB50IIRbTAByR60VQVoAw3ogxewwQSklRNM//+FOBx7LTnUIp2RkTGBCoflIQPY4EDCYNybCpqp////vwMdBgv0oSsKSB4ogM5Of6TQfko7wCMBUDKQ8nF0q8EoGCKAnge/jd5sMAqoCeidnkYHCUYB7QADAwMAAAD//4IPEujfYOBHXkWAPJOJaxUB8k0GhJb6I68iQL7KENsqApROEZmrCJAPUERaRfCU8f//Osb//0zk79+sln1459Fo8hp5gP3H92Sm//+moGwxwDKDj7LtANr5RpnhR9q2gLlN5i9sUIEJPY0jBgAwB85gZmGcv/EP4QY0e5gYUQcvUAYF0FctMMEGOP7+5QINFAylyIce2katjg6ow204WAcH0AHSYEEiFTrkuIA+BeFLabzIQweARgEWAA0bSjpPGyi8yWIUjILhCEbzxCigJhhNT6Ng+AAGBgYAAAAA//+CDxIw/funjryKANSpp3QVAfwGBByrCJA7QcirCOA3IBBY0YBvFQEj6iGLJ5n+/StSv37BTOXW5VmKd6/TqpE9CoYIYP/+rZj57193pv//jmBLY7BOPvK2A+SVBljOA2BCO2OACaOzjjzQgHnGAMrgFvKqBWxbIZiRBgzQ8gTyQAMTI9qgAjOq26Ucj74aSucTLKDCYT2gvF8I6nBTcFjfgAHorD1o9mAijdwQz8jISM6sPjUGb0YHCXADSldaULolZBSMglEwCkbBKBgFIwUwMDAAAAAA//+CDxIw/v+ngG0VAUrnnMxVBMhyyKsIUFYoYFlFgOwW5FUEKOcV4F9FsJbp/z9P7UunQjWunVs1mrBHATLg+P71IPfnj65M//95MP39uww0ww5d+o/S8WZGHGaI8ywDbOkR27kD6IcMIucX2LYDZrTBBORtB/DBC2zbI9BWLWAMXqAN9kH94zIUEgUjI2MDFQ4qvAi6Nuj///9Detk19MwCUKcxkEarCvqhqzZIchN06wYlwJ5Ue0cCAN0+QWHaPzh6zdsoGAWjYBSMglEwCogGDAwMAAAAAP//Ql5JwIFtFQG8c45jFQFyhwXXKgLkTj3eQQi0VQTINyBgXUWA/crFL4z//09i+v/P1uDc0WKdiyevjqaIUYAP8Hz6cIj/w9s0pn//pBn//auEXoOJOQCAtO2ACelQQuRtCzgOM4R34JkRnXykATmUVQsYNyNgXS2A5TBDbIMKqAMRqAMNoEERxn//BJ2OvhzsZxOAOo71FJqx8P///wbDqbMEPWDRADr4QW1AzkGG1Bh8GT2bABNQusJidBXBKBgFo2AUjIJRMAqIBwwMDAAAAAD//0JaSfBfgVAHHtsqAjCbyFUEjP8Rh7MhryJgQNkmgGUwAbkDhLyKAHl7xP9/zxn//atg+v/P3uTk/omGZw4/GU0Ko4AUIPDu9UfhNy+mir14osP0/58v+OYL1G0BqB1v9EMG0fPKf8zDDJG3HeA4YwDzfAT0GxgwzxhAPR8BPf8iDVpgHGYIcbv2IE8o/hTqTwSdPUAltwwqAB30cKDCLD46kCe10w/dvkHp4Yrxoyc2IwA0LCi99vAAtd01CkbBMAGjBxeOAmqC0RVbo2D4AAYGBgAAAAD//+xdQQrCMBDcWf2DB0XQd/iQHvskL959hXfBk/gLQV/RjUwatRVbEFJE2Tn0sGw3G9jQbjJkxvfZdDTkbbp/D4vgqVbQzSJoKSf0bUK8sAiaCghvWAQnmG1W+93RS9ORC5PrmYoXh8tsMQ+CQoEiwKYBiCf4/HsPVaWsdJapwmobkk0q0FcFYspaJc8m2QAx1i79zRAkxlSuwhBjGP1UGYb8nKp+j3trUK47+iWb1OOp8BHHgaQcRkh5MobFmBJzl0aeMR9b/mnhkIpfflvScGgkqn8JQDIrP7Bh337YZK4zyFOWfvr9gN9F4HAMB79ozpEN3LRP32GH4/chIjcAAAD//+yduw3CQBBEd1wBgoyUiC6IkKiANqiDBkhpgQKgFQsJCiAg5Bbt3d7HkgNkuABrR3JiW14Hl8zTaDZBgobdA85NO6WBvSmCTsSf8jvF6sGBKQIqSwh7oEUx/wnmC5w7rM6nux1FUy3Nb61swNjL1S6WGwa2DKwRTH4w8JSMOft7weSDFCJ4AKAwQZ9RMvDB5LMCAG/yo4GPZr+ACUQ6r8kwIQIA6Bz/LSEJMg/Q/1SYQBkmJGhBeM1GeIAEEPxlOeFQSVqiAig4Sk/Ap834AmQAXL9s4t+ZufUpgskP1h6OGpCZTCaTyWSqICJ6AwAA///snS0OwkAQhWfmAiTgSAhB4bgFHgPn4gY1OCxJuQmCoNEEzQyZ/Wl3E0C0gGjnyWbTmhF9r1/n1SEB842ERy8bDTKKwNEAbymCbEdBQ4qAsntKShdcifmAwrvlcX+3mTD9U7PLqQSA8jxfTAAeG0FcE+BYvCFXY65jyxS/8iO60Evf9h05AGkAoPa9Chr8tUAMeAMfjH+kDyChFvQApzRANPuOUCBSIiEPL+qgIYQJ4rOCGDQMOzhIvQoIon4QFEwbmHY9W7R45kAr/0KTQ5+1atnmsbXaQ5Ppo3Sni/2OY/qKbPGuqVMCgCcAAAD//0LebvCA8f9/JXiHHHqTAc5VBCidfKQzBRj+411FgKwP1yoC5BsQoOpvM/37t8Jn46JNoylwFAw0UL156TEDA0MvCF/VMwv9//dv6H9GRjNExxxpAAC67YAZumIAPAAAneVnxlwpAM0LiFl+5G0H8C0KkE4+A2jbAdQe+LYDZgb4QAMjbPACse0AumoBNniBPGgxvEDiSBwggAEaDBTUQ7cdELvfcgN02wElHdwC6JWXIxlQuppipIffKBgFhACph7OOglGAD4ymp1EwfAADAwMAAAD//0LebnCD8d8/Zyy3CGBfRfAf6QYEHFfAYT9g8D8pqwi2Mf37tzVgzdyzo8luFAxGoH3p1GoGBobVF4ysZZgYGJMYGP8G/2dk5AINADBA9/wjnQcAEYMOJoA767CzDGDbDpBm+WHbAjDOGGCAbjFggKw0QDt3gBG2egH5zATYtgPQQgcm8KAA0qoFpn8/h1HiKhydgYYPFChQ4XwAGGggduk7aPYaNKjAwMCQT4F9+qCr/0bqoXvQaw8p2bKxcPTaw1EwCkbBKBgFo2AUkAUYGBgAAAAA//+CDxIcNhN87nj0FeRcAqRVBPDl/rhWESAPJiCtIoCfbYBjFQGyPrRVBF+Z/v3bwfT/38rQ5dOfj8bsKBgKwODcUdBtGk0gfMrSOfj/P8YgRqZ/JqhnDCC2HSANAMAPM4QNJqCcMcAAP1wQddsBdGsCwz+sZwxAVhqA9EIHE7AcZgjOe2B1f/8+GyaJDNQxosY1fMMFBEBP76akswkDoEMMG0joeE6gcJCAAbqaYKQuBaZ0FcFoPhgFo2AUjIJRMApGAXmAgYEBAAAA//9iQdbJ9P/fXqZ//8JIWkWAfF4BllUEGGcbYNEHVfOK6d+/NUz//22LXDzpy2iUjoKhCsyO713LwMCw9riNu/R/BsZ4JkbGgP+M/7iRtx0gH2bIBDvTAO1mBAbEzQjwrQIM6DcjMDIyMf/9ywDKkciHGcIHFZBuRkA7y+A/YqsB43AYJHg4esc+KoDO6IMGCs5TyUhSVhOATnleSOGWB3/QaoiRNiNOhRUgB0fydptRMApGwSgYBaNgFFAIGBgYAAAAAP//Qhkk2Gsjcc79wGM7pn//pEleRYB+6wF0FQHsBgQ8+i6BBgcS53QeGY3PUTCcgOWRnaCbN9oOO/hM+c/41/k/I2PMf0ZGNdAVnijbDkDbAhhQDjOEbxVg/ouyLQD1jAHYqgIGvIcZMv5Du4kBedsBdFBhOFwfGjB6SBsmAHUWGRkZG0HnClDBOFJXEyygwrkIBSNw8Gf0LIJRMAroAxRGw3kUUBGMHlw4CoYPYGBgAAAAAP//YkH3DeO/f6uY/v0rwrIaAP8qAtgqAQLnDCDp283079+61Oktd0aT1CgYzsD2wJZPDAwM60F4j3uIBgPjX9BggQMTAyMXfKsA0mGGDNDDBVHOGGCA3oIA3X7AyIjU8YdctwgfTIANNMC2HTAz/AXffAgekMA8zPD9an+9oX6NaOPozClu8P///wboigJ9KhhHymqCA4yMjAcpnBVPgA5MjIgBIOi1hwEUGPFw9EyOUTDEwUUqlVXEgNFBglFATUDvgwtH2z2jgHaAgYEBAAAA///CGCTY4ST/zHfn7ZWM//9HIZ1LQGg1AMFVBNBVCd8Y//3byPTv366sSXUvR6N2FIw04LJzzQ0GBoaaHd6RvP8ZGR2Z//6NYmBkVPmPtC2AETbLD992gHRlIXQwAcvVhqBBPNAQHgPyYYawbQeMqDcj/AOfZQAZTNg+xKMA1Cka8XfqEwESqLTtIADUkSWh076AwkECfqjbR8oe+wJKrz2koltGwSgYCDC6ImwUjAIiwOjqyVFAU8DAwAAAAAD//8IYJACBze6qpwO3XgN16oOZ/v3jhq0iwLIagNhVBK8Z//1bXthduns0RkfBKGBg8Ni6/DMDAwPoSs9NG4MS1ZkYGCP+//3rDdl2AD/MEPlmBNgZA5DzBP5h3IzwD0bjOMwQ9YBEyM0Iz5aGmZ0Y4tFB1Kz2SAfQbQcTqXCYIEmddtCsNmglAIWHJxaMoM4vJen54wjaanBwELhhFAx9QK3bX0bBKAABh9FQGAXDBjAwMAAAAAD//8I6SAAC6721ToVtuPCM8f//WKb//+SgqwEY8K4iQIjBVhFcZfz3b0VpW8Hl0VQzCkYBduC/bv5N0JL5daGpff+Z/nn//8cYzsT0Twz1jAHEtoN/oEE7BsS5A0xIhxnCth0wQ7cmIB1myITYdgBW8+P/P/DBckMZHBypV+SRCWBbBSiZqWYgo9MOUttPgX3yoO0S////30CBGYMeMDIyJlA4mLJgpMws/f//f7QxPnzBhdHO+ygYBQTBxdEgGgU0BQwMDAAAAAD//+yduw3CQAxA47NHYAFGgI4OKiQKJkCpadiAgiFoqckWQEXDENRMQOEPMgQ6BCgXQNG9xjrH0kmxYt8n5wMze9lHXux7KDwOIi0SDsgcgkqgUnrb9UEFiPmMwocgUswX01Py4H9Q7uZVKl5mZtCgV/LXrCezriCNFHHISKqIqgGNiVyqEPmXd5fmzwVJBdEESVwnd9ubzuXVxm0ZabnK+7Gq3r/k+sNDfAZpkeAzYsSBks67dSDKc/bHiosTu6ZPDAFgW3Fy1P7VTRAA4L7ZfKu/lIuaS8QY9S4pjySiUNM45xm15MQUyxMPsiy7AAAA//8iapAABlIX7JNl/vvHiPnvX3nmv394mP/+Ac9Yguk/fx4x//t7jfnvn6sN1clfR3ooMzIyGgyyJbIKVLgvfTAt8bzw////YX/q+eKEIp5/zMyef5lZQv4yM4vBOvv/IIMAkMEARMcfRP+HDR6ABgiggwr/YYMK/5iZv/5hZpk4I9ntBj39QYPKc9h3GmkBqNRhB4GJpOQ/RkZGatx0MGCdYFoDKjTMNv7//5+SAw8pAqMNy1FALcDIyFhA4cojUkHgcF+lNApoD6B163s6BjVNyvzRsnwUwAEDAwMAAAD//8K53QAbmJ3g9JiBgeHxaAgSBQSG4ZK50SWAdAaxC/q+MDAwrAbhuelVBv8Z/wb/Z2S0RNl2gHQzAtphhuAtCqDDDJkg1x/e/M/IOHNGmtubYRA0o4cVkgFAy9EZGRknUGGmLoDEqwkbqDBIQPTNCkMQUOqv0QMLR8FwAfQ+sR00oTM6SDAKKAX0vv5w9GaDUUBbwMDAAAAAAP//ImmQYBSMglEwcCB5ZhuoUrgwM7te4j8joxvz37+uDIyMosg3I8APM2SEHnAIOczwCsM/xjW9ef7Xhkn0XRxdHkoRWECFQQLQOQEGxG45AK0AYGRk3Ag6goMCO+NBs4zDbd89IyOjAoUDKKP5YRQMJ0Dv/D16t/0ooAagdzoavdlgFNAWMDAwAAAAAP//Gh0kGAWjYIiB9KmNLxgYGBaB8KSidmUmRkbL/3//iv1nYBRjYPwLOuTwPxMj473/jP/ugQYI2ooiXg+zOB6dNaUAQDvsC6kwsx9A4mzGBAoHCRigqxeG2yqS0VUEo2AUQAH0JhZ6BsfoIMEooAYYXUkwCoYXYGBgAAAAAP//7N27EYAwDAPQaAPYgA3YfxuyAUwgzg01PpnfodcnuRT5NJZTmQR23t11PT/kmvQPKc4kGN0fWBPdAqKJjThN+gwCiI/NLKzZSU7C+NcBsAoZERvJ4ek9uY7VKgFYCjKUMvymmKTgbcu6JKPHd7kdWms7AAAA//9iGg2NUTAKRsEQAgtHG3OUA+hBXQ8pNIicM0oonfWWh14VOCwA1C+UHCI5uopgFAxHQO8DSkdXE4wCSgE9BwgYhushvqNgEAEGBgYAAAAA//8aHSQYBaNgFAwlMHrAFPUAxWEJnXUgGvz//x90HsJHCq0dTreaULp1YnSQYBQMR0DvMzZGVyWOArIBqfUgFcBgumlsFAxXwMDAAAAAAP//Gh0kGAWjYBQMJTB6QBv1ADXCkpzGEaUdW/0BaJRRHUD9QMmS6tFVNaNguAJ6z5KODhKMAkoAvdPP6CqCUUB7wMDAAAAAAP//7N0JDQAwCAQw/Luas3kYjATSuuA9TQJgiqMoqlOUDf6yplsx/d5wcpDdiBADylbdT9nEO5PR3STwtJD/IuICAAD//+zdwQ0AIAhDUdjADZ3NUdzMSweQgDGa/xbAcwOWkADAK9giqJddWwyHBAp6RnJuV3Xgk/T2TNPD5CYVv9qtVq2kz1yBEHdvF0ImQgKcZ2YLAAD//+zcwQkAMAhD0WzS/aeMl54LbVUQ/htBPARFGRIAmIIhQb7fmq4dkm5lbMEn/ybgFwFw1n13zckBXrT3jW2yEOpJCgAAAP//Gh0kGAWjYBQMCTBaMdIEUCNMyVlN8IAKnYAEMgcoBhRA3UzJrOVDKm0VGQWjYDADepf3oysJRgE5gN7p5uJoLI0CugAGBgYAAAAA//9iIdai2o6F3Ex//yqw/P2jy/T3LyPz3z+MzP/+MjD9/Xuf5e+fe/k95S9HY20UjIJRQCMwWjHSBlBj2SK5y/4bKLyPmR/aQFtAgRkDASi99nD0LIJRMBIAvZdUg1ZFGQzEVodRMKQBvQcJRidLRgF9AAMDAwAAAP//IjhIUNq/yp75319TZiYmM8b//5n+/WdiYvj/n4mRgZkRxGdk+s/07x8T08Tijjcsf/7sZvr3d13m5Povo1E4CkbBKKAiGG240QCAzgdgZGR8SOEp+2QNEoBWhlDB7oYhOEhAyTaJj6PXgI6CEQIGojOUMMyuWB0FNATQcywoGfAlB4y2hUYBfQADAwMAAAD//+zdvQ3CMBAF4PtZgQFoqVghI9BHKekQM6RgALqkY4hUkRiGQfA9ZMktBUpIhHhf78KWC/v5bL8NCc7dsPNIjZttQ6AKhwJQeCigAYiZIQCIe6hgk9xrETT9qb17eo7H7sLJTERz4CNt3/NYIyQo8ib/NqF9Pv2rfuUqSllUThnrK3/4oH9QAsxcQbZfsLsHhgT0gTWuqLCSgJYhIi8AAAD//+ydsQ0CMQxFHdsNWzAAa3AFKyBRIpiBhoaOkvJgAyQ6RHdbUFPfjRDHyEBJgwKRDvkpXboUkfL0/fNWEizrS0WIU0sKPASAJQjQzABqQIWgaMIAREntJg+gkJ57qgltjYNSVS9WLYocWeJ5dth6usBxvsh6sx8lpGEkHgizJiSNzCrEbSK67uaT7o/O24Xj72gy25lzJMHpVcKXG7/vS+lY7gOkb6kJx8mhKSwJfOTA+YTSkuDmv9o4xQCAOwAAAP//whgkSFm4P4mFicnmH3TFAGgw4B8TE2QwALJigAm6mgC07eA/03/wagIGRmbISgMGKP0PMpggxvj/f/bf/8w5ixOLdzL9+7s9euGE8yMhhqEzW4yDwClgwMjICGpI11NiBng8aBQMKOionSL2l4k58i8Li9l/JmaOf0zgHUD//jMy/gOzGcHs//8Ymf6mz9/z8C8T8+458Y5Hh0Gsjc6eDkMAnS2cQGHZZA+6UnCwN55AnQ8KB2MWjjYQR8EIA6B2VD6dvVwA3XYwCkYBTsDIyEjp2TLkgNGtZqOAfoCBgQEAAAD//+ydvQrCQAzHL5c8iD6Aq7iKDyCCoJs+hg8hzi5OIujkO4jv4e7qeknlvNrSpVjP+oH5LQklBErh7nIk/97q+jvTzbGHwmNkZ704IQVrUdiic9YKAwVrMYgXYiGOnY+FzM8tYJ7rjM6tUPgw3C4v+rnfg14S/Dbz2aLFSH1BbDskYSIRi1LwiYSRRDB9HvzEhc6C3XrU+Zj4HwAkD4SV0dQCqR7SFvh9TPKYtcEX+MaYU+TL+QL6qw/2AOC7ACYRKbrfOlbhRz4iRSgroXvR//CCvaMqXvejoWM9ShkAENuB9wyDuv9so2u5kmGMuQIAAP//gg8SRK86JcPy908NaAAAo+OP1Nlngg4YgAYDQIMEaAMAjFA52KACE3RQATxwgDaY8JXp79/DLH//LA9YM/fWaKzQFowOEgxNMLGk0/UvE3P0XxYWEVCn/y8T8/+/kMGAv3+Zmf+DxZiZ//2FDgpAxf6C1SDU/gPnThaWfSuCjNYMREBQ2tAbTXu0A9RoFFAaP1ToQA/qhj302sP3FBhx8P///4N2S8Vow3IU0AowMjKCOkX+dA7gxP///49u7RkFWAGVBrZJBvQo90bL8lEABwwMDAAAAAD//4JvN/jPxBTylwF6xgAT4owBxLYDpC0GoAMLGUDbCWBi0C0GoG0HTEwo2w5AHRgG8BYFkDxY7t8/BmYGxv//uRmZ/nv9+8fksyE46TbLnz8rmP793e+1eeno6oJRMKLBjJwGib/MzG5/mVkC/jGzcIK2EfyDbCMAb/0BYTCbEcaG0GA2E/iyEdB2AxD7P1wNRN4+ZNNl9jV+uktHehgLYOJFAAAgAElEQVSPgkEHJlA4SMAPXSY8WK8HHD2LYBSMAvLAQAwSDMVbU0YB/cBA1DMbR+N3FNAVMDAwAMQEIkI3XlL9x8SkgtKxYGbG7HhAOxugjj+8YwLVA5qphHREmDH0wMRAS6IxOjAQs1T/MjPX/2di2rbdJ6p5l2eYxmhKGAUjDcxNr1KZlVVX/p+Rccl/RqaY/0xMXOBTQZgQ+eU/ZFDg3z8mtEEARsTAwX/YIAJUDWg4D2kwwdR/+0330cQ1CpDAgM++Qw8KO0ihMYN5uwElgwQPR2c1R8EIBgOxD1seOqM6CkYBCoCuChuIWw1GzyMYBfQFDAwMAAAAAP//Ag8SgGYY/0E6+f8QnX2UAQCUzj7yAAGok480U/kfpfOCNJiAZVDh/z9MPdz/mJh8/jExr9ztETp/n2vQQGTEUTAK6AoWJpfazkutmPiPiWn2PyYmt39I+Q+FxrKKgIGRkdhVBJBjSCFibt677ykPoVj+OAjcMGzBIDrJm9KOsDz0MKlBBahwwNWEweanUTAK6AWgW4gGYhZ1sK5KGgUDCwoG4MBChtFBglFAd8DAwAAAAAD//wJvN/jHxKQD2g4AvdoQvC0AfpvB//9MSFcb/sfYYsDwn4HpH6hzghD7+5/5H8N/yBYD2PYD+LYD0DYEhv/gbQcgJWg3I8CvW2T6z2T87/9/030ugRUsf/9sZPr3d5HNwW1PR1PJKBgOYEV0Ds8/Zmbvv8wsIf+YWcRQVgggVgPAVxH8ZwDdK4J7FcE/lJUGOFcRILP9GBgY+odIUI5eRzUCAGi2HHp2ijwFvk0YhMuEKVlF8HF02fMoGAUDsuUAdGuKw2A9LHQU0B9AVxFQunWMHLBx9CDNUUB3wMDAAAAAAP//YvLddUcZ0YGAzO6DZvn/o81ggrcYoG07gHU4QIelIc9e/kdeWQBdaYDaUYGIwVctMKKahbzS4D8TE88/JqbY/4xMe4/aeS4+YeUaNJpSRsFQBWvD0iRXRWUV/mdkXP+PkSnvHxOTONpZA3hXESCLIa8iYEDSh20VAXL+A9n3n4lJ0uXQM6XRhDQKBhmgdNbcHnrV4KAA0CXLlNzzvmG0cTgKRsGAzaKOriYYBchgdBXBKBg5gIGBAQAAAP//YvnHyMSJPIMPXU3w7+9/8OGCTP8YILP8sMMMGSCrCSBimIcZQlYfMGA9zJDhL3TFAMgYRvjBiNBVCwzQVQsMoJMNwfb8Y/rHxAhWCzWL4f9/UyYmJvOTli61zP/+rmP++2e+4ZnDT0aT7CgY7GBjUKLxPyZmn/8sLF7gQwghHfi/SOcMIM4WQBqIQ19FAO3g41xFgDyIh7yKADb4gKQe5AYrBgaGe0Mg+AZNp28U0BwsgDbMKWmIDaZ7zil1x2gnZRSMeAAaKGNkZNw4uppgFAwUGMBVBB9HBwlGwYAABgYGAAAAAP//YvrHxCT1H2W2Eu2MAbTDDP+jzVDCVh1ADzNE2RP9F3ZQIcxMZHuYEYcZ/kezB3YwInT1AkrH5y9EH2h1QcI/RqbDF4xtZl/Wtxg9iG0UDEqwzTfab3NA/Ir/TEwz/zExeWNuFcC+igDMxrOKADlfIK8iYEC+9QDLKgK0Mwq0hkiqGYiR+xEDBtMBXdBZc0qX18dDr6gaUAB1AyU3NoCWmD4YaH+MglEwSMBAbbsZHagbBQwDuYpgdDXZKBgQwMDAAAAAAP//YvkHnd1nZEDM8jNBzx/AOGOAAXrGAANkpQHs3AHo1Ybgzg70LAP46gPQ6QL//oPPGADTDAxIqxYgqwkYGKArEv7+h17BCDULZB9CDLrS4P9/SCfn//9/jMzg1Q4uDMzMblf0zZ8x/f27mvnvn9Xq1y88Hk1Ro2CgwD7XIN4/LCyxf5lZ/P4zM4uDrjAErZ35jxgAYPgPudaQ7FUESIcQYl1FgHbrAfoNCHC32J56r3jYTJDu9/2OglGAB4C2HORTGEAJg6BxT+ms0+iBhaNgFEDB////NzAyMj6k8MwScgBoNUHC6A0jIxdAB3zrBygARtPdKBgYwMDAAAAAAP//YvrHyPT9H+YMPspp6f9hM/+w2www7meHnzGA0llBWWmAtprgP5JZGB0cZPtAHSy0/dkYZxlAxKT+MzEV/mNiPnFLQ3/+XVUdz9FkNQroCQ45+krvdwlo+8fEtPs/I1PGf0ZGCbwdeNQbC8haRYCcNxhw3XqAZRUB0sodjtFEMgoGE4DOni+k0EkDsSwUDqBLUynZavBwdInzKBgFGGDAVhNA8/QoGJlgoAZsR+uBUTBwgIGBAQAAAP//Am03eIZtOwD6AADGgWhIhwyibQeAbDtAHgBANwvp+kOEfkjHH8dhhv/gAxVonaR/aIcmQvW4/2Nimn9PRfvsQ0X1ssfyKqPLlUcBzcBxG3fzw/bei6GDA/7/mMBXeWLdsoOyigDExrOKAGmlAc5VBLAbEHCtIkDOz8irCJBuQJAYCiljMCwfH8aA0rClxRWVlHYG+Af4OsQACpemji5xHgWjABMM1CCB/GieHJkAuh2P3mdhwMDoarJRMHCAgYEBAAAA//9i+g8eJECdwf+PtKoA6xkDyCsN0G5GwFgCDV0x8B9jUAD1ZgRsy6ZRzkfAMtDwH3EAG2wlBHyg4h9kFYT0Pyamkv+MTHefyClPfS4lbzOa3EYBtcBpC6fg49ZuB/4xMS36z8RkgrHEH+kqQ/yrCJDSP9IqAuTzCshdRcDAgLSiANs5I2A1QwKMDhLQDlAatlS/ohI6e3KRQmMGslFPid0fR5c2j4JRgAmotMqIXJA/mG5OGQW0B9DVIwNVFo9efzsKBhYwMDAAAAAA//9i2Wct/sP5yItnf/8zS8POGIDdRgDpQMBvLADNWcLPGGCE3oiAcjMC4owByFkGDNDzBBgQtxlAzzdgxHLGAAPWmxEg5x38h9rDiHwzAlSOAfnMhH9QN/yHnquAdDNCOBMTU+QLSbmnzP/+Tmf++2ep0JuXtJgBGwXDGFwysJT5x8wc8oeZJfEfMws3AyMjaKDsH7RzzkCoQ459FQEj3lUEyAMM5K4i+Ic0oIa0igDEfjFEYmt0kIB2YLAuowXNosynQL/8QJxMzsjIGEDhvunR2aNRMApwgwUUHghKCVgwetvOiAINA3AGBgwsGD2wcBQMKGBgYAAAAAD//2ICEf8Ymc6iL/3/B71JAMt5AFg7I9DtACg3I/xHmuVHOmMAftYBbPUByi0GSKsW/mNZoYC87QCxqgB11QJ8VQHaXmzoSgOZf0xMbf8YmR6/Fxab+YlfyG40FY4CQuC6trH2FX3zvn9MTEf/MTLl/4fcsIH7oEAsqwhAhxDiXUWAYg7SgAMJ+nCtIoAPYGBuzfkxRCJ/dJCAdoDSRi9NTuCHzqY/pNCYgTibYPTAwlEwCmgEoIN+BwcofPUZGRlHtx2MAADdZkDpAbqUgNF6YBQMLGBgYAAAAAD//4IMEjAzn/vPxPQd0TFHOw8AxyGD8M46/sMMsR0yiLPDQ+AwQ2z2oA4qMKIMCkC3HaCduYAYtIj6x8y8/TOf4MmvPHyjgwWjAAPcVtcLv6FltOYfE9POf4xMIciDWQxIWwNIWUWAMuiFvIoAxsaxigCPPgZsarCtIkB2I8iMU/ocQ+WKtdHZG9qBQTlIAAWULrf0p+d5FlC77CkwYuHo7NEoGAUEwUB21OtHtx0MbzDA2wwYoPXA6PW3o2BgAQMDAwAAAP//Ag8SHLQQ/vGPkWkPbI8/8iw/1pPRkTrkSOcB/MM4YwBpBh+5k0/gjAH4SgP0mxHQDzNEtwdl8ALL9XLogxYwPX+ZmXX+MzHt/MbNu+YnB+foCbYjHDySV+W/r6yZfldVB7TCpv8/I6MlvEPOQHCJP9LVhthXEcCX++NaRYBsPqo+/KsP4Ct0cK8iQD674D8j040hFNOjKwloAKCNIUoPdqVlY2YCFQ5GpOdqAko7L6OzR6NgFBAAA7yaAAQ2jN52MKzBggHcZsAwekjmKBgUgIGBAQAAAP//YoI55ICV6LF/jEz3kG8sQOpEY3bM0Q4zRN4OgDSYgLHtAGVQAalTg7zt4C/ajQXI2w6QDzPE2B6BtpoAedvBX7SbEeArDVDd5vOfkWnPL3YO/dEUOvLAcyl5uSdyym3/mZjO/WdkbAYdfInRIce+xJ8BW4ec7FUEkPMKcK4iQEnHqLceMJCyiuAf05AaJNAfbZTRBFBjRoxmgwTQWfUNFBqTQI+0A7UjgAIjDv7//5/qh0COglEwTMFAdqTkRw+VG54AeivOQN1mwDC6imAUDBrAwMAAAAAA//9iQnbMPyamJf+ZmN7/RbqOELVTg7TknxnLNYaI8wBQbkZA7sD/ZULqrKMNAOC6GQHLagHMcwcwzzL4h6EH/QpGVHtggwqgVQV7frOxj3ZIRgh4IyZl+0JSbtl/JqYL/xiZ0v4xMfHCVwUgd8gZsHfqsa0iQOmQk7uKgBGjU49x5gG2VQTIAwV4VhF8OKPLRunp8fQGo0s8qQ8cKDWRDgcDUtoZAK2UoMd1iAUUrsoYXUUwCkYBkWAQrCbwHz2fYHgB6DYSSg7LpQYYTVOjYHAABgYGAAAAAP//QhkkOGgpAtp2sBh8LSJsJhNjWwDmjCquwwyRO/lo2wH+IXfM0exB7uz/Q7MH+1YIRpRrGTGXgiMNWmAcZoh+PgJED98/Jqa9o8l0eIMPQqIxb0Ukjv1jYtryn5HRE1tH/j+0Y43nnAFcHXK8qwjQVgNgX0WA2qnHHJRDXm2DflsCnlUEUDN3DMHIpbhDOwqoHqaUHixIEEBnVSjtDNBjywElAxEP////T+mKiVEwCkYaGOgOVT30NpNRMMQBdCUYXW/CwQJGVxGMgsEDGBgYAAAAAP//YkJ3zQEr0ef/GJlm/2Vmvod0IwDK7OZfRCcf8zBDWEceedsC0kAD+rYDWCfqL9KKAfSOELYzBpDs+YduD/qqBbSzDDC2LcA6U8iDF/8ZmXR/sXPUjSbX4Qe+8vLXfBQQvvGfkXHGfyYmHSwn/mOsIkBO51g69ThXESAPJqANPhC/igBJDO3mBNgKBayrCNAOWYQPODAwMt44o8t2cwhG7GhjjIoA2iii5JA9EKDX8nhKOwPytGzMQ5eoUrKHdXT2aBSMAhLBIFhNAAILRg8yHNoAaYCA0vN5KAWj9cAoGDyAgYEBAAAA///CGCQAgf3WYj/22krO+sfItOo/E9M7pEMGEZ0V2OwotNONfjMCwcMMmTAPM8RyMwLaIYcYgxb/0AYAUA5GRDm3ALE94t9/NP/gOMsAJFbzm4199MC0YQJ+cnLpf+Pmvf2Pkan6PxOTLHrnHN8qAmI79VhuPcB7pgCW1QCYqwiQDiHEuaIByyoCHIcsvvjHxLRxiMbo6LkE1AXUWJlBl0ECaGdgMF+HSMkqgo9UOHdhFIyCkQrosZUIHwB1LA+M1k1DGoDOlxjos8gaR1cRjIJBBRgYGAAAAAD//8I6SAADu+2lz+5wlGv/y8w8/z8j0xXkmX6UzjrmIYMYVw6iHzKIth0A5ZBBtMEEyLYD7DcjoNKMKIMC2K9gRD8zAa2TiLJtAaImbzTVDn3wi50j7h8j0ynw4ADmagCKVxHADxDEsYoAeTABbTUAxasIMM45wD2Y8JyBkXHBGV22H0M4QkdXE1APUCMs6bk8k9JZFntazPhB79OmZEXGgtFrD0fBKCAPQDtWEwc4+EYHCoYoYGRkXDDABxUyQAeKR8+kGQWDCzAwMAAAAAD//8I7SAADO5zkr25xU57/n4mp5R8T8/Z/TEzfMc4dwDzMEGXbAfphhv+xdeBRbjtgxt3ZQT5jAGlQ4D8TxmGGqNsO0AcvUAYtmFH0IG078BtNtkMb/GFli//PxDQH5XwBrKsIUDrkZK0iQFaDsqKAAXEDAp7VABStIkAZYEA9ZBE0gHH8HyPTglP6HEN5gIBhdJCAqoDisKTDoYXIdi0YpNchUjqTOdo4HAWjgDLQQIWygVKgPzpQMLQAdIAgfhA4umB0oHgUDDrAwMAAAAAA///sXTtqAzEQnc9CqoAvEHARXAdcuHXlC+QAOUou4lu4SmNwkxOk9w1SJpXnmSdtgu21DUaGrIMeSILZnZGKFdLMPo2aSwa1mD1+isgby/PiY6LwiQKjoDtCh0QAgQfdkw0c3NUpixlboQOfZO7Bf7CUBSzLJOulZ4CF5SroX8GTnV+bAkk2JclSt0k395OdMsrc2/4BwBCAWG4huT+lfVZ8Z2fstGnt2B9IU7/7/rq1TPAVvLGjaZ7Cm/mpBH77LILkyJ9kERzoHWURdG49OBNM2GURHLIBOiyCfb2jLIIOKyG/vw615fv4fv1PvgdmlB7UBbUM7Rn60vOXf3EWmA71a4H+i6pebUOmqsPCTWZNVFVRUQjOZ87rHmSm/wkUTOsa1W/0KECwagPgFRX9gohsAQAA//8iaiUBNrDWV+fkqgD9Sf+YmOr+MzHt+8vM/A3jPAD0QwZRlm0zYT93AGnbwV+0mxGQtx3guhnhH7bzEbBdwYh6rSPmrDLytgVGJrvRpDs0wT9GprXwjjUsXTIwYsY3I84O+X9c+vCtIkBZUYC0ioAB2pHHtYrgH7IY8ioC3PpwrSI4+4+Jac4hc6G5R035h8sAAQwM9B7U4QCosSJjIPbRU6MxRc3VBJSmxdHG4SgYBVQA0I7WQB9iyDC6omDwg0E0QMBAp5t3RsEoIB0wMDAAAAAA///snbsNwkAMhm0nQ1BR01KCWIIFECOwAbPQgcQKFNDQsAslFTbynRUSlATloSSC+6VI0Un3KFI4/r+zK5EEeTosp0oXHPVZ7a8zFpljFE3U5QdPDAA7V967/E8jBhKqgETYO/nARgwg6BAhgIDRBILm8uscRy18EAq6nxvz+zhCwVEFnkwAJNG/MEUJkrWSNeFNLaCdwagCZDeX+q54GlRDHMdbjuJxSRvAfIog1cqwsM7AF4ogeS9KJmQSFNliiaUUQSphlkMRPITowkS302J0/+FvZhMQ7foy97uNO5idJwnUdUfEXcMAb91iFekmAd65y+saQUF/oLUVU+07ZgtEwUA1sASBFivsqkNQUFA1AcALAAD//6J4kAAZLIqwPM7AwHA8celhYcZ/TP6MTP+N/v1j4oZ2zCEDAKAOPBMT6rYDCA0ZAIBuC4BtO/gL3TKAvC0Ase0A2tlngAw0MID6Uv+ZGaADANDO/n8G+KACYjABvu0APnjBDN1iwATZgwAZtIBuW/jPPJqyhiD4x8iUh75tAHk1AKwjj3MVAW59DFg7/iSsIkC79QBjFQHKbSDIqwiQzytAqHn3n5Fpxz8mpis7HWS/j4CoBV9nN3qvPNmAGh3khwO4TH4ChY08UPpJoHSJJxW2bIyuIhgFo4CKADqICCrf+gdBuIIGCh5ABwpGO4IDDKArOyitO6gJLv7//3/0ysNRMHgBAwMDAAAA///snbENwjAQRe9i16xAR88A9Omgp6bPKEwAlNQMgMIMlFQMwAo+ZMeXnKKABLFEIu5VqVJZif31/S5pSMDs14sHAOw2h/MRjZkjUe4ymnIAwI4BVzUF/Pk+EwGA9AE0jgGIjgEIQUMoJzjhHQDpMmDvADsGoHYZ1AFA40yoGgM+vKDoVeDQgpsGlcNAGRPO2qUzduJbBIAtaWDHQbyzRYAtaeCbCQjftgjkO2WLgEcZvm4RhOcbYVae8tn1DxdnoWPjPidulMZ61SDgN9yIeOk5UaBIcEjvs8G76z1URUkPEW19iNzz+5AKnnqw0tbQ74j/vXIAYw4lem1SGTYA8AQAAP//oskgAQzMTnD6xsDAcBSEc2Ztk/v7n9mD4f9/E8b//3mg2wGQDzOEHTLI8B82yw89XBB6yCB4AADWyWdA6sDDth38QxxmCDs0Eb7t4D9kNcE/RmbISgMGJqRVC/BtB5irFqD2jKbkIQb+MTL5E7uKAHYIIc5VBMiHCaJtDcC3igD5vABcqwgYkAYicAxeYFtFcOI/I+O2tb4670ZwFNtDZ2hGG16kgQIqLcUd6O0eEyjsBOhTkn6g1x7KU2D/6ADBKBgFtAODZdsBA9QN+xkZGQtBAxiDwD0jCkCvvT0wSNICDIxuMxgFgx8wMDAAAAAA//+i6SABMpiS5vWIgYFhVsHUjUv+MYEGCpg9Gf//V4SfMYA0gw9fafAfeosB7NwBxBkD4G0BGDcjQDv5oG0HTP+YGLGcMYAYVIDejAAX+4/zZgTItoNRMKTAPyYmfWiHnOhVBMhyKKsIULcGYKwiQDmwkxHt6kEKVxHArjL8z8T07R8T097/TEx7VwYajoQtBcQA0Eyuw+B35uAA0LMIqHFI0sWBPpEftNWEkZHxIYUd9QRo45EcQEk4jt6JPQpGAQ0BdNsBKH+vH0Th3A8dXEwYPaeAPgCaBgb6xgt0cHB0m8EoGBKAgYEBAAAA//+i2yABDEzI9getLjgEwmX9K7UY//93+MvA7ABZCYDYdgA9Y4ABccggYtsBfFAB6XBB2LkDDIizDMADDsiHGSK2HSANAKAeZsgI32LAAB+8ALnh8GiKHlrgPxOTLrgzj+jAwzv2uFYRoBwaiG0VARNqpx7bVYZYbx1AGoQgYxXBo3+MTHsWRlodG+lxigXYU2Nv+QgCDcNkFQEMNFDYAARdh9hA6oAHFQ5+3DDaSRgFo4C2ADqQSOkhp9QGoHLjAnT7wehMMo3AIDx/AAY+jm4zGAVDBjAwMAAAAAD//6L7IAEy6CoMv8bAwHCtqnvpwn9MTA4M///7MjIzizMiDjUEd/LhZwxg3ozAgHnGAGLbAeZtBohtB0xMkDMNGJAOM2T8z4Sy7QD5MMPRVD20APoqAgakA//IXkXAgHQDApZVBGhnFMBXEYD0Ebgl4T+WVQTn/jMw7pob53BzpMclAQDafzra6SIAoDNY1GgwfRxEZ0FsgDYEKRn4KCBjVQCls0Cjs0ijYBTQB4DytsEg24sOWv10npGRsXF0Rpn6AFrXLaBwlRmtQMJAr8IbBaOAaMDAwAAAAAD//xrQQQIYaCuN/srAwLAVhBta5+owMjE5MTL8d0Y7zJARPgCAvO0A280IDCiHGTJiOWOACX5AIgOWKxiRth1AVyiMxIPhhjRA68CjHjJI4SoClHMOkFYRwM88wLGKAOXWA+SBCAb4YYlf/0GuMNw5I8n1zUiPQyIBP7TTNXrXMA4AnVWh1mqLBYNlQAbkDuh1VvkUGJMAXU1AlJ+ocPDjwdFG4igYBfQB0DIiYBCdT4AM6qFuSxhdVUA5gJbNoHZA/SB1YuPojUyjYEgBBgYGAAAAAP//GhSDBMigoTr5CgMDw5WWhhlzGZmZnRn//w9gYPovzvSf6d8/5KsNkbcdIA0m4DjMkOEf4mYEBqSzDP7DVy3ADjP8B+q4IVYfgLYoSD25/3HwhNAoIAYgz9wjryKAdeRxrSJAXuqPaxUBA/INCFhWEaCsEEBaRYB8AwLaKoLX/5mYtoEGCKake38bjWCSQT50NcHoIYbYQQMVZ1UG2176CRQOEvBDO/3EDqJQeu3h6MzhKBgFdATQ8wlAeXz/IAx3fdiqAlBZNroijjwwyFcPgMDG0VUjo2DIAQYGBgAAAAD//+xdO2oDMRDd+dQGXyD4AGnSGR8gR/A5nDZXcBFfIUdxmdKQKpWbnCDtPMnMatg4hMCajcNu0GtmEG80IC1idiSNaAqv+20fd0sG7hW2YoAFxgIQJ7CYsSSQmEkrYVw4RZfgOFeLJIk+GCCFCZ9xO/3Tz/vN8e1uBMNQcQE+ZvMXqN6aKDxBBNFkqin5LJ/rqv6F5FZKq6dOl8LtOKIIuxxt6Qe7HHYIu/SNX/p+Bct++7De//e5JaJrLzSeyFvUIOsrIjj+reJdzznn0d2njNMEQ65S+HOEi56+jgMC0d5+poYI0v/sJ6zN8VdUXAAi8l3mpxGPmRdi3dTd5v6I+jC7gTViro2DF1ieSmxS1/KKDk3TnAAAAP//GnQrCbCB0raCEwwMDCf6S7vFGZj+uzH+Z45FO2OAAevNCNAbC2DbDpDPGIAfZgjfdoB0BSNiNQFI7NHgC5FRQAj8Y2L6gLH/nwHtrAEirh2kZBUB8o0GyKsI/jMy7v/PyLS1ozhydNkx9QA/dI/66G0HUABtQFHzUMfBOhNC6SCBPDHXIUJPyqZkpmp0JmkUjIIBAqDrB6HX4Q22w+xgAFS2rGdkZARNGjSMrozDDZC2FlDrSl9aAdDkRcDo5MUoGJKAgYEBAAAA//9iGkoOL+wuffmfiWkdckcO1PHHehUdWIwZ6+FwEL3M/zAOkmNmBp+GD5oJRtpXPrrVYAiC/6C9/YxM/2BnDSCfRQC/oYAJNV3ArxtEusoQ11kEyGkH+SyC/9BBBNBZBMg3IEDPG1jxn4kps7kifmpbafToAAH1gT10VnnEA2gjagMVG1ALB+teemhjmtLVOMR04ClZRfFx9BaOUTAKBhZAV0JtHOTRYA+ayQVtoYMO9I4CKADVa6AzZBgYGB5Azx4Y7AMEDqNn0IyCIQsYGBgAAAAA//8aEisJkMFfJmZlyEoB+CGDDNBDBmFnCzDiOMwQcu4AM3SlAdJhhn+RrlJkhN2MALlu8R/jf+ZLg8f3o4BYAFpJgPNKQqRVBP+Rbz3AsooASmOsIkC+ypDAKoKX/xiZlv1nYjpRX5PydTQCaQ5A19odGO2QgQcIqHWi98chMAu+ANq4JheABpgUcDXooDOQlJg/2M5yGAWjYKQC0EDBgUF24wE2AFpC7z+6smBIrRxABgWjB1KOgiENGBgYAAAAAP//GnKDBOCOF/RqQ+ghgwyMSFsMmEAdOqRtB/DtBIjDDBFXG2IeZsiAfpghyPxRMPTAP0amSyirCKBXC+JaRQBedYBlFQHyVYbYVhEgD0KgrSK4/I+RaUlFS+7ozRj0B/MZQfE2QgcKoKspKJgyk/YAACAASURBVOnQooMJg302BBTX0BkmSrcD4FotQOntGSN90GoUjIJBAaA3HjgMkYECBqSVBQeht8uMmLIEupKiAXq47FAZHACBxNGJilEw5AEDAwNAQ26Q4B8jky4DZKUAw19mZvCwAWRFAfSMAQZmyKoCJsTVhv9RbywAdR8gnUcGxEADA5abEaD0sUHg7VFAIvjPxPSQlFUEsA4+rlUEyAMFyKsIUK4yhIjt+sfItLi4s/jlaJwNKBiRAwVUOMQPHTwcQqcyL6Dw+qsA0IwV+v5R6CwWJWE6aLdqjIJRMBLBEBwoYIAOFoBWPE2AlnWDfvCWXAA9/yWByoPd9AKjAwSjYHgABgYGAAAAAP//GnqDBExMDODtANCtAohtB9DtBOCzDMFbDP7Dtx1AVwxADzNE2XaAfJghkplgNbBVBYPA26OARCD68umj59IKJK8iQDmjAGkVAfKqBGyrCP4xMX35x8QUk99b8WU0rgYNGDEDBdCO7AIanPI86G4zwAMmULgclR+qH31QhNJVBKNbDUbBKBhkYIgOFDBAy6l86NW/F6Hl/oahPmAAvYknYAiuGkAGowMEo2D4AAYGBgAAAAD//xpSBxcyQGaIFaGHDGLfbw46zJAJfJjhP5Ql4nA1qIcZws1igh5ciHmY4dVB4O1RQAb4x8T0CHUVARPBVQTwGxBwrCJATkvIqwgYGBi5c/urRgcIBh+YP9wPM4QOEBygwQDBxKG0Dxa6AoDS68OwDYpQMkhwcHRf6igYBYMTQMsMB+g1dUMR6EOvdbzPyMh4AbTKADrwMegB9BDCBFD9zMjI+AF6VW/86ADBKBgFgwQwMDAAAAAA//8aigcXckHPH/gPPWTwH2LbAdJhhv/hhxminzEAO8zwP+wwQ+RtB4z/mEB9QKa//yHbFvQuHP80CLw9CsgA/5iYHv5nZJRCWg1A9CoClFsx0M82wHEg4oTSLqWC7rJ7o3FFE/CRgsZDPHRv47C7igh6oN4BGjSsHg7RK/saqHAdYgKssQdd9kpJ2I6uIqABgJ4/MQqGJjgwmAYfh/CKAnSgD8WgFQYfof65MFjCG1oHG0AHZRyGeFijg9EBAjLBaFk+iAEDwwEAAAAA//8aigcXisIHAKCdfNAEL9q5A/CDC5EGExhg2w6ghxkyQPRiOcwQeqbB//9MowMEQxj8Z2S6/I+JyQLfagBcqwhgZxfg1Ie09YCBAX7rAc9ID3MaggbojAm5ALS38QFoSeNwOSUaWrlSsgcfHxiSAyqgJbeMjIwbKVxVkYB00CAlqwhA5zlQurJhFGAHtEr3o4A+YFCVwcNooAAG+GG3I4DyCmjbHXS1xAXo9YEgf36g1SonaFgqQLEDdHBgqK4QIARGBwgoA6Nl+WAFDAwMAAAAAP//7J3BDYMwEAQXU0DySBsR6SCtpIV04vRGIaEBXwReKxeUF5YlDt0IiYfFAx6WvFrmLDoJLioAKHJB+RltmCWGkvI9JfTolHcA8/UNFfLzeTLCIjOky6CD9OMOXtnZSAph+tsiKM2AihaB9hyUiQYphCsAH5nZABGJ/GexRmR0oiX6xZFSJlsFbA/EhlKnp/GKfKwMCe6qsltzYPAWgeMYQQUFLdwue2BQ+9lyMGN4MDE8AAOEtdvgzfUzD/trblyDUdHgVubv9vAg2DksAD4AAAD//xpSgwQ1nYu4mRkhhwv+hd9GAJ35ZwD1/5kYGRgQVyLiPMzw/3+mv4jDDFFuRoAPNEC2HYweWjiEwX9GxqP/mJiKiFkNQO4qArRbD0Z6kNMaBEAbMJTOSORDT7JvGEozAEh3RdNy5B10Ev+Q7tyCVopAD/SipIOfgNTwJQd8HL32cBSMgqEFoAPHATS4JWYwA36kzv1I6uRTAkDlu8PoeTOjYFgDBgYGAAAAAP//GlIHF/5jZFKAHS6I9aR5ZuZ//9H3ijPCDzOEq0c+4BByOB0zxgF10IMRTwwCb48CMsF/RqaPKGkEfRUB8u0FWFYRoOnDuooAah7skEzd0biiHYA14KhkgTz0UMMDQ+GgJ0ZGxgLoAAktBwgu/v//fyjdZoAPUDrQEU/hbOKC4Xb+xSgYBSMFQMvBxNEIHwVYAGgAWmF0gGAUDHvAwMAAAAAA//8aUoMESJ04cKcM1PFH6uyjHCb3F3ZTAfTmAlBH7j/qAADqsnKo2dCbEWCdxEHg61FALlC6c/XKf9jKACJXAyCvIoDdgEDsKoJ/TExco5FFWwA9T6CQipbYQ7cgHIBuZxg0AHr6cwMjI+MD6HkMtNzTeRG6d3RYAOgKkY8D6JfRrQajYBQMYQAtQxwHuBwZBYMLLISuIBgdAB4Fwx8wMDAAAAAA//8aWisJmJi0oAMAKJ2+/0hXG6JcY4i49vAfygAA6mACykoDlNlkZuZrg8Dbo4AC8I+J6TG8Y8+IdKMB8ioClPMKMFcRoKQ13KsIQGoURuOK9gC6HH4hlS0CDRasB3XIoR3zAYtL0MoG6HJX2MoBeRpb+XCYNnwGqqO+cKjfWT4KRsEogA9KGwzhKxJHAfUA6KyehNEBglEwYgADAwMAAAD//xpigwTMqJ029EEBbAMA6PvK0fQh6YFvO0CyZ/R2gyEO/jMyPobFPewmA5yrCJDEkFcRwFcXENAHYjc3zRIb6WFODwBdDkrtgQIGaIe8Hune6QLoQYE0BaBVDNA7rkGdy/10vC/643C8GhIKBmqQYPQsglEwCoYJAA34/f//H1QHTByN0xEJQHWk41A/q2cUjAKSAQMDAwAAAP//7J3BDcIwDEWdv0Pn4MRerMQI3YAVugISF3bARiY/SqjgAmqB4H+teoh6qPrtvvdT4EIFhmI2uGT9oSgMSSvM8KYxJLAwQwhdUWeSCCrktaTFZpDNCBmC6N97hhZmePqCY0feiAFHBbbtFsHMXlDLgQIvfLJF8MB6oLxPmgLBS4JzPLNVsuOUZyll1aZoF+feaZ/yvzotZunQOqM/BYuaSGfu8t9K0sr3KwPIpl4Um5FIpMbMvDA+sATsVecXuc/Id2RsD0T+LyJyBQAA///sncENgCAMRT9hBCdyM0dxBAdwCUZxANFAi4AJiRdJgP4TksDRwKPNaw0STIna0L8Kg4wFZDPwn3zJJ4iggAgAGCYADBHOS9N63stBhDin7bxvAgkaj1XUbpBWETzjUhVBMpdWERStBzlMcJc/UWdWSGW3deadRtRHGVZEgQHC+zARXNFh/HfrwNeYQXorl8qQQF6bJJJO43R3DHlXMQF0nYM1yfI/l4wbADcAAAD//+ydsQ2AMAwEbZdMxWiMwEpZgp4dqAOyY0JAooiQAgm+MgUSosHP4a8qJFiROhn2Y7WhVhayIRCGfIhn/H2XjjBBztQY4HmOgwapRgyhAqDWHwLPfF7khOUDt2w8xBNN2RaBhgh3FsG+CPNqEej1bHlhQZKgYHypsioNJ2p5aXQN/2Jwgm0PRHSFns1cU6WmYRj5qEHWa+PMYFZBczi1B2yvjPFvAGADAAD//xpSZxL8ZWaWRb/68C/k2sN/4DMG0Dp1GGcMoOwrhxxiiOMwQ5DY9UHg5VFAIfjPxPSR7FUEsIEAtFUEKLceYA4maI/GGX0BqLNLwzMKhhuY+P///5F2OjO9ZoNGBwhGwSgYIQA6y2wA7VSOgqEPPkIPJ3QYHSAYBaOAgYGBgYEBAAAA//8aalcg/kMaAMC+9BtyKwH8GkP0w+b+Il1/CNPzFz6IgHqY4SDwMk3APxYWg38sLPb/WFgEhqH3UIDB2SMnsK0iQLnJAtcqAuhgAK5VBKgDDIywdDO6kmCAAHSggJrXIw4nAGoAJYL21Y40j4OWCENvcKA1GF2aOgpGwQgC0EMNQSvZAkevShzSAHT2gMHo9oJRMAqQAAMDAwAAAP//GjLbDdLn71FnBnXcmbGeMQA7zBByngDooELUwwwZkQ8z/M8E3WIAMosBtG0BadsB5LwDkD2nB4G3qQJ+s7HHQ5fb2v9nZJRjYEaKdnYO0A0Al6Cj4QvZf3wfdlf9/GNi+gTaBoC8igC8MoDoVQQ4bz1gwNiSwMQkNwi8PGIBqJIH3UrAwMCwYXQZKBxchG4vGMmzI6BlwfNpaP7C0cOtRsEoGJkAelaBArScyR9NBkMGPIRuLRg9bHYUjAJ0wMDAAAAAAP//GjIrCf4xMqEsE/+Pfo0hRA6+7eAf0ooB+MwvdMXAX6SVBkirCaBiiBUKg8DbFIEfnNx5Pzi5X/9lZpn9l5kl5i8zi+xfZpZ/yPgPCyuI1vnLzJL9l5nl1Ddu3t1fefjshrC3McA/RqaruFYR/EMWw7mKgBHvKgLk1ScgtaUTVo+uJhhAAK3wFUaXgYJBI+j6rtHlk+BBI1rO9DXQ0OxRMApGwSAH0G1voJVaiqN1z6AHsK0FCqMDBKNgFOAADAwMAAAAAP//GjqDBExMsuCOP2xwAGMZODNq5w1pMAG0nQDXHfcoZxkwoZh1cxB4myzwlYdP/ysP36m/LCxdf1lYeP+ysPwD4T+srH9hbDjGHDSw/svMsuMTv1D3J36hYTET+5+J6ck/1NUAKLcXULqKALZdASkNDZYT7EcsgDbYHKDbD0biMlBQI1Xx////o51XaHqg4XaAg6ODMKNgFIwCBtQtCI6jgwWDDoDaAo2gSYTRrQWjYBQQAAwMDAAAAAD//xoygwT/mZg4kQcAoAcWop4xgDjMEGUwAddhhkgdQ7AY2mDC50HgbZLBJ34h37/MLDv/sLDq/AF1+vFh0CoC9EEDBM78y8Ky472wmN4QCwIM8I+J6QkDbJUAjlUE/5DEyF1FgDQAJTrIgmDEAqTDpTaOkDB4CD17YPTwJUxAq4MFRwdiRsEoGAUoADRDPTpYMKjAQujgQMPo1rBRMAqIAAwMDAAAAAD//xpK2w2EYdsC0LcdIN1YAN92gHSIIWJQAb7tgAll2wFsoOE/SgeQ+dkg8DZJ4L2wGGjlwPK/LCw8WDv+6KsGmFn+omM0Ndp/WFi3vhaXjh5CwYAB/jEyXcd2yCXyKgLYVYY4VxGg6sO6igDpBgSRQRYEIxpAZ3YCoI21YXfmBhQgL58cPWUfC4AOmlD7BoyHo8tVR8EoGAW4wOhgwYAC2MoBQdDBxqODA6NgFJAAGBgYAAAAAP//GjIHF/5jZhZiZPgPOpiQAXrI4H9GBvBhhIw4DjOEiIHUMTGBDzP8Bz3M8B/0oEPG///Bs8vggwuZoGZCDzMMWTHj+SDwNlHgjZgUaFvAcgZmFhtQUIH0gDqsyHpBHVt0gKGGAasaHgYGhinPpeS9GBgYsiSfPRx6S7cZGT/BBoYYYCsDcKwi+IeyKgDl1gOMKxNxrCIAqR3dbjAIAbQzZ8DIyJgAnf0dDvH0EOqXDaMNIKIAaGVJPBXNG11FMApGwSggCKD1jwMjIyNowCCByuXQKEAFD6ErxyaM1oujYBSQCRgYGAAAAAD//xpKZxLAtxv8RdoqgHG1IdphhihnGCAfZoh0lSLSwYWw5eRDZqvBS0lZ3T/MLJf/MLNYwbYW/GZh/Yu+zQDL2QPoqwYwVh6gnWHg8ZeF5eBjeRXdQeBtksA/JqbrGFdlIq0QQF5FABpMwbuKAJmNfRUBiOYcQsEz4gBoph004z7EZ3YOQrcVKED9M9oQIgL8////AhXj/CP0QMRRMApGwSggtgw6AL2uVxE6yz16dSL1AHK9OLqtYBSMAkoAAwMDAAAA//8aStsNpPEcMoiy7QD5MEOULQRItx38ZWZG2XqAvO3gHzPzrUHgZYLgmYxi5h8W1oM4txcgOvv//oBoZIzlrAKMQQNMLP2XmWXfAyWN9EEeNCjAft+mz+irCJBXCWBbRYCSNlD1oZ5tgDHoBBZXG0TeHwU4ANIyUFBjbSKd7tKnBDyENioVoWcOjG4rIA9QK9xGZ6lGwSgYBWQB6DY4UEdWANSxHUHn5lAbfITW36P14igYBdQEDAwMAAAAAP//GjLbDcCz/P//MzEyM/+HbDtA2k7wnwm8fQC27QDU2Wf4D7nFECrH8Pc/VAyyRYEJ1N/7/w/UqQPph4ghbzsYBF7GCR7Jq4K2F7QyMLNEMDAy/kNWh76FgIHYrQZY1DAw4FTTdFdVxwO0ZE759pUhMQr+j4np9D9GJiP0VQTINxogryLAcesB0rkEyGcXIFYRwM4rSJ+/h2tmosu3QeD1UUAAQPeqg66uKmBkZDSALgUNGCTbES5CZ6s3QGfBRwGFANSIZGRkpMZ2k9HG6CgYBaOAYgDt2ILKJQVo3QOqg/RHQxYn+IhUL46u5hoFo4AWgIGBAQAAAP//GhKDBCGbLqswMUPOEfjHgDh3AOmMAfDZBMhnDMDOFkAZAICcZcDACDWLAWYmYjDh/1+I+nODwNtYwX1lTR0GFpbJDAwM2qC+L2bnnvAgATEDCTjUIIuZMzAwnrypaZikfv38MWr4jaYAdi4BI8ZZAwz4VhEgy6GsIkC5AQFlFQFsy4osAwPDkL1Gc6QCaEccNmAAa7CBBg4c6DRoAFouCXIDaP/qgdGZapoBUMMynwLDF47eHjEKRsEooCaAlimgc1MmjA4YYIDRgYFRMAroCRgYGAAAAAD//xoSgwT/mJgYIJ15pAEAlFUF4MMMISsNGOCDCQxMsJUC0MGEv5iHGYI6dIzgI/uQDzP8zzQoVxLcUdP1ZGBmAS2r4sM+QIB1hQAWv5A+aIDDbNChhquu6pr2aV8+3Ueid+gK/jEy3fjPxGRH6ioCMBvPKgLkgQKUWw8YGbkGc3iMAsIAqcEGBoyMjALQAQMQFoAOHDBA+fwkBClsTzxoMOADlH4wulKAPgAajwkUWjZ6x/YoGAWjgGYAbcBAADpg4AClSalvhjK4CB0w3zB6i8woGAV0BgwMDAAAAAD//xoigwTM0pAOPLiTz/APvCuACbyqALbtAL6dADYAANpiANt2AFlVwAgfAEDedoB0MwJ0UAF0M8KLQeBtFHBT07CJgZklBSpG/g0G2LYVELOyAP8KhYJLBpZu/xkZU/TPH3tCms/oA/4xMT2lZBUB2hkFcH0MyOYhVhGA2KCVBOcHY1iMAvIAdFb/ABSPgqELKG1kHxwd0BkFo2AU0AtA654FsC1O0G1xDkh4OA0aXITeGjO6km4UjIKBBAwMDAAAAAD//xoqKwk4YGcLwLcFMCDOHYBtO8B5xgBkpQBUDLrSAGQWExPKtgPQYYYM4C0K/wfN9YfXdExAqwbm/WdhsYANDoABsbP/uM8VQBYjeSABixqN/wyM286Z2JUYnTm0C6+nBgD8Z2J6hmsVAdIKAZyrCOA3IOBYRfAPZaUBeFuC8GALg1EwCkYBGFB6beHoWQRoADrLh+1gm1EwCkYB9fPbBegKNPCKJujWBAOkrXGkrm4bTAC0tUJgdIBgYMBoWT4K4ICBgQEAAAD//xoSgwT/mZgEoecOMMG2BSAdMsgA33YAWTEAXmmANJgAXykA23bwD3amAWyLAdK2A+hqgi+DwNsMl/UttBmYWeb8Z2SURhkgIHaLAOUrBHDaxYB9sIGbgYFh+mkLJ1AjeqLpiX2fcPmN3uAfI9PN/zhWAyCfNUDMbQfYVhGg3JwAoYUGi99HwSgYBRDAyMhI6YGUD0dPzx4Fo2AUDCYA3ZrwAPlKVqTtcQpQDNsmNxQGEOYzgraAjpa1o2AUDBxgYGAAAAAA//8aGisJGJkEGRDbAWC3Gfz7+5+ZATwAgHSYIWLbAdIZA6iHGTLCDjVEO8wQfjNC+tTGOwPt5wvGNiEMLCw9DJDO9z90eXJWCODo2BM2B/tAAj59cQwMDGbHbdzLLI/svI5h4AAA3w0LP68PScG7igB5pQGuVQSwswtwrSJA2nogMxj8PQpGwShAAQUUBsfoWQSjYBSMgkEPkLbHYQVIgwgwEEDhYa7UBqMDBWiAkZERVP8sGN3uNgroAhgYGAAAAAD//xpSBxeCzxhgQGwngGwbQDvMEGnbAWwAAL7FALJSALSQgAn5MEMGqFnw7QcDCM6YOYC2F9QyMLMEw1cPkHM7AREde2z6iFp9QJz9qgwMDIsO23u32R7cun4gwxQG/jExnf3HxGSA2slHubGA4lUEDIgVChyDwc+jYBSMAgiALsm1pyA4Po5uNRgFo2AUDAeAZRDhACMjI6jzOX8QeW90oAAKGBkZQWEQD9pOwsjI6DC6HWMU0BwwMDAAAAAA//8aGoMEzMwK0G0BsAEABsS2A7QzBpC2HYBWGjAgDSagHWYIPeQQxAUPJsAOM7w8UP48Zeks85+ZZToDA4MmrsMJGcjs2GMzi6hVA+SaA1ED2n7QesDZ35SBgaHdYe/GzxgK6QjgqwggqwFwriKAnTlAwSoCsFjEunOqK4KMbg+kn0fBKBgFcEDxWQSjDbNRMApGwXAFoM44I6Q9NzpQMIgA0gABA/TMhgXQlR+jYBTQDjAwMAAAAAD//xoq2w3+Ix0yiDhjALrt4N9/JsjNBQyIjj9ouQADE/K2A4zDDP8jth2gDjQMhB+P27i7/Gdh7WRgYOBFPn+A3FUDZK0+oJJdWMzy+8/IaLLHPSTPZeeaGxiK6QRAKwn+MzHpwzv5qGcUIDr8IDaeVQTI+nCsIoCJcw6UX0fBKBgFCABdWhtPYZCMbjUYBaNgFAxrMDpQMLgA2gABDPgzMjI2/P//n9KB71EwCnADBgYGAAAAAP//GvSDBA7HXksygwcIwJ18RvgZAyjbDtAGAGCHGUIWHiDOHUA9zJABedsBdFABtEKB7ucRHLb3zmFgZsmBdrbxHlBIzxUC2Mwie2UDA6MEAwPDqp1eEV3u21YswbCcDuAfI9NnlFUEIDaeVQRIKw1QVhHAbkDAt4oAaibowMlLA+HXUTAKRgEKoPQsgo3Qw8FGwSgYBaNgWINBPFBg8P//f0rL8iEDcAwQwEA9aHvI////NwxN342CQQ8YGBgAAAAA//8a9IME/5mYOP7DOvnQmwoYGeADALDbCODbDuBnDDBAzxhggBxwyIB0MwLaYYYQMeiqgn//6XezwQFnf9CqgSkMLCyg5fj/BnKFANRs1MEGLLegkDlogcwv3uoXY8zAyFjnvXExXbcf/Gdiuo19FQET1lUEKLceENCHZRUBCI/ecDAKRsHgAKMHFo6CUTAKRgGRYJAOFORDV4UVDOetX1A/TiBi9dsC6PkEowcZjgLqAwYGBgAAAAD//xr0gwT/mJgEGKArBf4hHS4IpRkQhxkith3AzxiAbk1AuRkBegsC0mGGsMEEmNhLevhrr1uwBgMzyyQGBgYpbAMEDER2yHHM2uM1B5tZONQQXn1Azi0LDAx2/xkZt2wMSizyXzf/LIYGGoH/jIzPsa8iYMS7igB5hQDyKgJkfVhWEYBoQXr5bRSMglGAHTAyMiZQeOXXRejd0aNgFIyCUTBiwCAdKAB1nA1A19kOx9Vd0AGCA9CzBwgBUL22AbrCYvS8nFFAXcDAwAAAAAD//2Ia7EH6j5FJALnz9Y+J+R8qjTSjCxX7y8SM0WEDDSaAxZiZ/yHPCIM7gSAxxP32NB8k2OUV7v+XhWXVXxYWib8sLP/AmJk8/AcN/2Zh/fuHhQUFw+2A4j8srH//MrOgYxT7oWpQxbBhFlSMbhc2v/1hYQXRXH+ZWWasC01No3V4w0DUoonP8a4iwHXrAQOETYw+lFsPGBhHVxKMglEw8IDSfZujqwhGwSgYBSMSQM8BSBxkfgd1oC+ABgoGgVuoBkCdfQYGhgdEDhDAgDxooGDw+24UDDnAwMAAAAAA//8aCtsNGKCHDIJvLgBtO8A4YwD5MEP0qw1hhxky/P/37x8TIwPSzQhYzjIA2fOVVn7Z7hMF2l5Q9p+ZxZfQ2QPUmrUnamafmDMMqHk+Aaqa5FVRWYYMDAxNYcumPcdwCJXBP0am2/8ZGZWxriKAsXGsIkAeHEDTh/3WA9AqmFEwCkbBgAFoI1KeAvs/jl6/NQpGwSgYyWCQrigAzaKvZ2RknDgczilgZGQE+aGfTO32jIyME0bSeQ2jgA6AgYEBAAAA//8a9IME8CsLkbYKwAcA0M8YQNxYgLLtAHaYIQPmYALyYYZge6obM+/Rwh9b/OOkGJhZ+hgYGNT+MzLiHyAgskOOcT4BER17bGYRdT4BMeaQeYYBAyMjaNR04fLYvJbIxZMOYSqgHvjPxPSF3FUEsBsQcOpjYvqHtIoATHvtuS+1zUXxGS39NApGwSjACUbPIhgFo2AUjAIKwSAdKGCAnlPgwMDAkDAU9+YzMjIqQK80tKfQqHzoQYajg9qjgDqAgYEBAAAA//8a/CsJGJm+/0M+XBB2xgDs3AHYagCkwwzRzx1ADCr8B3fcwCsSoAcVIg00/PvPxISlB0s52BCc5MDAwgJa8srDgDZAwEDFFQJEzNpjH5Ag4wwDYuzC6m7cAwlcDAwMbYsTilbHLuibiKGISuAfE9P5/4xMupSsIkDdroJy6wEDihoIe/QaxFEwCgYAQBuOlDa8RgcJRsEoGAWjAHWgYAKF57xQG4Amms4zMjI2gtw2VPbnQ1cPNFAxLCdABwpGDzIcBZQDBgYGAAAAAP//GgoHF76AbwcAdTGhnfy/0CsRkbcd/IMeZvgPOpgAvtrwP/gWAwbEtgOIPgakmxEQ2w6YL1Pb/WvD0lIZmFlSYd6hQ2cbrzm0WiFAttmYaoLnp5TrMTAwtCfO6aT6dZSwVQJ4VgP8J7SKAHYDAq5VBMgDBdi2coyCUTAK6AIo7eAvHD0MahSMglEwChAAOlBwAXq43mAaKACBetCKAkZGxobBPKMOHcBeQOFWOGxg9CDDUUA9wMDAAAAAAP//GvSDBGd02R6aXvoJ2g4AWQ0AW1XA9J/h3z+mf6ADCjDOGGCADyrAxZC3HaDcjAA1CzrQcJ9a7l4dmcn7n5GxloGFxQ75/AFazdqTu0KAbLPJ2epAvF1KoAb+nIzqJeiLigAAFktJREFUKSkzWndguJkC8J+R6cI/JqYYtNUA/9FWA1C0igD5BgTw9YijYBSMAroC6I0GpBz+hA2MriIYBaNgFIwCNACaqYZ2dAfjQAGo4z0fWgc0DKabaaBh1kCFFW74AOwgQwca2jEKRgJgYGAAaNAPEjBAVhNcYPz/3+A/E8YZA7DDDGHbDxhg2w5AhxmCxggYEdsPkLYdQFcaQJYoQFYoQAYarlLDvctjclUZmFm6GBgZxVEGCKg1a0+ljj0DkVsdqLRCAPsgBe6BDNAy/dKZ2fX6/xkZp2ZMafiCqZd08I+J6Que1QAYtxdQsooAat57arh7FIyCUUAcgF4hRemNBgdHl2yOglEwCkYBdjDIBwoYoB3x/YyMjBehWxAGbGUBdMCigAoD18QC0EGGC/7//59AJ/tGwXAEDAwMAAAAAP//AvWnB73XDK/+lWf+9zeO6e9fJpa/f5iY/v1lZP7zh4n5318mGM309y8j898/TMx//zJBaTAfpAesDsJmZIGJQdWCzGL5AzbzXWdRRA6lbl0SX+gFOkDkPyMjN4YktTrb1J21J1kNno49fneTNZAAVgO6lrI+e2LNXUy3kA4mF7btAm1J+QO9khHGBp19AboWEnSV4z8m5v9geQgbcr0jkloo+z9UH/RqR4haJPa3XQ4ylHZWhgVgxJqOiAfgnUKjYBQQAUBLTaHLTikBjoNpBmoUjIJRMAoGIyDxXv+BBB+hS/wX0GMAGHaYIgMDQ8AADqIkjh5kOArIBgwMDAAAAAD//xoSKwnOazM/NLr6/wHj//+K8DMGUA8zZABtO8A4YwB2mCEDys0IEDHomQbwmxH+/19NqTsXJpdWMbCweDBAOruoNxgQefMA7WbtqTf7T6uBBDxqRBkYGKZNLO6Ykd9bsR7TLtLAf0bGi/8YmXRQVgngWkWAJIa8igB+tgH+VQRUGdQYBaNgFBAHoPdMUzpAcHB0gGAUjIJRMAoIA9Ded6QVBYN5oADUUc+H3gLwELokH+TmA9TYvw+9pcABigdyYAAZzB89yHAUkA0YGBgAAAAA//8aEoMEDJC95Jv+Mf1PY/zPzIn1jAEG8BYD2PYDxNWGsG0H2A4zhG87YH7Ymxd8kFy3zUurlGBgYGhlYGZRxno44eDpbJNkFzZ1VLxSkZwzFFJ7y3t1GRgYeos7i79iWkIc+M/EdOwfE5M25tWH0LMIQAMAjPDDCzHOIsCiD+MsApC+/0xMVNm+MgpGwSggGlBj1mR09c8oGAWjYBQQCaCdbAPQEncGBob4IRBu8rABAwZIBx+0JQHUkX4ApWGDBh+g2ypAqyUMkPTD+DDaYJBuuWCADlqMDhKMAtIBAwMDAAAA//8aMoME57WYPhpe/b+Tkem/P3wAAHaYIQP8MMP//0B3IDLBzxgAH1AInu0FjylADjNkQDrMkPE/0zfG//9nkuuu2Zk1Bv9ZWJoZGBi4EecP0K6zTc4KASxmXfrPyNjNwMAQCMXY7cNuDlVuWcBxiCJhfzAwmoHGZbqqJraUteWTdRvFP0amXf+ZmCL/MzJyIp07wIB3FQHK9YiIVQQYtyUgnUWw10biHDnuGwWjYDACUENpMJ+YzMjIOIEKM1mjqwhGwSgYBaOADADaA8/IyPiACqu56A30cdUdjEP7hirQDT2jB/COAvIAAwMDAAAA//8aEmcSIAOjq3/0mf/+9cc4YwB6TgHTv79M0DMG4GcToIhBzjCAnWnwk+nv385pqR6PyHHLjJyG+P+MjLHo4gO5QgBiNN5Z+w0F3WXwQZH+0m5LBgaG4v+MjFxk+WNgr2tcXtmUvRxTI2HQVTUx6h8zcwS2cwf+MjH/J+Ysgr8sLH/BZxfA1EDVg88lYGFZNTpIgACjZxIMfQBt/A3Kq6WgB0PNp4JRo2cRjIJRMApGAQUAWh5PGMSz6yMBbPz//3/ASA+EUUABYGBgAAAAAP//GnKDBCBgfOW3PvOfPwGgzj78MEPYwYV4DjNEHkwADRAw//3TMyvBmeQBgqn5LTwMDAyZDAwMbrRajo9VH2Wz9qDl+f0lHUXH0eV7KvvF/zMy1jAwMCiSYhdW+2h4XSMOu0BL+ttr69JI2n7QWT2J+y8Ly4S/zCwif6EHFoIHCCBs8MDBX+ghhHA2bBABrh6qFiKGrPbuHjupWaS4Z7iD0UGCoQ3QDgNcOJhOTYaeQ0CNE7ZHG1WjYBSMglFABUDFcnkUkA5A2yccBvPKv1EwBAADAwMAAAD//xqSgwQgYHL5lwTz3z8BzH//SsJWFSAPEEBXFTAiVhUgbjtg+fvnMtO/vwvnR9t+I8fuicUdoKX6esR07BnI7ABTsBwfm5r7oFHd8ta8ezg9xcDA0FE7JZKBgSESm3uw2UfDFQLEhRHiMEjQDGddY3USSQMFLQ0zFP+ysDT/Y2LmQF9FgNzxJ2UVwV9mlrf/mJkn7rWR+EGKW4Y7GB0kGLoAeiDTfTQPbASd3DzQjRAqN0QV/////4AK5oyCUTAKRsGIB0Po5oPhBEYHCEYBdQADAwMAAAD//xqygwQwYHH+qwHT37+GLH//KCFdbciIbdsB898/p5n//j25LMTkNrn29ZX1pDMwMPgzENu5HfjO9l4GBoY5VY1ZRHWgWxpm6DAwMFRhbD+g4nYIjJseqGP26ZbyuC4MywiAhta5in+ZWRr+MrNwkLaKAGnVAWIVwdu/TMwL99hJPSfVHcMdjA4SDF3AyMh4AHrnNDoAnRAdMFAnJ1N5gKDx////owcWjoJRMApGAZUB9LyY/NFwpTkYHSAYBdQDDAwMAAAAAP//GvKDBDBgc/oDB/Pfv4pMf/9KMf/9wwjdVgCj7zL9+/t0nY/2d0rs6K6aADpZvx3Gp2CJPF41xKwQwKYOS4d8bm19+mZsfsEHGlrngg5hrGBgYNBGsp/kjj2RbiRq0ITIAZGFHcWR24j3KQRUdy1W+MvMUvKXiVmYglUEd/4ysyzcbS9NURobrmB0kGBoAkZGRtDye0LXjjaCVirRs2FC5T2vD////69ABXNGwSgYBaNgFGAB0Lpkwej2A5qB0QGCUUBdwMDAAAAAAP//GjaDBPQAHbVT5jAwMIgxUHE5PlazKJ9ZB22jqG2oTkZfIkwSqO1Y6A1aUky0/ej+peF1jTgGEkCrJfK6C0JJ3kZS3reC+y8zS/BfFhY3klYRsLB8+8vEvGObi+JhUu0cSWB0kGDoAehS0QdENuoe0uNQQ6ibJlD5mq3RwwpHwSgYBaOAxgC6dW3D6PYDqoOFDAwMBaMDBKOAqoCBgQEAAAD//xodJCAStDTMMGdgYKiEqSanY89A7Mw6Zcvxr4EO72+uiCdpfz4uUNW9VOE/I2MJAwODKMn+IGOFADazSBxIWNefE7iOFD8ig/xpm0AHGbr/ZWYx/MvCIggbMMCyiuDxX2aWk/+YmE9vcVMeXT1AAIwOEgw9QOYS0YfQTvwCajdYaHRi9sT///8XUNG8UTAKRsEoGAV4wOj2A6qCQXWQ8CgYRoCBgQEAAAD//xodJCASNLbMAS2/N4OpxnOIHgJQ6eYDEjrb29pKoxdSyctwUNq/igt6m4MJkl3obsTrZmxqsKojYtCEgDlvJmX6FhHyEzEgdcE+kb8sLMJ/mVmE/jIzg+ibf5lZGP4yMz9Z66szOjBAAhgdJBhaALrf/zyFjl4IPTNgA7kDBtCZpwLoiiZqL1O9+P//fwMqmzkKRsEoGAWjgABgZGR0gG4/kB8NK7JB4mC8kngUDBPAwMAAAAAA//8aHSQgEtS1L1jEwMAAPsyPakvkqbf64Nt/RsZpXYXhZ6jhV1ygaPI6OwYGhtj/jIycGEqIGDSh1lYDjMEXzEGTkqlpnm9I8dsooC0YHSQYWgDPYYXkAtB+yQvQ7Quwpf0fYIceQgcDYOcCOEDZDjRsQH6E7t8ckEMXR8EoGAWjYKQD6PaxhtFVBSSD0fprFNAeMDAwAAAAAP//Gh0kIAJUdS0BNVgRJ+fTaIUAA3kDCQ//MzLO6M0LfkihN4kC+dM2yf9nZExlYGCQw+EemBjhLRM0uhoSdGDjjCTXoxR5dBRQFYwOEgwdwMjICJq57x/m3gz8////hkHgjlEwCkbBKBjRYHRVAUlgUFw/PApGAGBgYAAAAAD//2IZjWfC4C8LC2gFwT8G0g7Ro81AAqoa0GF5i/uzA0g+qI9cMDHL72H2rO1toKvPGBgY3KjkD+xqiNzWgWUgQZhW/h8Fo2A4A6SZneEMGkcHCEbBKBgFo2BwANDBsdAtbqAB6vrRaMEKPkIPB54wCN02CoYjYGBgAAAAAP//Gh0kIAKA9qHjHSQgY7abCsvxl07O8NlJJS+SBKameYIGJZZlzNt94z8jYxIDAwPK9gNiDmOk1kACUQc/joJRMAqIBdQ+GHCwAdAhT8N9EGQUjIJRMAqGFIDOjDcwMjIugK4qoOZ2t6EODkJXDzwY6QExCugIGBgYAAAAAP//Gh0kIAL8ZWH5Dx8kIKOzS63l+FB9oA56x7RUj0dU9SQZYEaS67nkRQdA2xyyGRgYZJH8gu5mqqwQIOHAxNFBglEwCsgDB6h8veBgAqOnQI+CUTAKRsEgBtCOsAN0C8KEEX5d4kfo1YajhxOOAvoDBgYGAAAAAP//Gh0kIAL8ga4kIPMQPeqtPmBkBA0MdM1MdKHb9gJCYG6cw1sGBoamhKVHfBkYGHywDYhQbesF8QMJo4MEo2AUkAFAjRFGSJ6aP8zCb3SAYBSMglEwCoYIAG1BYGBgMIBefdswws4r+AgdIJkwevbAKBgwwMDAAAAAAP//Gh0kIAL8ZWYBzZb/JfMQPbI6wFjU7JkT77iCuj6jHlgQbbM5duWJm/8ZGTOQtx8Q1bFnwDqQQMl2jMcDFhCjYBQMcYA0UDBcth6MDhCMglEwCkbBEATQWfQFI2iwYCH07IHRrQWjYGABAwMDAAAA//8avd2ASJA+f08X+oF45J4rQOJyfNB9/CvnR9seo6H3qAYi154FDRCkMTAwqDJQsGqAgbJtHY1rfXXeDVwojAJ0MHq7wdAD0IOkFgzx5Z6j90iPglEwCkbBMAHQbQgNw+zMgo/QunbC6ODAKBg0gIGBAQAAAP//Gh0kIBIkLz4YwcDA4IysmkorBPDttX8CGlVcFGE55GbGwzZcBBXkQSQexki0GvRBBCQ1zzZ4aXRT4PRRQAMwOkgwNMEQvscatPorYPQe6VEwCkbBKBh+gJGRUQF6G0LCEF7x9hC6Ym/B6LaCUTDoAAMDAwAAAP//Gh0kIBLELzsKWkXQBldNtc4uzoGES6ABgmWhpt/p4D2agMCt16RB4ysMDAxCCPNpdPAjA3yFxorNbiqnB1lQjHgwOkgwtAF0VcGEITJ7sxB62NNoo2sUjIJRMAqGOWBkZAyAXssdMAQGDECrBjZABwYODAL3jIJRgB0wMDAAAAAA//8aHSQgAcSsOgk69duCgbLT+InpAK9dGWi4n55+oxXw23ELtP0gkoGBQYfoMxzIH0h4v91ZoQ1D8SgYcDA6SDA8wCDfF3oROjgw2vAaBaNgFIyCEQigAwYO0AGDwVJPPYQODBz4////hkHgnlEwCggDBgYGAAAAAP//Gh0kIAFA99s3gQ7mo/ISeRj4/p+RcfYaP907A+A9mgLv3fdM/zMy+jEwMHAg20O1MxwgYTtrl4PMvSEQHCMOjA4SDC8AHSxIGCQrCx5CD3oaPXtgFIyCUTAKRgEYQLckgAYMDKCYXvUVaMD6AvRK4QOj5wyMgiEJGBgYAAAAAP//Gh0kIBGEbbgo/Z+RsRxdFzlL5NHUPGVgYJiy3ltryG4vIATcDzyWAgUhAwODJAMFBz/iWLFxbK+NxBb6+mgUEAtGBwmGJ0DaFzoQszYboUs2R2dmRsEoGAWjYBQQBNCtcwLQwQMB6OABA5QmZasCaCDgAxSDBgRAAwEPRleyjYJhAxgYGAAAAAD//xodJCADBG69ZsbAwBCF0Enk2QO4BwkObfJQGxENXefDz0ErCVwYGBissVx7iKGeyIGEcwctRdbSxMGjgCpgdJBg+ANo4wu21JMWMzYfoTMzoLJyw+iZA6NgFIyCUTAKRsEoGAU0AAwMDAAAAAD//xodJCAT+O24BTqULxu0fJ6oJfLYO7s/QLNhW12VRtxBew7HXmv9Z2QMQtl+QN4hhscPmwluo5lDR8EoGAVkAehVVaCBAwWk2RpiBw8OQukD0BmaC6M3FYyCUTAKRsEoGAWjYBTQATAwMAAAAAD//xodJKAAeO++BzqjwP8/I6MxsilEncbPyAjaO79yh6Pc+8HqP1oDm9MfQEu9gqCdCNBACoqNBAZfQLOI648Z847u9RoFo2CIAtAVi6MrAkbBKBgFo2AUjIJRMAoGEWBgYAAAAAD//xodJKACcD/wWBDU52VgYDABryzAfTo/aOXAVQYGhrO77aVHD9iDAstzXxT+Q5YqGyCLY6wigAwivGRgYDhxyoBzdFZxFIyCUTAKRsEoGAWjYBSMglEwCqgJGBgYAAAAAP//Gh0koDJwPvICdCifIOxwPgZIZxe0WuD5Pmvx58PFn7QCppd+KsAOQENbkfHiPyPjy7M6rKOzjqNgFIyCUTAKRsEoGAWjYBSMglFAC8DAwAAAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NABDQAAAMKgz/6hLQIRmAYAAACg6gAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//+zYgQAAAACAoP2pFymMJAEAAABQ1QAAAP//7NiBAAAAAICg/akXKYwkAQAAAFDVAAAA///s2IEAAAAAgKD9qRcpjCQBAAAAUNUAAAD//wMA2Samg9r4xKwAAAAASUVORK5CYII=)" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "e5osj0vVuqT8" + }, + "source": [ + "\n", + "This notebook demonstrates how to use the pyEQL library to calculate equilibrium conditions in a carbonate system, specifically focusing on the concentrations of CO2, HCO3-, H+ in an aqueous solution.\n", + "\n", + "In this tutorial, users will learn to set up a basic equilibrium system with pyEQL, define initial species concentrations, and calculate both the equilibrium pH and final species concentrations.\n", + "\n", + "For more information refer to the [pyEQL Quickstart](https://pyeql.readthedocs.io/en/latest/quickstart.html)\n", + "\n", + "*Tutorial by Nikhil Dhruv and Ryan Kingsbury*" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "BdztuGoowC9d" + }, + "source": [ + "# Step 1: Install and Import Libraries\n", + "\n", + "First, we need to install pyEQL and import the necessary libraries. pyEQL provides functions for equilibrium calculations in aqueous chemistry, making it well-suited for modeling the carbonate system.\n" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": { + "id": "v_IUkaKMxI7v" + }, + "outputs": [], + "source": [ + "# Install pyEQL (only needed if not already installed)\n", + "# Don't need > /dev/null 2>&1\n", + "\n", + "!pip install pyEQL > /dev/null 2>&1\n", + "\n", + "# Import the pyEQL library and other necessary modules\n", + "import pyEQL\n", + "import numpy as np\n", + "import matplotlib.pyplot as plt\n" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "-XxKBG2VyGRT" + }, + "source": [ + "# Step 2: Define Initial Concentrations for Carbonate Species\n" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "za6HA_-xyXe3" + }, + "source": [ + "Define the initial concentrations of the carbonate species in mol/L. For this example, we'll include:\n", + "\n", + "\n", + "\n", + "\n", + "* **Bicarbonate** (`HCO3-`) at 1.0e-3mol/L\n", + "* **Carbonate** (`CO3-2`) at 1.0e-4mol/L\n", + "* **Hydrogen ions** (`H+`) representing neutral pH (pH=7)\n", + "\n", + "\n" + ] + }, + { + "cell_type": "code", + "execution_count": 54, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "4.004913801641528" + ] + }, + "execution_count": 54, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "solution = pyEQL.Solution(initial_conditions)\n", + "solution.pH" + ] + }, + { + "cell_type": "code", + "execution_count": 59, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "10.000195364947507" + ] + }, + "execution_count": 59, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "solution = pyEQL.Solution(initial_conditions, pH=10)\n", + "solution.pH" + ] + }, + { + "cell_type": "code", + "execution_count": 60, + "metadata": { + "id": "1eK5yghBt5b_" + }, + "outputs": [], + "source": [ + "initial_conditions = {\n", + " 'HCO3-': 1.0e-3,\n", + " 'CO3--': 1.0e-4,\n", + " 'H+': 1.0e-7 # Note: instead of including H+ here, you could use the pH keyword argument\n", + "}" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "XrFBQeXIxWT9" + }, + "source": [ + "# Section 2: Initialize the Solution\n" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "3K3UXL9kxeyW" + }, + "source": [ + "After the libraries are installed and imported, create a ` Solution ` object to represent the carbonate system where equilibrium occurs" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": { + "id": "N20sHJ36yCZQ" + }, + "outputs": [], + "source": [ + "# Initialize the solution\n", + "solution = pyEQL.Solution(initial_conditions)" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "bO6qlHX3wZ01" + }, + "source": [ + "# Step 4: Retrieve and Display Initial Concentrations" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "pFJkVszcwkoe" + }, + "source": [ + "Next, we will use [`Solution.get_amount()`](https://pyeql.readthedocs.io/en/latest/class_solution.html#pyEQL.Solution.get_amount) to display the initial concentrations for each species in the carbonate system. Remember, we have not equilibrated the solution until we call [`Solution.equilibrate()`](https://pyeql.readthedocs.io/en/latest/class_solution.html#pyEQL.Solution.equilibrate)!" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": { + "colab": { + "base_uri": "https://localhost:8080/" + }, + "id": "KEOk1-5YwlXL", + "outputId": "6489ea32-208a-46ba-bc0e-82888d0c7cb8" + }, + "outputs": [ + { + "data": { + "text/plain": [ + "{'H2O(aq)': 55.319705873262286,\n", + " 'HCO3[-1]': 0.016333195734562208,\n", + " 'CO3[-2]': 0.0016607536395842363,\n", + " 'H[+1]': 9.887493212140253e-05,\n", + " 'OH[-1]': 9.995506319339221e-08}" + ] + }, + "execution_count": 4, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Retrieve equilibrium concentrations using get_amount\n", + "{species: solution.get_amount(species, 'mol/L').magnitude for species in solution.components}" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "bO6qlHX3wZ01" + }, + "source": [ + "# Step 5: Equilibrate the `Solution` and re-examine the concentrations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "`equilibrate` uses the [Electrolyte Modeling Engine](https://pyeql.readthedocs.io/en/latest/engines.html) to calculate the\n", + "concentrations of individual species in the `Solution` after it comes into thermodynamic equilibrium. The default modeling engine does this based on the USGS\n", + "[PHREEQC software](https://www.usgs.gov/software/phreeqc-version-3). Notice how additional species appear (such as `CO2(aq)`) appear." + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{'H2O(aq)': 55.319705873262286,\n", + " 'CO2(aq)': 0.017914993150922456,\n", + " 'H[+1]': 9.9612076212742e-05,\n", + " 'HCO3[-1]': 7.89561874012311e-05,\n", + " 'OH[-1]': 9.815800515624362e-11,\n", + " 'CO3[-2]': 3.661456852916522e-11,\n", + " 'H2(aq)': 7.730951850139117e-29,\n", + " 'O2(aq)': 1.0539559631767556e-36}" + ] + }, + "execution_count": 5, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "solution.equilibrate()\n", + "# Retrieve equilibrium concentrations using get_amount\n", + "{species: solution.get_amount(species, 'mol/L').magnitude for species in solution.components}" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "TwieSDP4wuOv" + }, + "source": [ + "# Step 6: Examine how Species Concentrations Changes as a function of pH" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "id": "rCmDP4s6w0d0" + }, + "source": [ + "In this step, we’ll create a line graph to visualize the equilibrium concentrations of each species in the carbonate system as we vary the pH.\n", + "\n", + "We’ll use ` matplotlib ` to plot the results, with different colors for each of the key species" + ] + }, + { + "cell_type": "code", + "execution_count": 50, + "metadata": { + "colab": { + "base_uri": "https://localhost:8080/", + "height": 564 + }, + "id": "NPcejbyAw887", + "outputId": "43d53a19-60bc-4e0d-9775-fa0334f20342" + }, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "import matplotlib.pyplot as plt\n", + "\n", + "# iterate through several pH values, re-equilibrating the solution each time the pH changes\n", + "phs = np.arange(0,13.5, 0.5)\n", + "# store the species concentrations in these lists\n", + "h2co3 = []\n", + "hco3 = []\n", + "co3 = []\n", + "co2 = []\n", + "\n", + "for ph in phs:\n", + " # create a solution with 1 mM total carbonate, then equilibrate\n", + " s = pyEQL.Solution({\"Na+\": \"1e-3 mol/L\", \"HCO3-\": \"1e-3 mol/L\"}, pH=ph)\n", + " s.equilibrate()\n", + " h2co3.append(s.get_amount('H2CO3', 'mM').magnitude)\n", + " hco3.append(s.get_amount('HCO3-', 'mM').magnitude)\n", + " co3.append(s.get_amount('CO3-2', 'mM').magnitude)\n", + " co2.append(s.get_amount('CO2', 'mM').magnitude)\n", + "\n", + "# Plotting the equilibrium concentrations\n", + "plt.figure(figsize=(8,4))\n", + "plt.plot(phs, h2co3, color='skyblue', label=r\"H$_2$CO$_3$\")\n", + "plt.plot(phs, hco3, color='g', label=r\"HCO$_3^{-1}$\")\n", + "plt.plot(phs, co3, color='r', label=r\"CO$_3^{-2}$\")\n", + "plt.plot(phs, co2, color='b', label=r\"CO$_2$(aq)\")\n", + "\n", + "# add a horizontal line for the total carbonate concentration\n", + "plt.axhline(1, ls=\"--\", color=\"k\")\n", + "# add labels and legend\n", + "plt.xlabel('pH')\n", + "plt.ylabel('Concentration (mmol/L)')\n", + "plt.legend()\n", + "plt.title('Equilibrium Concentrations of Carbonate System Species')\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The plot above is exactly consistent with what we'd expect to see based on [carbonic acid equlibrium](https://en.wikipedia.org/wiki/Carbonic_acid)." + ] + } + ], + "metadata": { + "colab": { + "provenance": [] + }, + "kernelspec": { + "display_name": "Python 3 (ipykernel)", + "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.12.5" + } + }, + "nbformat": 4, + "nbformat_minor": 4 +}