{ "cells": [ { "attachments": {}, "cell_type": "markdown", "id": "8414ba1c-c56d-46e3-a099-d00044905eda", "metadata": {}, "source": [ "# Parallelized Cubic Spline Interpolation" ] }, { "cell_type": "markdown", "id": "8f1b4641", "metadata": {}, "source": [ "We recommend first working through Trajectory_tutorial.ipynb and Amplitude_tutorial.ipynb before reading this tutorial." ] }, { "attachments": {}, "cell_type": "markdown", "id": "1cf56b82-e6a1-405c-ba54-9a31decb1f64", "metadata": {}, "source": [ "A part of the Fast EMRI waveforms package is parallelized cubic spline interpolation. This generally means fitting and evaluating many splines in parallel with the same input x array. This is available for GPUs and CPUs (not parallelized for CPU). The user can perform this operation entirely in Python while leveraging [CuPy](https://cupy.dev/) for GPUs. However, the evaluation will not be as efficient as when it is implemented properly in a customized kernel. The spline class ([CubicSplineInterpolant](https://bhptoolkit.org/FastEMRIWaveforms/user/sum.html#few.summation.interpolatedmodesum.CubicSplineInterpolant)) can provide an 1D flattened array of all spline coefficients for use in a custom CUDA kernel. " ] }, { "cell_type": "code", "execution_count": 1, "id": "3c526d1a", "metadata": { "execution": { "iopub.execute_input": "2026-07-07T15:30:41.896361Z", "iopub.status.busy": "2026-07-07T15:30:41.896138Z", "iopub.status.idle": "2026-07-07T15:30:44.874835Z", "shell.execute_reply": "2026-07-07T15:30:44.874287Z" } }, "outputs": [ { "data": { "text/plain": [ "" ] }, "execution_count": 1, "metadata": {}, "output_type": "execute_result" } ], "source": [ "import numpy as np\n", "import matplotlib.pyplot as plt\n", "\n", "import few\n", "\n", "# tune few configuration\n", "cfg_set = few.get_config_setter(reset=True)\n", "\n", "# Uncomment if you want to force CPU or GPU usage\n", "# Leave commented to let FEW automatically select the best available hardware\n", "# - To force CPU usage:\n", "# cfg_set.enable_backends(\"cpu\")\n", "# - To force GPU usage with CUDA 12.x\n", "# cfg_set.enable_backends(\"cuda12x\", \"cpu\")\n", "\n", "cfg_set.set_log_level(\"info\")" ] }, { "cell_type": "code", "execution_count": 2, "id": "19ba8ad4", "metadata": { "execution": { "iopub.execute_input": "2026-07-07T15:30:44.876267Z", "iopub.status.busy": "2026-07-07T15:30:44.876102Z", "iopub.status.idle": "2026-07-07T15:30:47.425101Z", "shell.execute_reply": "2026-07-07T15:30:47.424468Z" } }, "outputs": [], "source": [ "from few.trajectory.inspiral import EMRIInspiral\n", "from few.trajectory.ode import SchwarzEccFlux\n", "from few.amplitude.romannet import RomanAmplitude\n", "\n", "traj = EMRIInspiral(func=SchwarzEccFlux)\n", "amp = RomanAmplitude()\n", "\n", "# parameters\n", "m1 = 1e5\n", "m2 = 1e1\n", "a = 0.0 # Schwarzschild as we are using SchwarzEccFlux here\n", "p0 = 10.0\n", "e0 = 0.7\n", "xI = 1.0 # +1 for prograde, -1 for retrograde inspirals\n", "\n", "# get trajectory\n", "t, p, e, x, Phi_phi, Phi_theta, Phi_r = traj(m1, m2, a, p0, e0, xI)\n", "\n", "# The shape is (nb of data points in parameter space, mode values)\n", "teuk_modes = amp(a, p, e, x)" ] }, { "cell_type": "code", "execution_count": 3, "id": "18b9882f-3e6d-4ca2-8730-c034ae96e649", "metadata": { "execution": { "iopub.execute_input": "2026-07-07T15:30:47.426692Z", "iopub.status.busy": "2026-07-07T15:30:47.426578Z", "iopub.status.idle": "2026-07-07T15:30:47.438248Z", "shell.execute_reply": "2026-07-07T15:30:47.437702Z" } }, "outputs": [], "source": [ "from few.summation.interpolatedmodesum import CubicSplineInterpolant\n", "\n", "# Let's take the amplitudes from the last step and spline those.\n", "# For the argument of CubicSplineInterpolant, the shape of the input has to be switched.\n", "# We will split real and imaginary components\n", "\n", "# First argument will be the real, then imaginary mode values, and second argument the data points.\n", "interp_in = np.zeros((teuk_modes.shape[1] * 2, teuk_modes.shape[0]))\n", "\n", "interp_in[: teuk_modes.shape[1], :] = teuk_modes.T.real\n", "interp_in[teuk_modes.shape[1] :, :] = teuk_modes.T.imag\n", "\n", "spline_of_interp_in = CubicSplineInterpolant(t, interp_in)" ] }, { "cell_type": "code", "execution_count": 4, "id": "04ebee73-84eb-4e73-945a-8d59eef9795e", "metadata": { "execution": { "iopub.execute_input": "2026-07-07T15:30:47.439533Z", "iopub.status.busy": "2026-07-07T15:30:47.439445Z", "iopub.status.idle": "2026-07-07T15:30:47.888471Z", "shell.execute_reply": "2026-07-07T15:30:47.887871Z" } }, "outputs": [ { "data": { "image/png": "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XpEz2zYQeTKigKNYBDGRn3guHs/luERERHThWRpacGw5CU5HBziiorSYq0a0togK1KLAowhM4uLiGrcRLSlNu5b27t2LkSNHykWsf/HFF+VzkUNzLse1Bs6uS61paag9EREBJtdA/LX2PixW3W3T26ESQ6m64gciusZEsnFZWdkfuqtEAcjjx4/L+WPErLsiyZZIEP+7iNpaYsSe+D2JjY29MGVCiIg6ieT8Clz+6i/wd3fG/icnXtDv76ZsV+bTjonRWGIWZdE1JopBEp1JBL8iCZvBDRFRy6UabN04wACnFaIsgfjXuRh+TnRmACzqddn6f14iIrukL8el6v1wUURNxctsdhoMcP7ki6w9c/YQERF1NU5laXjfeSkKzH4AbDf4h8kDREREZD2NMxk78DBxIiIi6prDxC0qBjhERETkICwWs+PPZExERERds4tKYRcVEREROQpFYQsOERERORjFbB85OBwmTkRERFZT7RmNhcY74e7li7/DdpiDQ0RERFZT6xqE/5ovwxbnCbAlBjhERERkNebGUg2wKQY4REREZDVq/SmMVv+OOEsKbIk5OERERGQ1HkUHsdx5EY5XxQC4E7bCFhwiIiKynoZh4pzJmIiIiBxtmLjCmYyJiIjIUSj1tajYgkNERESOQ2GpBiIiInIwSmOxTVYTJyIiIkerRaWy7UQ4HCZOREREVlPq1QfPG2fCy7cb4mE7DHCIiIjIaio9ovEf8xSMdQ+ALXEeHCIiIrIaC0s1EBERkaPR1hRjsOo4wkxZNj0PdlERERGR1QTnb8Eq3dM4UDoCwAzYCruoiIiIyGoUi8UuQgwGOERERGQ9djJMnAEOERERWX0mY7DYJhERETlcLSqwi4qIiIgchaWhBYddVEREROQoFFYTJyIiIgdT4NUfS43X4YDnBJueB+fBISIiIqvJ9+qHN8waXO0VBlviKCoiIiKyeqkGtZrVxImIiMhBOBtKEKfKgI9J59gtOGvXrsW4ceMQFRWFyy67DDt27Gj3PsuWLUNISEizJS4urgOvgoiIiNqid84q/Kh7HJML3ofDBjjbt2/HVVddhalTp2LdunUYMmSIDFiSkpLatU9lZSXCw8Nx4MCBxmXr1q0deSlERETUFvVdVA490d/ixYtlcPLoo4+iT58+WLJkCWJiYrB06dJ276PVapu14AQFBXXkpRAREVFb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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "image/png": "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D7d67AULFmDevHmN26IFJzo6uk3XTURERE4c4Iicl6Z5L+ej1+uVlpzjx4832y+2u3fvflF1evTooXRbNR06Pnz4cHz44YdKC48IglpydXVVHkREROT8OjTJWMxf8+mnnyqtLYIY5bRq1SrcdNNNjWXWr1+v5NG0p860adOUbimRV9Ng06ZN6NmzZ6vBDREREXUuHTpMXHQtiRYfi8WifF2zZg2ioqKwdu3axtaURYsWYcmSJUrZttapra3Ftddei8LCQiUHJyUlBbt27cK3336LESNGtOncRDeYn58fsrKyOEyciIjIQTSkmIh4QeToqhLgNAQjYl6bzMxMpVtJDPnWarWNz//yyy9Ka0zTeXF+r44gAqDVq1cro6vCw8OVgCcgIKDN5yVGXTEHh4iIyDGJBgrRAKJagGOvrFYrcnJy4O3tbdNurYbIki1D6uF7oD6+B+rje2Af+D7YnghbRBpLRERE48AmVdaislfippwv8rtYYqg7Z0hWF98D9fE9UB/fA/vA98G2ztc11YCriRMREZHTYYBDRERETocBjo2JkV5iBXTOuaMevgfq43ugPr4H9oHvg3o6bZIxEREROS+24BAREZHTYYBDRERETocBDhERETmdTjsPTkcwmUzYsmWLsgzEoEGDEBkZqfYp2S1xj9atW4fQ0FCMHDmy1TKnT5/G7t27lfkOLrvssmaLq9prGUchUu8OHTqE9PR0xMbGok+fPq2Wy8/Px/bt2+Hp6alcs5ubm92XcSRitvYDBw4oP1Pib4a7u/tZZYqLi7F161ZlMWLxu+Lh4WH3ZRzRtm3bkJGRgfHjx8Pf3/+sv1fib7uYFFZcs5ggtiV7K0N1f+jIBjIyMuSuXbvKiYmJ8pgxY2R3d3f5zTff5L1toby8XL7//vvl8PBwOTQ0VL7++utbvUfi3ol7KO6luKfi3op7bM9lHMXmzZvlPn36yL1795YnTZokh4WFycOHD5cLCwublfvggw9kT09P+fLLL5d79OghR0dHy4cPH7brMo6itLRUnjp1qvKzNHnyZOW9CAoKktesWdOs3Ndffy17e3vLI0aMUN4z8Tuze/duuy7jiPbv3y/7+PiIATfyrl27mj23bt062c/PTx4yZIg8cOBAOSAgQN64caNdl6E6DHBsZMKECfLIkSNlo9GobL///vuyVquVjx49aquXcAp5eXnysmXL5MrKSvnGG29sNcA5cuSIcu8+/vhjZdtgMCh/UCdOnGi3ZRzJjz/+KB88eLBZ0Nm9e3d5+vTpjftycnKaBekWi0W+7rrr5GHDhtltGUdy5syZs4KZGTNmKEFbg5KSEtnX11f+61//2rjv1ltvVYI7q9Vql2UcUVVVlXINL7/88lkBTnV1tfIPwMMPP9y4709/+pPyPjX8rbe3MvQbBjg2IP7z1Wg08v/+97/GfeIPsPhBXLRokS1ewimdK8BZuHChHBER0eyP5kcffaTc46KiIrss4+geeughuX///o3bIpDw8vKSa2trG/etXbtW+QA4ceKEXZZxdK+++qry33gD8U+STqdTAosGO3fuVK65odXE3so4IhHYP/jgg0rQ3zLAWbVqlbIvKyurcd/x48eVfaIlxR7L0G+YZGwDhw8fVhbv7NWrV7O1rpKTk3Hw4EF2hbaTuGfi3jVdBLV3797KPRb32h7LODKLxYINGzY0+/kV15yUlNRswkpxzYLI3bHHMo5o06ZN+Oijj/Dcc89hyZIleOuttxqfE9cs1svz8/Nr3NeQK9Xwd8Xeyjiajz/+GDt27MDLL7/c6vPiukQ+TtN1C8XPocj9anpf7KkM/YZJxjYgEr6EgICAZvsDAwNRVFRki5fodPczKCjorHsplJaW2mUZR/bUU08hLS0Nn3/+eeM+cc2t/Ty3vC/2VMZRE1t37typBMoi4T4hIaHxudauWQR4Iqn3fPdFzTKO5OTJk5g1axZ+/PHHVpO7z3XNgth3vvuiZhn6DQMcG2j4r7KysrLZfrHt6KM81Lqfrd1LoeF+2lsZR/Xqq68qLQcrV65E165dG/fb2/111vfgsccea/x+/vz5mDBhgjKyzcvLq9VrFq2GtbW1570vapZxJLNnz8bAgQNx9OhR5ZGdna3sX7t2rTIidvjw4a1ec8u/7fZWhn7DLiobSExMbBzy2ZQYctj0PzJq+/1s7V4KDffT3so4IhHYiNabr776CuPGjWv2nL3dX2d9D5q64447lBbfhm5Pcc05OTkwm82NZcQ9EEFF0/tiT2UcSf/+/ZXutq+//lp5/PTTT8r+jRs3YteuXY3XLN6T6urqxnqipaS8vLzZfbGnMtREk3wcugjdunWTZ86c2bh96NAhJfGr5UgJ+v0k4++//165d2L0UoP77rtPGeljr2UczRtvvCG7ubnJq1evbvV5kWgprlkMKW/w+OOPK4nzZrPZLss42iiqlpYvXy5LkiRnZ2cr28eOHVO2v/3228YyL774ojKcWYz8sccyjqy1JGMxek8kVospChosXbpUdnV1bZxWwd7K0G8Y4NiI+BB0cXGRZ82apXx4JCQkKEPH6WxffPGFMuR66NCh8qBBg5Tvxb6mxL0Tc4SIeylG+Ih7K+6xPZdxFB9++KHyh1yMHhH3vuEh5jhp6s4775QjIyPl1157TZ4/f75yzaKuPZdxFCtWrFDm8xEBwnvvvSfPmTNHmeNHBG1Nib8nYn4cMYT5mWeekfV6vfz222/bdRlnCnAEcZ0iiHvhhReUIfIeHh7y4sWL7boM1eFq4ja0Z88erFixQkkEE/2399xzj0PPdttR7r33XlRVVTXbJ2amfffddxu3RR/4e++9pyRhille77zzTqW/vCl7K+MoxM/o6tWrz9ovmuuXLl3auC26Ht5//32lyV4kkt56661nzTptb2Ucyf79+/HZZ58p3T5iVMyUKVMwYMCAs8r973//U/JCxMzBN910E8aOHWv3ZRyRyMF55JFH8MILL5zV3SO6sL777jtlJOXkyZMxceLEs+rbWxkCGOAQERGR02GSMRERETkdBjhERETkdBjgEBERkdNhgENEREROhwEOEREROR0GOEREROR0GOAQERGR02GAQ0RERE6HAQ4RERE5HQY4RERE5HQY4BAREZHTYYBDREREcDb/Dyb+S/gnlGb0AAAAAElFTkSuQmCC", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# Get new values\n", "t_new = np.linspace(t[0], t[-1], 1000)\n", "\n", "# Notice the output has the same shape as the inital input to the spline.\n", "new_teuk_modes = spline_of_interp_in(t_new)\n", "\n", "# To get back the original shape (with now data points at t_new), add the real and imaginary values back together and transpose\n", "new_teuk_modes = new_teuk_modes[:teuk_modes.shape[1],:] + 1j * new_teuk_modes[teuk_modes.shape[1]:,:]; new_teuk_modes = new_teuk_modes.T\n", "\n", "# Check the original and interpolated values for the (2,2,0,0) mode\n", "ind = amp.special_index_map[(2, 2, 0, 0)]\n", "\n", "plt.plot(t_new, new_teuk_modes[:,ind].real, label=\"interpolated\")\n", "plt.plot(t, teuk_modes[:, ind].real, \"--\", label=\"original\")\n", "plt.legend()\n", "plt.show()\n", "\n", "plt.plot(t_new, new_teuk_modes[:,ind].imag, label=\"interpolated\")\n", "plt.plot(t, teuk_modes[:, ind].imag, \"--\", label=\"original\")\n", "plt.legend()\n", "plt.show()" ] }, { "attachments": {}, "cell_type": "markdown", "id": "88352b10-edac-456c-a390-111716f38fee", "metadata": {}, "source": [ "To get the array of interp coefficients for CUDA implementations, do the following. The underlying shape of the array is (4, length, ninterps). It is flattened though for entry into GPU kernel. " ] }, { "cell_type": "code", "execution_count": 5, "id": "cc04fd9e-60ee-4d0f-b90b-e45d08b2cb26", "metadata": { "execution": { "iopub.execute_input": "2026-07-07T15:30:47.889859Z", "iopub.status.busy": "2026-07-07T15:30:47.889758Z", "iopub.status.idle": "2026-07-07T15:30:47.891962Z", "shell.execute_reply": "2026-07-07T15:30:47.891569Z" } }, "outputs": [ { "data": { "text/plain": [ "array([ 6.23202881e-06, 3.56235880e-06, -1.26105090e-06, ...,\n", " 1.25157281e-11, 1.37053945e-11, 7.05472871e-12],\n", " shape=(1352736,))" ] }, "execution_count": 5, "metadata": {}, "output_type": "execute_result" } ], "source": [ "spline_of_interp_in.interp_array" ] }, { "cell_type": "markdown", "id": "2f1b29b9", "metadata": {}, "source": [ "For convenience, the coefficients array can be returned to its original form via the `reshape_shape` attribute:\n" ] }, { "cell_type": "code", "execution_count": 6, "id": "20c13975", "metadata": { "execution": { "iopub.execute_input": "2026-07-07T15:30:47.893215Z", "iopub.status.busy": "2026-07-07T15:30:47.893127Z", "iopub.status.idle": "2026-07-07T15:30:47.895215Z", "shell.execute_reply": "2026-07-07T15:30:47.894772Z" } }, "outputs": [ { "data": { "text/plain": [ "(7686, 44)" ] }, "execution_count": 6, "metadata": {}, "output_type": "execute_result" } ], "source": [ "spline_of_interp_in.interp_array.reshape(spline_of_interp_in.reshape_shape)[0].T.shape" ] }, { "cell_type": "code", "execution_count": 7, "id": "2a6c7f0c", "metadata": { "execution": { "iopub.execute_input": "2026-07-07T15:30:47.896387Z", "iopub.status.busy": "2026-07-07T15:30:47.896309Z", "iopub.status.idle": "2026-07-07T15:30:47.899904Z", "shell.execute_reply": "2026-07-07T15:30:47.899434Z" } }, "outputs": [ { "data": { "text/plain": [ "True" ] }, "execution_count": 7, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Check\n", "interp_in_recovered = spline_of_interp_in.interp_array.reshape(spline_of_interp_in.reshape_shape)[0].T\n", "np.allclose(\n", " interp_in_recovered, \n", " interp_in\n", " )" ] } ], "metadata": { "kernelspec": { "display_name": "few-env", "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.13" } }, "nbformat": 4, "nbformat_minor": 5 }