{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Updating Plots" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "`bqplot` is an interactive plotting library. Attributes of plots can be updated in place without recreating the whole figure and marks. Let's look at idiomatic ways of updating plots in `bqplot`" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "import numpy as np\n", "import bqplot.pyplot as plt" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "x = np.linspace(-10, 10, 100)\n", "y = np.sin(x)\n", "\n", "fig = plt.figure()\n", "line = plt.plot(x=x, y=y)\n", "fig" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "To update the attributes of the plot(x, y, color etc.) the correct way to do it is to update the attributes of the **mark** objects in place. Recreating figure or mark objects is not recommended" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "# update y attribute of the line object\n", "line.y = np.tan(x)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can update multiple attributes of the mark object simultaneously by using the `hold_sync` method like so. (This makes only one round trip from the python kernel to front end)" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "# update both x and y together\n", "with line.hold_sync():\n", " line.x = np.arange(100)\n", " line.y = x ** 3 - x" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can also animate the changes to the x, y and other data attributes by setting the `animation_duration` property on the figure object. More examples of animations can found in the [Animations](../Advanced Plotting/Animations.ipynb) notebook" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "fig.animation_duration = 1000\n", "line.y = np.cos(x)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Let's look at an example to update a scatter plot" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "x, y = np.random.rand(2, 10)\n", "\n", "fig = plt.figure(animation_duration=1000)\n", "scat = plt.scatter(x=x, y=y)\n", "fig" ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "# update the x and y attreibutes in place using hold_sync\n", "with scat.hold_sync():\n", " scat.x, scat.y = np.random.rand(2, 10)" ] } ], "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.7.6" } }, "nbformat": 4, "nbformat_minor": 1 }