{ "cells": [ { "attachments": {}, "cell_type": "markdown", "id": "a5199387", "metadata": {}, "source": [ "# Fitting and forecasting\n", "\n", "To use `bluebonnet.forecast` in a project:" ] }, { "cell_type": "code", "execution_count": 1, "id": "80627b25", "metadata": { "tags": [] }, "outputs": [], "source": [ "import matplotlib.pyplot as plt\n", "import numpy as np\n", "import pandas as pd\n", "from scipy.integrate import cumulative_trapezoid\n", "from scipy.interpolate import interp1d\n", "\n", "from bluebonnet.flow import (\n", " FlowProperties,\n", " IdealReservoir,\n", " RelPermParams,\n", " SinglePhaseReservoir,\n", ")\n", "from bluebonnet.forecast import ForecasterOnePhase" ] }, { "attachments": {}, "cell_type": "markdown", "id": "fba0e946", "metadata": {}, "source": [ "## Forecasting with an ideal gas" ] }, { "cell_type": "code", "execution_count": 2, "id": "188e7eb8", "metadata": {}, "outputs": [], "source": [ "# Get ideal gas recovery\n", "t_end = 6\n", "nx = 50\n", "pressure_initial = 9000\n", "pressure_bh = 1000\n", "time = np.linspace(0, np.sqrt(t_end), 10_000) ** 2\n", "res_ideal = IdealReservoir(nx, pressure_bh, pressure_initial, None)\n", "res_ideal.simulate(time)\n", "rf_ideal = res_ideal.recovery_factor()\n", "rf_func = interp1d(time, rf_ideal, bounds_error=False, fill_value=(0, rf_ideal[-1]))" ] }, { "cell_type": "code", "execution_count": 3, "id": "70d2bc34", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "" ] }, "execution_count": 3, "metadata": {}, "output_type": "execute_result" }, { "data": { "image/png": "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Hj16+OXazz//PIYPHw4AuPfeezF37lwcP34cnTp1AgD8/e9/x4YNG84rkXnqqaek5+np6Zg1axZWrFiB2bNnIzIyEjExMVAoFA02Jd16662YPn06/vrrLylxWb58OSZNmgRBEJCbm4tly5YhNzcXKSkpAIBZs2Zh9erVWLZsGV588cUmx9+QsElkuPo1ERH5g7/vJ3379pWeJyUlSc0/ztu2b99+Xtf48ssvsXjxYhw/fhw6nQ4WiwVxcXE+nSMxMRHXXnstPv/8c1x++eXIycnBli1b8O677wIADhw4AKvVim7durm8z2g0onXr1ucVf0PCJpHhPDJERM2bWinH93NGB+3ajdW1a1cIgtBgh16ZzN4F1TnpcfRJqU+pVErPBUFwee3YZnNqVZDJZG7JlLdzA8CWLVtw++2349lnn8Xo0aOh0WiwYsUKvPbaa17f483tt9+ORx55BG+++SaWL1+OPn36oE+fPgAAnU4HuVyOXbt2QS53/TxjYmJ8vlZjhU0iwz4yRETNmyAIjW7eCaaEhASMHj0aS5YswSOPPOLWT6aiogKJiYkA7MOXBwwYAAAuHX/PR2JiIvLz86XXWq0WOTk5Xo/fvHkzOnbsiH/961/StlOnTrkco1KpYLWeu3/STTfdhAceeACrV6/G8uXLcdddd0n7BgwYAKvViqKiIqnp6UIIn1FL7CNDRER+smTJElitVgwePBjffPMNsrOzkZmZicWLF2Po0KGIjIzEpZdeipdeegmZmZnYuHGjSz+V8zFy5Eh89tln+PPPP3HgwAFMnjzZrQLirGvXrsjNzcWKFStw/PhxLF68GN99953LMenp6cjJycHevXtRUlICo9Ho8VzR0dEYN24c5s2bh8zMTEyaNEna161bN9x+++2466678O233yInJwfbt2/HggUL8PPPP/vlZ/ckfBIZiOwnQ0REftGpUyfs3r0bV111FR577DH07t0b11xzDdatW4elS5cCAD766CNYLBYMHDgQ06dPx/PPP++Xa8+dOxcjRozA3/72N9x4440YN24cOnfu7PX4sWPHYsaMGZg2bRr69++PzZs3Y968eS7HTJgwAddddx2uuuoqJCYm4osvvvB6vttvvx379u3D5ZdfjrS0NJd9y5Ytw1133YXHHnsM3bt3x7hx47Bjxw634/xJEEP87q7VaqHRaLBx3nBcPn8j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AxMnToTJZEJFRYVLVaawsBDJyck+X8ceOzv7EhERhZJGJzIajQaAvSITGxuLyMhIaZ9KpcKll16K+++//7wDstlsMBqNGDhwIJRKJdatW4cJEyYAALKyspCbm4uhQ4c27eTs7EtERBRSGp3ILFu2DACQnp6OWbNmNakZqb65c+fi+uuvR1paGqqqqrB8+XL8/vvvWLNmDTQaDe69917MnDkTCQkJiIuLw8MPP4yhQ4d6HbF0TlJFhksUEBERhQKf+8g888wzfrt4UVER7rrrLuTn50Oj0aBv375Ys2YNrrnmGgDAokWLIJPJMGHCBBiNRowePRpvv/12k68nsCJDREQUUgSxCQsPff3111i5ciVyc3NhMplc9u3evdtvwfmDVquFRqNBZWUlbIUHceKrJxGV0hM9piwNdmhERETkhfP9Oy4uzutxPg+/Xrx4Me6++24kJSVhz549GDx4MFq3bo0TJ07g+uuvP6+gA40VGSIiotDicyLz9ttv47333sObb74JlUqF2bNnY+3atXjkkUdQWVkZiBj9R+A8MkRERKHE50QmNzdXGmYdGRmJqqoqAMCdd96JL774wr/R+ZmjItOE1jQiIiJqhnxOZJKTk6WZfdPS0rB161YA9jWYmn2CwIoMERFRSPE5kRk5ciR++OEHAMDdd9+NGTNm4JprrsHEiRNx8803+z1A/3JUZJjIEBERhQKfh1+/9957sNUuujh16lS0bt0amzdvxtixY/Hggw/6PUB/qltrqZlXjoiIiKhRfE5kZDIZZLK6Qs5tt92G2267za9BBQyXKCAiIgopjUpk9u/f3+gT9u3bt8nBBBqHXxMREYWWRiUy/fv3hyAI5+zMKwgCrNZmPP0/O/sSERGFlEYlMjk5OYGO44KoG37NRIaIiCgUNCqR6dixY6DjuDAEuf1PJjJEREQhwefOvp9++mmD+++6664mBxNonBCPiIgotPicyDz66KMur81mM6qrq6FSqRAVFdWsExn2kSEiIgotPk+IV15e7vLQ6XTIysrCZZdd1uyXKABHLREREYUUnxMZT7p27YqXXnrJrVrT3AicR4aIiCik+CWRAQCFQoGzZ8/663SB4ajI2JjIEBERhQKf+8g41llyEEUR+fn5eOuttzB8+HC/BRYIUkUGbFoiIiIKBT4nMuPGjXN5LQgCEhMTMXLkSLz22mv+iisw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rRbbtm3jPaMRHElMdnY2fvvtN7Ru3fqCXj9km5ZmzpyJyZMnY9CgQRg8eDBef/116PV63H333cEOrVmbOnUqli9fju+//x6xsbFS+7BGo0FkZGSQo2veYmNj3foSRUdHo3Xr1uxjdA4zZszAsGHD8OKLL+LWW2/F9u3b8d577+G9994LdmjN2pgxY/DCCy8gLS0NvXr1wp49e7Bw4ULcc889wQ6t2dHpdDh27Jj0OicnB3v37kVCQgLS0tIwffp0PP/88+jatSsyMjIwb948pKSkYNy4ccELuplo6LNr164d/v73v2P37t346aefYLVapftGQkICVCpV4AO8IGOjguTNN98U09LSRJVKJQ4ePFjcunVrsENq9gB4fCxbtizYobVIHH7deD/++KPYu3dvUa1Wiz169BDfe++9YIfU7Gm1WvHRRx8V09LSxIiICLFTp07iv/71L9FoNAY7tGZnw4YNHn+3TZ48WRRF+xDsefPmiUlJSaJarRavvvpqMSsrK7hBNxMNfXY5OTle7xsbNmy4IPEJosgpIImIiKhlCsk+MkRERBQemMgQERFRi8VEhoiIiFosJjJERETUYjGRISIiohaLiQwRERG1WExkiIiIqMViIkNEREQtFhMZohA1ZcoUTq9+HtLT0/H6668H9BonT56EIAjYu3dvQK9DFMpCdq0lolAmCEKD+5955hm88cYb4MTdzceUKVNQUVGBVatWSdtSU1ORn5+PNm3aBC8wohaOiQxRC5Sfny89//LLL/H000+7rB4dExODmJiYYITWrJhMpguzaF0TyeVyJCcnBzsMohaNTUtELVBycrL00Gg0EATBZVtMTIxb09KVV16Jhx9+GNOnT0erVq2QlJSE999/X1oVPjY2Fl26dMGvv/7qcq2DBw/i+uuvR0xMDJKSknDnnXeipKSkwfi++eYb9OrVC2q1Gunp6Xjttddc9qenp+PFF1/EPffcg9jYWKSlpZ1zpesrr7wS06ZNw7Rp06DRaNCmTRvMmzfPpeqUnp6Of//737jrrrsQFxeHBx54oFHxFBUVYcyYMYiMjERGRgY+//xzl/2emoAqKiogCAJ+//13aduhQ4fwt7/9DXFxcYiNjcXll1+O48ePY/78+fjkk0/w/fffQxAE6X2ezrtx40YMHjwYarUa7dq1wxNPPAGLxeLyOTzyyCOYPXs2EhISkJycjPnz5zf42RGFMiYyRGHkk08+QZs2bbB9+3Y8/PDD+Oc//4lbbrkFw4YNw+7du3HttdfizjvvRHV1NQD7zXrkyJEYMGAAdu7cidWrV6OwsBC33nqr12vs2rULt956K2677TYcOHAA8+fPx7x58/Dxxx+7HPfaa69h0KBB2LNnDx566CH885//dKkqeYtfoVBg+/bteOONN7Bw4UJ88MEHLsf85z//Qb9+/bBnzx7MmzevUfFMmTIFeXl52LBhA77++mu8/fbbKCoq8umzPXPmDK644gqo1WqsX78eu3btwj333AOLxYJZs2bh1ltvxXXXXYf8/Hzk5+dj2LBhHs9xww034JJLLsG+ffuwdOlSfPjhh3j++efdPofo6Ghs27YNr7zyCp577jmsXbvWp3iJQsYFWWObiAJm2bJlokajcds+efJk8aabbpJejxgxQrzsssuk1xaLRYyOjhbvvPNOaVt+fr4IQNyyZYsoiqL473//W7z22mtdzpuXlycCELOysjzG83//93/iNddc47Lt8ccfFy+66CLpdceOHcU77rhDem2z2cS2bduKS5cu9fpzjhgxQuzZs6dos9mkbXPmzBF79uzpct5x48b5FE9WVpYIQNy+fbu0PzMzUwQgLlq0SBRFUczJyREBiHv27JGOKS8vFwGIGzZsEEVRFOfOnStmZGSIJpPJY/z1/z48nffJJ58Uu3fv7vIzLlmyRIyJiRGtVqv0OTj/PYqiKF5yySXinDlzPF6XKNSxIkMURvr27Ss9l8vlaN26Nfr06SNtS0pKAgCpGrFv3z5s2LBB6nMTExODHj16AACOHz/u8RqZmZkYPny4y7bhw4cjOzsbVqvVYyyOprFzVUEuvfRSl47OQ4cOdTvvoEGDfIonMzMTCoUCAwcOlPb36NED8fHxDcZS3969e3H55ZdDqVT69L76sQ4dOtTlZxw+fDh0Oh1Onz4tbXP+7ACgXbt2PleQiEIFO/sShZH6N1lBEFy2OW6gNpsNAKDT6TBmzBi8/PLLbudq166d32NxXPd8REdHn/c56pPJ7N/5RKf+OGaz2eWYyMhIv1/Xm0B9dkQtESsyROTVxRdfjEOHDiE9PR1dunRxeXhLGHr27IlNmza5bNu0aRO6desGuVx+XvFs27bN5fXWrVvRtWvXBs97rnh69OgBi8WCXbt2SfuzsrJQUVEhvU5MTATgOlqs/twvffv2xZ9//umW4DioVCqXypG3WLds2eKSMG3atAmxsbHo0KFDg+8lCldMZIjIq6lTp6KsrAyTJk3Cjh07cPz4caxZswZ3332315vyY489hnXr1uHf//43jh49ik8++QRvvfUWZs2add7x5ObmYubMmcjKysIXX3yBN998E48++miD7zlXPN27d8d1112HBx98ENu2bcOuXbtw3333uVRYIiMjcemll+Kll15CZmYmNm7ciKeeesrlOtOmTYNWq8Vtt92GnTt3Ijs7G5999pnUgTk9PR379+9HVlYWSkpKPCY8Dz30EPLy8vDwww/jyJEj+P777/HMM89g5syZUlWIiFzxfwYReZWSkoJNmzbBarXi2muvRZ8+fTB9+nTEx8d7vbFefPHFWLlyJVasWIHevXvj6aefxnPPPYcpU6acdzx33XUXampqMHjwYEydOhWPPvqoNMTam8bEs2zZMqSkpGDEiBEYP348HnjgAbRt29blPB999BEsFgsGDhyI6dOnu40kat26NdavXw+dTocRI0Zg4MCBeP/996VmoPvvvx/du3fHoEGDkJiY6FYlAoD27dvjl19+wfbt29GvXz/84x//wL333uuWNBFRHUEUOfUnETV/V155Jfr37x/wZQOIqGVhRYaIiIhaLCYyRERE1GKxaYmIiIhaLFZkiIiIqMViIkNEREQtFhMZIiIiarGYyBAREVGLxUSGiIiIWiwmMkRERNRiMZEhIiKiFouJDBEREbVY/w9rzxJHEfHz1AAAAABJRU5ErkJggg==", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# Create test production to fit to\n", "m_factor = 1e3\n", "fake_tau = 2\n", "time_on_production = np.linspace(1e-2, t_end, 500) * fake_tau\n", "\n", "# Add some randomness to make this interesting\n", "randomness = np.random.default_rng(42).normal(0, 2e-3, size=len(time_on_production)) / np.sqrt(\n", " time_on_production + 0.1\n", ")\n", "fake_rf = rf_func(time_on_production / fake_tau)\n", "fake_rate = m_factor * np.maximum(np.gradient(fake_rf) + randomness, 0)\n", "cum_production = cumulative_trapezoid(fake_rate, time_on_production, initial=0)\n", "\n", "fig, ax = plt.subplots()\n", "ax.plot(time_on_production, fake_rate, color=\"peru\", label=\"Rate\")\n", "ax.plot(time_on_production, cum_production, color=\"steelblue\", label=\"Cumulative\")\n", "ax.set(\n", " xlabel=\"Time on production\",\n", " ylabel=\"Rate or cumulative prod\",\n", " xlim=(0, None),\n", " ylim=(0, None),\n", ")\n", "ax.legend()" ] }, { "attachments": {}, "cell_type": "markdown", "id": "7b3af4f2", "metadata": {}, "source": [ "After that setup, the actual fitting is fairly simple:" ] }, { "cell_type": "code", "execution_count": 4, "id": "71393a45", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "tau_fit=2.84, and should be 2\n" ] } ], "source": [ "# Fit the test production\n", "scaling_curve = ForecasterOnePhase(rf_func)\n", "\n", "scaling_curve.fit(time_on_production, cum_production)\n", "M_fit = scaling_curve.M_\n", "tau_fit = scaling_curve.tau_\n", "print(f\"{tau_fit=:.2f}, and should be {fake_tau}\")" ] }, { "cell_type": "code", "execution_count": 5, "id": "aeb28e72", "metadata": {}, "outputs": [ { "data": { "image/png": "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Lxk7dix+fn58+eWXp3zuZZdd1iCFebpq42M6jAKTyb0FiYiI+KB6BZnx48eTlpZGTEwM48ePr/N5JpMJu93eULV5tA2Hcrnh+PiY9r417VxERMRT1GvWksPhICYmpup+XTdXQ8ySJUsYN24cCQkJmEwmPv/882rnDcPgkUceIT4+nsDAQEaNGsWuXbtceo/GUFbhIDt1H13MBzEwKciIiIi4icvTr99//31KS0trHC8rK+P999936VqFhYX07t2b1157rdbzzz77LC+//DJvvvkmK1asIDg4mNGjR1NSUuJq2Q1qZ3o+g431zget+kFQpFvrERER8VUmwzAMV15gsVhITU2taqE5Lisri5iYmDPuWjKZTHz22WdVXVeGYZCQkMD999/PjBkzAMjNzSU2NpZ3332X66+/vtbrlJaWVgtaeXl5JCYmkpubS1hY2BnV9mvzVhwg7KvbudSyHIbPhAseapDrioiIiFNeXh7h4eGn/f52uUXGMAxMtQxsPXToEOHh4a5erk4pKSmkpaUxatSJac3h4eEMGjSIZcuW1fm6uXPnEh4eXnVLTExssJqO23womyHmLc4H7UY0+PVFRESkfuo9/bpv376YTCZMJhMjR47Eaj3xUrvdTkpKCmPGNNxeQ2lpaQDExsZWOx4bG1t1rjazZs1i+vTpVY+Pt8g0pLz9G4gy5VNhCcTaqn+DXltERETqr95B5niXz/r16xk9ejQhISFV5/z9/UlKSuKqq65q8AJdZbPZsNlsjXb9knI7CdkrwQoVrQdjtfo32nuJiIjIqdU7yMyZMweApKQkrrvuOgICAhqtKIC4uDgA0tPTiY+Przqenp5Onz59GvW9T2V7Wj6DTM5uJVsnzVYSERFxJ5fHyNx8882NHmLAubN2XFwcCxYsqDqWl5fHihUrGDJkSKO/f102HTjKIPM2AEza7VpERMStXN6iwG6388ILL/Dxxx9z4MABysrKqp3Pzs6u97UKCgrYvXt31eOUlBTWr19PZGQkbdq0Ydq0aTz55JN07NiR5ORkZs+eTUJCwikX5WtsObtXEGIqodgaTmBsT7fVISIiImfQIvPYY4/x/PPPc91115Gbm8v06dO58sorMZvNPProoy5da/Xq1fTt25e+ffsCMH36dPr27csjjzwCwB/+8AemTp3KHXfcwYABAygoKODbb79tkhahuoQd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eIKJEycSFhbGHXfcUa96MjIyGDduHIGBgSQnJ/Ovf/2r2vnauoBycnIwmUwsWrSo6tiWLVu49NJLCQsLIzQ0lPPOO489e/bw6KOP8t577/HFF19gMpmqXlfbdRcvXszAgQOx2WzEx8fz4IMPUlFRUe1zuOeee/jDH/5AZGQkcXFxPProo6f87ESaMwUZER/y3nvv0bJlS1auXMnUqVO56667uOaaaxg6dChr167loosu4qabbqKoqAhwfllfeOGF9O3bl9WrV/Ptt9+Snp7OtddeW+d7rFmzhmuvvZbrr7+eTZs28eijjzJ79mzefffdas977rnn6N+/P+vWrePuu+/mrrvuqtaqVFf9VquVlStX8tJLL/H888/zt7/9rdpz/vKXv9C7d2/WrVvH7Nmz61XPpEmTOHjwIAsXLuQ///kPr7/+OhkZGS59tocPH+b888/HZrPx448/smbNGm699VYqKiqYMWMG1157LWPGjCE1NZXU1FSGDh1a6zUuvvhiBgwYwIYNG3jjjTf4+9//zpNPPlnjcwgODmbFihU8++yzPP7448yfP9+lekWajSbZY1tEGs0777xjhIeH1zh+8803G5dffnnV4+HDhxvnnntu1eOKigojODjYuOmmm6qOpaamGoCxbNkywzAM44knnjAuuuiiatc9ePCgARg7duyotZ4bbrjB+M1vflPt2AMPPGB069at6nHbtm2N3/72t1WPHQ6HERMTY7zxxht1/p7Dhw83unbtajgcjqpjM2fONLp27VrtuuPHj3epnh07dhiAsXLlyqrz27ZtMwDjhRdeMAzDMFJSUgzAWLduXdVzjh07ZgDGwoULDcMwjFmzZhnJyclGWVlZrfX/+s+jtus+9NBDRufOnav9jq+99poREhJi2O32qs/h5D9HwzCMAQMGGDNnzqz1fUWaO7XIiPiQXr16Vd23WCxERUXRs2fPqmOxsbEAVa0RGzZsYOHChVVjbkJCQujSpQsAe/bsqfU9tm3bxrBhw6odGzZsGLt27cJut9day/GusdO1ggwePLjaQOchQ4bUuG7//v1dqmfbtm1YrVb69etXdb5Lly5EREScspZfW79+Peeddx5+fn4uve7XtQ4ZMqTa7zhs2DAKCgo4dOhQ1bGTPzuA+Ph4l1uQRJoLDfYV8SG//pI1mUzVjh3/AnU4HAAUFBQwbtw4nnnmmRrXio+Pb/Bajr/v2QgODj7ra/ya2ez8N59x0nic8vLyas8JDAxs8PetS2N9diLeSC0yIlKnc845hy1btpCUlESHDh2q3eoKDF27dmXp0qXVji1dupROnTphsVjOqp4VK1ZUe7x8+XI6dux4yuuerp4uXbpQUVHBmjVrqs7v2LGDnJycqsfR0dFA9dliv177pVevXvz00081As5x/v7+1VqO6qp12bJl1QLT0qVLCQ0NpXXr1qd8rYivUpARkTpNnjyZ7OxsJkyYwKpVq9izZw/fffcdt9xyS51fyvfffz8LFizgiSeeYOfOnbz33nu8+uqrzJgx46zrOXDgANOnT2fHjh188MEHvPLKK9x7772nfM3p6uncuTNjxozhzjvvZMWKFaxZs4bf/e531VpYAgMDGTx4ME8//TTbtm1j8eLFPPzww9XeZ8qUKeTl5XH99dezevVqdu3axT/+8Y+qAcxJSUls3LiRHTt2kJmZWWvgufvuuzl48CBTp05l+/btfPHFF8yZM4fp06dXtQqJSHX6L0NE6pSQkMDSpUux2+1cdNFF9OzZk2nTphEREVHnF+s555zDxx9/zIcffkiPHj145JFHePzxx5k0adJZ1zNx4kSKi4sZOHAgkydP5t57762aYl2X+tTzzjvvkJCQwPDhw7nyyiu54447iImJqXadt99+m4qKCvr168e0adNqzCSKiorixx9/pKCggOHDh9OvXz/eeuutqm6g22+/nc6dO9O/f3+io6NrtBIBtGrVim+++YaVK1fSu3dvfv/733PbbbfVCE0icoLJMLT0p4h4vhEjRtCnT59G3zZARLyLWmRERETEaynIiIiIiNdS15KIiIh4LbXIiIiIiNdSkBERERGvpSAjIiIiXktBRkRERLyWgoyIiIh4LQUZERER8VoKMiIiIuK1FGRERETEa/0/0/9JjZI0+CkAAAAASUVORK5CYII=", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# Forecast cumulative production and compare fit\n", "cum_bestfit = scaling_curve.forecast_cum(time_on_production)\n", "\n", "fig, ax = plt.subplots()\n", "ax.plot(time_on_production, cum_production, label=\"'Real' production\")\n", "ax.plot(time_on_production, cum_bestfit, label=\"Fit\")\n", "ax.legend()\n", "ax.set(\n", " xlim=(0, None),\n", " ylim=(0, None),\n", " xlabel=\"Time on production\",\n", " ylabel=\"Cumulative production\",\n", ");" ] }, { "attachments": {}, "cell_type": "markdown", "id": "216f21a2", "metadata": {}, "source": [ "The forecaster also allows you to fit production with a known value for $\\tau$. This is important when the well has not yet ended transient flow, usually around $t < 0.5\\tau$. Until that point, setting $\\tau$ to any value above a certain point will achieve the same fit but different in-place and ultimate recovery estimates.\n", "\n", "A few example fits:" ] }, { "cell_type": "code", "execution_count": 6, "id": "125210f3", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "tau=2.00, and M_fit=24.05\n", "tau=3.00, and M_fit=29.37\n", "tau=4.00, and M_fit=34.06\n" ] }, { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "from itertools import cycle\n", "\n", "cum_production = cum_production[time_on_production < 1] + 2.1\n", "time_on_production = time_on_production[time_on_production < 1]\n", "\n", "fig, ax = plt.subplots()\n", "\n", "lines = [\"--\", \"-.\", \":\"]\n", "linecycler = cycle(lines)\n", "ax.plot(time_on_production, cum_production, label=\"'Real' production\")\n", "for tau in [2, 3, 4]:\n", " scaling_curve.fit(time_on_production, cum_production, tau=tau)\n", " M_fit = scaling_curve.M_\n", " print(f\"{tau=:.2f}, and {M_fit=:.2f}\")\n", "\n", " # Forecast cumulative production and compare fit\n", " cum_bestfit = scaling_curve.forecast_cum(time_on_production)\n", " ax.plot(time_on_production, cum_bestfit, next(linecycler), label=f\"Fit for {tau=}\")\n", "ax.legend()\n", "ax.set(\n", " xlim=(0, None),\n", " ylim=(0, None),\n", " xlabel=\"Time on production\",\n", " ylabel=\"Cumulative production\",\n", " xscale=\"squareroot\",\n", ");" ] }, { "attachments": {}, "cell_type": "markdown", "id": "71302b2d", "metadata": {}, "source": [ "## Forecasting with a real gas" ] }, { "cell_type": "code", "execution_count": 7, "id": "3b23cd9c", "metadata": {}, "outputs": [], "source": [ "pvt_gas = pd.read_csv(\n", " \"https://raw.githubusercontent.com/frank1010111/bluebonnet/main/tests/data/pvt_gas.csv\"\n", ").rename(\n", " columns={\n", " \"P\": \"pressure\",\n", " \"Z-Factor\": \"z-factor\",\n", " \"Cg\": \"compressibility\",\n", " \"Viscosity\": \"viscosity\",\n", " \"Density\": \"density\",\n", " }\n", ")\n", "t_end = 6\n", "nx = 60\n", "pressure_initial = 12_000\n", "pressure_bh = 1000\n", "real_gas_flow_props = FlowProperties(pvt_gas, p_i=pressure_initial)\n", "time = np.linspace(0, np.sqrt(t_end), 10_000) ** 2\n", "res_real = SinglePhaseReservoir(nx, pressure_bh, pressure_initial, real_gas_flow_props)\n", "res_real.simulate(time)\n", "rf_real = res_real.recovery_factor()" ] }, { "cell_type": "code", "execution_count": 8, "id": "e5094dd8", "metadata": {}, "outputs": [], "source": [ "fake_ogip = 300\n", "fake_tau = 150\n", "time_on_production = time[: len(time) // 2] * fake_tau\n", "randomness = np.maximum(\n", " 0, np.random.default_rng(42).normal(0, 0.02, size=len(time_on_production))\n", ").cumsum()\n", "fake_cum = rf_real[: len(time) // 2] * fake_ogip + randomness" ] }, { "cell_type": "code", "execution_count": 9, "id": "55726dc5", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "The fitted OOIP is 389.75, and it should be over 300 (because all the randomness is positive)\n", "The fitted tau is 175.52, and it should be near 150\n" ] }, { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAAjsAAAGwCAYAAABPSaTdAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjkuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8hTgPZAAAACXBIWXMAAA9hAAAPYQGoP6dpAABlfElEQVR4nO3dd3hUZd7G8e9MGukhkAqBhN5DD5FepIoiqIgodUGRInURX2nqiuKKXdldFbBgF1BUlI5A6L2FYugJPZ20mfP+wTpLDCWBJJNyf65rriunzJl7cpLML895zvOYDMMwEBERESmhzPYOICIiIlKQVOyIiIhIiaZiR0REREo0FTsiIiJSoqnYERERkRJNxY6IiIiUaCp2REREpERztHeAosBqtXL27Fk8PT0xmUz2jiMiIiK5YBgGSUlJBAcHYzbfvP1GxQ5w9uxZQkJC7B1DRERE7sCpU6eoWLHiTber2AE8PT2Ba98sLy8vO6cRERGR3EhMTCQkJMT2OX4zKnbAdunKy8tLxY6IiEgxc7suKOqgLCIiIiWaih0REREp0VTsiIiISImmPju5ZLVaycjIsHcMEQCcnZ1veZuliIj8j4qdXMjIyCAmJgar1WrvKCIAmM1mwsLCcHZ2tncUEZEiT8XObRiGQWxsLA4ODoSEhOi/abG7PwfBjI2NpVKlShoIU0TkNlTs3EZWVhapqakEBwfj5uZm7zgiAPj5+XH27FmysrJwcnKydxwRkSJNzRS3YbFYAHS5QIqUP38e//z5FBGRm1Oxk0u6VCBFiX4eRURyT8WOiIiIlGgqdkRERKREU7Ej+apdu3aMHTvW3jFuqrDymUwmFi9eXOCvIyIit6dip4QaNGgQM2bMsC23a9cOk8mEyWSiTJky1KhRg1mzZmEYRoHmaNeuHfPnzy/Q17CnGTNm0LBhwxzrY2Nj6datW+EHEhGRHFTslCLDhg0jNjaW6OhopkyZwrRp05g7d669Y+VZcRjJOjAwEBcXF3vHEBGxG8OSxYnDu1m656y9o6jYySvDMEjNyLLL425bYdzc3AgMDKRy5coMHjyYBg0asHz5ctv29PR0Jk6cSIUKFXB3dyciIoI1a9bYtl+6dIl+/fpRoUIF3NzcqF+/Pl988cVdZRo0aBC9evVi5syZ+Pn54eXlxVNPPZWtoGnXrh2jRo1i7NixlC9fni5dugCwdu1amjdvjouLC0FBQTz77LNkZWXZnpeSksKAAQPw8PAgKCiI119/Pcfr3+hyk4+PT7bWqNOnT9OvXz98fX1xd3enadOmbN68mfnz5zNz5kx2795tazX783l/Pe7evXvp0KEDrq6ulCtXjuHDh5OcnJzj+/DPf/6ToKAgypUrx8iRI8nMzLyL766ISOG6dOYoOxe/xe45D5D0YmXKfd6ZiV9uIynNvn/LNKhgHl3NtFBn2q92ee0DL3TBzfnuT5lhGKxfv55Dhw5RvXp12/pRo0Zx4MABvvzyS4KDg1m0aBFdu3Zl7969VK9enbS0NJo0acLkyZPx8vLip59+4oknnqBq1ao0b978jvOsXLmSMmXKsGbNGo4fP87gwYMpV64c//jHP2z7LFiwgBEjRrBhwwYAzpw5Q/fu3Rk0aBCffPIJhw4dYtiwYZQpU8Z2+W7SpEmsXbuWJUuW4O/vz3PPPceOHTtueNnpZpKTk2nbti0VKlTghx9+IDAwkB07dmC1Wunbty/79u1j2bJlrFixAgBvb+8cx0hJSaFLly5ERkaydetWzp8/z9/+9jdGjRqVrahavXo1QUFBrF69mqNHj9K3b18aNmzIsGHD8v5NFREpBBeT09l47BKb/7iEV/S3TE57k3LXbU/EjftDrnI5JQPPMvYbAFXFTgl1o34y77//Ph9++CEZGRlkZmZSpkwZxowZA8DJkyeZN28eJ0+eJDg4GICJEyeybNky5s2bx8svv0yFChWYOHGi7XijR4/m119/5euvv75psXN9y9DNODs78/HHH+Pm5kbdunV54YUXmDRpEi+++KJteo7q1asze/Zs23P+7//+j5CQEN59911MJhO1atXi7NmzTJ48mWnTppGamspHH33EZ599RseOHYFrBVPFihVz9f3708KFC7lw4QJbt27F19cXgGrVqtm2e3h44OjoSGBg4C2PkZaWxieffIK7uzsA7777Lj179uTVV18lICAAgLJly/Luu+/i4OBArVq16NGjBytXrlSxIyJFhtViJebgdi7s+gnXE6v5NDWCby1tAQg1hTDB2Uy0Yy0uBbbEq15najVuy+wicElfxU4euTo5cOCFLnZ77bvRv39//u///o8rV64wffp07rnnHu655x7g2mUWi8VCjRo1sj0nPT2dcuWu1ekWi4WXX36Zr7/+mjNnzpCRkUF6evpd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4+XlhY+PD0OHDrUNdChFXNw+rn7QAbeEo8Qavsz0m8O00SMI9nG1dzIRESlB8lzslC9fnlGjRrFhwwaOHTvGww8/zIIFCwgNDaVDhw55OlZKSgrh4eG89957N9w+e/Zs3n77bebOncvmzZtxd3enS5cupKWl2fbp378/+/fvZ/ny5SxdupR169YxfPjwvL4tKWTGiY2k/6cLrukXOGQN4d0qc/nHk33xdnOydzQRESlh7riD8p8sFgu//PILU6dOZc+ePVgsljsLYjKxaNEievXqBVxr1QkODmbChAlMnDgRgISEBAICApg/fz6PPvooBw8epE6dOmzdupWmTZsCsGzZMrp3787p06cJDg6+4Wulp6eTnp5uW05MTCQkJEQdlAtJVtJFst6oTxlrKlutNfi96buMva85ZrPJ3tFERKQYyW0H5Ty37Pxpw4YNPP300wQFBfHYY49Rr149fvrppzs9XA4xMTHExcXRqVMn2zpvb28iIiKIiooCICoqCh8fH1uhA9CpUyfMZjObN2++6bFnzZqFt7e37RESEpJvueXWUtKzGP5dDP+XNoCVlkZE3/sJ4++PUKEjIiIFJs/FzpQpUwgLC6NDhw6cPHmSt956i7i4OD799FO6du2ab8Hi4uIACAgIyLY+ICDAti0uLg5/f/9s2x0dHfH19bXtc7P3kJCQYHucOnUq33LLzV28eJFH/72JVYfOs9TcjsxHvuDx1rXtHUtEREq4PN96vm7dOiZNmsQjjzxC+fLlCyJTgXNxccHFxcXeMUoPw+DK0qlc3fEtsVenUdatPB8ObEaTymXtnUxEREqBPBc7GzZsKIgcOQQGBgJw7tw5goKCbOvPnTtHw4YNbfucP38+2/OysrK4fPmy7fliZ1YL8d+OpuyBzykLPOy1n0eGP0dYeXd7JxMRkVIiV8XODz/8QLdu3XBycuKHH3645b73339/vgQLCwsjMDCQlStX2oqbxMRENm/ezIgRIwCIjIwkPj6e7du306RJEwBWrVqF1WolIiIiX3LIXbBkkvD5IHz+WIrVMPGe+0iGPj2N8h5qVRMRkcKTq2KnV69etv4xf94tdSMmkylPd2MlJydz9OhR23JMTAy7du3C19eXSpUqMXbsWF566SWqV69OWFgYU6dOJTg42Jahdu3adO3alWHDhjF37lwyMzMZNWoUjz766E3vxJJC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Eig2Ntb29VdffcW0adOIjo62rfPw8MDDw8Me0YqUjIwMnJ2d7R3jphwcHAgMDLR3DJFiT5exREqgwMBA28Pb2xuTyZRtnYeHR47LWO3atWP06NGMHTuWsmXLEhAQwH/+8x9SUlIYPHgwnp6eVKtWjV9++SXba+3bt49u3brh4eFBQEAATzzxBBcvXrxlvu+++466devi4uJCaGgor7/+erbtoaGhvPzyywwZMgRPT08qVarEv//971ses127dowaNYpRo0bh7e1N+fLlmTp1arbWq9DQUF588UUGDBiAl5cXw4cPz1We8+fP07NnT1xdXQkLC+Pzzz/Ptv1Gl5vi4+MxmUysWbPGtm7//v3cd999eHl54enpSevWrTl27BgzZsxgwYIFLFmyBJPJZHvejY67du1amjdvjouLC0FBQTz77LNkZWVl+z6MGTOGv//97/j6+hIYGMiMGTNu+b0TKelU7IiIzYIFCyhfvjxbtmxh9OjRjBgxgocffph77rmHHTt20LlzZ5544glSU1OBax/oHTp0oFGjRmzbto1ly5Zx7tw5HnnkkZu+xvbt23nkkUd49NFH2bt3LzNmzGDq1KnMnz8/236vv/46TZs2ZefOnTz99NOMGDEiW+vUzfI7OjqyZcsW3nrrLebMmcOHH36YbZ9//vOfhIeHs3PnTqZOnZqrPIMGDeLUqVOsXr2ab7/9lvfff5/z58/n6Xt75swZ2rRpg4uLC6tWrWL79u0MGTKErKwsJk6cyCOPPELXrl2JjY0lNjaWe+6554bH6N69O82aNWP37t188MEHfPTRR7z00ks5vg/u7u5s3ryZ2bNn88ILL7B8+fI85RUpUew76bqIFLR58+YZ3t7eOdYPHDjQeOCBB2zLbdu2NVq1amVbzsrKMtzd3Y0nnnjCti42NtYAjKioKMMwDOPFF180OnfunO24p06dMgAjOjr6hnkee+wx49577822btKkSUadOnVsy5UrVzYef/xx27LVajX8/f2NDz744Kbvs23btkbt2rUNq9VqWzd58mSjdu3a2Y7bq1evPOWJjo42AGPLli227QcPHjQA44033jAMwzBiYmIMwNi5c6dtnytXrhiAsXr1asMwDGPKlClGWFiYkZGRccP8fz0fNzruc889Z9SsWTPbe3zvvfcMDw8Pw2Kx2L4P159HwzCMZs2aGZMnT77h64qUBmrZERGbBg0a2L52cHCgXLly1K9f37YuICAAwNaqsXv3blavXm3rA+Th4UGtWrUAOHbs2A1f4+DBg7Rs2TLbupYtW3LkyBEsFssNs/x5Ge52rSktWrTI1jk7MjIyx3GbNm2apzwHDx7E0dGRJk2a2LbXqlULHx+fW2b5q127dtG6dWucnJzy9Ly/Zo2MjMz2Hlu2bElycjKnT5+2rbv+ewcQFBSU55YokZJEHZRFxOavH8Qmkynbuj8/ZK1WKwDJycn07NmTV199NcexgoKC8j3Ln697N9zd3e/6GH9lNl/7v9G4rn9QZmZmtn1cXV3z/XVvpqC+dyLFlVp2ROSONW7cmP379xMaGkq1atWyPW5WVNSuXZsNGzZkW7dhwwZq1KiBg4PDXeXZvHlztuVNmzZRvXr1Wx73dnlq1apFVlYW27dvt22Pjo4mPj7etuzn5wdkvwvur2PjNGjQgN9//z1HEfQnZ2fnbC1QN8saFRWVrajasGEDnp6eVKxY8ZbPFSnNVOyIyB0bOXIkly9fpl+/fmzdupVjx47x66+/Mnjw4Jt+cE+YMIGVK1fy4osvcvjwYRYsWMC7777LxIkT7zrPyZMnGT9+PNHR0XzxxRe88847PPPMM7d8zu3y1KxZk65du/Lkk0+yefNmtm/fzt/+9rdsLTWurq60aNGCV155hYMHD7J27Vqef/75bK8zatQoEhMTefTRR9m2bRtHjhzh008/tXW6Dg0NZc+ePURHR3Px4sUbFkVPP/00p06dYvTo0Rw6dIglS5Ywffp0xo8fb2tdEpGc9NshIncsODiYDRs2YLFY6Ny5M/Xr12fs2LH4+Pjc9MO3cePGfP3113z55ZfUq1ePadOm8cILLzBo0KC7zjNgwACuXr1K8+bNGTlyJM8884zt9vKbyU2eefPmERwcTNu2benduzfDhw/H398/23E+/vhjsrKyaNKkCWPHjs1xh1S5cuVYtWoVycnJtG3bliZNmvCf//zHdslp2LBh1KxZk6ZNm+Ln55ejtQmgQoUK/Pzzz2zZsoXw8HCeeuophg4dmqOwEpHsTIahIVRFpPhr164dDRs2LPApHESk+FHLjoiIiJRoKnZERESkRNNlLBERESnR1LIjIiIiJZqKHRERESnRVOyIiIhIiaZiR0REREo0FTsiIiJSoqnYERERkRJNxY6IiIiUaCp2REREpET7f7z0cpBgRW4/AAAAAElFTkSuQmCC", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "rf_func = interp1d(time, rf_real, bounds_error=False, fill_value=(0, rf_real[-1]))\n", "scaling_curve = ForecasterOnePhase(rf_func)\n", "scaling_curve.fit(time_on_production, fake_cum)\n", "print(\n", " f\"The fitted OOIP is {scaling_curve.M_:.2f}, and it should be over {fake_ogip} \"\n", " \"(because all the randomness is positive)\\n\"\n", " f\"The fitted tau is {scaling_curve.tau_:.2f}, and it should be near {fake_tau}\"\n", ")\n", "\n", "cum_bestfit = scaling_curve.forecast_cum(time_on_production)\n", "\n", "fig, ax = plt.subplots()\n", "ax.plot(time_on_production, fake_cum, label=\"'Real' production\")\n", "ax.plot(time_on_production, cum_bestfit, \"--\", label=\"Fit\")\n", "ax.legend()\n", "ax.set(\n", " xlim=(0, None),\n", " ylim=(0, None),\n", " xlabel=\"Time on production\",\n", " ylabel=\"Cumulative production\",\n", ");" ] }, { "attachments": {}, "cell_type": "markdown", "id": "bd782067", "metadata": {}, "source": [ "## Forecasting oil\n", "\n", "Oil wells tend to be producing three phases at a time. Let's say that the water phase is constant, and we can just worry about matching hydrocarbon production. These wells are almost all producing at below the bubble point, so a two-phase model is most appropriate." ] }, { "cell_type": "code", "execution_count": 10, "id": "dd34129b", "metadata": {}, "outputs": [], "source": [ "from bluebonnet.flow import (\n", " FlowPropertiesTwoPhase,\n", " relative_permeabilities,\n", ")\n", "\n", "# set conditions\n", "Sw = 0.1\n", "p_frac = 1000\n", "p_res = 6_000\n", "phi = 0.1\n", "\n", "df_pvt_mp = pd.read_csv(\"../tests/data/pvt_multiphase_oil.csv\")\n", "relperm_params = RelPermParams(\n", " n_o=1, n_g=1, n_w=1, S_or=0, S_gc=0, S_wc=0.1, k_ro_max=1, k_rw_max=1, k_rg_max=1\n", ")\n", "saturations_test = pd.DataFrame(\n", " {\"So\": np.linspace(0, 0.9), \"Sw\": np.full(50, 0.1), \"Sg\": np.linspace(0.9, 0)}\n", ")\n", "kr_matrix = pd.DataFrame(\n", " relative_permeabilities(saturations_test.to_records(index=False), relperm_params)\n", ")\n", "df_kr = pd.concat([saturations_test, kr_matrix], axis=1)\n", "reference_densities = {\"rho_o0\": 141.5 / (45 + 131.5), \"rho_g0\": 1.03e-3, \"rho_w0\": 1}\n", "flow_props = FlowPropertiesTwoPhase.from_table(\n", " df_pvt_mp, df_kr, reference_densities, phi, Sw, p_res\n", ")\n", "\n", "# get recovery factor curve\n", "res = SinglePhaseReservoir(50, p_frac, p_res, flow_props)\n", "res.simulate(time)\n", "rf_twophase = res.recovery_factor()" ] }, { "attachments": {}, "cell_type": "markdown", "id": "f8738b71", "metadata": {}, "source": [ "At this point, you have a recovery factor curve and can proceed just like real gas or ideal gas" ] }, { "cell_type": "code", "execution_count": 11, "id": "2c1e38b4", "metadata": {}, "outputs": [], "source": [ "fake_ooip = 700\n", "fake_tau = 200\n", "time_on_production = time[: round(len(time) / 1.5)] * fake_tau\n", "randomness = np.maximum(\n", " 0, np.random.default_rng(42).normal(0, 0.02, size=len(time_on_production))\n", ").cumsum()\n", "fake_cum = rf_twophase[: round(len(time) / 1.5)] * fake_ooip + randomness" ] }, { "cell_type": "code", "execution_count": 12, "id": "d473a1ed", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "The fitted OOIP is 751.99, and it should be over 700 (because all the randomness is positive)\n", "The fitted tau is 217.50, and it should be near 200\n" ] }, { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "rf_func = interp1d(time, rf_twophase, bounds_error=False, fill_value=(0, rf_twophase[-1]))\n", "scaling_curve = ForecasterOnePhase(rf_func)\n", "scaling_curve.fit(time_on_production, fake_cum)\n", "print(\n", " f\"The fitted OOIP is {scaling_curve.M_:.2f}, and it should be over {fake_ooip} \"\n", " \"(because all the randomness is positive)\\n\"\n", " f\"The fitted tau is {scaling_curve.tau_:.2f}, and it should be near {fake_tau}\"\n", ")\n", "\n", "cum_bestfit = scaling_curve.forecast_cum(time_on_production)\n", "\n", "fig, ax = plt.subplots()\n", "ax.plot(time_on_production, fake_cum, label=\"'Real' production\")\n", "ax.plot(time_on_production, cum_bestfit, \"--\", label=\"Fit\")\n", "ax.legend()\n", "ax.set(\n", " xlim=(0, None),\n", " ylim=(0, None),\n", " xlabel=\"Time on production\",\n", " ylabel=\"Cumulative production\",\n", ");" ] } ], "metadata": { "kernelspec": { "display_name": "bluebonnet", "language": "python", "name": "bluebonnet" }, "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.3" } }, "nbformat": 4, "nbformat_minor": 5 }