{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Parcels Tutorial" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Welcome to a quick tutorial on Parcels. This is meant to get you started with the code, and give you a flavour of some of the key features of Parcels." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "In this tutorial, we will first cover how to run a set of particles [from a very simple idealised field](#Running-particles-in-an-idealised-field). We will show how easy it is to run particles in [time-backward mode](#Running-particles-in-backward-time). Then, we will show how to [add custom behaviour](#Adding-a-custom-behaviour-kernel) to the particles. Then we will show how to [run particles in a set of NetCDF files from external data](#Reading-in-data-from-arbritrary-NetCDF-files). Then we will show how to use particles to [sample a field](#Sampling-a-Field-with-Particles) such as temperature or sea surface height. And finally, we will show how to [write a kernel that tracks the distance travelled by the particles](#A-second-example-kernel:-calculating-distance-travelled)." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Let's start with importing the relevant modules. The key ones are all in the `parcels` directory." ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [], "source": [ "from parcels import FieldSet, ParticleSet, Variable, JITParticle, AdvectionRK4, plotTrajectoriesFile\n", "import numpy as np\n", "import math\n", "from datetime import timedelta\n", "from operator import attrgetter" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Running particles in an idealised field" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The first step to running particles with Parcels is to define a `FieldSet` object, which is simply a collection of hydrodynamic fields. In this first case, we use a simple flow of two idealised moving eddies. That field is saved in NetCDF format in the directory `examples/MovingEddies_data`. Since we know that the files are in what's called `Parcels FieldSet` format, we can call these files using the function `FieldSet.from_parcels()`." ] }, { "cell_type": "code", "execution_count": 2, "metadata": {}, "outputs": [], "source": [ "fieldset = FieldSet.from_parcels(\"MovingEddies_data/moving_eddies\")" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The `fieldset` can then be visualised with the `show()` function. To show the zonal velocity (`U`), give the following command" ] }, { "cell_type": "code", "execution_count": 3, "metadata": {}, "outputs": [ { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAAXUAAAD8CAYAAACINTRsAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAIABJREFUeJzsvX28LFlZ3/v9rep9zkRl4ugwZGQGMYoxxKAJc4kJMYIo\nIhLwJeB7QCETNBiiF3SIiclF+QTjSyRK0IlvmECEi6Jz4yAguUQTUZmJIC8jOEEShkHHQYwQPWd3\n13ryx3qpVdVV3b337t7nTO/1m09PrVq1qmpV9dnfevqpZz1LZkZVVVVV1X7IXeoOVFVVVVVtTxXq\nVVVVVXukCvWqqqqqPVKFelVVVdUeqUK9qqqqao9UoV5VVVW1R5pt0kjSe4EPAy2wMLMbJH0P8LeB\nQ+C/A19nZn+0q45WVVVVVa3XUSz1R5vZZ5rZDXH99cCnm9nDgHcDz9t676qqqqqqjqRju1/M7HVm\ntoirvwZct50uVVVVVVUdVxu5XwADXifJgB8xs5sH278eeMXYjpJuBG4E0LlzDz94wDXH7WtVVdUZ\n0uH77rrXzO5/kmN8waM/2j74h+3adrf/1sXXmtnjTnKuy0WbQv2RZna3pGuA10v6bTP7ZQBJ3w4s\ngJeN7RgfADcDnH/Q9fbA5/yjLXS7qqpq3/W7z37O/zjpMT74hy2/8doHrW3XXPs7V5/0XJeLNnK/\nmNndcXkP8GrgEQCSngo8Afhqq0lkqqqqLjMZ4Df4b5+01lKX9NGAM7MPx/JjgedLehzwbcDnmNmf\n7LifVVVVVUeWYcxtvftln7SJ++UBwKslpfYvN7NflHQncJ7gjgH4NTN75s56WlVVVXUM7Zslvk5r\noW5m7wE+Y6T+U3bSo6qqqqotyTDaM+YZ3vRFaVVVVdV9Up4K9aqqqqq9kAFthXpVVVXV/qha6lVV\nVVV7IgPm1adeVVVVtR8yrLpfqqqqqvZGBu3ZYnqFelVV1f4qjCg9W6pQr6qq2mOJFl3qTpyqKtSr\nqqr2Vgb46n6pqqqq2g8ZcHjGZu2sUK+qqtpreTtb7pez9Qirqqo6UwojSrX2s4kk/bikeyS9fWL7\nV0v6rfj5VUmfUWz7WEmvkvTbku6Q9Ndj/ZMlvUOSl3TD2HGPqgr1qqqqvZUhWtzaz4b6SWDV7Ei/\nS0hF/jDgO4mTA0W9CPhFM/s0QoLEO2L924EvBX75CJe1UtX9UlVVtdfalvvFzH5Z0oNXbP/VYjXP\n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\ncZwG8RfALu+HE1DfCAAAAABJRU5ErkJggg==\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "fieldset.U.show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The next step is to define a `ParticleSet`. In this case, we start 2 particles at (3.3E, 46N) and (3.3E, 47.8N) using the `from_list` constructor method, that are advected on the `fieldset` we defined above. Note that we use `JITParticle` as `pclass`, because we will be executing the advection in JIT (Just-In-Time) mode. The alternative is to run in `scipy` mode, in which case `pclass` is `ScipyParticle`" ] }, { "cell_type": "code", "execution_count": 4, "metadata": {}, "outputs": [], "source": [ "pset = ParticleSet.from_list(fieldset=fieldset, # the fields on which the particles are advected\n", " pclass=JITParticle, # the type of particles (JITParticle or ScipyParticle)\n", " lon=[ 3.3, 3.3], # a vector of release longitudes \n", " lat=[46.0, 47.8]) # a vector of release latitudes" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Print the `ParticleSet` to see where they start" ] }, { "cell_type": "code", "execution_count": 5, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "P[0](lon=3.300000, lat=46.000000, depth=0.000000, time=not_yet_set)\n", "P[1](lon=3.300000, lat=47.799999, depth=0.000000, time=not_yet_set)\n" ] } ], "source": [ "print(pset)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "This output shows for each particle the (longitude, latitude, depth, time). Note that in this case the time is `not_yet_set`, that is because we didn't specify a `time` when we defined the `pset`." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "To plot the positions of these particles on the zonal velocity, use the following command" ] }, { "cell_type": "code", "execution_count": 6, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "pset.show(field=fieldset.U)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The final step is to run (or 'execute') the `ParticelSet`. We run the particles using the `AdvectionRK4` kernel, which is a 4th order Runge-Kutte implementation that comes with Parcels. We run the particles for 6 days (using the `timedelta` function from `datetime`), at an RK4 timestep of 5 minutes. We store the trajectory information at an interval of 1 hour in a file called `EddyParticles.nc`. Because `time` was `not_yet_set`, the particles will be advected from the first date available in the `fieldset`, which is the default behaviour." ] }, { "cell_type": "code", "execution_count": 7, "metadata": {}, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "INFO: Compiled JITParticleAdvectionRK4 ==> /var/folders/r2/8593q8z93kd7t4j9kbb_f7p00000gn/T/parcels-501/bf76ff41b11b481f93607ada06701358.so\n" ] } ], "source": [ "pset.execute(AdvectionRK4, # the kernel (which defines how particles move)\n", " runtime=timedelta(days=6), # the total length of the run\n", " dt=timedelta(minutes=5), # the timestep of the kernel\n", " output_file=pset.ParticleFile(name=\"EddyParticles.nc\", outputdt=timedelta(hours=1))) # the file name and the time step of the outputs" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The code should have run, which can be confirmed by printing and plotting the `ParticleSet` again" ] }, { "cell_type": "code", "execution_count": 8, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "P[0](lon=2.024550, lat=46.088692, depth=0.000000, time=518400.000000)\n", "P[1](lon=2.017325, lat=48.305149, depth=0.000000, time=518400.000000)\n" ] }, { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "print(pset)\n", "pset.show(field=fieldset.U)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Note that both the particles (the black dots) and the `U` field have moved in the plot above. Also, the `time` of the particles is now 518400 seconds, which is 6 days." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The trajectory information of the particles is stored in the `EddyParticles.nc` file. It can be quickly plotted using the `plotTrajectoriesFile` function." ] }, { "cell_type": "code", "execution_count": 9, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 9, "metadata": {}, "output_type": "execute_result" } ], "source": [ "plotTrajectoriesFile('EddyParticles.nc')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The `plotTrajectoriesFile` function can also be used to show the trajectories as an animation, by specifying that it has to run in `movie2d_notebook` mode. If we pass this to our function above, we can watch the particles go!" ] }, { "cell_type": "code", "execution_count": 10, "metadata": {}, "outputs": [ { "data": { "text/html": [ "" ], "text/plain": [ "" ] }, "execution_count": 10, "metadata": {}, "output_type": "execute_result" } ], "source": [ "plotTrajectoriesFile('EddyParticles.nc', mode='movie2d_notebook')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The `plotTrajectoriesFile` can also be used to display 2-dimensional histograms (`mode=hist2d`) of the number of particle observations per bin. Use the `bins` argument to control the number of bins in the longitude and latitude direction. See also the [matplotlib.hist2d](https://matplotlib.org/api/_as_gen/matplotlib.pyplot.hist2d.html) page." ] }, { "cell_type": "code", "execution_count": 11, "metadata": {}, "outputs": [ { "data": { "image/png": "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\nEnxEREP9Pzn2xPyBxxLEAAAAAElFTkSuQmCC\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 11, "metadata": {}, "output_type": "execute_result" } ], "source": [ "plotTrajectoriesFile('EddyParticles.nc', mode='hist2d', bins=[30, 20])" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Now one of the neat features of Parcels is that the particles can be plotted as a movie *during execution*, which is great for debugging. To rerun the particles while plotting them on top of the zonal velocity field (`fieldset.U`), first reinitialise the `ParticleSet` and then re-execute. However, now rather than saving the output to a file, display a movie using the `moviedt` display frequency, in this case with the zonal velocity `fieldset.U` as background" ] }, { "cell_type": "code", "execution_count": 12, "metadata": {}, "outputs": [], "source": [ "# THIS DOES NOT WORK IN THIS IPYTHON NOTEBOOK, BECAUSE OF THE INLINE PLOTTING.\n", "# THE 'SHOW_MOVIE' KEYWORD WILL WORK ON MOST MACHINES, THOUGH\n", "# pset = ParticleSet(fieldset=fieldset, size=2, pclass=JITParticle, lon=[3.3, 3.3], lat=[46.0, 47.8])\n", "# pset.execute(AdvectionRK4,\n", "# runtime=timedelta(days=6),\n", "# dt=timedelta(minutes=5),\n", "# moviedt=timedelta(hours=1),\n", "# movie_background_field=fieldset.U)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Running particles in backward time" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Running particles in backward time is extremely simple: just provide a `dt` < 0. " ] }, { "cell_type": "code", "execution_count": 13, "metadata": {}, "outputs": [], "source": [ "pset.execute(AdvectionRK4,\n", " dt=-timedelta(minutes=5), # negative timestep for backward run\n", " runtime=timedelta(days=6), # the run time\n", " output_file=pset.ParticleFile(name=\"EddyParticles_Bwd.nc\", outputdt=timedelta(hours=1))) # the file name and the time step of the outputs" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Now print the particles again, and see that they (except for some round-off errors) returned to their original position" ] }, { "cell_type": "code", "execution_count": 14, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "P[0](lon=3.300004, lat=45.999912, depth=0.000000, time=0.000000)\n", "P[1](lon=3.300233, lat=47.800236, depth=0.000000, time=0.000000)\n" ] }, { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "print(pset)\n", "pset.show(field=fieldset.U)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Adding a custom behaviour kernel" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "A key feature of Parcels is the ability to quickly create very simple kernels, and add them to the execution. Kernels are little snippets of code that are run during exection of the particles." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "In this example, we'll create a simple kernel where particles obtain an extra 2 m/s westward velocity after 1 day. Of course, this is not very realistic scenario, but it nicely illustrates the power of custom kernels." ] }, { "cell_type": "code", "execution_count": 15, "metadata": {}, "outputs": [], "source": [ "def WestVel(particle, fieldset, time, dt):\n", " if time > 86400:\n", " uvel = -2.\n", " particle.lon += uvel * dt / 1.1e5 # 1.1e5 m in 1 degree latitude" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Now reset the `ParticleSet` again, and re-execute. Note that we have now changed `kernel` to be `AdvectionRK4 + k_WestVel`, where `k_WestVel` is the `WestVel` function as defined above cast into a `Kernel` object (via the `pset.Kernel` call)." ] }, { "cell_type": "code", "execution_count": 16, "metadata": {}, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "INFO: Compiled JITParticleAdvectionRK4WestVel ==> /var/folders/r2/8593q8z93kd7t4j9kbb_f7p00000gn/T/parcels-501/8ddee27c613ec72b7a4170f24b18046e.so\n" ] } ], "source": [ "pset = ParticleSet.from_list(fieldset=fieldset, pclass=JITParticle, lon=[3.3, 3.3], lat=[46.0, 47.8])\n", "\n", "k_WestVel = pset.Kernel(WestVel) # casting the WestVel function to a kernel object\n", "\n", "pset.execute(AdvectionRK4 + k_WestVel, # simply add kernels using the + operator\n", " runtime=timedelta(days=3),\n", " dt=timedelta(minutes=5),\n", " output_file=pset.ParticleFile(name=\"EddyParticles_WestVel.nc\", outputdt=timedelta(hours=1)))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "And now plot this new trajectory file" ] }, { "cell_type": "code", "execution_count": 17, "metadata": {}, "outputs": [ { "data": { "image/png": "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\nSUVORK5CYII=\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 17, "metadata": {}, "output_type": "execute_result" } ], "source": [ "plotTrajectoriesFile('EddyParticles_WestVel.nc')" ] }, { "cell_type": "markdown", "metadata": { "collapsed": true }, "source": [ "## Reading in data from arbritrary NetCDF files" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "In most cases, you will want to advect particles within pre-computed velocity fields. If these velocity fields are stored in NetCDF format, it is fairly easy to load them into the `FieldSet.from_netcdf()` function." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The `examples` directory contains a set of [GlobCurrent](http://globcurrent.ifremer.fr/products-data/products-overview) files of the region around South Africa." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "First, define the names of the files containing the zonal (U) and meridional (V) velocities. You can use wildcards (`*`) and the filenames for U and V can be the same (as in this case)" ] }, { "cell_type": "code", "execution_count": 18, "metadata": {}, "outputs": [], "source": [ "filenames = {'U': \"GlobCurrent_example_data/20*.nc\",\n", " 'V': \"GlobCurrent_example_data/20*.nc\"}" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Then, define a dictionary of the variables (`U` and `V`) and dimensions (`lon`, `lat` and `time`; note that in this case there is no `depth` because the GlobCurrent data is only for the surface of the ocean)" ] }, { "cell_type": "code", "execution_count": 19, "metadata": {}, "outputs": [], "source": [ "variables = {'U': 'eastward_eulerian_current_velocity',\n", " 'V': 'northward_eulerian_current_velocity'}\n", "dimensions = {'lat': 'lat',\n", " 'lon': 'lon',\n", " 'time': 'time'}" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Finally, read in the fieldset using the `FieldSet.from_netcdf` function with the above-defined `filenames`, `variables` and `dimensions`" ] }, { "cell_type": "code", "execution_count": 20, "metadata": {}, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "WARNING: Casting lon data to np.float32\n", "WARNING: Casting lat data to np.float32\n", "WARNING: Casting depth data to np.float32\n" ] } ], "source": [ "fieldset = FieldSet.from_netcdf(filenames, variables, dimensions)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Now define a `ParticleSet`, in this case with 5 particle starting on a line between (28E, 33S) and (30E, 33S) using the `ParticleSet.from_line` constructor method" ] }, { "cell_type": "code", "execution_count": 21, "metadata": {}, "outputs": [], "source": [ "pset = ParticleSet.from_line(fieldset=fieldset, pclass=JITParticle,\n", " size=5, # releasing 5 particles\n", " start=(28, -33), # releasing on a line: the start longitude and latitude\n", " finish=(30, -33)) # releasing on a line: the end longitude and latitude" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "And finally execute the `ParticleSet` for 10 days using 4th order Runge-Kutta" ] }, { "cell_type": "code", "execution_count": 22, "metadata": {}, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "INFO: Compiled JITParticleAdvectionRK4 ==> /var/folders/r2/8593q8z93kd7t4j9kbb_f7p00000gn/T/parcels-501/6bb37b538fcb7e1b1ba7daee87fb7a77.so\n" ] } ], "source": [ "pset.execute(AdvectionRK4,\n", " runtime=timedelta(days=10),\n", " dt=timedelta(minutes=5),\n", " output_file=pset.ParticleFile(name=\"GlobCurrentParticles.nc\", outputdt=timedelta(hours=6)))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Now visualise this simulation using the `plotParticles` script again. Note you can plot the particles on top of one of the velocity fields using the `tracerfile`, `tracerfield`, etc keywords." ] }, { "cell_type": "code", "execution_count": 23, "metadata": {}, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "/Users/erik/miniconda2/envs/py2_parcels/lib/python2.7/site-packages/numpy/core/numeric.py:531: RuntimeWarning: invalid value encountered in greater\n", " return array(a, dtype, copy=False, order=order)\n" ] }, { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 23, "metadata": {}, "output_type": "execute_result" } ], "source": [ "plotTrajectoriesFile('GlobCurrentParticles.nc',\n", " tracerfile='GlobCurrent_example_data/20020101000000-GLOBCURRENT-L4-CUReul_hs-ALT_SUM-v02.0-fv01.0.nc',\n", " tracerlon='lon',\n", " tracerlat='lat',\n", " tracerfield='eastward_eulerian_current_velocity')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Sampling a Field with Particles" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "One typical use case of particle simulations is to sample a Field (such as temperature, vorticity or sea surface hight) along a particle trajectory. In Parcels, this is very easy to do, with a custom Kernel." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Let's read in another example, the flow around a Peninsula (see [Fig 2.2.3 in this document](http://archimer.ifremer.fr/doc/00157/26792/24888.pdf)), and this time also load the Pressure (`P`) field, using `extra_fields={'P': 'P'}`. Note that, because this flow does not depend on time, we need to set `allow_time_extrapolation=True` when reading in the fieldset." ] }, { "cell_type": "code", "execution_count": 24, "metadata": {}, "outputs": [], "source": [ "fieldset = FieldSet.from_parcels(\"Peninsula_data/peninsula\", extra_fields={'P': 'P'}, allow_time_extrapolation=True)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Now define a new `Particle` class that has an extra `Variable`: the pressure. We initialise this by sampling the `fieldset.P` field." ] }, { "cell_type": "code", "execution_count": 25, "metadata": {}, "outputs": [], "source": [ "class SampleParticle(JITParticle): # Define a new particle class\n", " p = Variable('p', initial=fieldset.P) # Variable 'p' initialised by sampling the pressure" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Now define a `ParticleSet` using the `from_line` method also used above in the GlobCurrent data. Plot the `pset` and print their pressure values `p`" ] }, { "cell_type": "code", "execution_count": 26, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" }, { "name": "stdout", "output_type": "stream", "text": [ "('p values before execution:', [-4.6339731, -13.038223, -22.007469, -31.454386, -41.185543])\n" ] } ], "source": [ "pset = ParticleSet.from_line(fieldset=fieldset, pclass=SampleParticle, \n", " start=(0.1, 0.05), finish=(0.1, 0.4), size=5, time=0)\n", "pset.show(field=fieldset.P, vmax=1)\n", "print('p values before execution:', [p.p for p in pset])" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Now create a custom function that samples the `fieldset.P` field at the particle location. Cast this function to a `Kernel`." ] }, { "cell_type": "code", "execution_count": 27, "metadata": {}, "outputs": [], "source": [ "def SampleP(particle, fieldset, time, dt): # Custom function that samples fieldset.P at particle location\n", " particle.p = fieldset.P[time, particle.lon, particle.lat, particle.depth]\n", "\n", "k_sample = pset.Kernel(SampleP) # Casting the SampleP function to a kernel." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Finally, execute the `pset` with a combination of the `AdvectionRK4` and `SampleP` kernels, plot the `pset` and print their new pressure values `p`" ] }, { "cell_type": "code", "execution_count": 28, "metadata": {}, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "INFO: Compiled SampleParticleAdvectionRK4SampleP ==> /var/folders/r2/8593q8z93kd7t4j9kbb_f7p00000gn/T/parcels-501/8172010f79d559398f00a4e72e534f11.so\n" ] }, { "data": { "image/png": "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\n+P/xU/EYyd6WugAAAABJRU5ErkJggg==\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" }, { "name": "stdout", "output_type": "stream", "text": [ "('p values after execution:', [-4.6339455, -13.037563, -22.007505, -31.454361, -41.18549])\n" ] } ], "source": [ "pset.execute(AdvectionRK4 + k_sample, # Add kernels using the + operator.\n", " runtime=timedelta(hours=20),\n", " dt=timedelta(minutes=5))\n", "pset.show(field=fieldset.P, vmax=1)\n", "print('p values after execution:', [p.p for p in pset])" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "And see that these pressure values `p` are (within roundoff errors) the same as the pressure values before the execution of the kernels. The particles thus stay on isobars!" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Calculating distance travelled" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "As a second example of what custom kernels can do, we will now show how to create a kernel that logs the total distance that particles have travelled." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "First, we need to create a new `Particle` class that includes three extra variables. The `distance` variable will be written to output, but the auxiliary variables `prev_lon` and `prev_lat` won't be written to output (can be controlled using the `to_write` keyword)" ] }, { "cell_type": "code", "execution_count": 29, "metadata": {}, "outputs": [], "source": [ "class DistParticle(JITParticle): # Define a new particle class that contains three extra variables\n", " distance = Variable('distance', initial=0., dtype=np.float32) # the distance travelled\n", " prev_lon = Variable('prev_lon', dtype=np.float32, to_write=False,\n", " initial=attrgetter('lon')) # the previous longitude\n", " prev_lat = Variable('prev_lat', dtype=np.float32, to_write=False,\n", " initial=attrgetter('lat')) # the previous latitude." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Now define a new function `TotalDistance` that calculates the sum of Euclidean distances between the old and new locations in each RK4 step" ] }, { "cell_type": "code", "execution_count": 30, "metadata": {}, "outputs": [], "source": [ "def TotalDistance(particle, fieldset, time, dt):\n", " # Calculate the distance in latitudinal direction (using 1.11e2 kilometer per degree latitude)\n", " lat_dist = (particle.lat - particle.prev_lat) * 1.11e2\n", " # Calculate the distance in longitudinal direction, using cosine(latitude) - spherical earth\n", " lon_dist = (particle.lon - particle.prev_lon) * 1.11e2 * math.cos(particle.lat * math.pi / 180)\n", " # Calculate the total Euclidean distance travelled by the particle\n", " particle.distance += math.sqrt(math.pow(lon_dist, 2) + math.pow(lat_dist, 2))\n", "\n", " particle.prev_lon = particle.lon # Set the stored values for next iteration.\n", " particle.prev_lat = particle.lat" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We will run this on a `ParticleSet` containing the two particles within the idealised moving eddies fieldset from above. Note that `pclass=DistParticle` in this case" ] }, { "cell_type": "code", "execution_count": 31, "metadata": {}, "outputs": [], "source": [ "fieldset = FieldSet.from_parcels(\"MovingEddies_data/moving_eddies\")\n", "pset = ParticleSet.from_list(fieldset=fieldset, pclass=DistParticle, lon=[3.3, 3.3], lat=[46.0, 47.8])" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Again define a new kernel to include the function written above and execute the `ParticleSet`." ] }, { "cell_type": "code", "execution_count": 32, "metadata": {}, "outputs": [ { "name": "stderr", "output_type": "stream", "text": [ "INFO: Compiled DistParticleAdvectionRK4TotalDistance ==> /var/folders/r2/8593q8z93kd7t4j9kbb_f7p00000gn/T/parcels-501/a671fb28e39d9ea81a0d010d91ae7ab8.so\n" ] } ], "source": [ "k_dist = pset.Kernel(TotalDistance) # Casting the TotalDistance function to a kernel.\n", "\n", "pset.execute(AdvectionRK4 + k_dist, # Add kernels using the + operator.\n", " runtime=timedelta(days=6),\n", " dt=timedelta(minutes=5),\n", " output_file=pset.ParticleFile(name=\"EddyParticles_Dist.nc\", outputdt=timedelta(hours=1)))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "And finally print the distance that each particle has travelled (note that this is also stored in the `EddyParticles_Dist.nc` file)" ] }, { "cell_type": "code", "execution_count": 33, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[952.56305, 990.1734]\n" ] } ], "source": [ "print([p.distance for p in pset])" ] } ], "metadata": { "kernelspec": { "display_name": "Python 2", "language": "python", "name": "python2" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 2 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython2", "version": "2.7.14" } }, "nbformat": 4, "nbformat_minor": 1 }