{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Scripting manual warps\n", "\n", "Manual (Gaussian-kernel-based) warps can be scripted using the **warp_manual** function, which accepts four parameters:\n", "\n", "* **y** --- original 1D data\n", "* **center** --- warp kernel center, relative to its feasible range (between 0 and 1)\n", "* **amp** --- warp kernel amplitude, relative to its feasible range (between -1 and 1)\n", "* **head** --- warp kernel head width, relative to its feasible range (between 0 and 1)\n", "* **tail** --- warp kernel tail width, relative to its feasible range (between 0 and 1)" ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [], "source": [ "%matplotlib inline" ] }, { "cell_type": "code", "execution_count": 2, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": { "needs_background": "light" }, "output_type": "display_data" } ], "source": [ "import numpy as np\n", "from matplotlib import pyplot as plt\n", "import mwarp1d\n", "\n", "#define warp:\n", "center = 0.25\n", "amp = 0.5\n", "head = 0.2\n", "tail = 0.2\n", "\n", "#apply warp:\n", "Q = 101 #domain size\n", "y = np.sin( np.linspace(0, 4*np.pi, Q) ) #an arbitary 1D observation\n", "yw = mwarp1d.warp_manual(y, center, amp, head, tail) #warped 1D observation\n", "\n", "#plot:\n", "plt.figure()\n", "ax = plt.axes()\n", "ax.plot(y, label='Original')\n", "ax.plot(yw, label='Warped')\n", "ax.legend()\n", "ax.set_xlabel('Domain position (%)', size=13)\n", "ax.set_ylabel('Dependent variable value', size=13)\n", "plt.show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The same can be achieved somewhat more verbosely using the **ManualWarp1D** class:" ] }, { "cell_type": "code", "execution_count": 3, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": { "needs_background": "light" }, "output_type": "display_data" } ], "source": [ "#create warp:\n", "Q = 101 #domain size\n", "warp = mwarp1d.ManualWarp1D(Q) #constrained Gaussian kernel warp object\n", "warp.set_center(0.25) #relative warp center (0 to 1)\n", "warp.set_amp(0.5) #relative warp amplitude (-1 to 1)\n", "warp.set_head(0.2) #relative warp head (0 to 1)\n", "warp.set_tail(0.2) #relative warp tail (0 to 1)\n", "\n", "#apply warp:\n", "y = np.sin( np.linspace(0, 4*np.pi, Q) ) #an arbitary 1D observation\n", "yw = warp.apply_warp(y) #warped 1D observation\n", "\n", "#plot:\n", "plt.figure()\n", "ax = plt.axes()\n", "ax.plot(y, label='Original')\n", "ax.plot(yw, label='Warped')\n", "ax.legend()\n", "ax.set_xlabel('Domain position (%)', size=13)\n", "ax.set_ylabel('Dependent variable value', size=13)\n", "plt.show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "One advantage of using the **ManualWarp1D** class is that it can be used to access details like the displacement field:" ] }, { "cell_type": "code", "execution_count": 4, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": { "needs_background": "light" }, "output_type": "display_data" } ], "source": [ "dq = warp.get_displacement_field()\n", "\n", "\n", "plt.figure()\n", "ax = plt.axes()\n", "ax.plot(dq, label='Displacement field')\n", "\n", "#label the warp parameters:\n", "c = warp.center\n", "ax.plot([0,c], [0,0], color='k', ls=':')\n", "ax.plot([c]*2, [0,dq.max()], color='k', ls=':')\n", "xh,xt = 15,58\n", "ax.plot([xh,c], [dq[xh]]*2, color='k', ls=':')\n", "ax.plot([c,xt], [dq[xt]]*2, color='k', ls=':')\n", "\n", "#add text labels\n", "bbox = dict(facecolor='w', edgecolor='0.7', alpha=0.9)\n", "ax.text(0.5*c, 0, 'center', ha='center', bbox=bbox)\n", "ax.text(c, 0.8*dq.max(), 'amp', ha='center', bbox=bbox)\n", "ax.text(0.5*(xh+c), dq[xh], 'head', ha='center', bbox=bbox)\n", "ax.text(c + 0.5*(xt-c), dq[xt], 'tail', ha='center', bbox=bbox)\n", "\n", "ax.legend()\n", "ax.set_xlabel('Domain position (%)', size=13)\n", "ax.set_ylabel('Displacement (%)', size=13)\n", "plt.show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Note that the parameters above characterize this displacement field:\n", "\n", "* **center** indicates the position of the kernel's maximum value\n", "* **amp** indicates the kernel amplitude\n", "* **head** and **tail** indicate the kernel width\n", "\n", "Changing head and tail to zero, for example, yields the following result:" ] }, { "cell_type": "code", "execution_count": 5, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": { "needs_background": "light" }, "output_type": "display_data" } ], "source": [ "warp.set_head(0)\n", "warp.set_tail(0)\n", "dq = warp.get_displacement_field()\n", "\n", "plt.figure()\n", "ax = plt.axes()\n", "ax.plot(dq, label='Displacement field')\n", "ax.legend()\n", "ax.set_xlabel('Domain position (%)', size=13)\n", "ax.set_ylabel('Displacement (%)', size=13)\n", "plt.show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Note that these values of *head* and *tail* represent the minimum possible values for these parameters that maintain a monotonically increasing warped domain, which can be visualized as indicated below." ] }, { "cell_type": "code", "execution_count": 6, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": { "needs_background": "light" }, "output_type": "display_data" } ], "source": [ "q0 = warp.get_original_domain()\n", "qw = warp.get_warped_domain()\n", "\n", "plt.figure()\n", "ax = plt.axes()\n", "ax.plot(q0, label='Original domain')\n", "ax.plot(qw, label='Warped domain')\n", "ax.legend()\n", "ax.set_xlabel('Domain position (%)', size=13)\n", "ax.set_ylabel('Domain position (%)', size=13)\n", "plt.show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Attempting to set smaller *absolute* values for *head* and *tail* would result in a non-monotonically increasing warping field. If the domain is time, it would imply that warped time does not flow forward across the whole domain, and thus that temporal events can be re-ordered in time. The **ManualWarp1D** class ensures that this does not happen, and that all warped domains remain monotonically increasing. " ] } ], "metadata": { "kernelspec": { "display_name": "Python 3", "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.6.9" } }, "nbformat": 4, "nbformat_minor": 2 }