{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "76283c7d-8237-4e8e-8d7c-ad74511deed1",
   "metadata": {},
   "source": [
    "# Solution Demonstrations for `pycap`"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "56843571",
   "metadata": {},
   "source": [
    "## First, make some imports"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "5cb2ece2-f25f-4a00-a64b-fd3524e5a2d2",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:02.109995Z",
     "iopub.status.busy": "2025-05-27T20:24:02.109855Z",
     "iopub.status.idle": "2025-05-27T20:24:02.415970Z",
     "shell.execute_reply": "2025-05-27T20:24:02.415705Z"
    }
   },
   "outputs": [],
   "source": [
    "import sys\n",
    "\n",
    "sys.path.insert(1, \"../../\")\n",
    "import matplotlib.pyplot as plt\n",
    "import numpy as np"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "655b619f-ceb4-4e3e-9b24-97a142eaf9eb",
   "metadata": {},
   "source": [
    "## Individual Functions"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "94ff2f06-cc50-4681-b07f-a35165f8fc88",
   "metadata": {},
   "source": [
    "### Set some common variables to evaluate. Note that the units here are using SI units. Almost all the functions in this suite are arbitrary provided the units are self-consistent. In other words, if T is provided in m/d, then Q must by in m**3/d and so on."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "id": "9bdaa684-3a74-482f-a80d-d5b4e91e6db4",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:02.417630Z",
     "iopub.status.busy": "2025-05-27T20:24:02.417518Z",
     "iopub.status.idle": "2025-05-27T20:24:02.419511Z",
     "shell.execute_reply": "2025-05-27T20:24:02.419281Z"
    }
   },
   "outputs": [],
   "source": [
    "T = 1000  # Transmissivity [m/day]\n",
    "S = 3e-6  # Storativity [unitless]\n",
    "dist = 500  # distance [m]\n",
    "time = np.logspace(0.1, 2.5, 150)  # time [day]\n",
    "Q = 4000  # pumping rate [m**3/day]"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "867e9307-95ac-479a-a8f9-37c11f4e9e36",
   "metadata": {},
   "source": [
    "## Theis Drawdown"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "id": "8569e137-7717-4805-a001-e45d45148a80",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:02.420761Z",
     "iopub.status.busy": "2025-05-27T20:24:02.420686Z",
     "iopub.status.idle": "2025-05-27T20:24:03.000948Z",
     "shell.execute_reply": "2025-05-27T20:24:03.000552Z"
    }
   },
   "outputs": [],
   "source": [
    "from pycap.solutions import theis_drawdown"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "id": "bacdeae3-5cb5-4ec6-918a-961415502472",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.002583Z",
     "iopub.status.busy": "2025-05-27T20:24:03.002431Z",
     "iopub.status.idle": "2025-05-27T20:24:03.004244Z",
     "shell.execute_reply": "2025-05-27T20:24:03.004017Z"
    }
   },
   "outputs": [],
   "source": [
    "s_theis = theis_drawdown(T, S, time, dist, Q)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "id": "ed6967f4-a781-49be-a36a-2f47ae44dd99",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.005419Z",
     "iopub.status.busy": "2025-05-27T20:24:03.005342Z",
     "iopub.status.idle": "2025-05-27T20:24:03.065029Z",
     "shell.execute_reply": "2025-05-27T20:24:03.064796Z"
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Text(0, 0.5, 'drawdown')"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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Jpw+fVr/vFarFV5//XXB19dXkEqlQkJCgpCTkyNixd3n4MGDAoBWP7NmzRIEoXPX4vr168ILL7wguLu7Cw4ODsKUKVOEgoICEc6m63V0ferr64VJkyYJXl5egq2trdCnTx9h1qxZrc69t16ftq4LAGHz5s36Npb8+bnd9bHkz89zzz2n/y7y8vIS7rvvPn34EQTL+9xIBEEQTNffRERERCQ+zgEiIiIii8MARERERBaHAYiIiIgsDgMQERERWRwGICIiIrI4DEBERERkcRiAiIiIyOIwABEREZHFYQAiol4jNTUVEokE1dXVYpdCRGaOK0ETUY81duxYDBw4EKtXrwag27yxqqoKPj4+kEgk4hZHRGbNRuwCiIi6ip2dHXx9fcUug4h6AA6BEVGPNHv2bKSlpSExMRESiQQSiQRbtmwxGALbsmULXF1d8d133yEiIgKOjo544oknoFKpsHXrVgQHB8PNzQ0vvvgiNBqN/r0bGxvxpz/9CQEBAXBycsLw4cORmpoqzokSUbdgDxAR9UiJiYk4f/48+vfvj7/97W8AgNOnT7dqV19fjzVr1iApKQm1tbWYNm0apk2bBldXV+zatQsXL17E448/jnvvvRczZswAAMyZMweXLl1CUlIS/P39kZKSgsmTJyMnJwfh4eEmPU8i6h4MQETUI8nlctjZ2cHR0VE/7HX27NlW7ZqamrB+/Xr07dsXAPDEE0/g3//+N8rKyuDs7IyoqCiMGzcOBw8exIwZM3DhwgVs374dV65cgb+/PwDglVdewZ49e7B582a88847pjtJIuo2DEBE1Ks5Ojrqww8A+Pj4IDg4GM7OzgbHysvLAQAnTpyAIAjo16+fwfuo1Wp4eHiYpmgi6nYMQETUq9na2ho8lkgkbR7TarUAAK1WC2traxw/fhzW1tYG7W4OTUTUszEAEVGPZWdnZzB5uSvExcVBo9GgvLwco0eP7tL3JiLzwbvAiKjHCg4OxtGjR3Hp0iVUVFToe3HuRr9+/fDMM8/g2WefxY4dO5Cfn4/MzEy8++672LVrVxdUTUTmgAGIiHqsV155BdbW1oiKioKXlxcKCgq65H03b96MZ599Fn/84x8RERGBRx55BEePHoVCoeiS9yci8XElaCIiIrI47AEiIiIii8MARERERBaHAYiIiIgsDgMQERERWRwGICIiIrI4DEBERERkcRiAiIiIyOIwABEREZHFYQAiIiIii8MARERERBaHAYiIiIgszv8HpKql8ATBd1IAAAAASUVORK5CYII=",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.plot(time, s_theis)\n",
    "plt.xlabel(\"time\")\n",
    "plt.ylabel(\"drawdown\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "f4554214-3267-41c7-82df-963ed142bf4f",
   "metadata": {},
   "source": [
    "## Ward-Lough 2-Layer Drawdown"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "cf6d45da-de36-4258-a064-99bc35ce1474",
   "metadata": {},
   "source": [
    "### We need a couple more variables (assuming the previously defined variables pertain to the upper aquifer, then the lower aquifer is defined by T2,S2, etc.) and river and aquitard characterstics."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "id": "424354d1-081e-4ecf-86e7-3d1b1481eafd",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.066411Z",
     "iopub.status.busy": "2025-05-27T20:24:03.066326Z",
     "iopub.status.idle": "2025-05-27T20:24:03.068412Z",
     "shell.execute_reply": "2025-05-27T20:24:03.068188Z"
    }
   },
   "outputs": [],
   "source": [
    "T2 = 1400  # Deep aquifer Transmissivity [m/day]\n",
    "S2 = 1e-4  # Deep aquifer Storativity [unitless]\n",
    "width = 10  # stream width [m]\n",
    "streambed_thick = 20  # stream sediment thickness [m]\n",
    "streambed_K = 250  # streambed hydraulic conductivity\n",
    "aquitard_thick = 1  # aquitard thickness [m]\n",
    "aquitard_K = 50  # aquitard hydraulic conductivity\n",
    "x = 20  # x-location at which to calculate drawdown\n",
    "# (x=0 is at the stream)\n",
    "y = 5  # x-location at which to calculate drawdown\n",
    "# (y=0 is the along-stream location of the pumping well)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "id": "dc80916d-3498-4156-97bf-2d570d0d8e81",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.069599Z",
     "iopub.status.busy": "2025-05-27T20:24:03.069525Z",
     "iopub.status.idle": "2025-05-27T20:24:03.071047Z",
     "shell.execute_reply": "2025-05-27T20:24:03.070816Z"
    }
   },
   "outputs": [],
   "source": [
    "from pycap.solutions import ward_lough_drawdown"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "id": "2ed9b694-c630-4dbd-8136-b2bbe9c821ed",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.072136Z",
     "iopub.status.busy": "2025-05-27T20:24:03.072058Z",
     "iopub.status.idle": "2025-05-27T20:24:03.515487Z",
     "shell.execute_reply": "2025-05-27T20:24:03.515134Z"
    }
   },
   "outputs": [],
   "source": [
    "s_wl = ward_lough_drawdown(\n",
    "    T,\n",
    "    S,\n",
    "    time,\n",
    "    dist,\n",
    "    Q,\n",
    "    width=width,\n",
    "    T2=T2,\n",
    "    S2=S2,\n",
    "    streambed_thick=streambed_thick,\n",
    "    streambed_K=streambed_K,\n",
    "    aquitard_thick=aquitard_thick,\n",
    "    aquitard_K=aquitard_K,\n",
    "    x=x,\n",
    "    y=y,\n",
    ")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "id": "2c67fba7-ad30-46dc-a43f-ef104347e7d3",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.516920Z",
     "iopub.status.busy": "2025-05-27T20:24:03.516833Z",
     "iopub.status.idle": "2025-05-27T20:24:03.649310Z",
     "shell.execute_reply": "2025-05-27T20:24:03.649060Z"
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Text(0, 0.5, 'drawdown')"
      ]
     },
     "execution_count": 9,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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sVrh+Kwb1W0oIiJid05NtJYsWcKUKVN4+umniY+PJyYmhsGDB5OYmFhi/YSEBIYMGUJMTAzx8fE89dRTTJ48maVLlxare+TIER599FFiYmKKvZadnU2HDh2YN2/eFeO76aabSEpKsj1WrlxZ5PWxY8eyb98+vvrqK3bs2MGoUaMYPXo08fHxZXgXnCcp/Tw7jqdjMsGAqLrODkdERKTacWqi9corrzBhwgT++te/0qpVK+bOnUtERARvvvlmifUXLFhAw4YNmTt3Lq1ateKvf/0rf/nLX5g9e3aRemazmXvuuYfnnnuOJk2aFDvP4MGDeeGFFxg1atQV4/P09KRevXq2R506dYq8vmnTJh5++GG6detGkyZNeOaZZwgMDOS3334r4zvhHN/vMboNO0UEEuLn6eRoREREqh+nJVp5eXls3bqVgQMHFikfOHAgGzduLPGYTZs2Fas/aNAgtmzZQn5+vq1s5syZhISEMGHChGuKMTY2lrp169KiRQsmTpxISkpKkdf79OnDkiVLSEtLw2KxsHjxYnJzc+nfv/9lz5mbm0tGRkaRh7PYpnVorW5DERERR3BaopWamorZbCY0tOiXfGhoKMnJySUek5ycXGL9goICUlONBZE3bNjAokWLWLhw4TXFN3jwYD7++GN++OEH5syZw6+//sp1111Hbm6urc6SJUsoKCggKCgIT09PHnjgAZYtW0bTpk0ve95Zs2YREBBge0REXHlpHEfJzi1g48HTgMZniYiIOIrT7zr887p6Vqv1imvtlVS/sDwzM5MxY8awcOFCgoOvbaqC0aNH2/bbtm1Lly5daNSoEd98842ty/GZZ57hzJkzfPfddwQHB7N8+XJuv/124uLiaNeuXYnnnT59OtOmTbM9z8jIcEqyFXfgFHlmC42CvGmmRaRFREQcwmmJVnBwMK6ursVar1JSUoq1WhWqV69eifXd3NwICgpi165dHD58mKFDh9pet1gsALi5ubFv374rtjZdSVhYGI0aNeLAgQMAHDp0iHnz5rFz507atGkDQIcOHYiLi+ONN9647N2Qnp6eeHo6fzzU2gvTOtzQKlSLSIuIiDiI07oOPTw8iI6OZu3atUXK165dS69eJS8Z07Nnz2L116xZQ5cuXXB3dycqKoodO3awbds222PYsGEMGDCAbdu2XVPL0enTpzl69ChhYWEAnDt3DgAXl6Jvoaurqy25q6zMFis/7NVs8CIiIo7m1K7DadOmMXbsWLp06ULPnj15++23SUxMZNKkSYDRzXb8+HE++OADACZNmsS8efOYNm0aEydOZNOmTSxatIhPPvkEAC8vL9q2bVvkGoGBgQBFyrOysjh48KDteUJCAtu2baNOnTo0bNiQrKws/vnPf3LrrbcSFhbG4cOHeeqppwgODmbkyJEAREVF0axZMx544AFmz55NUFAQy5cvZ+3atXz99dcOe8/s4bfEM5w5l09ALXe6Nq7t7HBERESqLacmWqNHj+b06dPMnDmTpKQk2rZty8qVK2nUqBEASUlJRebUioyMZOXKlUydOpU33niD8PBwXn/9dW699dYyXXfLli0MGDDA9rxwzNR9993He++9h6urKzt27OCDDz7g7NmzhIWFMWDAAJYsWYKfnx8A7u7urFy5kieffJKhQ4eSlZVFs2bNeP/99xkyZMi1vjUOVbi24XVRdXFzdfqctSIiItWWyVo4mlycIiMjg4CAANLT0/H396+Qa143J5Y/TmXzxt2dubl9WIVcU0REpDop7fe3mjNqmEOnsvjjVDburib6ttAi0iIiIo6kRKuG+f7CJKU9mgTh5+Xu5GhERESqNyVaNcy6vacAY3yWiIiIOJYSrRokK7eALUfSAOjfUomWiIiIoynRqkE2Hkwl32ylUZA3kcE+zg5HRESk2lOiVYOs3290G/ZrEeLkSERERGoGJVo1hNVqJXafkWj1b6lES0REpCIo0aohDp3K5vjZ83i4utCjSZCzwxEREakRlGjVELH7jEWkuzepg7eHUxcEEBERqTGUaNUQGp8lIiJS8ZRo1QDn88xsTiic1kGJloiISEVRolUD/PzHafIKLNQPrEXTEF9nhyMiIlJjKNGqAQrHZ/VrGYLJZHJyNCIiIjWHEq0aQOOzREREnEOJVjV3ODWbw6fP4eZionezYGeHIyIiUqMo0armCluzujSuja+npnUQERGpSEq0qrnCREuLSIuIiFQ8JVrVWE6+mY2HUgGNzxIREXEGJVrV2K+H08jJtxDq70lUPT9nhyMiIlLjKNGqxgoXke7XQtM6iIiIOIMSrWrs4rQOGp8lIiLiDEq0qqljZ85xMCULVxcTfZprWgcRERFnUKJVTRW2ZnWKCCSglruToxEREamZlGhVU4Xjs7SItIiIiPNo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Y8eObNmyhdWrV3Py5EnuuOMOO70jImJPJqsGDIhIDdK/f386duzI3LlzOXDgAC1atGDDhg306tULgNOnTxMREcH777/P7bffzp133klWVhZff/217Rxjxozh66+/5uzZsyVe43JjtMaNG8fZs2dZvny5LRaz2UxcXBwAZrOZgIAARo0axQcffABAcnIyYWFhbNq0iR49evDss8+yefNmvv32W9t5jx07RkREBPv27aNFixZ2fLdE5FqpRUtEaqw9e/bg5uZG9+7dbWVBQUG0bNmSPXv2ALBv3z66detW5Lg/P78W7du3t+27uroSFBREu3btbGWhoaEApKSkALB161bWrVuHr6+v7REVFQXAoUOH7BaXiNiHBsOLSI11uQZ9q9WKyWQqtn+148rD3d29yHOTyVSkrPDaFovFth06dCj//ve/i50rLCzMbnGJiH0o0RKRGqt169YUFBSwefPmIl2H+/fvp1WrVgBERUXZxlwV2rJlyxXP6+HhARhdgfbWuXNnli5dSuPGjXFz059wkcpOXYciUmM1b96c4cOHM3HiRH766Se2b9/OmDFjqF+/PsOHDwfg4YcfZuXKlbzyyiscOHCAt956i1WrVhVr5bpU3bp1qVWrlm2genp6ut1ifvDBB0lLS+Ouu+7il19+4Y8//mDNmjX85S9/cUhiJyLXRomWiNRo7777LtHR0dxyyy307NkTq9XKypUrbd13vXv3ZsGCBbzyyit06NCB1atXM3XqVLy8vC57Tjc3N15//XXeeustwsPDbUmbPYSHh7NhwwbMZjODBg2ibdu2PPLIIwQEBODioj/pIpWN7joUESmjiRMnsnfvXtvdgiIil6MOfhGRq5g9ezY33ngjPj4+rFq1ivfff5/58+c7OywRqQLUoiUichV33HEHsbGxZGZm0qRJEx5++GEmTZrk7LBEpApQoiUiIiLiIBo5KSIiIuIgSrREREREHESJloiIiIiDKNESERERcRAlWiIiIiIOokRLRERExEGUaImIiIg4iBItEREREQdRoiUiIiLiIP8P+ry3cj9Zfk4AAAAASUVORK5CYII=",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.plot(time, s_wl[:, 0], label=\"shallow s\")\n",
    "plt.plot(time, s_wl[:, 1], label=\"deep s\")\n",
    "plt.legend()\n",
    "plt.xscale(\"log\")\n",
    "plt.xlabel(\"log time\")\n",
    "plt.ylabel(\"drawdown\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "02aa1861-cad2-45aa-bf53-0f99be56afd6",
   "metadata": {},
   "source": [
    "## Walton Depletion\n",
    "\n",
    "### Note that this function must use Imperial units of feet for length and days for time."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "id": "0271b736-7fb1-4d9f-b602-980d7c7e044b",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.650657Z",
     "iopub.status.busy": "2025-05-27T20:24:03.650578Z",
     "iopub.status.idle": "2025-05-27T20:24:03.652296Z",
     "shell.execute_reply": "2025-05-27T20:24:03.652096Z"
    }
   },
   "outputs": [],
   "source": [
    "from pycap.solutions import walton_depletion"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "id": "d5ad810e-d069-402f-a73f-26327c761dfe",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.653469Z",
     "iopub.status.busy": "2025-05-27T20:24:03.653398Z",
     "iopub.status.idle": "2025-05-27T20:24:03.655120Z",
     "shell.execute_reply": "2025-05-27T20:24:03.654921Z"
    }
   },
   "outputs": [],
   "source": [
    "qd = walton_depletion(T * 0.3048, S, time, dist, Q * (0.3048**3))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "id": "c5ffd493-43f6-41e7-94d3-a8feb9943d0e",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.656201Z",
     "iopub.status.busy": "2025-05-27T20:24:03.656127Z",
     "iopub.status.idle": "2025-05-27T20:24:03.701841Z",
     "shell.execute_reply": "2025-05-27T20:24:03.701583Z"
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Text(0, 0.5, 'depletion')"
      ]
     },
     "execution_count": 12,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.plot(time, qd)\n",
    "plt.xlabel(\"time\")\n",
    "plt.ylabel(\"depletion\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "01f8a6b2-ea2c-4ffa-a92a-afff39dfcea4",
   "metadata": {},
   "source": [
    "## Glover Depletion"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "id": "67ab47d2-7407-4af4-b323-9ea3687d3b29",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.703136Z",
     "iopub.status.busy": "2025-05-27T20:24:03.703054Z",
     "iopub.status.idle": "2025-05-27T20:24:03.704793Z",
     "shell.execute_reply": "2025-05-27T20:24:03.704582Z"
    }
   },
   "outputs": [],
   "source": [
    "from pycap.solutions import glover_depletion"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "id": "99d37a27-729e-4829-81b5-4c3ffabb2bf0",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.705883Z",
     "iopub.status.busy": "2025-05-27T20:24:03.705808Z",
     "iopub.status.idle": "2025-05-27T20:24:03.707495Z",
     "shell.execute_reply": "2025-05-27T20:24:03.707277Z"
    }
   },
   "outputs": [],
   "source": [
    "qd = glover_depletion(T, S, time, dist, Q)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "id": "e613c576-e726-42f1-9a95-bc1c3b47f898",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.708623Z",
     "iopub.status.busy": "2025-05-27T20:24:03.708552Z",
     "iopub.status.idle": "2025-05-27T20:24:03.748948Z",
     "shell.execute_reply": "2025-05-27T20:24:03.748742Z"
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Text(0, 0.5, 'depletion')"
      ]
     },
     "execution_count": 15,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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P1+0byL92Ln11luD56Lk5GTjG9/4RjAMGUZkHTcWwzCM0LVHAQAAhB/GEAEAgIhHIAIAABGPQAQAACIegQgAAEQ8AhEAAIh4BCIAABDxCEQAACDiEYgAAEDEIxAB6LGKiopksVhUU1NjdikAwhx3qgbQY1x33XW64oor9Mwzz0jyP4jy+PHjSk1NlcViMbc4AGEt2uwCAKCr2O12paWlmV0GgG6ALjMAPcLs2bO1evVqLVy4UBaLRRaLRS+++GKbLrMXX3xRiYmJeuONN5Sdna24uDh95zvfUX19vZYtW6aBAweqd+/euueee+T1eoPrbmpq0o9+9CP169dP8fHxGj16tIqKiszZUABdghYiAD3CwoULtWvXLl122WX6z//8T0nS1q1bz1iuoaFBv/nNb1RQUKC6ujrNmDFDM2bMUGJiot58803t2bNH3/72t/XVr35VN954oyTplltu0b59+1RQUKCMjAytXLlSkyZNUllZmS6++OKQbieArkEgAtAjuFwu2e12xcXFBbvJduzYccZyzc3NWrx4sQYPHixJ+s53vqM///nPqqqqUkJCgnJycvT1r39d7733nm688Ubt3r1bL730kg4ePKiMjAxJ0kMPPaTCwkK98MIL+q//+q/QbSSALkMgAhBR4uLigmFIklJTUzVw4EAlJCS0mXb48GFJ0qZNm2QYhi655JI26/F4POrTp09oigbQ5QhEACKKzWZr891isZx1ms/nkyT5fD5ZrVZt3LhRVqu1zXKnhygA3RuBCECPYbfb2wyG7gwjR46U1+vV4cOHdc0113TqugGED64yA9BjDBw4UOvWrdO+fft09OjRYCvPhbjkkkv0ve99TzNnztRrr72mvXv3asOGDXriiSf05ptvdkLVAMIBgQhAj/HQQw/JarUqJydHycnJ2r9/f6es94UXXtDMmTP14IMPKjs7W1OnTtW6deuUmZnZKesHYD7uVA0AACIeLUQAACDiEYgAAEDEIxABAICIRyACAAARj0AEAAAiHoEIAABEPAIRAACIeAQiAAAQ8QhEAAAg4hGIAABAxCMQAQCAiPf/A1W3zMsgUtGtAAAAAElFTkSuQmCC",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.plot(time, qd)\n",
    "plt.xlabel(\"time\")\n",
    "plt.ylabel(\"depletion\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "1556515a-30e8-4d43-967c-cb06f457f5ba",
   "metadata": {},
   "source": [
    "## Ward-Lough 2-Layer Depletion"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "id": "f74a2766-8a67-42c7-a29c-1739c3629c3e",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.750188Z",
     "iopub.status.busy": "2025-05-27T20:24:03.750102Z",
     "iopub.status.idle": "2025-05-27T20:24:03.751705Z",
     "shell.execute_reply": "2025-05-27T20:24:03.751489Z"
    }
   },
   "outputs": [],
   "source": [
    "from pycap.solutions import ward_lough_depletion"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "id": "a65d20d2-b57d-41db-807e-701919b83e02",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.752829Z",
     "iopub.status.busy": "2025-05-27T20:24:03.752756Z",
     "iopub.status.idle": "2025-05-27T20:24:03.754912Z",
     "shell.execute_reply": "2025-05-27T20:24:03.754699Z"
    }
   },
   "outputs": [],
   "source": [
    "qd_wl = ward_lough_depletion(\n",
    "    T,\n",
    "    S,\n",
    "    time,\n",
    "    dist,\n",
    "    Q,\n",
    "    T2=T2,\n",
    "    S2=S2,\n",
    "    width=width,\n",
    "    streambed_thick=streambed_thick,\n",
    "    streambed_K=streambed_K,\n",
    "    aquitard_thick=aquitard_thick,\n",
    "    aquitard_K=aquitard_K,\n",
    "    x=0,\n",
    "    y=5,\n",
    ")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "id": "c437d7fc-915f-46d6-8f91-6517d5b4fd25",
   "metadata": {
    "execution": {
     "iopub.execute_input": "2025-05-27T20:24:03.755986Z",
     "iopub.status.busy": "2025-05-27T20:24:03.755913Z",
     "iopub.status.idle": "2025-05-27T20:24:03.800357Z",
     "shell.execute_reply": "2025-05-27T20:24:03.800115Z"
    }
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Text(0, 0.5, 'depletion')"
      ]
     },
     "execution_count": 18,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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khIDkcRsNgGCvYOIV5kRERFJhEdgiXX0DgHsISIiIpIKA5HEOsYPAYCCPURERESS4BFYYh2P7QA4qJqIiEgqDEQS63hsB8BHdxAREUmFgUhi1sse7CqTMRARERFJgYFIYhY+6Z6IiEhyDEQSE590z0BEREQkGQYiibWxh4iIiEhyDEQS67jsns8xIyIikg6PwhJra78xI3uIiIiIpMNAJLGOq8w8GYiIiIgkw0AksY5A5MFAREREJBlJA1FmZibi4uKgVquhVquh0+mwbds2cX5jYyOeeeYZREREwNvbG6NHj0ZmZqY4v76+HkuWLEFsbCx8fHwQFRWFZ599FgaDwWE7MTExkMlkDq8XXnjBaft5LTaBg6qJiIik5inlxiMiIrBu3TqMGDECALB582YkJyejtLQUY8aMwbJly7Bjxw589NFHiImJwddff42nn34a4eHhSE5ORlVVFaqqqrB+/XpotVqcPHkSixcvRlVVFT777DOHbb388stITU0VP/v5+Tl1X7vScaNqOW/KSEREJBlJA9EDDzzg8Dk9PR2ZmZkoLCzEmDFjsGfPHixcuBDTp08HADz11FPIyspCcXExkpOTMXbsWOTk5IjfHz58ONLT0/Gzn/0MbW1t8PS8tHv+/v4IDQ11yn7dCJ4yIyIikp7LjCGyWq3Izs5GU1MTdDodAGDq1KnYunUrzp49C0EQsGPHDhw5cgT33ntvl+sxGAxQq9UOYQgAXn31VQQGBuL2229Heno6zGbzNesxmUwwGo0Or74gnjJjDxEREZFkJO0hAoDy8nLodDq0trbCz88Pubm50Gq1AICNGzciNTUVERER8PT0hIeHBzZt2oSpU6dedV0XLlzAK6+8gp///OcO05cuXYoJEyYgICAA+/btQ1paGiorK7Fp06Yu61q7di3WrFnTezvaBfYQERERSU8mCO1dFBIxm804deoU9Ho9cnJysGnTJhQUFECr1WL9+vV45513sH79ekRHR2Pnzp1IS0tDbm4uEhISHNZjNBqRmJiIgIAAbN26FQqFostt5uTk4KGHHkJdXR0CAwOvuozJZILJZHJYf2RkpNgD1Vt2/HAOj79XhHFDNfhyydWDHhEREfWM0WiERqO57vFb8h4ipVIpDqqOj49HUVERNmzYgDfeeAOrV69Gbm4u7r//fgBAXFwcysrKsH79eodA1NDQgFmz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",
      "text/plain": [
       "<Figure size 640x480 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.plot(time, qd_wl)\n",
    "plt.xlabel(\"time\")\n",
    "plt.ylabel(\"depletion\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "bf4cb858-c670-4894-bb31-8ca06da1a770",
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "pycap",
   "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.11.12"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}